@ankhorage/expo-runtime 2.2.1 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/expo-runtime
 
+## 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/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.3.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": [

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/planning.ts

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