@ankhorage/expo-runtime 0.0.0 → 0.0.2

package/dist/resolveExpoRuntimePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveExpoRuntimePlan.js","sourceRoot":"","sources":["../src/resolveExpoRuntimePlan.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AnkhorageCapabilityName,\n  AppManifest,\n  ScreenCapabilityRequirement,\n  ScreenPermissionRequirement,\n} from '@ankhorage/contracts';\nimport type { Permission } from '@ankhorage/permissions';\nimport { isPermission } from '@ankhorage/permissions';\nimport {\n  EXPO_PERMISSION_SUPPORT,\n  type ExpoPermissionMetadata,\n  type PermissionSupport,\n} from '@ankhorage/permissions/expo/manifest';\n\ninterface ExpoRuntimeDependency {\n  readonly name: string;\n  readonly version: string;\n  readonly reasons: readonly string[];\n}\n\ninterface ExpoRuntimeConfigPlugin {\n  readonly name: string;\n  readonly options?: Readonly<Record<string, boolean | string>>;\n}\n\nexport type ExpoRuntimeProviderId = 'permissions';\nexport type ExpoRuntimeAdapterId = 'ExpoBarcodeScannerAdapter';\n\ninterface ExpoRuntimeDiagnostic {\n  readonly severity: 'error' | 'warning';\n  readonly requirementType: 'capability' | 'configHint' | 'package' | 'permission';\n  readonly requirement: string;\n  readonly message: string;\n  readonly support?: PermissionSupport;\n}\n\nexport interface ExpoRuntimePlan {\n  readonly permissions: readonly ScreenPermissionRequirement[];\n  readonly capabilities: readonly ScreenCapabilityRequirement[];\n  readonly impliedPermissions: readonly ScreenPermissionRequirement[];\n  readonly dependencies: readonly ExpoRuntimeDependency[];\n  readonly nativeConfig: {\n    readonly androidPermissions: readonly string[];\n    readonly configHints: readonly string[];\n    readonly plugins: readonly ExpoRuntimeConfigPlugin[];\n  };\n  readonly providers: readonly ExpoRuntimeProviderId[];\n  readonly runtimeAdapters: readonly ExpoRuntimeAdapterId[];\n  readonly usesExpoRuntimeRegistry: boolean;\n  readonly needsPermissionsProvider: boolean;\n  readonly diagnostics: readonly ExpoRuntimeDiagnostic[];\n}\n\ninterface ExpoRuntimeCapabilityMetadata {\n  readonly impliedPermissions?: readonly ScreenPermissionRequirement[];\n  readonly requiredPackages?: readonly string[];\n  readonly providers?: readonly ExpoRuntimeProviderId[];\n  readonly runtimeAdapters?: readonly ExpoRuntimeAdapterId[];\n  readonly androidPermissions?: readonly string[];\n  readonly plugins?: readonly ExpoRuntimeConfigPlugin[];\n}\n\ninterface ExpoRuntimeHintMetadata {\n  readonly androidPermissions?: readonly string[];\n  readonly plugin?: ExpoRuntimeConfigPlugin;\n}\n\ninterface ResolveExpoRuntimePlanOptions {\n  readonly capabilityRegistry?: Readonly<\n    Partial<Record<AnkhorageCapabilityName, ExpoRuntimeCapabilityMetadata>>\n  >;\n  readonly dependencyVersions?: Readonly<Record<string, string>>;\n  readonly permissionSupport?: Readonly<Record<Permission, ExpoPermissionMetadata>>;\n}\n\nconst CAMERA_ANDROID_PERMISSION = 'android.permission.CAMERA';\nconst EXPO_RUNTIME_PACKAGE_NAME = '@ankhorage/expo-runtime';\n\nconst GENERATED_EXPO_DEPENDENCY_VERSIONS = {\n  '@ankhorage/permissions': '^0.2.0',\n  '@ankhorage/expo-runtime': 'latest',\n  'expo-camera': '~17.0.10',\n} as const satisfies Record<string, string>;\n\nconst EXPO_RUNTIME_PROVIDER_PACKAGES = {\n  permissions: '@ankhorage/permissions',\n} as const satisfies Record<ExpoRuntimeProviderId, string>;\n\nconst EXPO_RUNTIME_CONFIG_HINTS = {\n  cameraPermission: {\n    androidPermissions: [CAMERA_ANDROID_PERMISSION],\n    plugin: {\n      name: 'expo-camera',\n      options: {\n        cameraPermission: 'Allow camera access.',\n      },\n    },\n  },\n} as const satisfies Readonly<Record<string, ExpoRuntimeHintMetadata>>;\n\nconst EXPO_CAPABILITY_RUNTIME_REGISTRY = {\n  barcodeScanner: {\n    impliedPermissions: [{ permission: 'camera' }],\n    requiredPackages: ['expo-camera'],\n    providers: ['permissions'],\n    runtimeAdapters: ['ExpoBarcodeScannerAdapter'],\n    androidPermissions: [CAMERA_ANDROID_PERMISSION],\n    plugins: [\n      {\n        name: 'expo-camera',\n        options: {\n          cameraPermission: 'Allow camera access to scan barcodes.',\n        },\n      },\n    ],\n  },\n} as const satisfies Readonly<\n  Partial<Record<AnkhorageCapabilityName, ExpoRuntimeCapabilityMetadata>>\n>;\n\nexport function resolveExpoRuntimePlan(\n  manifest: AppManifest,\n  options: ResolveExpoRuntimePlanOptions = {},\n): ExpoRuntimePlan {\n  const permissionsByName = new Map<string, ScreenPermissionRequirement>();\n  const impliedPermissionsByName = new Map<string, ScreenPermissionRequirement>();\n  const capabilitiesByName = new Map<string, ScreenCapabilityRequirement>();\n\n  for (const screen of Object.values(manifest.screens)) {\n    screen.requires?.permissions?.forEach((requirement) => {\n      permissionsByName.set(requirement.permission, requirement);\n    });\n    screen.requires?.capabilities?.forEach((requirement) => {\n      capabilitiesByName.set(requirement.capability, requirement);\n    });\n  }\n\n  const capabilityRegistry: Readonly<\n    Partial<Record<AnkhorageCapabilityName, ExpoRuntimeCapabilityMetadata>>\n  > = options.capabilityRegistry ?? EXPO_CAPABILITY_RUNTIME_REGISTRY;\n\n  for (const capabilityRequirement of capabilitiesByName.values()) {\n    capabilityRegistry[capabilityRequirement.capability]?.impliedPermissions?.forEach(\n      (permissionRequirement: ScreenPermissionRequirement) => {\n        if (!permissionsByName.has(permissionRequirement.permission)) {\n          permissionsByName.set(permissionRequirement.permission, permissionRequirement);\n          impliedPermissionsByName.set(permissionRequirement.permission, permissionRequirement);\n        }\n      },\n    );\n  }\n\n  const diagnostics: ExpoRuntimeDiagnostic[] = [];\n  const dependencies = new Map<string, ExpoRuntimeDependency>();\n  const pluginOptions = new Map<string, Record<string, boolean | string>>();\n  const configHints = new Set<string>();\n  const androidPermissions = new Set<string>();\n  const providers = new Set<ExpoRuntimeProviderId>();\n  const runtimeAdapters = new Set<ExpoRuntimeAdapterId>();\n  const dependencyVersions: Readonly<Record<string, string>> =\n    options.dependencyVersions ?? GENERATED_EXPO_DEPENDENCY_VERSIONS;\n  const permissionSupport = options.permissionSupport ?? EXPO_PERMISSION_SUPPORT;\n  const configHintRegistry: Readonly<Record<string, ExpoRuntimeHintMetadata>> =\n    EXPO_RUNTIME_CONFIG_HINTS;\n\n  const addDependency = (name: string, reason: string) => {\n    const version = dependencyVersions[name];\n    if (version === undefined) {\n      diagnostics.push({\n        severity: 'warning',\n        requirementType: 'package',\n        requirement: name,\n        message: `No generated-app dependency version is registered for '${name}'.`,\n      });\n      return;\n    }\n\n    const existing = dependencies.get(name);\n    if (existing) {\n      dependencies.set(name, {\n        ...existing,\n        reasons: Array.from(new Set([...existing.reasons, reason])),\n      });\n      return;\n    }\n\n    dependencies.set(name, {\n      name,\n      version,\n      reasons: [reason],\n    });\n  };\n\n  const addProvider = (provider: ExpoRuntimeProviderId, reason: string) => {\n    providers.add(provider);\n    addDependency(EXPO_RUNTIME_PROVIDER_PACKAGES[provider], reason);\n  };\n\n  const addPlugin = (plugin: ExpoRuntimeConfigPlugin) => {\n    const existingOptions = pluginOptions.get(plugin.name) ?? {};\n    pluginOptions.set(plugin.name, {\n      ...existingOptions,\n      ...(plugin.options ?? {}),\n    });\n  };\n\n  for (const permissionRequirement of permissionsByName.values()) {\n    if (!isPermission(permissionRequirement.permission)) {\n      diagnostics.push({\n        severity: 'error',\n        requirementType: 'permission',\n        requirement: permissionRequirement.permission,\n        message: `Unknown permission '${permissionRequirement.permission}' cannot be resolved for Expo runtime generation.`,\n      });\n      continue;\n    }\n\n    const supportMetadata = permissionSupport[permissionRequirement.permission];\n    if (\n      supportMetadata.support === 'unsupported' ||\n      supportMetadata.support === 'notImplemented' ||\n      supportMetadata.support === 'limited'\n    ) {\n      diagnostics.push({\n        severity: supportMetadata.support === 'limited' ? 'warning' : 'error',\n        requirementType: 'permission',\n        requirement: permissionRequirement.permission,\n        message: `Expo runtime support for '${permissionRequirement.permission}' is '${supportMetadata.support}'.`,\n        support: supportMetadata.support,\n      });\n      continue;\n    }\n\n    if (supportMetadata.support === 'notRequired') {\n      continue;\n    }\n\n    addProvider('permissions', `permission:${permissionRequirement.permission}`);\n    supportMetadata.requiredPackages.forEach((packageName) => {\n      addDependency(packageName, `permission:${permissionRequirement.permission}`);\n    });\n\n    supportMetadata.configHints.forEach((configHint) => {\n      configHints.add(configHint);\n      const configHintMetadata = configHintRegistry[configHint];\n      if (!configHintMetadata) {\n        diagnostics.push({\n          severity: 'warning',\n          requirementType: 'configHint',\n          requirement: configHint,\n          message: `Config hint '${configHint}' is not translated into generated Expo config yet.`,\n        });\n        return;\n      }\n\n      configHintMetadata.androidPermissions?.forEach((permissionName) => {\n        androidPermissions.add(permissionName);\n      });\n      if (configHintMetadata.plugin) {\n        addPlugin(configHintMetadata.plugin);\n      }\n    });\n  }\n\n  for (const capabilityRequirement of capabilitiesByName.values()) {\n    const capabilityMetadata = capabilityRegistry[capabilityRequirement.capability];\n    if (!capabilityMetadata) {\n      diagnostics.push({\n        severity: 'warning',\n        requirementType: 'capability',\n        requirement: capabilityRequirement.capability,\n        message: `No Expo runtime metadata is registered for capability '${capabilityRequirement.capability}'.`,\n      });\n      continue;\n    }\n\n    capabilityMetadata.requiredPackages?.forEach((packageName) => {\n      addDependency(packageName, `capability:${capabilityRequirement.capability}`);\n    });\n    capabilityMetadata.providers?.forEach((provider) => {\n      addProvider(provider, `capability:${capabilityRequirement.capability}`);\n    });\n    capabilityMetadata.runtimeAdapters?.forEach((runtimeAdapter) => {\n      runtimeAdapters.add(runtimeAdapter);\n    });\n    capabilityMetadata.androidPermissions?.forEach((permissionName) => {\n      androidPermissions.add(permissionName);\n    });\n    capabilityMetadata.plugins?.forEach(addPlugin);\n  }\n\n  if (providers.size > 0 || runtimeAdapters.size > 0) {\n    addDependency(EXPO_RUNTIME_PACKAGE_NAME, 'runtime:expo');\n  }\n\n  const plugins = Array.from(pluginOptions.entries())\n    .map(([name, options]) => ({\n      name,\n      options: Object.keys(options).length > 0 ? options : undefined,\n    }))\n    .sort((left, right) => left.name.localeCompare(right.name));\n\n  return {\n    permissions: Array.from(permissionsByName.values()).sort(comparePermissionRequirements),\n    capabilities: Array.from(capabilitiesByName.values()).sort(compareCapabilityRequirements),\n    impliedPermissions: Array.from(impliedPermissionsByName.values()).sort(\n      comparePermissionRequirements,\n    ),\n    dependencies: Array.from(dependencies.values()).sort((left, right) =>\n      left.name.localeCompare(right.name),\n    ),\n    nativeConfig: {\n      androidPermissions: Array.from(androidPermissions).sort(),\n      configHints: Array.from(configHints).sort(),\n      plugins,\n    },\n    providers: Array.from(providers).sort(),\n    runtimeAdapters: Array.from(runtimeAdapters).sort(),\n    usesExpoRuntimeRegistry: runtimeAdapters.size > 0,\n    needsPermissionsProvider: providers.has('permissions'),\n    diagnostics,\n  };\n}\n\nfunction compareCapabilityRequirements(\n  left: ScreenCapabilityRequirement,\n  right: ScreenCapabilityRequirement,\n): number {\n  return left.capability.localeCompare(right.capability);\n}\n\nfunction comparePermissionRequirements(\n  left: ScreenPermissionRequirement,\n  right: ScreenPermissionRequirement,\n): number {\n  return left.permission.localeCompare(right.permission);\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "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": {
@@ -10,7 +10,7 @@
   "license": "MIT",
   "main": "./dist/index.js",
   "sideEffects": false,
-  "types": "./dist/index.d.ts",
+  "types": "./src/index.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ankhorage/expo-runtime.git"
@@ -21,7 +21,11 @@
     "expo",
     "runtime"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "@ankhorage/contracts": "^1.18.0",
+    "@ankhorage/permissions": "^0.2.0",
+    "@ankhorage/zora": "^2.8.0"
+  },
   "files": [
     "dist",
     "src",
@@ -34,7 +38,7 @@
     ".": {
       "react-native": "./src/index.ts",
       "browser": "./src/index.ts",
-      "types": "./dist/index.d.ts",
+      "types": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -57,12 +61,23 @@
     "typecheck": "bun x tsc --noEmit -p tsconfig.json",
     "version-packages": "changeset version"
   },
+  "peerDependencies": {
+    "expo": "~54.0.34",
+    "expo-camera": "~17.0.10",
+    "react": "19.1.0",
+    "react-native": "0.81.5"
+  },
   "devDependencies": {
     "@ankhorage/devtools": "^1.0.6",
     "@ankhorage/paradox": "^0.1.10",
     "@changesets/cli": "^2.31.0",
     "@types/bun": "^1.3.13",
     "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "expo": "~54.0.34",
+    "expo-camera": "~17.0.10",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
     "typescript": "^5.9.3"
   },
   "packageManager": "bun@1.3.13"

package/src/ExpoBarcodeScannerAdapter.test.tsx

@@ -0,0 +1,75 @@
+import { describe, expect, it } from 'bun:test';
+
+import {
+  BARCODE_SCAN_DEDUPE_WINDOW_MS,
+  BARCODE_SCANNER_TYPES,
+  mapPermissionStatusToCameraPermissionStatus,
+  normalizeExpoBarcodeScanResult,
+  shouldIgnoreBarcodeScan,
+} from './barcodeScanRuntime';
+
+describe('ExpoBarcodeScannerAdapter helpers', () => {
+  it('normalizes Expo barcode scan payloads for the runtime event pipeline', () => {
+    expect(
+      normalizeExpoBarcodeScanResult({
+        data: ' 0123456789 ',
+        type: 'ean13',
+      }),
+    ).toEqual({
+      value: '0123456789',
+      type: 'ean13',
+    });
+  });
+
+  it('drops empty scan payloads', () => {
+    expect(
+      normalizeExpoBarcodeScanResult({
+        data: '   ',
+        type: 'qr',
+      }),
+    ).toBeNull();
+  });
+
+  it('suppresses repeated scans inside the dedupe window', () => {
+    expect(
+      shouldIgnoreBarcodeScan(
+        {
+          value: '0123456789',
+          type: 'ean13',
+          timestamp: 1_000,
+        },
+        {
+          value: '0123456789',
+          type: 'ean13',
+        },
+        1_000 + BARCODE_SCAN_DEDUPE_WINDOW_MS - 1,
+      ),
+    ).toBe(true);
+    expect(
+      shouldIgnoreBarcodeScan(
+        {
+          value: '0123456789',
+          type: 'ean13',
+          timestamp: 1_000,
+        },
+        {
+          value: '0123456789',
+          type: 'ean13',
+        },
+        1_000 + BARCODE_SCAN_DEDUPE_WINDOW_MS,
+      ),
+    ).toBe(false);
+  });
+
+  it('maps permission states into the ZORA camera permission surface', () => {
+    expect(mapPermissionStatusToCameraPermissionStatus('unknown', false)).toBe('unknown');
+    expect(mapPermissionStatusToCameraPermissionStatus('granted', false)).toBe('granted');
+    expect(mapPermissionStatusToCameraPermissionStatus('denied', false)).toBe('denied');
+    expect(mapPermissionStatusToCameraPermissionStatus('blocked', true)).toBe('requesting');
+  });
+
+  it('keeps the exported scanner barcode type allowlist intact', () => {
+    expect(BARCODE_SCANNER_TYPES).toContain('qr');
+    expect(BARCODE_SCANNER_TYPES).toContain('ean13');
+  });
+});

package/src/ExpoBarcodeScannerAdapter.tsx

@@ -0,0 +1,84 @@
+import { Permission, usePermission } from '@ankhorage/permissions';
+import { BarcodeScannerView, type BarcodeScannerViewProps } from '@ankhorage/zora';
+import { type BarcodeScanningResult, type BarcodeType, CameraView } from 'expo-camera';
+import React from 'react';
+import { StyleSheet } from 'react-native';
+
+import {
+  BARCODE_SCANNER_TYPES,
+  type BarcodeScanRecord,
+  mapPermissionStatusToCameraPermissionStatus,
+  normalizeExpoBarcodeScanResult,
+  shouldIgnoreBarcodeScan,
+} from './barcodeScanRuntime';
+
+const CAMERA_BARCODE_TYPES: BarcodeType[] = [...BARCODE_SCANNER_TYPES];
+
+export function ExpoBarcodeScannerAdapter(props: BarcodeScannerViewProps) {
+  const { onBarcodeScanned, onRequestPermission, ...viewProps } = props;
+  const cameraPermission = usePermission(Permission.Camera);
+  const [isRequestingPermission, setIsRequestingPermission] = React.useState(false);
+  const lastScanRef = React.useRef<BarcodeScanRecord | null>(null);
+
+  const permissionStatus = mapPermissionStatusToCameraPermissionStatus(
+    cameraPermission.status,
+    isRequestingPermission,
+  );
+
+  const handleRequestPermission = React.useCallback(async () => {
+    setIsRequestingPermission(true);
+    try {
+      await cameraPermission.request();
+      await onRequestPermission?.();
+    } finally {
+      setIsRequestingPermission(false);
+    }
+  }, [cameraPermission, onRequestPermission]);
+
+  const handleBarcodeScanned = React.useCallback(
+    (result: BarcodeScanningResult) => {
+      void (async () => {
+        const normalizedResult = normalizeExpoBarcodeScanResult(result);
+        if (normalizedResult === null) {
+          return;
+        }
+
+        const now = Date.now();
+        if (shouldIgnoreBarcodeScan(lastScanRef.current, normalizedResult, now)) {
+          return;
+        }
+
+        lastScanRef.current = {
+          ...normalizedResult,
+          timestamp: now,
+        };
+        await onBarcodeScanned?.(normalizedResult);
+      })();
+    },
+    [onBarcodeScanned],
+  );
+
+  const camera =
+    permissionStatus === 'granted' ? (
+      <CameraView
+        barcodeScannerSettings={{ barcodeTypes: CAMERA_BARCODE_TYPES }}
+        onBarcodeScanned={handleBarcodeScanned}
+        style={styles.camera}
+      />
+    ) : undefined;
+
+  return (
+    <BarcodeScannerView
+      {...viewProps}
+      camera={camera}
+      onRequestPermission={handleRequestPermission}
+      permissionStatus={permissionStatus}
+    />
+  );
+}
+
+const styles = StyleSheet.create({
+  camera: {
+    flex: 1,
+  },
+});

package/src/ExpoRuntimeProviders.test.tsx

@@ -0,0 +1,61 @@
+import { afterEach, describe, expect, it, mock } from 'bun:test';
+import React from 'react';
+
+describe('ExpoRuntimeProviders', () => {
+  afterEach(() => {
+    mock.restore();
+  });
+
+  it('wraps children in PermissionsProvider when the permissions runtime is enabled', async () => {
+    const permissionClient = { name: 'permission-client' };
+    const PermissionsProvider = ({
+      children,
+      client,
+    }: {
+      children: React.ReactNode;
+      client: unknown;
+    }) => React.createElement('permissions-provider', { client }, children);
+
+    void mock.module('./permissionRuntime', () => ({
+      PermissionsProvider,
+      createPermissionClient: () => permissionClient,
+    }));
+
+    const { ExpoRuntimeProviders } = await import('./ExpoRuntimeProviders');
+    const child = React.createElement('child');
+    const element = ExpoRuntimeProviders({
+      children: child,
+      providers: ['permissions'],
+    });
+
+    expect(React.isValidElement(element)).toBe(true);
+    if (!React.isValidElement(element)) {
+      throw new Error('expected a React element');
+    }
+
+    expect(element.type).toBe(PermissionsProvider);
+    expect(element.props.client).toBe(permissionClient);
+    expect(element.props.children).toBe(child);
+  });
+
+  it('returns children unchanged when no runtime providers are enabled', async () => {
+    void mock.module('./permissionRuntime', () => ({
+      PermissionsProvider: ({ children }: { children: React.ReactNode }) => children,
+      createPermissionClient: () => ({ name: 'permission-client' }),
+    }));
+
+    const { ExpoRuntimeProviders } = await import('./ExpoRuntimeProviders');
+    const child = React.createElement('child');
+    const element = ExpoRuntimeProviders({
+      children: child,
+      providers: [],
+    });
+
+    expect(React.isValidElement(element)).toBe(true);
+    if (!React.isValidElement(element)) {
+      throw new Error('expected a React element');
+    }
+
+    expect(element.props.children).toBe(child);
+  });
+});

package/src/ExpoRuntimeProviders.tsx

@@ -0,0 +1,21 @@
+import React from 'react';
+
+import { createPermissionClient, PermissionsProvider } from './permissionRuntime';
+import type { ExpoRuntimeProviderId } from './resolveExpoRuntimePlan';
+
+const permissionClient = createPermissionClient();
+
+export interface ExpoRuntimeProvidersProps {
+  readonly children: React.ReactNode;
+  readonly providers?: readonly ExpoRuntimeProviderId[];
+}
+
+export function ExpoRuntimeProviders(props: ExpoRuntimeProvidersProps) {
+  const { children, providers = [] } = props;
+
+  if (providers.includes('permissions')) {
+    return <PermissionsProvider client={permissionClient}>{children}</PermissionsProvider>;
+  }
+
+  return <>{children}</>;
+}

package/src/barcodeScanRuntime.ts

@@ -0,0 +1,78 @@
+import type { PermissionStatus } from '@ankhorage/permissions';
+import type { BarcodeScanResult, CameraPermissionStatus } from '@ankhorage/zora';
+
+export const BARCODE_SCAN_DEDUPE_WINDOW_MS = 1500;
+
+export const BARCODE_SCANNER_TYPES = [
+  'aztec',
+  'code128',
+  'code39',
+  'code93',
+  'datamatrix',
+  'ean13',
+  'ean8',
+  'itf14',
+  'pdf417',
+  'qr',
+  'upc_a',
+  'upc_e',
+] as const;
+
+export interface BarcodeScanRecord extends BarcodeScanResult {
+  readonly timestamp: number;
+}
+
+export interface ExpoBarcodeScanResultLike {
+  readonly data: string;
+  readonly type?: string;
+}
+
+export function mapPermissionStatusToCameraPermissionStatus(
+  status: PermissionStatus,
+  isRequestingPermission: boolean,
+): CameraPermissionStatus {
+  if (isRequestingPermission) {
+    return 'requesting';
+  }
+
+  switch (status) {
+    case 'granted':
+      return 'granted';
+    case 'unknown':
+      return 'unknown';
+    default:
+      return 'denied';
+  }
+}
+
+export function normalizeExpoBarcodeScanResult(
+  result: ExpoBarcodeScanResultLike,
+): BarcodeScanResult | null {
+  const value = result.data.trim();
+  if (value.length === 0) {
+    return null;
+  }
+
+  const type = typeof result.type === 'string' && result.type.length > 0 ? result.type : undefined;
+
+  return {
+    value,
+    type,
+  };
+}
+
+export function shouldIgnoreBarcodeScan(
+  previous: BarcodeScanRecord | null,
+  next: BarcodeScanResult,
+  now: number,
+): boolean {
+  if (previous === null) {
+    return false;
+  }
+
+  return (
+    previous.value === next.value &&
+    previous.type === next.type &&
+    now - previous.timestamp < BARCODE_SCAN_DEDUPE_WINDOW_MS
+  );
+}

package/src/componentRegistry.ts

@@ -0,0 +1,11 @@
+import type React from 'react';
+
+export type ComponentRegistry = Record<string, React.ElementType>;
+
+export function createComponentRegistry(
+  ...registries: readonly ComponentRegistry[]
+): ComponentRegistry {
+  return registries.reduce<ComponentRegistry>((mergedRegistry, registry) => {
+    return { ...mergedRegistry, ...registry };
+  }, {});
+}

package/src/createExpoRuntimeRegistry.test.tsx

@@ -0,0 +1,31 @@
+import { afterEach, describe, expect, it, mock } from 'bun:test';
+import React from 'react';
+
+const BaseBarcodeScannerView = (): React.ReactElement => React.createElement(React.Fragment);
+const BaseText = (): React.ReactElement => React.createElement(React.Fragment);
+const MockExpoBarcodeScannerAdapter = (): React.ReactElement => React.createElement(React.Fragment);
+
+describe('createExpoRuntimeRegistry', () => {
+  afterEach(() => {
+    mock.restore();
+  });
+
+  it('overrides BarcodeScannerView while preserving unrelated registry entries', async () => {
+    void mock.module('./ExpoBarcodeScannerAdapter', () => ({
+      ExpoBarcodeScannerAdapter: MockExpoBarcodeScannerAdapter,
+    }));
+
+    const { createExpoRuntimeRegistry } = await import('./createExpoRuntimeRegistry');
+    const baseRegistry = {
+      BarcodeScannerView: BaseBarcodeScannerView,
+      Text: BaseText,
+    };
+
+    const registry = createExpoRuntimeRegistry(baseRegistry);
+
+    expect(registry).not.toBe(baseRegistry);
+    expect(registry.Text).toBe(BaseText);
+    expect(registry.BarcodeScannerView).not.toBe(BaseBarcodeScannerView);
+    expect(typeof registry.BarcodeScannerView).toBe('function');
+  });
+});

package/src/createExpoRuntimeRegistry.tsx

@@ -0,0 +1,17 @@
+import { type BarcodeScannerViewProps } from '@ankhorage/zora';
+import React from 'react';
+
+import { type ComponentRegistry, createComponentRegistry } from './componentRegistry';
+import { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';
+
+const EXPO_RUNTIME_OVERRIDES: ComponentRegistry = {
+  BarcodeScannerView: ExpoBarcodeScannerView,
+};
+
+export function createExpoRuntimeRegistry(baseRegistry: ComponentRegistry): ComponentRegistry {
+  return createComponentRegistry(baseRegistry, EXPO_RUNTIME_OVERRIDES);
+}
+
+function ExpoBarcodeScannerView(props: BarcodeScannerViewProps) {
+  return <ExpoBarcodeScannerAdapter {...props} />;
+}

package/src/index.ts

@@ -1 +1,20 @@
-/* todo */
+export {
+  BARCODE_SCAN_DEDUPE_WINDOW_MS,
+  BARCODE_SCANNER_TYPES,
+  type BarcodeScanRecord,
+  type ExpoBarcodeScanResultLike,
+  mapPermissionStatusToCameraPermissionStatus,
+  normalizeExpoBarcodeScanResult,
+  shouldIgnoreBarcodeScan,
+} from './barcodeScanRuntime';
+export type { ComponentRegistry } from './componentRegistry';
+export { createComponentRegistry } from './componentRegistry';
+export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';
+export { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';
+export { ExpoRuntimeProviders, type ExpoRuntimeProvidersProps } from './ExpoRuntimeProviders';
+export type {
+  ExpoRuntimeAdapterId,
+  ExpoRuntimePlan,
+  ExpoRuntimeProviderId,
+} from './resolveExpoRuntimePlan';
+export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';

package/src/permissionRuntime.ts

@@ -0,0 +1,2 @@
+export { PermissionsProvider } from '@ankhorage/permissions';
+export { createPermissionClient } from '@ankhorage/permissions/expo';