@ankhorage/contracts 26.2.1 → 26.2.2

package/src/infraPackedConsumer.test.ts

@@ -0,0 +1,102 @@
+import { mkdirSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+import { describe, expect, it } from 'bun:test';
+
+const packageRoot = process.cwd();
+const temporaryCacheDirectory = join(tmpdir(), 'contracts-infra-consumer-cache');
+
+const runCommand = (command: string[], cwd: string): string => {
+  const result = Bun.spawnSync(command, {
+    cwd,
+    env: {
+      ...process.env,
+      BUN_INSTALL_CACHE_DIR: temporaryCacheDirectory,
+      npm_config_cache: temporaryCacheDirectory,
+    },
+  });
+  const output = `${result.stdout.toString()}${result.stderr.toString()}`;
+
+  expect(result.exitCode, output).toBe(0);
+  return output;
+};
+
+const writeConsumerFiles = (consumerDirectory: string): void => {
+  writeFileSync(
+    join(consumerDirectory, 'consumer.mjs'),
+    [
+      "import { INFRA_ADAPTER_CATALOG, isInfraAdapterDescriptor } from '@ankhorage/contracts/infra';",
+      'const descriptor = INFRA_ADAPTER_CATALOG.hetzner;',
+      "if (!isInfraAdapterDescriptor(descriptor) || descriptor.package !== '@ankhorage/infra-hetzner') {",
+      "  throw new Error('published infra contract is unavailable');",
+      '}',
+    ].join('\n'),
+  );
+  writeFileSync(
+    join(consumerDirectory, 'consumer.ts'),
+    [
+      "import { INFRA_ADAPTER_CATALOG, isInfraAdapterDescriptor } from '@ankhorage/contracts/infra';",
+      'const descriptor = INFRA_ADAPTER_CATALOG.hetzner;',
+      'const isCanonicalDescriptor: boolean = isInfraAdapterDescriptor(descriptor);',
+      'void isCanonicalDescriptor;',
+    ].join('\n'),
+  );
+};
+
+const packAndInstall = (consumerDirectory: string, packedDirectory: string): void => {
+  runCommand(['bun', 'run', 'build'], packageRoot);
+  runCommand(
+    ['npm', 'pack', '--ignore-scripts', '--pack-destination', packedDirectory],
+    packageRoot,
+  );
+
+  const archiveName = readdirSync(packedDirectory).find((entry) => entry.endsWith('.tgz'));
+  expect(archiveName).toBeDefined();
+  runCommand(
+    ['bun', 'add', '--ignore-scripts', join(packedDirectory, archiveName ?? 'missing.tgz')],
+    consumerDirectory,
+  );
+};
+
+const verifyConsumer = (consumerDirectory: string): void => {
+  runCommand(['node', 'consumer.mjs'], consumerDirectory);
+  runCommand(['bun', 'consumer.mjs'], consumerDirectory);
+  runCommand(
+    [
+      join(packageRoot, 'node_modules/.bin/tsc'),
+      '--noEmit',
+      '--module',
+      'NodeNext',
+      '--moduleResolution',
+      'NodeNext',
+      '--target',
+      'ES2022',
+      '--skipLibCheck',
+      'consumer.ts',
+    ],
+    consumerDirectory,
+  );
+};
+
+describe('packed infra consumer', () => {
+  it('supports native Node ESM, Bun, and public declarations', () => {
+    const temporaryDirectory = mkdtempSync(join(tmpdir(), 'contracts-infra-consumer-'));
+    const consumerDirectory = join(temporaryDirectory, 'package');
+    const packedDirectory = join(temporaryDirectory, 'packed');
+
+    try {
+      mkdirSync(consumerDirectory);
+      mkdirSync(packedDirectory);
+      writeFileSync(
+        join(consumerDirectory, 'package.json'),
+        JSON.stringify({ name: 'contracts-infra-consumer', private: true, type: 'module' }),
+      );
+      writeConsumerFiles(consumerDirectory);
+      packAndInstall(consumerDirectory, packedDirectory);
+      verifyConsumer(consumerDirectory);
+    } finally {
+      rmSync(temporaryDirectory, { force: true, recursive: true });
+    }
+  });
+});

package/src/media.ts

@@ -1,7 +1,7 @@
 import { isRecord } from '@ankhorage/utility/object';
 import { isNonEmptyString } from '@ankhorage/utility/string';
 
-import type { EntityRegistry } from './collections';
+import type { EntityRegistry } from './collections.js';
 
 export const MEDIA_ASSET_KINDS = ['image', 'audio', 'video', 'font', 'file'] as const;
 

package/src/navigator/catalog.ts

@@ -4,14 +4,14 @@ import type {
   NavigatorPreset,
   NavigatorType,
   StackPresentation,
-} from '../navigator';
-import type { NavigatorDependencyRequirement } from './generation';
+} from '../navigator.js';
+import type { NavigatorDependencyRequirement } from './generation.js';
 import type {
   NavigatorApiStability,
   NavigatorCapabilityId,
   NavigatorRuntimePlatform,
   NavigatorSupportStatus,
-} from './planning';
+} from './planning.js';
 
 export type NavigatorVerificationKind =
   | 'structural'

package/src/navigator/extensions.ts

@@ -1,5 +1,5 @@
-import type { CustomNavigatorNode } from '../navigator';
-import type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning';
+import type { CustomNavigatorNode } from '../navigator.js';
+import type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning.js';
 export interface CustomNavigatorConfigIssue {
   code: string;
   message: string;

package/src/navigator/generation.ts

@@ -3,7 +3,7 @@ import type {
   NavigatorDiagnostic,
   NavigatorPlan,
   NavigatorSupportStatus,
-} from './planning';
+} from './planning.js';
 
 export interface NavigatorGeneratedFile {
   path: string;

package/src/navigator/planning.ts

@@ -5,9 +5,9 @@ import type {
   RouteDefinition,
   StackImplementation,
   StackScreenOptions,
-} from '../navigator';
-import type { CustomNavigatorRegistry } from './extensions';
-import type { NavigatorDependencyRequirement } from './generation';
+} from '../navigator.js';
+import type { CustomNavigatorRegistry } from './extensions.js';
+import type { NavigatorDependencyRequirement } from './generation.js';
 
 export interface ResolvedHeadlessTabsPresentation {
   presentation: ResolvedTabsPresentation;

package/src/navigator.ts

@@ -1,7 +1,7 @@
-import type { ValueMap } from './collections';
-import type { IconSpec, ManifestValue } from './types';
+import type { ValueMap } from './collections.js';
+import type { IconSpec, ManifestValue } from './types.js';
 
-export { isAppNavigatorManifest } from './appManifest/navigator';
+export { isAppNavigatorManifest } from './appManifest/navigator.js';
 
 export const NAVIGATOR_TYPES = ['slot', 'stack', 'tabs', 'drawer', 'split-view', 'custom'] as const;
 export type NavigatorType = (typeof NAVIGATOR_TYPES)[number];
@@ -288,12 +288,12 @@ export type {
   NavigatorPresetDescriptor,
   NavigatorVerificationKind,
   NavigatorVerificationStatus,
-} from './navigator/catalog';
+} from './navigator/catalog.js';
 export type {
   CustomNavigatorConfigIssue,
   CustomNavigatorRegistration,
   CustomNavigatorRegistry,
-} from './navigator/extensions';
+} from './navigator/extensions.js';
 export type {
   NavigatorDependencyRequirement,
   NavigatorGeneratedFile,
@@ -301,7 +301,7 @@ export type {
   NavigatorGenerationOptions,
   NavigatorGenerationResult,
   NavigatorScreenModule,
-} from './navigator/generation';
+} from './navigator/generation.js';
 export type {
   CreateNavigatorPlanOptions,
   ExpoRouterNavigatorModule,
@@ -321,4 +321,4 @@ export type {
   ResolvedTabsImplementation,
   ResolvedTabsPresentation,
   TabsNavigatorPlan,
-} from './navigator/planning';
+} from './navigator/planning.js';

package/src/requirements.ts

@@ -1,4 +1,4 @@
-import type { SerializableSet } from './collections';
+import type { SerializableSet } from './collections.js';
 
 export const ANKHORAGE_PERMISSION_NAMES = [
   'camera',

package/src/runtimeCallbacks.ts

@@ -1,4 +1,4 @@
-import type { UiNode } from './types';
+import type { UiNode } from './types.js';
 
 export interface RuntimeResolveNodePropsArgs {
   readonly node: UiNode;

package/src/state.ts

@@ -1,4 +1,4 @@
-import type { SerializableValue } from './serializable';
+import type { SerializableValue } from './serializable.js';
 
 /** Legend currently implements in-memory state only; unsupported persistence cannot be selected. */
 export interface AppStateSpec {

package/src/structure/generated.ts

@@ -2,12 +2,12 @@
 import type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';
 
 export const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';
-export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:40a6d82fcd341a4ff88936d61be4a5fa36e88a9425e71fc31b04219efee79a48';
+export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:572919c21c8b8eae4e4fda0e464fbb6e64c448425b737be1de7f4a203d709a4a';
 
 export const STRUCTURE_DESCRIPTOR = {
   "protocolVersion": 1,
   "packageName": "@ankhorage/contracts",
-  "packageVersion": "26.2.1",
+  "packageVersion": "26.2.2",
   "roots": {
     "auth-flow": "AuthFlowConfig",
     "auth-profile": "AuthProfileSpec",

package/src/structure/index.ts

@@ -1,4 +1,4 @@
-export type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
+export type { EntityRegistry, SerializableSet, ValueMap } from '../collections.js';
 export {
   STRUCTURE_DESCRIPTOR,
   STRUCTURE_DESCRIPTOR_COMPILER_VERSION,

package/src/structure/isStructureDescriptor.ts

@@ -1,7 +1,7 @@
 import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
 import { isNonEmptyString } from '@ankhorage/utility/string';
 
-import type { StructureDescriptor, StructureLiteralValue, StructureScalarType } from './types';
+import type { StructureDescriptor, StructureLiteralValue, StructureScalarType } from './types.js';
 
 /*** Validate one standalone structural descriptor without resolving external/local references. */
 export function isStructureDescriptor(value: unknown): value is StructureDescriptor {

package/src/structure/types.ts

@@ -1,4 +1,4 @@
-import type { EntityRegistry, ValueMap } from '../collections';
+import type { EntityRegistry, ValueMap } from '../collections.js';
 
 export type StructureDescriptorId = string;
 

package/src/theme.ts

@@ -1,4 +1,4 @@
-import type { ValueMap } from './collections';
+import type { ValueMap } from './collections.js';
 
 /** Numeric token values authored at theme level. */
 export type ThemeNumericTokenOverrides = ValueMap<string, number>;

package/src/types/appManifest.ts

@@ -1,4 +1,4 @@
-import type { AppManifest } from '../types';
+import type { AppManifest } from '../types.js';
 
 export type AppManifestParseResult =
   | { readonly ok: true; readonly manifest: AppManifest }

package/src/types/infraAdapters.ts

@@ -1,5 +1,5 @@
-import type { AppEnvironmentId } from '../environments';
-import type { INFRA_ADAPTER_CATALOG } from '../infraCatalog';
+import type { AppEnvironmentId } from '../environments.js';
+import type { INFRA_ADAPTER_CATALOG } from '../infraCatalog.js';
 import type {
   InfraDestroyRequest,
   InfraGeneratedArtifact,
@@ -9,7 +9,7 @@ import type {
   InfraPlanAction,
   InfraResourceStatus,
   InfraResult,
-} from './infraLifecycle';
+} from './infraLifecycle.js';
 import type {
   InfraAdapterId,
   InfraComputeProviderId,
@@ -17,10 +17,10 @@ import type {
   InfraEnvironmentSpec,
   InfraRuntimeProviderId,
   InfraRuntimeSelection,
-} from './infraManifest';
-import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';
-import type { InfraComputeTarget } from './infraTargets';
-import type { InfraWorkloadSpec } from './infraWorkload';
+} from './infraManifest.js';
+import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets.js';
+import type { InfraComputeTarget } from './infraTargets.js';
+import type { InfraWorkloadSpec } from './infraWorkload.js';
 
 /** Package exports must match this exact catalog entry; optional operations are advertised explicitly. */
 export type InfraAdapterDescriptor<P extends InfraAdapterId = InfraAdapterId> = {

package/src/types/infraLifecycle.ts

@@ -1,7 +1,7 @@
-import type { AppEnvironmentId } from '../environments';
-import type { InfraAdapterId } from './infraManifest';
-import type { InfraSecretReference } from './infraSecrets';
-import type { InfraComputeTarget } from './infraTargets';
+import type { AppEnvironmentId } from '../environments.js';
+import type { InfraAdapterId } from './infraManifest.js';
+import type { InfraSecretReference } from './infraSecrets.js';
+import type { InfraComputeTarget } from './infraTargets.js';
 
 /** Identity must be verified before mutation; unowned resources must never be pruned. */
 export interface InfraResourceIdentity {

package/src/types/infraManifest.ts

@@ -1,11 +1,11 @@
-import type { AuthFlowConfig, AuthOAuthConfig } from '../auth';
-import type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
-import type { ApiDefinitionRegistry, DataContractValue } from '../data';
-import type { AppEnvironmentId } from '../environments';
-import type { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from '../infraCatalog';
-import type { AuthProfileSpec, AuthScope, AuthSignInSpec, AuthSignUpSpec } from '../types';
-import type { InfraControlPlaneCredentialRef } from './infraSecrets';
-import type { InfraWorkloadRegistry } from './infraWorkload';
+import type { AuthFlowConfig, AuthOAuthConfig } from '../auth.js';
+import type { EntityRegistry, SerializableSet, ValueMap } from '../collections.js';
+import type { ApiDefinitionRegistry, DataContractValue } from '../data/index.js';
+import type { AppEnvironmentId } from '../environments.js';
+import type { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from '../infraCatalog.js';
+import type { AuthProfileSpec, AuthScope, AuthSignInSpec, AuthSignUpSpec } from '../types.js';
+import type { InfraControlPlaneCredentialRef } from './infraSecrets.js';
+import type { InfraWorkloadRegistry } from './infraWorkload.js';
 
 export type InfraAdapterId = keyof typeof INFRA_ADAPTER_CATALOG;
 export type InfraCapability =

package/src/types/infraSecrets.ts

@@ -1,4 +1,4 @@
-import type { AppEnvironmentId } from '../environments';
+import type { AppEnvironmentId } from '../environments.js';
 
 /** Bootstrap credentials cannot depend on the managed secret store being provisioned. */
 export interface InfraControlPlaneCredentialRef {

package/src/types/infraTargets.ts

@@ -1,4 +1,4 @@
-import type { InfraControlPlaneCredentialRef } from './infraSecrets';
+import type { InfraControlPlaneCredentialRef } from './infraSecrets.js';
 
 /** Portable runtime target state contains credential identity only, never resolved values. */
 export type InfraComputeTarget = {

package/src/types/infraWorkload.ts

@@ -1,5 +1,5 @@
-import type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
-import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';
+import type { EntityRegistry, SerializableSet, ValueMap } from '../collections.js';
+import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets.js';
 
 export interface InfraWorkloadArtifact {
   readonly kind: 'image';

package/src/types.ts

@@ -1,22 +1,22 @@
 import type { ColorHarmony } from '@ankhorage/color-theory';
 
-import type { AuthIdentifierKind, AuthSignUpField } from './auth';
+import type { AuthIdentifierKind, AuthSignUpField } from './auth.js';
 import type {
   BindingExpression,
   ComponentDataBindingRegistry,
   ScreenDataLoaderDefinition,
-} from './bindings';
-import type { EntityRegistry } from './collections';
-import type { DataSourceRegistry } from './data';
-import type { AppDeployManifest } from './deploy';
-import type { InfraManifest } from './infra';
-import type { MediaAssetReference, MediaManifest } from './media';
-import type { AppNavigatorManifest } from './navigator';
-import type { RepositoryManifest } from './repository';
-import type { ScreenRequirements } from './requirements';
-import type { SerializableValue } from './serializable';
-import type { AppStateSpec } from './state';
-import type { ThemeGlobalTokenOverrides, ThemeRecipeOverrides } from './theme';
+} from './bindings.js';
+import type { EntityRegistry } from './collections.js';
+import type { DataSourceRegistry } from './data/index.js';
+import type { AppDeployManifest } from './deploy.js';
+import type { InfraManifest } from './infra.js';
+import type { MediaAssetReference, MediaManifest } from './media.js';
+import type { AppNavigatorManifest } from './navigator.js';
+import type { RepositoryManifest } from './repository.js';
+import type { ScreenRequirements } from './requirements.js';
+import type { SerializableValue } from './serializable.js';
+import type { AppStateSpec } from './state.js';
+import type { ThemeGlobalTokenOverrides, ThemeRecipeOverrides } from './theme.js';
 
 export interface ThemeModeConfig {
   primaryColor: string;

package/src/ui.ts

@@ -1,5 +1,5 @@
-import type { MediaAssetKind } from './media';
-import type { ComponentEventDtoKind } from './types';
+import type { MediaAssetKind } from './media.js';
+import type { ComponentEventDtoKind } from './types.js';
 
 export type UiComponentCategory = 'component' | 'foundation' | 'layout' | 'pattern';