@ankhorage/expo-runtime 1.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/expo-runtime
 
+## 2.1.0
+
+### Minor Changes
+
+- 2d4b9c2: Add an isolated Expo media-picker subpath for transient file and photo-library selection, returning canonical media bytes and metadata without leaking local picker URIs into authoring state.
+
+## 2.0.0
+
+### Major Changes
+
+- 3ef194b: Align public manifest planning APIs with Contracts 6 and its canonical Ankhorage module fields. Expo config `plugins` remain unchanged as a separate Expo ecosystem concept.
+
 ## 1.0.0
 
 ### Major Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # EXPO-RUNTIME
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.0.11](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Declarative runtime integration for Expo apps: maps app capabilities to permissions, packages, config plugins, providers, and adapters
 

package/dist/mediaPicker/createExpoMediaPickerAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { ExpoMediaPickerAdapter } from './types';
+export declare function createExpoMediaPickerAdapter(): ExpoMediaPickerAdapter;
+//# sourceMappingURL=createExpoMediaPickerAdapter.d.ts.map

package/dist/mediaPicker/createExpoMediaPickerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExpoMediaPickerAdapter.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/createExpoMediaPickerAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,wBAAgB,4BAA4B,IAAI,sBAAsB,CAKrE"}

package/dist/mediaPicker/createExpoMediaPickerAdapter.js

@@ -0,0 +1,8 @@
+import { pickDocumentMedia } from './documentPicker';
+import { pickPhotoLibraryMedia } from './photoLibraryPicker';
+export function createExpoMediaPickerAdapter() {
+    return {
+        pick: (input) => input.source === 'photo-library' ? pickPhotoLibraryMedia(input) : pickDocumentMedia(input),
+    };
+}
+//# sourceMappingURL=createExpoMediaPickerAdapter.js.map

package/dist/mediaPicker/createExpoMediaPickerAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExpoMediaPickerAdapter.js","sourceRoot":"","sources":["../../src/mediaPicker/createExpoMediaPickerAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,MAAM,KAAK,eAAe,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC;KAC7F,CAAC;AACJ,CAAC","sourcesContent":["import { pickDocumentMedia } from './documentPicker';\nimport { pickPhotoLibraryMedia } from './photoLibraryPicker';\nimport type { ExpoMediaPickerAdapter } from './types';\n\nexport function createExpoMediaPickerAdapter(): ExpoMediaPickerAdapter {\n  return {\n    pick: (input) =>\n      input.source === 'photo-library' ? pickPhotoLibraryMedia(input) : pickDocumentMedia(input),\n  };\n}\n"]}

package/dist/mediaPicker/documentPicker.d.ts

@@ -0,0 +1,18 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+import { type ArrayBufferReadable, type SelectedMediaByteSource } from './readSelectedBytes';
+import type { ExpoMediaPickerInput, ExpoMediaPickerResult } from './types';
+interface DocumentPickerAssetLike extends SelectedMediaByteSource {
+    readonly name: string;
+    readonly mimeType?: string;
+    readonly size?: number;
+    readonly file?: ArrayBufferReadable;
+}
+interface DocumentPickerResultLike {
+    readonly canceled: boolean;
+    readonly assets: readonly DocumentPickerAssetLike[] | null;
+}
+type ByteReader = (source: SelectedMediaByteSource) => Promise<Uint8Array | null>;
+export declare function normalizeDocumentPickerResult(result: DocumentPickerResultLike, mediaKinds: readonly MediaAssetKind[] | undefined, readBytes?: ByteReader): Promise<ExpoMediaPickerResult>;
+export declare function pickDocumentMedia(input: ExpoMediaPickerInput): Promise<ExpoMediaPickerResult>;
+export {};
+//# sourceMappingURL=documentPicker.d.ts.map

package/dist/mediaPicker/documentPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentPicker.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/documentPicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE3E,UAAU,uBAAwB,SAAQ,uBAAuB;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GAAG,IAAI,CAAC;CAC5D;AAED,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAElF,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,wBAAwB,EAChC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,EACjD,SAAS,GAAE,UAAmC,GAC7C,OAAO,CAAC,qBAAqB,CAAC,CAkBhC;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAahC"}

package/dist/mediaPicker/documentPicker.js

@@ -0,0 +1,41 @@
+import { inferMediaAssetKind, isRequestedMediaKind, resolveDocumentPickerMimeTypes, } from './mediaKinds';
+import { readSelectedMediaBytes, } from './readSelectedBytes';
+export async function normalizeDocumentPickerResult(result, mediaKinds, readBytes = readSelectedMediaBytes) {
+    if (result.canceled)
+        return { ok: false, reason: 'cancelled' };
+    const asset = result.assets?.[0];
+    if (!asset)
+        return { ok: false, reason: 'empty-selection' };
+    const kind = inferMediaAssetKind(asset.mimeType, asset.name);
+    if (!isRequestedMediaKind(kind, mediaKinds))
+        return { ok: false, reason: 'unsupported-kind' };
+    const body = await readBytes(asset);
+    if (!body)
+        return { ok: false, reason: 'read-failed' };
+    return {
+        ok: true,
+        selection: {
+            kind,
+            name: asset.name,
+            body,
+            contentType: asset.mimeType,
+            sizeBytes: asset.size ?? body.byteLength,
+        },
+    };
+}
+export async function pickDocumentMedia(input) {
+    try {
+        const DocumentPicker = await import('expo-document-picker');
+        const result = await DocumentPicker.getDocumentAsync({
+            base64: false,
+            copyToCacheDirectory: true,
+            multiple: false,
+            type: resolveDocumentPickerMimeTypes(input.mediaKinds),
+        });
+        return await normalizeDocumentPickerResult(result, input.mediaKinds);
+    }
+    catch {
+        return { ok: false, reason: 'picker-failed' };
+    }
+}
+//# sourceMappingURL=documentPicker.js.map

package/dist/mediaPicker/documentPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentPicker.js","sourceRoot":"","sources":["../../src/mediaPicker/documentPicker.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAiB7B,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAAgC,EAChC,UAAiD,EACjD,YAAwB,sBAAsB;IAE9C,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC9F,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACvD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS,EAAE;YACT,IAAI;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI;YACJ,WAAW,EAAE,KAAK,CAAC,QAAQ;YAC3B,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU;SACzC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC;YACnD,MAAM,EAAE,KAAK;YACb,oBAAoB,EAAE,IAAI;YAC1B,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,8BAA8B,CAAC,KAAK,CAAC,UAAU,CAAC;SACvD,CAAC,CAAC;QACH,OAAO,MAAM,6BAA6B,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;AACH,CAAC","sourcesContent":["import type { MediaAssetKind } from '@ankhorage/contracts';\n\nimport {\n  inferMediaAssetKind,\n  isRequestedMediaKind,\n  resolveDocumentPickerMimeTypes,\n} from './mediaKinds';\nimport {\n  type ArrayBufferReadable,\n  readSelectedMediaBytes,\n  type SelectedMediaByteSource,\n} from './readSelectedBytes';\nimport type { ExpoMediaPickerInput, ExpoMediaPickerResult } from './types';\n\ninterface DocumentPickerAssetLike extends SelectedMediaByteSource {\n  readonly name: string;\n  readonly mimeType?: string;\n  readonly size?: number;\n  readonly file?: ArrayBufferReadable;\n}\n\ninterface DocumentPickerResultLike {\n  readonly canceled: boolean;\n  readonly assets: readonly DocumentPickerAssetLike[] | null;\n}\n\ntype ByteReader = (source: SelectedMediaByteSource) => Promise<Uint8Array | null>;\n\nexport async function normalizeDocumentPickerResult(\n  result: DocumentPickerResultLike,\n  mediaKinds: readonly MediaAssetKind[] | undefined,\n  readBytes: ByteReader = readSelectedMediaBytes,\n): Promise<ExpoMediaPickerResult> {\n  if (result.canceled) return { ok: false, reason: 'cancelled' };\n  const asset = result.assets?.[0];\n  if (!asset) return { ok: false, reason: 'empty-selection' };\n  const kind = inferMediaAssetKind(asset.mimeType, asset.name);\n  if (!isRequestedMediaKind(kind, mediaKinds)) return { ok: false, reason: 'unsupported-kind' };\n  const body = await readBytes(asset);\n  if (!body) return { ok: false, reason: 'read-failed' };\n  return {\n    ok: true,\n    selection: {\n      kind,\n      name: asset.name,\n      body,\n      contentType: asset.mimeType,\n      sizeBytes: asset.size ?? body.byteLength,\n    },\n  };\n}\n\nexport async function pickDocumentMedia(\n  input: ExpoMediaPickerInput,\n): Promise<ExpoMediaPickerResult> {\n  try {\n    const DocumentPicker = await import('expo-document-picker');\n    const result = await DocumentPicker.getDocumentAsync({\n      base64: false,\n      copyToCacheDirectory: true,\n      multiple: false,\n      type: resolveDocumentPickerMimeTypes(input.mediaKinds),\n    });\n    return await normalizeDocumentPickerResult(result, input.mediaKinds);\n  } catch {\n    return { ok: false, reason: 'picker-failed' };\n  }\n}\n"]}

package/dist/mediaPicker/index.d.ts

@@ -0,0 +1,3 @@
+export { createExpoMediaPickerAdapter } from './createExpoMediaPickerAdapter';
+export { EXPO_MEDIA_PICKER_SOURCES, type ExpoMediaPickerAdapter, type ExpoMediaPickerFailureReason, type ExpoMediaPickerInput, type ExpoMediaPickerResult, type ExpoMediaPickerSelection, type ExpoMediaPickerSource, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/mediaPicker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,SAAS,CAAC"}

package/dist/mediaPicker/index.js

@@ -0,0 +1,3 @@
+export { createExpoMediaPickerAdapter } from './createExpoMediaPickerAdapter';
+export { EXPO_MEDIA_PICKER_SOURCES, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/mediaPicker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mediaPicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EACL,yBAAyB,GAO1B,MAAM,SAAS,CAAC","sourcesContent":["export { createExpoMediaPickerAdapter } from './createExpoMediaPickerAdapter';\nexport {\n  EXPO_MEDIA_PICKER_SOURCES,\n  type ExpoMediaPickerAdapter,\n  type ExpoMediaPickerFailureReason,\n  type ExpoMediaPickerInput,\n  type ExpoMediaPickerResult,\n  type ExpoMediaPickerSelection,\n  type ExpoMediaPickerSource,\n} from './types';\n"]}

package/dist/mediaPicker/mediaKinds.d.ts

@@ -0,0 +1,5 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+export declare function inferMediaAssetKind(contentType: string | undefined, name: string): MediaAssetKind;
+export declare function isRequestedMediaKind(kind: MediaAssetKind, mediaKinds?: readonly MediaAssetKind[]): boolean;
+export declare function resolveDocumentPickerMimeTypes(mediaKinds?: readonly MediaAssetKind[]): string | string[];
+//# sourceMappingURL=mediaKinds.d.ts.map

package/dist/mediaPicker/mediaKinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaKinds.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/mediaKinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmB3D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CASjG;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EACpB,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,GACrC,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,GACrC,MAAM,GAAG,MAAM,EAAE,CAKnB"}

package/dist/mediaPicker/mediaKinds.js

@@ -0,0 +1,37 @@
+const FONT_EXTENSIONS = /\.(eot|otf|ttf|woff2?)$/i;
+const FONT_CONTENT_TYPES = new Set([
+    'application/font-sfnt',
+    'application/font-woff',
+    'application/font-woff2',
+    'application/vnd.ms-fontobject',
+    'application/x-font-opentype',
+    'application/x-font-ttf',
+]);
+const DOCUMENT_MIME_TYPES = {
+    image: ['image/*'],
+    audio: ['audio/*'],
+    video: ['video/*'],
+    font: ['font/*', ...FONT_CONTENT_TYPES],
+};
+export function inferMediaAssetKind(contentType, name) {
+    const normalizedType = contentType?.toLowerCase();
+    if (normalizedType?.startsWith('image/'))
+        return 'image';
+    if (normalizedType?.startsWith('audio/'))
+        return 'audio';
+    if (normalizedType?.startsWith('video/'))
+        return 'video';
+    if (normalizedType?.startsWith('font/') || FONT_CONTENT_TYPES.has(normalizedType ?? '')) {
+        return 'font';
+    }
+    return FONT_EXTENSIONS.test(name) ? 'font' : 'file';
+}
+export function isRequestedMediaKind(kind, mediaKinds) {
+    return !mediaKinds?.length || mediaKinds.includes(kind);
+}
+export function resolveDocumentPickerMimeTypes(mediaKinds) {
+    if (!mediaKinds?.length || mediaKinds.includes('file'))
+        return '*/*';
+    return Array.from(new Set(mediaKinds.flatMap((kind) => (kind === 'file' ? [] : DOCUMENT_MIME_TYPES[kind]))));
+}
+//# sourceMappingURL=mediaKinds.js.map

package/dist/mediaPicker/mediaKinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaKinds.js","sourceRoot":"","sources":["../../src/mediaPicker/mediaKinds.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,uBAAuB;IACvB,uBAAuB;IACvB,wBAAwB;IACxB,+BAA+B;IAC/B,6BAA6B;IAC7B,wBAAwB;CACzB,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAyE;IAChG,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,IAAI,EAAE,CAAC,QAAQ,EAAE,GAAG,kBAAkB,CAAC;CACxC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,WAA+B,EAAE,IAAY;IAC/E,MAAM,cAAc,GAAG,WAAW,EAAE,WAAW,EAAE,CAAC;IAClD,IAAI,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IACzD,IAAI,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IACzD,IAAI,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IACzD,IAAI,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAC;QACxF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAoB,EACpB,UAAsC;IAEtC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,UAAsC;IAEtC,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAC1F,CAAC;AACJ,CAAC","sourcesContent":["import type { MediaAssetKind } from '@ankhorage/contracts';\n\nconst FONT_EXTENSIONS = /\\.(eot|otf|ttf|woff2?)$/i;\nconst FONT_CONTENT_TYPES = new Set([\n  'application/font-sfnt',\n  'application/font-woff',\n  'application/font-woff2',\n  'application/vnd.ms-fontobject',\n  'application/x-font-opentype',\n  'application/x-font-ttf',\n]);\n\nconst DOCUMENT_MIME_TYPES: Readonly<Record<Exclude<MediaAssetKind, 'file'>, readonly string[]>> = {\n  image: ['image/*'],\n  audio: ['audio/*'],\n  video: ['video/*'],\n  font: ['font/*', ...FONT_CONTENT_TYPES],\n};\n\nexport function inferMediaAssetKind(contentType: string | undefined, name: string): MediaAssetKind {\n  const normalizedType = contentType?.toLowerCase();\n  if (normalizedType?.startsWith('image/')) return 'image';\n  if (normalizedType?.startsWith('audio/')) return 'audio';\n  if (normalizedType?.startsWith('video/')) return 'video';\n  if (normalizedType?.startsWith('font/') || FONT_CONTENT_TYPES.has(normalizedType ?? '')) {\n    return 'font';\n  }\n  return FONT_EXTENSIONS.test(name) ? 'font' : 'file';\n}\n\nexport function isRequestedMediaKind(\n  kind: MediaAssetKind,\n  mediaKinds?: readonly MediaAssetKind[],\n): boolean {\n  return !mediaKinds?.length || mediaKinds.includes(kind);\n}\n\nexport function resolveDocumentPickerMimeTypes(\n  mediaKinds?: readonly MediaAssetKind[],\n): string | string[] {\n  if (!mediaKinds?.length || mediaKinds.includes('file')) return '*/*';\n  return Array.from(\n    new Set(mediaKinds.flatMap((kind) => (kind === 'file' ? [] : DOCUMENT_MIME_TYPES[kind]))),\n  );\n}\n"]}

package/dist/mediaPicker/photoLibraryPicker.d.ts

@@ -0,0 +1,24 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+import { type ArrayBufferReadable, type SelectedMediaByteSource } from './readSelectedBytes';
+import type { ExpoMediaPickerInput, ExpoMediaPickerResult } from './types';
+export type ExpoPhotoLibraryMediaType = 'images' | 'videos';
+interface PhotoLibraryAssetLike extends SelectedMediaByteSource {
+    readonly fileName?: string | null;
+    readonly fileSize?: number;
+    readonly mimeType?: string | null;
+    readonly width: number;
+    readonly height: number;
+    readonly duration?: number | null;
+    readonly type?: 'image' | 'video' | 'livePhoto' | 'pairedVideo' | null;
+    readonly file?: ArrayBufferReadable;
+}
+interface PhotoLibraryResultLike {
+    readonly canceled: boolean;
+    readonly assets: readonly PhotoLibraryAssetLike[] | null;
+}
+type ByteReader = (source: SelectedMediaByteSource) => Promise<Uint8Array | null>;
+export declare function resolvePhotoLibraryMediaTypes(mediaKinds?: readonly MediaAssetKind[]): ExpoPhotoLibraryMediaType[] | null;
+export declare function normalizePhotoLibraryResult(result: PhotoLibraryResultLike, mediaKinds: readonly MediaAssetKind[] | undefined, readBytes?: ByteReader): Promise<ExpoMediaPickerResult>;
+export declare function pickPhotoLibraryMedia(input: ExpoMediaPickerInput): Promise<ExpoMediaPickerResult>;
+export {};
+//# sourceMappingURL=photoLibraryPicker.d.ts.map

package/dist/mediaPicker/photoLibraryPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photoLibraryPicker.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/photoLibraryPicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,UAAU,qBAAsB,SAAQ,uBAAuB;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;CAC1D;AAED,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAElF,wBAAgB,6BAA6B,CAC3C,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,GACrC,yBAAyB,EAAE,GAAG,IAAI,CAMpC;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,EACjD,SAAS,GAAE,UAAmC,GAC7C,OAAO,CAAC,qBAAqB,CAAC,CAqBhC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAiBhC"}

package/dist/mediaPicker/photoLibraryPicker.js

@@ -0,0 +1,68 @@
+import { isRequestedMediaKind } from './mediaKinds';
+import { readSelectedMediaBytes, } from './readSelectedBytes';
+export function resolvePhotoLibraryMediaTypes(mediaKinds) {
+    if (!mediaKinds?.length)
+        return ['images', 'videos'];
+    const mediaTypes = [];
+    if (mediaKinds.includes('image'))
+        mediaTypes.push('images');
+    if (mediaKinds.includes('video'))
+        mediaTypes.push('videos');
+    return mediaTypes.length > 0 ? mediaTypes : null;
+}
+export async function normalizePhotoLibraryResult(result, mediaKinds, readBytes = readSelectedMediaBytes) {
+    if (result.canceled)
+        return { ok: false, reason: 'cancelled' };
+    const asset = result.assets?.[0];
+    if (!asset)
+        return { ok: false, reason: 'empty-selection' };
+    const kind = resolvePhotoLibraryAssetKind(asset);
+    if (!isRequestedMediaKind(kind, mediaKinds))
+        return { ok: false, reason: 'unsupported-kind' };
+    const body = await readBytes(asset);
+    if (!body)
+        return { ok: false, reason: 'read-failed' };
+    return {
+        ok: true,
+        selection: {
+            kind,
+            name: asset.fileName?.trim() ?? `selected-${kind}`,
+            body,
+            contentType: asset.mimeType ?? undefined,
+            sizeBytes: asset.fileSize ?? body.byteLength,
+            width: asset.width,
+            height: asset.height,
+            durationMs: asset.duration ?? undefined,
+        },
+    };
+}
+export async function pickPhotoLibraryMedia(input) {
+    const mediaTypes = resolvePhotoLibraryMediaTypes(input.mediaKinds);
+    if (!mediaTypes)
+        return { ok: false, reason: 'unsupported-kind' };
+    try {
+        const ImagePicker = await import('expo-image-picker');
+        const result = await ImagePicker.launchImageLibraryAsync({
+            allowsEditing: false,
+            allowsMultipleSelection: false,
+            base64: false,
+            exif: false,
+            mediaTypes,
+            quality: 1,
+        });
+        return await normalizePhotoLibraryResult(result, input.mediaKinds);
+    }
+    catch {
+        return { ok: false, reason: 'picker-failed' };
+    }
+}
+function resolvePhotoLibraryAssetKind(asset) {
+    if (asset.type === 'video' || asset.type === 'pairedVideo')
+        return 'video';
+    if (asset.type === 'image' || asset.type === 'livePhoto')
+        return 'image';
+    if (asset.mimeType?.startsWith('video/'))
+        return 'video';
+    return asset.duration !== null && asset.duration !== undefined ? 'video' : 'image';
+}
+//# sourceMappingURL=photoLibraryPicker.js.map

package/dist/mediaPicker/photoLibraryPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photoLibraryPicker.js","sourceRoot":"","sources":["../../src/mediaPicker/photoLibraryPicker.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaAssetKind } from '@ankhorage/contracts';\n\nimport { isRequestedMediaKind } from './mediaKinds';\nimport {\n  type ArrayBufferReadable,\n  readSelectedMediaBytes,\n  type SelectedMediaByteSource,\n} from './readSelectedBytes';\nimport type { ExpoMediaPickerInput, ExpoMediaPickerResult } from './types';\n\nexport type ExpoPhotoLibraryMediaType = 'images' | 'videos';\n\ninterface PhotoLibraryAssetLike extends SelectedMediaByteSource {\n  readonly fileName?: string | null;\n  readonly fileSize?: number;\n  readonly mimeType?: string | null;\n  readonly width: number;\n  readonly height: number;\n  readonly duration?: number | null;\n  readonly type?: 'image' | 'video' | 'livePhoto' | 'pairedVideo' | null;\n  readonly file?: ArrayBufferReadable;\n}\n\ninterface PhotoLibraryResultLike {\n  readonly canceled: boolean;\n  readonly assets: readonly PhotoLibraryAssetLike[] | null;\n}\n\ntype ByteReader = (source: SelectedMediaByteSource) => Promise<Uint8Array | null>;\n\nexport function resolvePhotoLibraryMediaTypes(\n  mediaKinds?: readonly MediaAssetKind[],\n): ExpoPhotoLibraryMediaType[] | null {\n  if (!mediaKinds?.length) return ['images', 'videos'];\n  const mediaTypes: ExpoPhotoLibraryMediaType[] = [];\n  if (mediaKinds.includes('image')) mediaTypes.push('images');\n  if (mediaKinds.includes('video')) mediaTypes.push('videos');\n  return mediaTypes.length > 0 ? mediaTypes : null;\n}\n\nexport async function normalizePhotoLibraryResult(\n  result: PhotoLibraryResultLike,\n  mediaKinds: readonly MediaAssetKind[] | undefined,\n  readBytes: ByteReader = readSelectedMediaBytes,\n): Promise<ExpoMediaPickerResult> {\n  if (result.canceled) return { ok: false, reason: 'cancelled' };\n  const asset = result.assets?.[0];\n  if (!asset) return { ok: false, reason: 'empty-selection' };\n  const kind = resolvePhotoLibraryAssetKind(asset);\n  if (!isRequestedMediaKind(kind, mediaKinds)) return { ok: false, reason: 'unsupported-kind' };\n  const body = await readBytes(asset);\n  if (!body) return { ok: false, reason: 'read-failed' };\n  return {\n    ok: true,\n    selection: {\n      kind,\n      name: asset.fileName?.trim() ?? `selected-${kind}`,\n      body,\n      contentType: asset.mimeType ?? undefined,\n      sizeBytes: asset.fileSize ?? body.byteLength,\n      width: asset.width,\n      height: asset.height,\n      durationMs: asset.duration ?? undefined,\n    },\n  };\n}\n\nexport async function pickPhotoLibraryMedia(\n  input: ExpoMediaPickerInput,\n): Promise<ExpoMediaPickerResult> {\n  const mediaTypes = resolvePhotoLibraryMediaTypes(input.mediaKinds);\n  if (!mediaTypes) return { ok: false, reason: 'unsupported-kind' };\n  try {\n    const ImagePicker = await import('expo-image-picker');\n    const result = await ImagePicker.launchImageLibraryAsync({\n      allowsEditing: false,\n      allowsMultipleSelection: false,\n      base64: false,\n      exif: false,\n      mediaTypes,\n      quality: 1,\n    });\n    return await normalizePhotoLibraryResult(result, input.mediaKinds);\n  } catch {\n    return { ok: false, reason: 'picker-failed' };\n  }\n}\n\nfunction resolvePhotoLibraryAssetKind(asset: PhotoLibraryAssetLike): 'image' | 'video' {\n  if (asset.type === 'video' || asset.type === 'pairedVideo') return 'video';\n  if (asset.type === 'image' || asset.type === 'livePhoto') return 'image';\n  if (asset.mimeType?.startsWith('video/')) return 'video';\n  return asset.duration !== null && asset.duration !== undefined ? 'video' : 'image';\n}\n"]}

package/dist/mediaPicker/readSelectedBytes.d.ts

@@ -0,0 +1,9 @@
+export interface ArrayBufferReadable {
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface SelectedMediaByteSource {
+    readonly uri: string;
+    readonly file?: ArrayBufferReadable;
+}
+export declare function readSelectedMediaBytes(source: SelectedMediaByteSource): Promise<Uint8Array | null>;
+//# sourceMappingURL=readSelectedBytes.d.ts.map

package/dist/mediaPicker/readSelectedBytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSelectedBytes.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/readSelectedBytes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAU5B"}

package/dist/mediaPicker/readSelectedBytes.js

@@ -0,0 +1,13 @@
+export async function readSelectedMediaBytes(source) {
+    try {
+        if (source.file) {
+            return new Uint8Array(await source.file.arrayBuffer());
+        }
+        const { File } = await import('expo-file-system');
+        return await new File(source.uri).bytes();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=readSelectedBytes.js.map

package/dist/mediaPicker/readSelectedBytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSelectedBytes.js","sourceRoot":"","sources":["../../src/mediaPicker/readSelectedBytes.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAA+B;IAE/B,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAClD,OAAO,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["export interface ArrayBufferReadable {\n  arrayBuffer(): Promise<ArrayBuffer>;\n}\n\nexport interface SelectedMediaByteSource {\n  readonly uri: string;\n  readonly file?: ArrayBufferReadable;\n}\n\nexport async function readSelectedMediaBytes(\n  source: SelectedMediaByteSource,\n): Promise<Uint8Array | null> {\n  try {\n    if (source.file) {\n      return new Uint8Array(await source.file.arrayBuffer());\n    }\n    const { File } = await import('expo-file-system');\n    return await new File(source.uri).bytes();\n  } catch {\n    return null;\n  }\n}\n"]}

package/dist/mediaPicker/types.d.ts

@@ -0,0 +1,29 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+export declare const EXPO_MEDIA_PICKER_SOURCES: readonly ["file", "photo-library"];
+export type ExpoMediaPickerSource = (typeof EXPO_MEDIA_PICKER_SOURCES)[number];
+export interface ExpoMediaPickerInput {
+    readonly source: ExpoMediaPickerSource;
+    readonly mediaKinds?: readonly MediaAssetKind[];
+}
+export interface ExpoMediaPickerSelection {
+    readonly kind: MediaAssetKind;
+    readonly name: string;
+    readonly body: Uint8Array;
+    readonly contentType?: string;
+    readonly sizeBytes?: number;
+    readonly width?: number;
+    readonly height?: number;
+    readonly durationMs?: number;
+}
+export type ExpoMediaPickerFailureReason = 'cancelled' | 'empty-selection' | 'picker-failed' | 'read-failed' | 'unsupported-kind';
+export type ExpoMediaPickerResult = {
+    readonly ok: true;
+    readonly selection: ExpoMediaPickerSelection;
+} | {
+    readonly ok: false;
+    readonly reason: ExpoMediaPickerFailureReason;
+};
+export interface ExpoMediaPickerAdapter {
+    pick(input: ExpoMediaPickerInput): Promise<ExpoMediaPickerResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mediaPicker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mediaPicker/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,yBAAyB,oCAAqC,CAAC;AAE5E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,4BAA4B,GACpC,WAAW,GACX,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,kBAAkB,CAAC;AAEvB,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnE"}

package/dist/mediaPicker/types.js

@@ -0,0 +1,2 @@
+export const EXPO_MEDIA_PICKER_SOURCES = ['file', 'photo-library'];
+//# sourceMappingURL=types.js.map

package/dist/mediaPicker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mediaPicker/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,eAAe,CAAU,CAAC","sourcesContent":["import type { MediaAssetKind } from '@ankhorage/contracts';\n\nexport const EXPO_MEDIA_PICKER_SOURCES = ['file', 'photo-library'] as const;\n\nexport type ExpoMediaPickerSource = (typeof EXPO_MEDIA_PICKER_SOURCES)[number];\n\nexport interface ExpoMediaPickerInput {\n  readonly source: ExpoMediaPickerSource;\n  readonly mediaKinds?: readonly MediaAssetKind[];\n}\n\nexport interface ExpoMediaPickerSelection {\n  readonly kind: MediaAssetKind;\n  readonly name: string;\n  readonly body: Uint8Array;\n  readonly contentType?: string;\n  readonly sizeBytes?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly durationMs?: number;\n}\n\nexport type ExpoMediaPickerFailureReason =\n  | 'cancelled'\n  | 'empty-selection'\n  | 'picker-failed'\n  | 'read-failed'\n  | 'unsupported-kind';\n\nexport type ExpoMediaPickerResult =\n  | { readonly ok: true; readonly selection: ExpoMediaPickerSelection }\n  | { readonly ok: false; readonly reason: ExpoMediaPickerFailureReason };\n\nexport interface ExpoMediaPickerAdapter {\n  pick(input: ExpoMediaPickerInput): Promise<ExpoMediaPickerResult>;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "Declarative runtime integration for Expo apps: maps app capabilities to permissions, packages, config plugins, providers, and adapters",
   "homepage": "https://github.com/ankhorage/expo-runtime#readme",
   "bugs": {
@@ -22,7 +22,7 @@
     "runtime"
   ],
   "dependencies": {
-    "@ankhorage/contracts": "^4.0.2",
+    "@ankhorage/contracts": "^7.6.0",
     "@ankhorage/permissions": "^0.2.1"
   },
   "files": [
@@ -47,6 +47,13 @@
       "types": "./src/planning.ts",
       "import": "./dist/planning.js",
       "default": "./dist/planning.js"
+    },
+    "./media-picker": {
+      "react-native": "./src/mediaPicker/index.ts",
+      "browser": "./src/mediaPicker/index.ts",
+      "types": "./src/mediaPicker/index.ts",
+      "import": "./dist/mediaPicker/index.js",
+      "default": "./dist/mediaPicker/index.js"
     }
   },
   "publishConfig": {
@@ -71,9 +78,23 @@
     "@ankhorage/zora": "^2.8.7",
     "expo": "~54.0.34",
     "expo-camera": "~17.0.10",
+    "expo-document-picker": "~14.0.8",
+    "expo-file-system": "~19.0.23",
+    "expo-image-picker": "~17.0.11",
     "react": "19.1.0",
     "react-native": "0.81.5"
   },
+  "peerDependenciesMeta": {
+    "expo-document-picker": {
+      "optional": true
+    },
+    "expo-file-system": {
+      "optional": true
+    },
+    "expo-image-picker": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@ankhorage/devtools": "^1.0.6",
     "@ankhorage/paradox": "^0.1.10",
@@ -84,6 +105,9 @@
     "@types/react": "^19.2.14",
     "expo": "~54.0.34",
     "expo-camera": "~17.0.10",
+    "expo-document-picker": "~14.0.8",
+    "expo-file-system": "~19.0.23",
+    "expo-image-picker": "~17.0.11",
     "react": "19.1.0",
     "react-native": "0.81.5",
     "typescript": "^5.9.3"

package/src/generatedAppOutput.test.ts

@@ -63,6 +63,13 @@ const CAMERA_PLAN: ExpoRuntimePlan = {
 };
 
 describe('generatedAppOutput', () => {
+  test('keeps Expo config plugins as a distinct external ecosystem concept', () => {
+    expect(resolveExpoRuntimeConfigPluginOutput(CAMERA_PLAN)).toEqual([
+      ['expo-camera', { cameraPermission: 'Allow camera access to scan barcodes.' }],
+      'expo-something',
+    ]);
+  });
+
   test('returns empty output for missing or empty plans', () => {
     expect(resolveExpoRuntimeDependencyMap(undefined)).toEqual({});
     expect(resolveExpoRuntimeConfigPluginOutput(undefined)).toEqual([]);

package/src/mediaPicker/createExpoMediaPickerAdapter.ts

@@ -0,0 +1,10 @@
+import { pickDocumentMedia } from './documentPicker';
+import { pickPhotoLibraryMedia } from './photoLibraryPicker';
+import type { ExpoMediaPickerAdapter } from './types';
+
+export function createExpoMediaPickerAdapter(): ExpoMediaPickerAdapter {
+  return {
+    pick: (input) =>
+      input.source === 'photo-library' ? pickPhotoLibraryMedia(input) : pickDocumentMedia(input),
+  };
+}

package/src/mediaPicker/documentPicker.ts

@@ -0,0 +1,68 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+
+import {
+  inferMediaAssetKind,
+  isRequestedMediaKind,
+  resolveDocumentPickerMimeTypes,
+} from './mediaKinds';
+import {
+  type ArrayBufferReadable,
+  readSelectedMediaBytes,
+  type SelectedMediaByteSource,
+} from './readSelectedBytes';
+import type { ExpoMediaPickerInput, ExpoMediaPickerResult } from './types';
+
+interface DocumentPickerAssetLike extends SelectedMediaByteSource {
+  readonly name: string;
+  readonly mimeType?: string;
+  readonly size?: number;
+  readonly file?: ArrayBufferReadable;
+}
+
+interface DocumentPickerResultLike {
+  readonly canceled: boolean;
+  readonly assets: readonly DocumentPickerAssetLike[] | null;
+}
+
+type ByteReader = (source: SelectedMediaByteSource) => Promise<Uint8Array | null>;
+
+export async function normalizeDocumentPickerResult(
+  result: DocumentPickerResultLike,
+  mediaKinds: readonly MediaAssetKind[] | undefined,
+  readBytes: ByteReader = readSelectedMediaBytes,
+): Promise<ExpoMediaPickerResult> {
+  if (result.canceled) return { ok: false, reason: 'cancelled' };
+  const asset = result.assets?.[0];
+  if (!asset) return { ok: false, reason: 'empty-selection' };
+  const kind = inferMediaAssetKind(asset.mimeType, asset.name);
+  if (!isRequestedMediaKind(kind, mediaKinds)) return { ok: false, reason: 'unsupported-kind' };
+  const body = await readBytes(asset);
+  if (!body) return { ok: false, reason: 'read-failed' };
+  return {
+    ok: true,
+    selection: {
+      kind,
+      name: asset.name,
+      body,
+      contentType: asset.mimeType,
+      sizeBytes: asset.size ?? body.byteLength,
+    },
+  };
+}
+
+export async function pickDocumentMedia(
+  input: ExpoMediaPickerInput,
+): Promise<ExpoMediaPickerResult> {
+  try {
+    const DocumentPicker = await import('expo-document-picker');
+    const result = await DocumentPicker.getDocumentAsync({
+      base64: false,
+      copyToCacheDirectory: true,
+      multiple: false,
+      type: resolveDocumentPickerMimeTypes(input.mediaKinds),
+    });
+    return await normalizeDocumentPickerResult(result, input.mediaKinds);
+  } catch {
+    return { ok: false, reason: 'picker-failed' };
+  }
+}

package/src/mediaPicker/index.ts

@@ -0,0 +1,10 @@
+export { createExpoMediaPickerAdapter } from './createExpoMediaPickerAdapter';
+export {
+  EXPO_MEDIA_PICKER_SOURCES,
+  type ExpoMediaPickerAdapter,
+  type ExpoMediaPickerFailureReason,
+  type ExpoMediaPickerInput,
+  type ExpoMediaPickerResult,
+  type ExpoMediaPickerSelection,
+  type ExpoMediaPickerSource,
+} from './types';

package/src/mediaPicker/mediaKinds.ts

@@ -0,0 +1,45 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+
+const FONT_EXTENSIONS = /\.(eot|otf|ttf|woff2?)$/i;
+const FONT_CONTENT_TYPES = new Set([
+  'application/font-sfnt',
+  'application/font-woff',
+  'application/font-woff2',
+  'application/vnd.ms-fontobject',
+  'application/x-font-opentype',
+  'application/x-font-ttf',
+]);
+
+const DOCUMENT_MIME_TYPES: Readonly<Record<Exclude<MediaAssetKind, 'file'>, readonly string[]>> = {
+  image: ['image/*'],
+  audio: ['audio/*'],
+  video: ['video/*'],
+  font: ['font/*', ...FONT_CONTENT_TYPES],
+};
+
+export function inferMediaAssetKind(contentType: string | undefined, name: string): MediaAssetKind {
+  const normalizedType = contentType?.toLowerCase();
+  if (normalizedType?.startsWith('image/')) return 'image';
+  if (normalizedType?.startsWith('audio/')) return 'audio';
+  if (normalizedType?.startsWith('video/')) return 'video';
+  if (normalizedType?.startsWith('font/') || FONT_CONTENT_TYPES.has(normalizedType ?? '')) {
+    return 'font';
+  }
+  return FONT_EXTENSIONS.test(name) ? 'font' : 'file';
+}
+
+export function isRequestedMediaKind(
+  kind: MediaAssetKind,
+  mediaKinds?: readonly MediaAssetKind[],
+): boolean {
+  return !mediaKinds?.length || mediaKinds.includes(kind);
+}
+
+export function resolveDocumentPickerMimeTypes(
+  mediaKinds?: readonly MediaAssetKind[],
+): string | string[] {
+  if (!mediaKinds?.length || mediaKinds.includes('file')) return '*/*';
+  return Array.from(
+    new Set(mediaKinds.flatMap((kind) => (kind === 'file' ? [] : DOCUMENT_MIME_TYPES[kind]))),
+  );
+}

package/src/mediaPicker/mediaPicker.test.ts

@@ -0,0 +1,120 @@
+import { describe, expect, test } from 'bun:test';
+
+import { normalizeDocumentPickerResult } from './documentPicker';
+import { inferMediaAssetKind, resolveDocumentPickerMimeTypes } from './mediaKinds';
+import { normalizePhotoLibraryResult, resolvePhotoLibraryMediaTypes } from './photoLibraryPicker';
+import { readSelectedMediaBytes } from './readSelectedBytes';
+
+const BYTES = new Uint8Array([1, 2, 3]);
+const readBytes = () => Promise.resolve(BYTES);
+
+describe('Expo media picker boundary', () => {
+  test('maps document MIME types and font extensions to canonical media kinds', () => {
+    expect(inferMediaAssetKind('image/svg+xml', 'logo.svg')).toBe('image');
+    expect(inferMediaAssetKind(undefined, 'Brand.woff2')).toBe('font');
+    expect(resolveDocumentPickerMimeTypes(['image', 'audio'])).toEqual(['image/*', 'audio/*']);
+    expect(resolveDocumentPickerMimeTypes(['file'])).toBe('*/*');
+  });
+
+  test('normalizes document selection to bytes without leaking the transient URI', async () => {
+    const result = await normalizeDocumentPickerResult(
+      {
+        canceled: false,
+        assets: [
+          {
+            uri: 'content://temporary/logo',
+            name: 'logo.svg',
+            mimeType: 'image/svg+xml',
+            size: 3,
+          },
+        ],
+      },
+      ['image'],
+      readBytes,
+    );
+
+    expect(result.ok).toBe(true);
+    if (!result.ok) return;
+    expect(result.selection).toEqual({
+      kind: 'image',
+      name: 'logo.svg',
+      body: BYTES,
+      contentType: 'image/svg+xml',
+      sizeBytes: 3,
+    });
+    expect('uri' in result.selection).toBe(false);
+  });
+
+  test('rejects document selections outside the requested media kinds', async () => {
+    const result = await normalizeDocumentPickerResult(
+      {
+        canceled: false,
+        assets: [{ uri: 'file:///tmp/song.mp3', name: 'song.mp3', mimeType: 'audio/mpeg' }],
+      },
+      ['image'],
+      readBytes,
+    );
+
+    expect(result).toEqual({ ok: false, reason: 'unsupported-kind' });
+  });
+
+  test('limits photo library picker to image and video kinds', () => {
+    expect(resolvePhotoLibraryMediaTypes()).toEqual(['images', 'videos']);
+    expect(resolvePhotoLibraryMediaTypes(['image'])).toEqual(['images']);
+    expect(resolvePhotoLibraryMediaTypes(['audio', 'font'])).toBeNull();
+  });
+
+  test('normalizes photo library metadata without exposing its local URI', async () => {
+    const result = await normalizePhotoLibraryResult(
+      {
+        canceled: false,
+        assets: [
+          {
+            uri: 'file:///tmp/clip.mov',
+            fileName: 'clip.mov',
+            fileSize: 3,
+            mimeType: 'video/quicktime',
+            width: 1920,
+            height: 1080,
+            duration: 2400,
+            type: 'video',
+          },
+        ],
+      },
+      ['video'],
+      readBytes,
+    );
+
+    expect(result.ok).toBe(true);
+    if (!result.ok) return;
+    expect(result.selection).toMatchObject({
+      kind: 'video',
+      name: 'clip.mov',
+      contentType: 'video/quicktime',
+      sizeBytes: 3,
+      width: 1920,
+      height: 1080,
+      durationMs: 2400,
+    });
+    expect('uri' in result.selection).toBe(false);
+  });
+
+  test('reads web picker files without persisting their blob URI', async () => {
+    const { buffer } = new Uint8Array([4, 5, 6]);
+    const bytes = await readSelectedMediaBytes({
+      uri: 'blob:https://studio.local/transient',
+      file: { arrayBuffer: () => Promise.resolve(buffer) },
+    });
+
+    expect(bytes).toEqual(new Uint8Array([4, 5, 6]));
+  });
+
+  test('normalizes cancellation', async () => {
+    expect(
+      await normalizeDocumentPickerResult({ canceled: true, assets: null }, undefined),
+    ).toEqual({
+      ok: false,
+      reason: 'cancelled',
+    });
+  });
+});

package/src/mediaPicker/photoLibraryPicker.ts

@@ -0,0 +1,94 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+
+import { isRequestedMediaKind } from './mediaKinds';
+import {
+  type ArrayBufferReadable,
+  readSelectedMediaBytes,
+  type SelectedMediaByteSource,
+} from './readSelectedBytes';
+import type { ExpoMediaPickerInput, ExpoMediaPickerResult } from './types';
+
+export type ExpoPhotoLibraryMediaType = 'images' | 'videos';
+
+interface PhotoLibraryAssetLike extends SelectedMediaByteSource {
+  readonly fileName?: string | null;
+  readonly fileSize?: number;
+  readonly mimeType?: string | null;
+  readonly width: number;
+  readonly height: number;
+  readonly duration?: number | null;
+  readonly type?: 'image' | 'video' | 'livePhoto' | 'pairedVideo' | null;
+  readonly file?: ArrayBufferReadable;
+}
+
+interface PhotoLibraryResultLike {
+  readonly canceled: boolean;
+  readonly assets: readonly PhotoLibraryAssetLike[] | null;
+}
+
+type ByteReader = (source: SelectedMediaByteSource) => Promise<Uint8Array | null>;
+
+export function resolvePhotoLibraryMediaTypes(
+  mediaKinds?: readonly MediaAssetKind[],
+): ExpoPhotoLibraryMediaType[] | null {
+  if (!mediaKinds?.length) return ['images', 'videos'];
+  const mediaTypes: ExpoPhotoLibraryMediaType[] = [];
+  if (mediaKinds.includes('image')) mediaTypes.push('images');
+  if (mediaKinds.includes('video')) mediaTypes.push('videos');
+  return mediaTypes.length > 0 ? mediaTypes : null;
+}
+
+export async function normalizePhotoLibraryResult(
+  result: PhotoLibraryResultLike,
+  mediaKinds: readonly MediaAssetKind[] | undefined,
+  readBytes: ByteReader = readSelectedMediaBytes,
+): Promise<ExpoMediaPickerResult> {
+  if (result.canceled) return { ok: false, reason: 'cancelled' };
+  const asset = result.assets?.[0];
+  if (!asset) return { ok: false, reason: 'empty-selection' };
+  const kind = resolvePhotoLibraryAssetKind(asset);
+  if (!isRequestedMediaKind(kind, mediaKinds)) return { ok: false, reason: 'unsupported-kind' };
+  const body = await readBytes(asset);
+  if (!body) return { ok: false, reason: 'read-failed' };
+  return {
+    ok: true,
+    selection: {
+      kind,
+      name: asset.fileName?.trim() ?? `selected-${kind}`,
+      body,
+      contentType: asset.mimeType ?? undefined,
+      sizeBytes: asset.fileSize ?? body.byteLength,
+      width: asset.width,
+      height: asset.height,
+      durationMs: asset.duration ?? undefined,
+    },
+  };
+}
+
+export async function pickPhotoLibraryMedia(
+  input: ExpoMediaPickerInput,
+): Promise<ExpoMediaPickerResult> {
+  const mediaTypes = resolvePhotoLibraryMediaTypes(input.mediaKinds);
+  if (!mediaTypes) return { ok: false, reason: 'unsupported-kind' };
+  try {
+    const ImagePicker = await import('expo-image-picker');
+    const result = await ImagePicker.launchImageLibraryAsync({
+      allowsEditing: false,
+      allowsMultipleSelection: false,
+      base64: false,
+      exif: false,
+      mediaTypes,
+      quality: 1,
+    });
+    return await normalizePhotoLibraryResult(result, input.mediaKinds);
+  } catch {
+    return { ok: false, reason: 'picker-failed' };
+  }
+}
+
+function resolvePhotoLibraryAssetKind(asset: PhotoLibraryAssetLike): 'image' | 'video' {
+  if (asset.type === 'video' || asset.type === 'pairedVideo') return 'video';
+  if (asset.type === 'image' || asset.type === 'livePhoto') return 'image';
+  if (asset.mimeType?.startsWith('video/')) return 'video';
+  return asset.duration !== null && asset.duration !== undefined ? 'video' : 'image';
+}

package/src/mediaPicker/readSelectedBytes.ts

@@ -0,0 +1,22 @@
+export interface ArrayBufferReadable {
+  arrayBuffer(): Promise<ArrayBuffer>;
+}
+
+export interface SelectedMediaByteSource {
+  readonly uri: string;
+  readonly file?: ArrayBufferReadable;
+}
+
+export async function readSelectedMediaBytes(
+  source: SelectedMediaByteSource,
+): Promise<Uint8Array | null> {
+  try {
+    if (source.file) {
+      return new Uint8Array(await source.file.arrayBuffer());
+    }
+    const { File } = await import('expo-file-system');
+    return await new File(source.uri).bytes();
+  } catch {
+    return null;
+  }
+}

package/src/mediaPicker/types.ts

@@ -0,0 +1,36 @@
+import type { MediaAssetKind } from '@ankhorage/contracts';
+
+export const EXPO_MEDIA_PICKER_SOURCES = ['file', 'photo-library'] as const;
+
+export type ExpoMediaPickerSource = (typeof EXPO_MEDIA_PICKER_SOURCES)[number];
+
+export interface ExpoMediaPickerInput {
+  readonly source: ExpoMediaPickerSource;
+  readonly mediaKinds?: readonly MediaAssetKind[];
+}
+
+export interface ExpoMediaPickerSelection {
+  readonly kind: MediaAssetKind;
+  readonly name: string;
+  readonly body: Uint8Array;
+  readonly contentType?: string;
+  readonly sizeBytes?: number;
+  readonly width?: number;
+  readonly height?: number;
+  readonly durationMs?: number;
+}
+
+export type ExpoMediaPickerFailureReason =
+  | 'cancelled'
+  | 'empty-selection'
+  | 'picker-failed'
+  | 'read-failed'
+  | 'unsupported-kind';
+
+export type ExpoMediaPickerResult =
+  | { readonly ok: true; readonly selection: ExpoMediaPickerSelection }
+  | { readonly ok: false; readonly reason: ExpoMediaPickerFailureReason };
+
+export interface ExpoMediaPickerAdapter {
+  pick(input: ExpoMediaPickerInput): Promise<ExpoMediaPickerResult>;
+}

package/src/resolveExpoRuntimePlan.test.ts

@@ -195,7 +195,7 @@ const BASE_MANIFEST = {
   activeThemeId: 'default',
   activeThemeMode: 'light',
   infra: {
-    plugins: [],
+    modules: [],
   },
   settings: {
     localization: {