@ankhorage/expo-runtime 2.2.1 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/expo-runtime
 
+## 2.4.0
+
+### Minor Changes
+
+- b2e39b8: Classify Expo authentication browser results into neutral OAuth transport responses.
+
+## 2.3.0
+
+### Minor Changes
+
+- de6bd74: Add canonical native scheme planning for enabled Expo application targets.
+
 ## 2.2.1
 
 ### Patch Changes

package/dist/nativeLinkingPlanning.d.ts

@@ -0,0 +1,5 @@
+import type { AppDeployTargets } from '@ankhorage/contracts/deploy';
+export type ExpoRuntimeNativePlatform = 'android' | 'ios';
+export type ExpoRuntimeNativeSchemeMap = Readonly<Partial<Record<ExpoRuntimeNativePlatform, string>>>;
+export declare function resolveExpoRuntimeNativeSchemeMap(targets: AppDeployTargets): ExpoRuntimeNativeSchemeMap;
+//# sourceMappingURL=nativeLinkingPlanning.d.ts.map

package/dist/nativeLinkingPlanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeLinkingPlanning.d.ts","sourceRoot":"","sources":["../src/nativeLinkingPlanning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,KAAK,CAAC;AAE1D,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAC/C,OAAO,CAAC,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CACnD,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,gBAAgB,GACxB,0BAA0B,CAW5B"}

package/dist/nativeLinkingPlanning.js

@@ -0,0 +1,11 @@
+export function resolveExpoRuntimeNativeSchemeMap(targets) {
+    const schemes = {};
+    if (targets.android?.enabled && targets.android.scheme !== undefined) {
+        schemes.android = targets.android.scheme;
+    }
+    if (targets.ios?.enabled && targets.ios.scheme !== undefined) {
+        schemes.ios = targets.ios.scheme;
+    }
+    return schemes;
+}
+//# sourceMappingURL=nativeLinkingPlanning.js.map

package/dist/nativeLinkingPlanning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeLinkingPlanning.js","sourceRoot":"","sources":["../src/nativeLinkingPlanning.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iCAAiC,CAC/C,OAAyB;IAEzB,MAAM,OAAO,GAAuD,EAAE,CAAC;IAEvE,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { AppDeployTargets } from '@ankhorage/contracts/deploy';\n\nexport type ExpoRuntimeNativePlatform = 'android' | 'ios';\n\nexport type ExpoRuntimeNativeSchemeMap = Readonly<\n  Partial<Record<ExpoRuntimeNativePlatform, string>>\n>;\n\nexport function resolveExpoRuntimeNativeSchemeMap(\n  targets: AppDeployTargets,\n): ExpoRuntimeNativeSchemeMap {\n  const schemes: Partial<Record<ExpoRuntimeNativePlatform, string>> = {};\n\n  if (targets.android?.enabled && targets.android.scheme !== undefined) {\n    schemes.android = targets.android.scheme;\n  }\n  if (targets.ios?.enabled && targets.ios.scheme !== undefined) {\n    schemes.ios = targets.ios.scheme;\n  }\n\n  return schemes;\n}\n"]}

package/dist/oauthBrowserTransport.d.ts

@@ -0,0 +1,4 @@
+import type { AuthOAuthAuthorizationResponse } from '@ankhorage/contracts/auth';
+export declare function resolveExpoOAuthBrowserResult(result: unknown): AuthOAuthAuthorizationResponse;
+export declare function resolveExpoOAuthBrowserException(): AuthOAuthAuthorizationResponse;
+//# sourceMappingURL=oauthBrowserTransport.d.ts.map

package/dist/oauthBrowserTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthBrowserTransport.d.ts","sourceRoot":"","sources":["../src/oauthBrowserTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAEhF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,8BAA8B,CAkB7F;AAED,wBAAgB,gCAAgC,IAAI,8BAA8B,CAQjF"}

package/dist/oauthBrowserTransport.js

@@ -0,0 +1,37 @@
+export function resolveExpoOAuthBrowserResult(result) {
+    if (!isRecord(result))
+        return transportFailed('The Expo authentication browser returned no result.');
+    const type = Reflect.get(result, 'type');
+    if (type === 'success') {
+        const url = Reflect.get(result, 'url');
+        return typeof url === 'string' && url.trim().length > 0
+            ? { type: 'callback', url }
+            : transportFailed('The Expo authentication browser returned no callback URL.');
+    }
+    if (type === 'cancel') {
+        return { type: 'cancelled', reason: 'user_cancelled' };
+    }
+    if (type === 'dismiss') {
+        return { type: 'cancelled', reason: 'browser_dismissed' };
+    }
+    return transportFailed('The Expo authentication browser did not complete the OAuth redirect.');
+}
+export function resolveExpoOAuthBrowserException() {
+    return {
+        type: 'error',
+        error: {
+            code: 'browser_unavailable',
+            message: 'The Expo authentication browser could not be opened.',
+        },
+    };
+}
+function transportFailed(message) {
+    return {
+        type: 'error',
+        error: { code: 'transport_failed', message },
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=oauthBrowserTransport.js.map

package/dist/oauthBrowserTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthBrowserTransport.js","sourceRoot":"","sources":["../src/oauthBrowserTransport.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,6BAA6B,CAAC,MAAe;IAC3D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnB,OAAO,eAAe,CAAC,qDAAqD,CAAC,CAAC;IAEhF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACrD,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;YAC3B,CAAC,CAAC,eAAe,CAAC,2DAA2D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,eAAe,CAAC,sEAAsE,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,sDAAsD;SAChE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import type { AuthOAuthAuthorizationResponse } from '@ankhorage/contracts/auth';\n\nexport function resolveExpoOAuthBrowserResult(result: unknown): AuthOAuthAuthorizationResponse {\n  if (!isRecord(result))\n    return transportFailed('The Expo authentication browser returned no result.');\n\n  const type = Reflect.get(result, 'type');\n  if (type === 'success') {\n    const url = Reflect.get(result, 'url');\n    return typeof url === 'string' && url.trim().length > 0\n      ? { type: 'callback', url }\n      : transportFailed('The Expo authentication browser returned no callback URL.');\n  }\n  if (type === 'cancel') {\n    return { type: 'cancelled', reason: 'user_cancelled' };\n  }\n  if (type === 'dismiss') {\n    return { type: 'cancelled', reason: 'browser_dismissed' };\n  }\n  return transportFailed('The Expo authentication browser did not complete the OAuth redirect.');\n}\n\nexport function resolveExpoOAuthBrowserException(): AuthOAuthAuthorizationResponse {\n  return {\n    type: 'error',\n    error: {\n      code: 'browser_unavailable',\n      message: 'The Expo authentication browser could not be opened.',\n    },\n  };\n}\n\nfunction transportFailed(message: string): AuthOAuthAuthorizationResponse {\n  return {\n    type: 'error',\n    error: { code: 'transport_failed', message },\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/planning.d.ts

@@ -1,6 +1,7 @@
 export { type ExpoRuntimeConfigPluginOutput, type ExpoRuntimeDependencyMap, type ExpoRuntimeGeneratedAppOutputPlan, type ExpoRuntimeNativeOutputPlan, resolveExpoRuntimeConfigPluginOutput, resolveExpoRuntimeDependencyMap, resolveExpoRuntimeGeneratedAppOutput, resolveExpoRuntimeNativeOutput, } from './generatedAppOutput';
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
 export { type ExpoRuntimeLayoutIntegrationPlan, resolveExpoRuntimeLayoutIntegration, } from './layoutIntegrationPlanning';
+export { type ExpoRuntimeNativePlatform, type ExpoRuntimeNativeSchemeMap, resolveExpoRuntimeNativeSchemeMap, } from './nativeLinkingPlanning';
 export type { ExpoRuntimeAdapterId, ExpoRuntimePlan, ExpoRuntimeProviderId, } from './resolveExpoRuntimePlan';
 export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';
 //# sourceMappingURL=planning.d.ts.map

package/dist/planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,KAAK,gCAAgC,EACrC,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,KAAK,gCAAgC,EACrC,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/planning.js

@@ -1,5 +1,6 @@
 export { resolveExpoRuntimeConfigPluginOutput, resolveExpoRuntimeDependencyMap, resolveExpoRuntimeGeneratedAppOutput, resolveExpoRuntimeNativeOutput, } from './generatedAppOutput';
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
 export { resolveExpoRuntimeLayoutIntegration, } from './layoutIntegrationPlanning';
+export { resolveExpoRuntimeNativeSchemeMap, } from './nativeLinkingPlanning';
 export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';
 //# sourceMappingURL=planning.js.map

package/dist/planning.js.map

@@ -1 +1 @@
-{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAEL,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export {\n  type ExpoRuntimeConfigPluginOutput,\n  type ExpoRuntimeDependencyMap,\n  type ExpoRuntimeGeneratedAppOutputPlan,\n  type ExpoRuntimeNativeOutputPlan,\n  resolveExpoRuntimeConfigPluginOutput,\n  resolveExpoRuntimeDependencyMap,\n  resolveExpoRuntimeGeneratedAppOutput,\n  resolveExpoRuntimeNativeOutput,\n} from './generatedAppOutput';\nexport { getExpoBarcodeScannerViewSource } from './generatedSources';\nexport {\n  type ExpoRuntimeLayoutIntegrationPlan,\n  resolveExpoRuntimeLayoutIntegration,\n} from './layoutIntegrationPlanning';\nexport type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAEL,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export {\n  type ExpoRuntimeConfigPluginOutput,\n  type ExpoRuntimeDependencyMap,\n  type ExpoRuntimeGeneratedAppOutputPlan,\n  type ExpoRuntimeNativeOutputPlan,\n  resolveExpoRuntimeConfigPluginOutput,\n  resolveExpoRuntimeDependencyMap,\n  resolveExpoRuntimeGeneratedAppOutput,\n  resolveExpoRuntimeNativeOutput,\n} from './generatedAppOutput';\nexport { getExpoBarcodeScannerViewSource } from './generatedSources';\nexport {\n  type ExpoRuntimeLayoutIntegrationPlan,\n  resolveExpoRuntimeLayoutIntegration,\n} from './layoutIntegrationPlanning';\nexport {\n  type ExpoRuntimeNativePlatform,\n  type ExpoRuntimeNativeSchemeMap,\n  resolveExpoRuntimeNativeSchemeMap,\n} from './nativeLinkingPlanning';\nexport type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "2.2.1",
+  "version": "2.4.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": "^7.6.0",
+    "@ankhorage/contracts": "^7.8.0",
     "@ankhorage/permissions": "^0.2.1"
   },
   "files": [
@@ -48,6 +48,13 @@
       "import": "./dist/planning.js",
       "default": "./dist/planning.js"
     },
+    "./oauth-browser": {
+      "react-native": "./src/oauthBrowserTransport.ts",
+      "browser": "./src/oauthBrowserTransport.ts",
+      "types": "./src/oauthBrowserTransport.ts",
+      "import": "./dist/oauthBrowserTransport.js",
+      "default": "./dist/oauthBrowserTransport.js"
+    },
     "./media-picker": {
       "react-native": "./src/mediaPicker/index.ts",
       "browser": "./src/mediaPicker/index.ts",

package/src/nativeLinkingPlanning.test.ts

@@ -0,0 +1,77 @@
+import type { AppDeployTargets } from '@ankhorage/contracts/deploy';
+import { describe, expect, test } from 'bun:test';
+
+import { resolveExpoRuntimeNativeSchemeMap } from './nativeLinkingPlanning';
+
+const TARGET_CASES: readonly [string, AppDeployTargets, Readonly<Record<string, string>>][] = [
+  ['web', { web: { enabled: true } }, {}],
+  [
+    'android',
+    { android: { enabled: true, package: 'com.ankh.android', scheme: 'ankh-android' } },
+    { android: 'ankh-android' },
+  ],
+  [
+    'ios',
+    { ios: { enabled: true, bundleIdentifier: 'com.ankh.ios', scheme: 'ankh-ios' } },
+    { ios: 'ankh-ios' },
+  ],
+  [
+    'web + android',
+    {
+      web: { enabled: true },
+      android: { enabled: true, package: 'com.ankh.android', scheme: 'ankh-android' },
+    },
+    { android: 'ankh-android' },
+  ],
+  [
+    'web + ios',
+    {
+      web: { enabled: true },
+      ios: { enabled: true, bundleIdentifier: 'com.ankh.ios', scheme: 'ankh-ios' },
+    },
+    { ios: 'ankh-ios' },
+  ],
+  [
+    'android + ios',
+    {
+      android: { enabled: true, package: 'com.ankh.android', scheme: 'ankh-android' },
+      ios: { enabled: true, bundleIdentifier: 'com.ankh.ios', scheme: 'ankh-ios' },
+    },
+    { android: 'ankh-android', ios: 'ankh-ios' },
+  ],
+  [
+    'web + android + ios',
+    {
+      web: { enabled: true },
+      android: { enabled: true, package: 'com.ankh.android', scheme: 'ankh-android' },
+      ios: { enabled: true, bundleIdentifier: 'com.ankh.ios', scheme: 'ankh-ios' },
+    },
+    { android: 'ankh-android', ios: 'ankh-ios' },
+  ],
+];
+
+describe('resolveExpoRuntimeNativeSchemeMap', () => {
+  for (const [name, targets, expected] of TARGET_CASES) {
+    test(`derives only enabled native schemes for ${name}`, () => {
+      expect(resolveExpoRuntimeNativeSchemeMap(targets)).toEqual(expected);
+    });
+  }
+
+  test('does not guess schemes from native application identifiers', () => {
+    expect(
+      resolveExpoRuntimeNativeSchemeMap({
+        android: { enabled: true, package: 'com.ankh.android' },
+        ios: { enabled: true, bundleIdentifier: 'com.ankh.ios' },
+      }),
+    ).toEqual({});
+  });
+
+  test('omits disabled native targets even when they retain stable schemes', () => {
+    expect(
+      resolveExpoRuntimeNativeSchemeMap({
+        android: { enabled: false, package: 'com.ankh.android', scheme: 'ankh-android' },
+        ios: { enabled: false, bundleIdentifier: 'com.ankh.ios', scheme: 'ankh-ios' },
+      }),
+    ).toEqual({});
+  });
+});

package/src/nativeLinkingPlanning.ts

@@ -0,0 +1,22 @@
+import type { AppDeployTargets } from '@ankhorage/contracts/deploy';
+
+export type ExpoRuntimeNativePlatform = 'android' | 'ios';
+
+export type ExpoRuntimeNativeSchemeMap = Readonly<
+  Partial<Record<ExpoRuntimeNativePlatform, string>>
+>;
+
+export function resolveExpoRuntimeNativeSchemeMap(
+  targets: AppDeployTargets,
+): ExpoRuntimeNativeSchemeMap {
+  const schemes: Partial<Record<ExpoRuntimeNativePlatform, string>> = {};
+
+  if (targets.android?.enabled && targets.android.scheme !== undefined) {
+    schemes.android = targets.android.scheme;
+  }
+  if (targets.ios?.enabled && targets.ios.scheme !== undefined) {
+    schemes.ios = targets.ios.scheme;
+  }
+
+  return schemes;
+}

package/src/oauthBrowserTransport.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, test } from 'bun:test';
+
+import {
+  resolveExpoOAuthBrowserException,
+  resolveExpoOAuthBrowserResult,
+} from './oauthBrowserTransport';
+
+describe('Expo OAuth browser transport', () => {
+  test('maps a successful browser redirect to a callback response', () => {
+    expect(
+      resolveExpoOAuthBrowserResult({ type: 'success', url: 'ankh://auth/callback?code=abc' }),
+    ).toEqual({ type: 'callback', url: 'ankh://auth/callback?code=abc' });
+  });
+
+  test('maps user cancellation separately from browser dismissal', () => {
+    expect(resolveExpoOAuthBrowserResult({ type: 'cancel' })).toEqual({
+      type: 'cancelled',
+      reason: 'user_cancelled',
+    });
+    expect(resolveExpoOAuthBrowserResult({ type: 'dismiss' })).toEqual({
+      type: 'cancelled',
+      reason: 'browser_dismissed',
+    });
+  });
+
+  test.each(['locked', 'opened'])(
+    'maps %s to a transport failure instead of cancellation',
+    (type) => {
+      expect(resolveExpoOAuthBrowserResult({ type })).toEqual({
+        type: 'error',
+        error: {
+          code: 'transport_failed',
+          message: 'The Expo authentication browser did not complete the OAuth redirect.',
+        },
+      });
+    },
+  );
+
+  test('rejects malformed success and unknown results as transport failures', () => {
+    expect(resolveExpoOAuthBrowserResult({ type: 'success' })).toMatchObject({
+      type: 'error',
+      error: { code: 'transport_failed' },
+    });
+    expect(resolveExpoOAuthBrowserResult(null)).toMatchObject({
+      type: 'error',
+      error: { code: 'transport_failed' },
+    });
+  });
+
+  test('maps a rejected browser invocation to browser unavailable', () => {
+    expect(resolveExpoOAuthBrowserException()).toEqual({
+      type: 'error',
+      error: {
+        code: 'browser_unavailable',
+        message: 'The Expo authentication browser could not be opened.',
+      },
+    });
+  });
+});

package/src/oauthBrowserTransport.ts

@@ -0,0 +1,42 @@
+import type { AuthOAuthAuthorizationResponse } from '@ankhorage/contracts/auth';
+
+export function resolveExpoOAuthBrowserResult(result: unknown): AuthOAuthAuthorizationResponse {
+  if (!isRecord(result))
+    return transportFailed('The Expo authentication browser returned no result.');
+
+  const type = Reflect.get(result, 'type');
+  if (type === 'success') {
+    const url = Reflect.get(result, 'url');
+    return typeof url === 'string' && url.trim().length > 0
+      ? { type: 'callback', url }
+      : transportFailed('The Expo authentication browser returned no callback URL.');
+  }
+  if (type === 'cancel') {
+    return { type: 'cancelled', reason: 'user_cancelled' };
+  }
+  if (type === 'dismiss') {
+    return { type: 'cancelled', reason: 'browser_dismissed' };
+  }
+  return transportFailed('The Expo authentication browser did not complete the OAuth redirect.');
+}
+
+export function resolveExpoOAuthBrowserException(): AuthOAuthAuthorizationResponse {
+  return {
+    type: 'error',
+    error: {
+      code: 'browser_unavailable',
+      message: 'The Expo authentication browser could not be opened.',
+    },
+  };
+}
+
+function transportFailed(message: string): AuthOAuthAuthorizationResponse {
+  return {
+    type: 'error',
+    error: { code: 'transport_failed', message },
+  };
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/src/planning.ts

@@ -13,6 +13,11 @@ export {
   type ExpoRuntimeLayoutIntegrationPlan,
   resolveExpoRuntimeLayoutIntegration,
 } from './layoutIntegrationPlanning';
+export {
+  type ExpoRuntimeNativePlatform,
+  type ExpoRuntimeNativeSchemeMap,
+  resolveExpoRuntimeNativeSchemeMap,
+} from './nativeLinkingPlanning';
 export type {
   ExpoRuntimeAdapterId,
   ExpoRuntimePlan,