feat: support string and file-URI attachments for React Native

[bobbyg603]

Summary

• Adds BugSplatFileRef ({ uri: string; type?: string }) to the BugSplatAttachment.data union so React Native consumers — @bugsplat/expo, bare RN — can upload files by URI (what expo-image-picker, react-native-view-shot, expo-screen-capture, etc. return). RN's fetch streams the file from disk at multipart-assembly time; no need to read it into JS memory.
• Refactors the duplicated attachment loop in post() and postFeedback() into a single exported appendAttachment() helper that branches on the shape of data. No platform detection in the SDK — callers provide the shape their runtime expects.

Attachment data shapes

Type	How it's appended
Blob	body.append(filename, blob, filename) — multipart file part (browser)
Uint8Array	Wrapped in a Blob first, then appended the same way (browser)
BugSplatFileRef ({ uri, type? })	RN's file shape — body.append(filename, { uri, type, name }, filename) — RN's fetch streams the URI

Usage

// Browser screenshot via <input type="file">
await client.postFeedback('Sidebar broken', {
  attachments: [{ filename: 'screenshot.png', data: fileFromInput }],
});

// React Native screenshot via react-native-view-shot / expo-image-picker
const uri = await captureRef(viewRef);
await client.postFeedback('Sidebar broken', {
  attachments: [{ filename: 'screenshot.png', data: { uri, type: 'image/png' } }],
});

Text attachments like a component stack are produced by the consumer in whatever shape their runtime needs (e.g. new Blob([text], { type: 'text/plain' }) on web, or a data:text/plain;base64,... URI inside a FileRef on RN). The SDK does not handle text specifically — see the paired change in bugsplat-react#21.

Test plan

• npm test — 33 tests pass, including 4 new appendAttachment tests (Blob, Uint8Array, FileRef, FileRef without type)
• npm run build — clean CJS + ESM
• End-to-end verified via local tarball in @bugsplat/expo example app on an Android emulator (Pixel 7 API 35): `` catches a render error, client POSTs to BugSplat, server returns 200 with `crash_id`, and `componentStack.txt` shows up as a real file attachment in the BugSplat dashboard.

Ship sequence

After this merges + publishes as `9.1.0`:

1. bugsplat-react#21 bumps `"bugsplat": "^9.1.0"` and publishes `2.1.0`.
2. bugsplat-expo#13 bumps `"@bugsplat/react": "^2.1.0"` and publishes `0.5.0`.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR expands the attachment API to support React Native-friendly attachment shapes and centralizes multipart attachment serialization so that post() and postFeedback() handle each runtime’s FormData capabilities correctly.

Changes:

• Widen BugSplatAttachment.data to accept string and BugSplatFileRef ({ uri, type? }) in addition to Blob and Uint8Array.
• Refactor attachment appending into a shared appendAttachment() helper used by both post() and postFeedback().
• Add unit tests covering all appendAttachment() branches.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
src/index.ts	Exports the new BugSplatFileRef type from the public entrypoint.
src/bugsplat.ts	Adds appendAttachment() and replaces duplicated attachment append loops in post()/postFeedback().
src/bugsplat-options.ts	Extends attachment type definitions and documents the supported attachment data shapes.
spec/bugsplat.spec.ts	Adds focused tests for the new appendAttachment() helper behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Adds React Native–friendly attachment support by allowing attachments to be provided as file URIs, and centralizes multipart attachment appending logic in one helper.

Changes:

• Extends BugSplatAttachment.data to support BugSplatFileRef ({ uri: string; type?: string }) for React Native file uploads.
• Introduces appendAttachment() to handle Blob, Uint8Array, and BugSplatFileRef attachment shapes and refactors post() / postFeedback() to use it.
• Adds unit tests covering the new attachment-appending behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
src/index.ts	Re-exports the new BugSplatFileRef type from the public entrypoint.
src/bugsplat.ts	Adds appendAttachment() helper and switches both posting methods to use it.
src/bugsplat-options.ts	Defines BugSplatFileRef and widens BugSplatAttachment.data union to include it.
spec/bugsplat.spec.ts	Adds tests for appendAttachment() across supported attachment shapes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.