@ankhorage/contracts 19.1.0 → 19.2.0

package/dist/types/deployRelease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployRelease.js","sourceRoot":"","sources":["../../src/types/deployRelease.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DeploymentCredentialReference,\n  DeploymentProviderResult,\n  DeploymentSecretResolver,\n  DeploymentStoreIdentity,\n} from './deployProvider';\n\nexport type ReleaseTarget = 'web' | 'android' | 'ios';\nexport type ReleaseRolloutMode = 'immediate' | 'staged';\n\nexport interface ReleaseNote {\n  readonly locale: string;\n  readonly text: string;\n}\n\nexport interface ReleaseTargetRollout {\n  readonly mode: ReleaseRolloutMode;\n  readonly initialFraction?: string;\n}\n\nexport interface ReleaseRollout {\n  readonly web?: ReleaseTargetRollout;\n  readonly android?: ReleaseTargetRollout;\n  readonly ios?: ReleaseTargetRollout;\n}\n\nexport interface ReleaseDesiredState {\n  readonly version: string;\n  readonly targets: readonly ReleaseTarget[];\n  readonly notes: readonly ReleaseNote[];\n  readonly rollout: ReleaseRollout;\n  readonly revision: string;\n}\n\nexport interface ReleaseObservedWebState {\n  readonly target: 'web';\n  readonly version: string | null;\n  readonly artifactRevision: string | null;\n}\n\nexport interface ReleaseObservedAndroidState {\n  readonly target: 'android';\n  readonly version: string | null;\n  readonly artifactRevision: string | null;\n  readonly versionCodes: readonly string[];\n  readonly releaseNotes: readonly ReleaseNote[];\n  readonly rolloutStatus: 'missing' | 'draft' | 'inProgress' | 'halted' | 'completed';\n  readonly userFraction?: string;\n}\n\nexport interface ReleaseObservedIosState {\n  readonly target: 'ios';\n  readonly version: string | null;\n  readonly artifactRevision: string | null;\n  readonly buildNumber: string | null;\n  readonly releaseNotes: readonly ReleaseNote[];\n  readonly appVersionState?: string;\n  readonly releaseType?: string;\n  readonly reviewState?: string;\n  readonly phasedReleaseState: 'INACTIVE' | 'ACTIVE' | 'PAUSED' | 'COMPLETE' | null;\n}\n\nexport type ReleaseObservedTargetState =\n  ReleaseObservedWebState | ReleaseObservedAndroidState | ReleaseObservedIosState;\n\nexport interface ReleaseObservedState {\n  readonly targets: readonly ReleaseObservedTargetState[];\n}\n\nexport type ReleasePlanStatus = 'no-change' | 'changes' | 'waiting' | 'blocked';\nexport type ReleaseStepRetry = 'safe' | 'reinspect' | 'never';\nexport type ReleaseStepOperation =\n  | 'prepare'\n  | 'build'\n  | 'publish'\n  | 'sync-notes'\n  | 'submit-review'\n  | 'release'\n  | 'rollout'\n  | 'verify'\n  | 'record';\n\nexport interface ReleaseDiagnostic {\n  readonly severity: 'warning' | 'error';\n  readonly code: string;\n  readonly message: string;\n  readonly target?: ReleaseTarget | 'release';\n}\n\nexport interface ReleasePlanStep {\n  readonly id: string;\n  readonly target: ReleaseTarget | 'release';\n  readonly operation: ReleaseStepOperation;\n  readonly dependsOn: readonly string[];\n  readonly retry: ReleaseStepRetry;\n  readonly irreversible: boolean;\n}\n\nexport interface ReleasePlan {\n  readonly status: ReleasePlanStatus;\n  readonly desiredRevision: string;\n  readonly currentRevision: string;\n  readonly steps: readonly ReleasePlanStep[];\n  readonly diagnostics: readonly ReleaseDiagnostic[];\n}\n\nexport type ReleaseLifecycleControl =\n  | { readonly target: 'android'; readonly action: 'halt' | 'resume' }\n  | {\n      readonly target: 'ios';\n      readonly action: 'pause-phased' | 'resume-phased' | 'cancel-phased' | 'cancel-review';\n    };\n\nexport type ReleaseMutationResult =\n  | { readonly status: 'completed' }\n  | { readonly status: 'blocked'; readonly code: string }\n  | { readonly status: 'failed'; readonly code: string };\n\nexport type ReleaseControlExecutionResult =\n  | { readonly status: 'completed'; readonly mutationAttempted: boolean }\n  | { readonly status: 'blocked'; readonly mutationAttempted: false; readonly code: string }\n  | { readonly status: 'failed'; readonly mutationAttempted: boolean; readonly code: string };\n\nexport interface ReleaseAdapterContext {\n  readonly identity: DeploymentStoreIdentity;\n  readonly credentials: readonly DeploymentCredentialReference[];\n  readonly resolveSecret: DeploymentSecretResolver;\n}\n\nexport interface ReleaseInspectionRequest extends ReleaseAdapterContext {\n  readonly version: string;\n}\n\nexport interface ReleaseStepExecutionRequest extends ReleaseAdapterContext {\n  readonly desired: ReleaseDesiredState;\n  readonly step: ReleasePlanStep;\n}\n\nexport interface ReleaseControlRequest extends ReleaseAdapterContext {\n  readonly desired: ReleaseDesiredState;\n  readonly control: ReleaseLifecycleControl;\n}\n\nexport type ReleaseObservedNativeState = ReleaseObservedAndroidState | ReleaseObservedIosState;\n\nexport interface DeploymentReleaseAdapter {\n  readonly target: 'android' | 'ios';\n  inspectAsync(\n    request: ReleaseInspectionRequest,\n  ): Promise<DeploymentProviderResult<ReleaseObservedNativeState>>;\n  executeStepAsync(request: ReleaseStepExecutionRequest): Promise<ReleaseMutationResult>;\n  controlAsync(request: ReleaseControlRequest): Promise<ReleaseControlExecutionResult>;\n}\n"]}

package/dist/types/deployStoreListing.d.ts

@@ -0,0 +1,91 @@
+import type { DeploymentCredentialReference, DeploymentProviderResult, DeploymentSecretResolver, DeploymentStoreIdentity } from './deployProvider';
+export type StoreListingTarget = 'android' | 'ios';
+export type StoreListingField = 'name' | 'summary' | 'description' | 'keywords' | 'promotionalText' | 'supportUrl' | 'marketingUrl' | 'privacyPolicyUrl' | 'promoVideoUrl';
+export interface StoreListingLocale {
+    readonly locale: string;
+    readonly name: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly keywords?: readonly string[];
+    readonly promotionalText?: string;
+    readonly supportUrl?: string;
+    readonly marketingUrl?: string;
+    readonly privacyPolicyUrl?: string;
+    readonly promoVideoUrl?: string;
+}
+export type StoreListingAssetMediaType = 'image/jpeg' | 'image/png';
+export interface StoreListingAsset {
+    readonly relativePath: string;
+    readonly sha256: string;
+    readonly md5: string;
+    readonly size: number;
+    readonly mediaType: StoreListingAssetMediaType;
+}
+export interface StoreListingAssetSet {
+    readonly target: StoreListingTarget;
+    readonly locale: string;
+    readonly variant: string;
+    readonly assets: readonly StoreListingAsset[];
+}
+export interface StoreListingRemoteAssetSet {
+    readonly target: StoreListingTarget;
+    readonly locale: string;
+    readonly variant: string;
+    readonly checksum: 'md5' | 'sha256';
+    readonly hashes: readonly string[];
+}
+export interface StoreListingDesiredState {
+    readonly revision: string;
+    readonly locales: readonly StoreListingLocale[];
+    readonly assetSets: readonly StoreListingAssetSet[];
+}
+export interface StoreListingDiagnostic {
+    readonly severity: 'warning' | 'error';
+    readonly code: string;
+    readonly message: string;
+    readonly target?: StoreListingTarget;
+    readonly locale?: string;
+    readonly field?: StoreListingField;
+    readonly variant?: string;
+}
+export interface StoreListingTargetState {
+    readonly target: StoreListingTarget;
+    readonly locales: readonly StoreListingLocale[];
+    readonly assetSets: readonly StoreListingRemoteAssetSet[];
+    readonly supportedFields: readonly StoreListingField[];
+    readonly diagnostics: readonly StoreListingDiagnostic[];
+}
+export type StoreListingPlanOperation = 'create-locale' | 'update-locale' | 'replace-assets';
+export interface StoreListingPlanStep {
+    readonly id: string;
+    readonly target: StoreListingTarget;
+    readonly operation: StoreListingPlanOperation;
+    readonly locale: string;
+    readonly variant?: string;
+}
+export interface StoreListingPlan {
+    readonly status: 'no-change' | 'changes' | 'blocked';
+    readonly desiredRevision: string;
+    readonly currentRevision: string;
+    readonly steps: readonly StoreListingPlanStep[];
+    readonly diagnostics: readonly StoreListingDiagnostic[];
+}
+export interface StoreListingAssetReader {
+    readAsync(relativePath: string): Promise<Uint8Array>;
+}
+export interface StoreListingAdapterContext {
+    readonly identity: DeploymentStoreIdentity;
+    readonly credentials: readonly DeploymentCredentialReference[];
+    readonly resolveSecret: DeploymentSecretResolver;
+}
+export interface StoreListingSyncRequest extends StoreListingAdapterContext {
+    readonly desired: StoreListingDesiredState;
+    readonly plan: StoreListingPlan;
+    readonly assets: StoreListingAssetReader;
+}
+export interface DeploymentStoreListingAdapter {
+    readonly target: StoreListingTarget;
+    inspectAsync(context: StoreListingAdapterContext): Promise<DeploymentProviderResult<StoreListingTargetState>>;
+    syncAsync(request: StoreListingSyncRequest): Promise<DeploymentProviderResult<StoreListingTargetState>>;
+}
+//# sourceMappingURL=deployStoreListing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployStoreListing.d.ts","sourceRoot":"","sources":["../../src/types/deployStoreListing.ts"],"names":[],"mappings":"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"}

package/dist/types/deployStoreListing.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deployStoreListing.js.map

package/dist/types/deployStoreListing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployStoreListing.js","sourceRoot":"","sources":["../../src/types/deployStoreListing.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DeploymentCredentialReference,\n  DeploymentProviderResult,\n  DeploymentSecretResolver,\n  DeploymentStoreIdentity,\n} from './deployProvider';\n\nexport type StoreListingTarget = 'android' | 'ios';\n\nexport type StoreListingField =\n  | 'name'\n  | 'summary'\n  | 'description'\n  | 'keywords'\n  | 'promotionalText'\n  | 'supportUrl'\n  | 'marketingUrl'\n  | 'privacyPolicyUrl'\n  | 'promoVideoUrl';\n\nexport interface StoreListingLocale {\n  readonly locale: string;\n  readonly name: string;\n  readonly summary?: string;\n  readonly description?: string;\n  readonly keywords?: readonly string[];\n  readonly promotionalText?: string;\n  readonly supportUrl?: string;\n  readonly marketingUrl?: string;\n  readonly privacyPolicyUrl?: string;\n  readonly promoVideoUrl?: string;\n}\n\nexport type StoreListingAssetMediaType = 'image/jpeg' | 'image/png';\n\nexport interface StoreListingAsset {\n  readonly relativePath: string;\n  readonly sha256: string;\n  readonly md5: string;\n  readonly size: number;\n  readonly mediaType: StoreListingAssetMediaType;\n}\n\nexport interface StoreListingAssetSet {\n  readonly target: StoreListingTarget;\n  readonly locale: string;\n  readonly variant: string;\n  readonly assets: readonly StoreListingAsset[];\n}\n\nexport interface StoreListingRemoteAssetSet {\n  readonly target: StoreListingTarget;\n  readonly locale: string;\n  readonly variant: string;\n  readonly checksum: 'md5' | 'sha256';\n  readonly hashes: readonly string[];\n}\n\nexport interface StoreListingDesiredState {\n  readonly revision: string;\n  readonly locales: readonly StoreListingLocale[];\n  readonly assetSets: readonly StoreListingAssetSet[];\n}\n\nexport interface StoreListingDiagnostic {\n  readonly severity: 'warning' | 'error';\n  readonly code: string;\n  readonly message: string;\n  readonly target?: StoreListingTarget;\n  readonly locale?: string;\n  readonly field?: StoreListingField;\n  readonly variant?: string;\n}\n\nexport interface StoreListingTargetState {\n  readonly target: StoreListingTarget;\n  readonly locales: readonly StoreListingLocale[];\n  readonly assetSets: readonly StoreListingRemoteAssetSet[];\n  readonly supportedFields: readonly StoreListingField[];\n  readonly diagnostics: readonly StoreListingDiagnostic[];\n}\n\nexport type StoreListingPlanOperation = 'create-locale' | 'update-locale' | 'replace-assets';\n\nexport interface StoreListingPlanStep {\n  readonly id: string;\n  readonly target: StoreListingTarget;\n  readonly operation: StoreListingPlanOperation;\n  readonly locale: string;\n  readonly variant?: string;\n}\n\nexport interface StoreListingPlan {\n  readonly status: 'no-change' | 'changes' | 'blocked';\n  readonly desiredRevision: string;\n  readonly currentRevision: string;\n  readonly steps: readonly StoreListingPlanStep[];\n  readonly diagnostics: readonly StoreListingDiagnostic[];\n}\n\nexport interface StoreListingAssetReader {\n  readAsync(relativePath: string): Promise<Uint8Array>;\n}\n\nexport interface StoreListingAdapterContext {\n  readonly identity: DeploymentStoreIdentity;\n  readonly credentials: readonly DeploymentCredentialReference[];\n  readonly resolveSecret: DeploymentSecretResolver;\n}\n\nexport interface StoreListingSyncRequest extends StoreListingAdapterContext {\n  readonly desired: StoreListingDesiredState;\n  readonly plan: StoreListingPlan;\n  readonly assets: StoreListingAssetReader;\n}\n\nexport interface DeploymentStoreListingAdapter {\n  readonly target: StoreListingTarget;\n  inspectAsync(\n    context: StoreListingAdapterContext,\n  ): Promise<DeploymentProviderResult<StoreListingTargetState>>;\n  syncAsync(\n    request: StoreListingSyncRequest,\n  ): Promise<DeploymentProviderResult<StoreListingTargetState>>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "19.1.0",
+  "version": "19.2.0",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
@@ -58,6 +58,10 @@
       "types": "./dist/deploy.d.ts",
       "default": "./dist/deploy.js"
     },
+    "./deploy-provider": {
+      "types": "./dist/deployProvider.d.ts",
+      "default": "./dist/deployProvider.js"
+    },
     "./runtime": {
       "types": "./dist/runtimeCallbacks.d.ts",
       "default": "./dist/runtimeCallbacks.js"

package/src/deployProvider.test.ts

@@ -0,0 +1,82 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+import { describe, expect, it } from 'bun:test';
+
+import {
+  DEPLOYMENT_PROVIDER_CAPABILITY_IDS,
+  type DeploymentProviderRegistration,
+} from './deployProvider';
+
+const fakeProvider: DeploymentProviderRegistration = {
+  descriptor: {
+    id: 'fake',
+    packageName: '@ankhorage/deploy-provider-fake',
+    displayName: 'Fake provider',
+    capabilities: [{ id: 'web-publish', targets: ['web'] }],
+  },
+  webPublisher: {
+    publishAsync: (request) =>
+      Promise.resolve({
+        status: 'completed',
+        value: {
+          target: 'web',
+          revision: request.revision,
+          provider: 'fake',
+          deploymentId: 'fake-deployment',
+          url: 'https://example.test',
+          production: request.intent.mode === 'production',
+        },
+      }),
+  },
+};
+
+describe('deployment provider contracts', () => {
+  it('defines the portable provider capability vocabulary', () => {
+    expect(DEPLOYMENT_PROVIDER_CAPABILITY_IDS).toEqual([
+      'setup',
+      'web-publish',
+      'android-build',
+      'android-publish',
+      'ios-build',
+      'ios-publish',
+      'store-listing',
+      'monetization',
+      'release',
+    ]);
+  });
+
+  it('supports an external provider registration without Deploy implementation types', async () => {
+    const result = await fakeProvider.webPublisher?.publishAsync({
+      projectRoot: '/project',
+      exportDirectory: '/tmp/export',
+      revision: 'revision-1',
+      intent: { mode: 'production' },
+      credentials: [],
+      resolveSecret: () => Promise.resolve(null),
+    });
+
+    expect(result).toEqual({
+      status: 'completed',
+      value: {
+        target: 'web',
+        revision: 'revision-1',
+        provider: 'fake',
+        deploymentId: 'fake-deployment',
+        url: 'https://example.test',
+        production: true,
+      },
+    });
+  });
+
+  it('publishes the focused deployment provider contract subpath', async () => {
+    const packageJson = JSON.parse(await readFile(join(process.cwd(), 'package.json'), 'utf8')) as {
+      exports?: Record<string, { default?: string; types?: string }>;
+    };
+
+    expect(packageJson.exports?.['./deploy-provider']).toEqual({
+      types: './dist/deployProvider.d.ts',
+      default: './dist/deployProvider.js',
+    });
+  });
+});

package/src/deployProvider.ts

@@ -0,0 +1,4 @@
+export * from './types/deployMonetization';
+export * from './types/deployProvider';
+export * from './types/deployRelease';
+export * from './types/deployStoreListing';

package/src/index.ts

@@ -5,6 +5,7 @@ export * from './cli';
 export * from './data';
 export * from './db';
 export * from './deploy';
+export * from './deployProvider';
 export * from './environments';
 export * from './infra';
 export * from './media';

package/src/types/deployMonetization.ts

@@ -0,0 +1,106 @@
+import type {
+  DeploymentCredentialReference,
+  DeploymentProviderResult,
+  DeploymentSecretResolver,
+  DeploymentStoreIdentity,
+} from './deployProvider';
+
+export type MonetizationProductKind = 'consumable' | 'non-consumable' | 'subscription';
+
+export interface MonetizationLocalization {
+  readonly locale: string;
+  readonly name: string;
+  readonly description: string;
+}
+
+export interface MonetizationBasePrice {
+  readonly country: string;
+  readonly currency: string;
+  readonly amount: string;
+}
+
+export type MonetizationSubscriptionPeriod = 'P1W' | 'P1M' | 'P2M' | 'P3M' | 'P6M' | 'P1Y';
+
+export interface MonetizationSubscription {
+  readonly family: string;
+  readonly period: MonetizationSubscriptionPeriod;
+  readonly level?: number;
+}
+
+export interface MonetizationProduct {
+  readonly id: string;
+  readonly kind: MonetizationProductKind;
+  readonly localizations: readonly MonetizationLocalization[];
+  readonly basePrice: MonetizationBasePrice;
+  readonly subscription?: MonetizationSubscription;
+}
+
+export interface MonetizationObservedProduct {
+  readonly id: string;
+  readonly kind: MonetizationProductKind | 'one-time';
+  readonly localizations: readonly MonetizationLocalization[];
+  readonly basePrice?: MonetizationBasePrice;
+  readonly subscription?: MonetizationSubscription;
+}
+
+export interface MonetizationDesiredState {
+  readonly revision: string;
+  readonly products: readonly MonetizationProduct[];
+}
+
+export interface MonetizationDiagnostic {
+  readonly severity: 'warning' | 'error';
+  readonly code: string;
+  readonly message: string;
+  readonly target?: 'android' | 'ios';
+  readonly productId?: string;
+  readonly locale?: string;
+}
+
+export interface MonetizationTargetState {
+  readonly target: 'android' | 'ios';
+  readonly products: readonly MonetizationObservedProduct[];
+  readonly subscriptionFamilies: readonly string[];
+  readonly diagnostics: readonly MonetizationDiagnostic[];
+}
+
+export interface MonetizationPlanStep {
+  readonly id: string;
+  readonly target: 'android' | 'ios';
+  readonly productId: string;
+  readonly operation:
+    | 'ensure-subscription-family'
+    | 'create-product'
+    | 'update-metadata'
+    | 'update-price'
+    | 'update-subscription';
+}
+
+export interface MonetizationPlan {
+  readonly status: 'no-change' | 'changes' | 'blocked';
+  readonly desiredRevision: string;
+  readonly currentRevision: string;
+  readonly steps: readonly MonetizationPlanStep[];
+  readonly diagnostics: readonly MonetizationDiagnostic[];
+}
+
+export interface MonetizationAdapterContext {
+  readonly identity: DeploymentStoreIdentity;
+  readonly credentials: readonly DeploymentCredentialReference[];
+  readonly resolveSecret: DeploymentSecretResolver;
+}
+
+export interface MonetizationSyncRequest extends MonetizationAdapterContext {
+  readonly desired: MonetizationDesiredState;
+  readonly plan: MonetizationPlan;
+}
+
+export interface DeploymentMonetizationAdapter {
+  readonly target: 'android' | 'ios';
+  inspectAsync(
+    context: MonetizationAdapterContext,
+  ): Promise<DeploymentProviderResult<MonetizationTargetState>>;
+  syncAsync(
+    request: MonetizationSyncRequest,
+  ): Promise<DeploymentProviderResult<MonetizationTargetState>>;
+}