feat(expo): add pickFiles wrapper over expo-document-picker

Author: Ripwords

packages/expo/package.json

@@ -61,6 +61,7 @@
     "expo": ">=52.0.0",
     "expo-constants": ">=16.0.0",
     "expo-device": ">=6.0.0",
+    "expo-document-picker": "*",
     "react": ">=18.3.0",
     "react-native": ">=0.74.0",
     "react-native-gesture-handler": ">=2.16.0",

packages/expo/src/capture/file-picker.cancel.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, mock, test } from "bun:test"
+
+mock.module("expo-document-picker", () => ({
+  getDocumentAsync: async () => ({ canceled: true }),
+}))
+
+describe("pickFiles", () => {
+  test("returns empty array when canceled", async () => {
+    const { pickFiles } = await import("./file-picker")
+    const out = await pickFiles({ multiple: true })
+    expect(out).toEqual([])
+  })
+})

packages/expo/src/capture/file-picker.success.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, mock, test } from "bun:test"
+
+mock.module("expo-document-picker", () => ({
+  getDocumentAsync: async () => ({
+    canceled: false,
+    assets: [
+      { uri: "file:///tmp/a.png", name: "a.png", mimeType: "image/png", size: 100 },
+      { uri: "file:///tmp/b.pdf", name: "b.pdf", mimeType: "application/pdf", size: 200 },
+    ],
+  }),
+}))
+
+describe("pickFiles", () => {
+  test("returns Attachment[] from a successful pick", async () => {
+    const { pickFiles } = await import("./file-picker")
+    const out = await pickFiles({ multiple: true })
+    expect(out).toHaveLength(2)
+    expect(out[0]?.filename).toBe("a.png")
+    expect(out[0]?.mime).toBe("image/png")
+    expect(out[0]?.size).toBe(100)
+    expect(out[0]?.isImage).toBe(true)
+  })
+})

packages/expo/src/capture/file-picker.ts

@@ -0,0 +1,47 @@
+import type { Attachment } from "@reprojs/sdk-utils"
+import type { DocumentPickerResult } from "expo-document-picker"
+
+type GetDocumentAsync = (opts?: {
+  multiple?: boolean
+  copyToCacheDirectory?: boolean
+}) => Promise<DocumentPickerResult>
+
+/**
+ * Wraps expo-document-picker.getDocumentAsync. Returns an empty array on
+ * cancel or when the picker module is unavailable. Each asset is converted
+ * to an Attachment — the blob field is a placeholder Blob; the intake-client
+ * uses the previewUrl (file:// uri) at submit time so we don't read every
+ * file into memory the moment it's picked.
+ */
+export async function pickFiles({ multiple = true }: { multiple?: boolean } = {}): Promise<
+  Attachment[]
+> {
+  let getDocumentAsync: GetDocumentAsync | undefined
+  try {
+    const mod = await import("expo-document-picker")
+    getDocumentAsync = mod.getDocumentAsync
+  } catch {
+    return []
+  }
+  if (!getDocumentAsync) return []
+
+  const result = await getDocumentAsync({
+    multiple,
+    copyToCacheDirectory: true,
+  })
+
+  if (result.canceled || !result.assets) return []
+
+  return result.assets.map((asset, i) => {
+    const mime = asset.mimeType ?? "application/octet-stream"
+    return {
+      id: `picker-${Date.now()}-${i}`,
+      blob: new Blob([], { type: mime }), // Placeholder — intake-client uses uri at submit time.
+      filename: asset.name,
+      mime,
+      size: asset.size ?? 0,
+      isImage: mime.startsWith("image/"),
+      previewUrl: asset.uri,
+    } satisfies Attachment
+  })
+}

packages/expo/src/vendor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Ambient stub for optional peer dependencies that are not installed in the
+ * workspace but must be importable at runtime in the host app.
+ */
+
+declare module "expo-document-picker" {
+  export interface DocumentPickerAsset {
+    uri: string
+    name: string
+    mimeType?: string
+    size?: number
+  }
+
+  export type DocumentPickerResult =
+    | { canceled: true; assets?: never }
+    | { canceled: false; assets: DocumentPickerAsset[] }
+
+  export function getDocumentAsync(options?: {
+    multiple?: boolean
+    copyToCacheDirectory?: boolean
+    type?: string | string[]
+  }): Promise<DocumentPickerResult>
+}