@ankhorage/studio 2.0.23 → 2.0.25

package/dist/host/deploy/ProjectDeployService.js

@@ -4,10 +4,12 @@ import { getProjectPath } from '../orchestrator/projectPaths';
 import { ProjectSecretService } from '../secrets/projectSecretService';
 import { createProjectDeployAccess } from './createProjectDeployAccess';
 import { ProjectDeployMutationGuard } from './ProjectDeployMutationGuard';
+/*** Adapt Studio project paths, secrets, and runtime credentials to the package-owned Deploy project APIs. */
 export class ProjectDeployService {
     workspaceRoot;
     secretStore;
     mutationGuard = new ProjectDeployMutationGuard();
+    /*** Construct the host Deploy adapter with an injected or default project secret store. */
     constructor(options) {
         this.workspaceRoot = options.workspaceRoot;
         this.secretStore =
@@ -17,30 +19,36 @@ export class ProjectDeployService {
                     workspaceRoot: options.workspaceRoot,
                 });
     }
+    /*** Read the persisted Deploy manifest for one generated project. */
     readConfig(projectId) {
         return readProjectDeploymentConfig({ projectRoot: this.projectRoot(projectId) });
     }
+    /*** Replace the persisted Deploy manifest for one generated project. */
     updateConfig(projectId, config) {
         return updateProjectDeploymentConfig({
             projectRoot: this.projectRoot(projectId),
             update: () => config,
         });
     }
+    /*** Read authored store-listing state for one generated project. */
     readListing(projectId) {
         return readProjectStoreListing({ projectRoot: this.projectRoot(projectId) });
     }
+    /*** Persist one localized store-listing record for a project. */
     writeListingLocale(projectId, locale) {
         return writeProjectStoreListingLocale({
             projectRoot: this.projectRoot(projectId),
             locale,
         });
     }
+    /*** Remove one localized store-listing record from a project. */
     removeListingLocale(projectId, locale) {
         return removeProjectStoreListingLocale({
             projectRoot: this.projectRoot(projectId),
             locale,
         });
     }
+    /*** Persist one binary store-listing asset at its Deploy-owned location. */
     writeListingAsset(projectId, location, data) {
         return writeProjectStoreListingAsset({
             projectRoot: this.projectRoot(projectId),
@@ -48,21 +56,25 @@ export class ProjectDeployService {
             data,
         });
     }
+    /*** Remove one authored store-listing asset from a project. */
     removeListingAsset(projectId, location) {
         return removeProjectStoreListingAsset({
             projectRoot: this.projectRoot(projectId),
             location,
         });
     }
+    /*** Read authored monetization products for one project. */
     readMonetization(projectId) {
         return readProjectMonetization({ projectRoot: this.projectRoot(projectId) });
     }
+    /*** Persist authored monetization products for one project. */
     writeMonetization(projectId, products) {
         return writeProjectMonetization({
             projectRoot: this.projectRoot(projectId),
             products,
         });
     }
+    /*** Inspect monetization state and pair the package-owned inspection with its derived execution plan. */
     async inspectMonetization(projectId, runtime) {
         const access = await this.createAccess(projectId, runtime);
         const result = await inspectProjectMonetization({
@@ -77,6 +89,7 @@ export class ProjectDeployService {
             plan: createProjectMonetizationPlan(result.inspection),
         };
     }
+    /*** Execute a monetization synchronization under the project's exclusive mutation reservation. */
     executeMonetization(input) {
         return this.mutationGuard.run(input.projectId, async () => {
             const access = await this.createAccess(input.projectId, input.runtime);
@@ -87,15 +100,18 @@ export class ProjectDeployService {
             });
         });
     }
+    /*** Read the authored release definition for one project. */
     readRelease(projectId) {
         return readProjectRelease({ projectRoot: this.projectRoot(projectId) });
     }
+    /*** Persist the authored release definition for one project. */
     writeRelease(projectId, release) {
         return writeProjectRelease({
             projectRoot: this.projectRoot(projectId),
             release,
         });
     }
+    /*** Inspect release readiness and augment the package-owned inspection with its plan and lifecycle controls. */
     async inspectRelease(projectId, runtime) {
         const access = await this.createAccess(projectId, runtime);
         const result = await inspectProjectRelease({
@@ -111,6 +127,7 @@ export class ProjectDeployService {
             lifecycleControls: result.inspection.observed.targets.flatMap(listReleaseLifecycleControls),
         };
     }
+    /*** Execute a release plan under the project's exclusive mutation reservation. */
     executeRelease(input) {
         return this.mutationGuard.run(input.projectId, async () => {
             const access = await this.createAccess(input.projectId, input.runtime);
@@ -122,6 +139,7 @@ export class ProjectDeployService {
             });
         });
     }
+    /*** Resume a prior release execution under the project's exclusive mutation reservation. */
     resumeRelease(input) {
         return this.mutationGuard.run(input.projectId, async () => {
             const access = await this.createAccess(input.projectId, input.runtime);
@@ -133,6 +151,7 @@ export class ProjectDeployService {
             });
         });
     }
+    /*** Execute one release lifecycle control under the project's exclusive mutation reservation. */
     executeReleaseControl(input) {
         return this.mutationGuard.run(input.projectId, async () => {
             const access = await this.createAccess(input.projectId, input.runtime);
@@ -143,6 +162,7 @@ export class ProjectDeployService {
             });
         });
     }
+    /*** List prior release executions and project each record with its resumability state. */
     async listReleaseHistory(projectId) {
         const records = await listProjectReleaseHistory({ projectRoot: this.projectRoot(projectId) });
         return records.map((record) => ({
@@ -150,9 +170,11 @@ export class ProjectDeployService {
             resumable: record.execution.steps.some(isReleaseStepResumable),
         }));
     }
+    /*** Resolve one Studio project id to its generated project root. */
     projectRoot(projectId) {
         return getProjectPath(this.workspaceRoot, projectId);
     }
+    /*** Build package-owned Deploy access from the project's runtime input and secret store. */
     createAccess(projectId, runtime) {
         return createProjectDeployAccess({
             projectId,

package/dist/host/deploy/ProjectDeployService.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectDeployService.js","sourceRoot":"","sources":["../../../src/host/deploy/ProjectDeployService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ProjectDeployService.js","sourceRoot":"","sources":["../../../src/host/deploy/ProjectDeployService.ts"],"names":[],"mappings":"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"}

package/dist/host/deploy/createProjectDeployAccess.d.ts

@@ -1,6 +1,7 @@
 import type { ProjectReleaseAccess } from '@ankhorage/deploy/project';
 import type { ProjectDeployRuntimeInput } from '../../projectDeployRuntimeInput';
 import type { ProjectDeploySecretStore } from './ProjectDeploySecretStore';
+/*** Build Deploy project access from project secrets and runtime-specific platform credentials. */
 export declare function createProjectDeployAccess(options: {
     readonly projectId: string;
     readonly runtime: ProjectDeployRuntimeInput;

package/dist/host/deploy/createProjectDeployAccess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createProjectDeployAccess.d.ts","sourceRoot":"","sources":["../../../src/host/deploy/createProjectDeployAccess.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhC"}
+{"version":3,"file":"createProjectDeployAccess.d.ts","sourceRoot":"","sources":["../../../src/host/deploy/createProjectDeployAccess.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,mGAAmG;AACnG,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhC"}

package/dist/host/deploy/createProjectDeployAccess.js

@@ -1,4 +1,5 @@
 import { serializeProjectDeploySecret } from './serializeProjectDeploySecret';
+/*** Build Deploy project access from project secrets and runtime-specific platform credentials. */
 export async function createProjectDeployAccess(options) {
     const listed = await options.secretStore.list({
         projectId: options.projectId,
@@ -17,11 +18,13 @@ export async function createProjectDeployAccess(options) {
         ...(options.runtime.web === undefined ? {} : { web: options.runtime.web }),
     };
 }
+/*** Map secret metadata carrying Deploy provider ownership into a Deploy credential reference. */
 function toCredentialReference(metadata) {
     return metadata.provider === undefined
         ? []
         : [{ id: metadata.ref, provider: metadata.provider, kind: metadata.kind }];
 }
+/*** Resolve an allow-listed Deploy credential only when the requested provider and kind still match metadata. */
 async function resolveAllowedSecret(options, allowed, reference) {
     const known = allowed.get(reference.id);
     if (known === undefined)

package/dist/host/deploy/createProjectDeployAccess.js.map

@@ -1 +1 @@
-{"version":3,"file":"createProjectDeployAccess.js","sourceRoot":"","sources":["../../../src/host/deploy/createProjectDeployAccess.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAI/C;IACC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;KACzC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtF,OAAO;QACL,WAAW;QACX,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1E,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAwB;IACrD,OAAO,QAAQ,CAAC,QAAQ,KAAK,SAAS;QACpC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,OAIC,EACD,OAA2D,EAC3D,SAAwC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAExF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;QACxC,GAAG,EAAE,SAAS,CAAC,EAAE;KAClB,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,4BAA4B,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"createProjectDeployAccess.js","sourceRoot":"","sources":["../../../src/host/deploy/createProjectDeployAccess.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAI/C;IACC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;KACzC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtF,OAAO;QACL,WAAW;QACX,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1E,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,SAAS,qBAAqB,CAAC,QAAwB;IACrD,OAAO,QAAQ,CAAC,QAAQ,KAAK,SAAS;QACpC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,iHAAiH;AACjH,KAAK,UAAU,oBAAoB,CACjC,OAIC,EACD,OAA2D,EAC3D,SAAwC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAExF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;QACxC,GAAG,EAAE,SAAS,CAAC,EAAE;KAClB,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,4BAA4B,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}

package/dist/host/deploy/serializeProjectDeploySecret.d.ts

@@ -1,4 +1,5 @@
 import type { SecretPayload } from '@ankhorage/contracts/secrets';
 import type { DeploymentCredentialReference } from '@ankhorage/deploy';
+/*** Serialize one Deploy credential payload using provider-specific token semantics when required. */
 export declare function serializeProjectDeploySecret(reference: DeploymentCredentialReference, payload: SecretPayload): string | null;
 //# sourceMappingURL=serializeProjectDeploySecret.d.ts.map

package/dist/host/deploy/serializeProjectDeploySecret.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializeProjectDeploySecret.d.ts","sourceRoot":"","sources":["../../../src/host/deploy/serializeProjectDeploySecret.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvE,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,6BAA6B,EACxC,OAAO,EAAE,aAAa,GACrB,MAAM,GAAG,IAAI,CAKf"}
+{"version":3,"file":"serializeProjectDeploySecret.d.ts","sourceRoot":"","sources":["../../../src/host/deploy/serializeProjectDeploySecret.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvE,sGAAsG;AACtG,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,6BAA6B,EACxC,OAAO,EAAE,aAAa,GACrB,MAAM,GAAG,IAAI,CAKf"}

package/dist/host/deploy/serializeProjectDeploySecret.js

@@ -1,9 +1,14 @@
+/*** Serialize one Deploy credential payload using provider-specific token semantics when required. */
 export function serializeProjectDeploySecret(reference, payload) {
     if (reference.provider === 'eas' && reference.kind === 'expo-token') {
         return nonEmpty(payload.token);
     }
     return JSON.stringify(payload);
 }
+/***
+ * Normalize an optional string to a trimmed non-empty value or null.
+ * @utility @ankhorage/utility/value
+ */
 function nonEmpty(value) {
     const normalized = value?.trim();
     return normalized === undefined || normalized.length === 0 ? null : normalized;

package/dist/host/deploy/serializeProjectDeploySecret.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializeProjectDeploySecret.js","sourceRoot":"","sources":["../../../src/host/deploy/serializeProjectDeploySecret.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,4BAA4B,CAC1C,SAAwC,EACxC,OAAsB;IAEtB,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACpE,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AACjF,CAAC"}
+{"version":3,"file":"serializeProjectDeploySecret.js","sourceRoot":"","sources":["../../../src/host/deploy/serializeProjectDeploySecret.ts"],"names":[],"mappings":"AAGA,sGAAsG;AACtG,MAAM,UAAU,4BAA4B,CAC1C,SAAwC,EACxC,OAAsB;IAEtB,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACpE,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,KAAyB;IACzC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AACjF,CAAC"}

package/dist/host/http/apiRoutes.d.ts

@@ -1,6 +1,10 @@
 import type { FastifyInstance } from 'fastify';
 import { StudioExternalApiService } from '../apis/studioExternalApiService';
 import type { ProjectManager } from '../orchestrator/projectManager';
+/***
+ * Register Studio external-API connect/manual/test HTTP adapters around the external API service.
+ * @todo Keep this Fastify adapter at the host edge while moving reusable parsing/response primitives to their shared owners.
+ */
 export declare function registerProjectApiRoutes(fastify: FastifyInstance, options: {
     readonly projectManager: ProjectManager;
     readonly workspaceRoot: string;

package/dist/host/http/apiRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/apiRoutes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAO7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACP,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CAC7C,GACA,IAAI,CA4BN"}
+{"version":3,"file":"apiRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/apiRoutes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAO7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACP,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CAC7C,GACA,IAAI,CA+BN"}

package/dist/host/http/apiRoutes.js

@@ -1,5 +1,9 @@
 import { StudioExternalApiService } from '../apis/studioExternalApiService';
 import { ProjectSecretService } from '../secrets/projectSecretService';
+/***
+ * Register Studio external-API connect/manual/test HTTP adapters around the external API service.
+ * @todo Keep this Fastify adapter at the host edge while moving reusable parsing/response primitives to their shared owners.
+ */
 export function registerProjectApiRoutes(fastify, options) {
     const service = options.service ??
         new StudioExternalApiService({
@@ -9,18 +13,21 @@ export function registerProjectApiRoutes(fastify, options) {
                 workspaceRoot: options.workspaceRoot,
             }),
         });
+    /*** Validate and execute an external API discovery/connect request. */
     fastify.post('/api/projects/:id/apis/connect', async (request, reply) => {
         const body = readConnectRequest(request.body);
         if (!body)
             return invalidPayload(reply, 'External API connection payload is invalid.');
         return sendResult(reply, await service.connect(readProjectId(request), body));
     });
+    /*** Validate and create a manually described REST API. */
     fastify.post('/api/projects/:id/apis/manual-rest', async (request, reply) => {
         const body = readManualRestRequest(request.body);
         if (!body)
             return invalidPayload(reply, 'Manual REST API payload is invalid.');
         return sendResult(reply, await service.createManualRest(readProjectId(request), body));
     });
+    /*** Validate and execute one authored external API operation test. */
     fastify.post('/api/projects/:id/apis/test', async (request, reply) => {
         const body = readOperationTestRequest(request.body);
         if (!body)
@@ -28,18 +35,28 @@ export function registerProjectApiRoutes(fastify, options) {
         return sendResult(reply, await service.testOperation(readProjectId(request), body));
     });
 }
+/***
+ * Read one named string route parameter from a Fastify request params object.
+ * @utility @ankhorage/utility/http/fastify
+ */
 function readProjectId(request) {
     return request.params.id;
 }
+/***
+ * Return a successful `{ok}` result directly or send failed results with a configurable semantic HTTP status.
+ * @utility @ankhorage/utility/http/fastify
+ */
 function sendResult(reply, result) {
     return result.ok ? result : reply.status(422).send(result);
 }
+/*** Build the external-API domain's canonical invalid-payload diagnostic response. */
 function invalidPayload(reply, message) {
     return reply.status(400).send({
         ok: false,
         diagnostics: [{ code: 'invalid-config', message, severity: 'error' }],
     });
 }
+/*** Parse an unknown connect payload into the external-API authoring contract. */
 function readConnectRequest(value) {
     const record = readRecord(value);
     const protocol = record?.protocol;
@@ -58,6 +75,7 @@ function readConnectRequest(value) {
         credential: readCredential(record.credential),
     };
 }
+/*** Parse an unknown manual REST payload into the external-API authoring contract. */
 function readManualRestRequest(value) {
     const record = readRecord(value);
     if (!record ||
@@ -83,6 +101,7 @@ function readManualRestRequest(value) {
         credential: readCredential(record.credential),
     };
 }
+/*** Parse an unknown operation-test payload into the external-API authoring contract. */
 function readOperationTestRequest(value) {
     const record = readRecord(value);
     if (!record ||
@@ -102,6 +121,7 @@ function readOperationTestRequest(value) {
         dryRun: record.dryRun === true,
     };
 }
+/*** Parse optional credential metadata from an unknown external-API payload. */
 function readCredential(value) {
     const record = readRecord(value);
     if (!record || typeof record.id !== 'string' || typeof record.kind !== 'string')
@@ -113,6 +133,10 @@ function readCredential(value) {
         scope: readString(record.scope),
     };
 }
+/***
+ * Parse an optional record whose values satisfy the shared DataContractValue contract.
+ * @todo Move this reusable data-contract parser beside `DataContractValue` in `@ankhorage/contracts/data` rather than Utility.
+ */
 function readDataValues(value) {
     if (value === undefined)
         return undefined;
@@ -121,6 +145,10 @@ function readDataValues(value) {
         return undefined;
     return record;
 }
+/***
+ * Recursively validate the shared DataContractValue union.
+ * @todo Move this reusable guard to `@ankhorage/contracts/data`; the same implementation already appears elsewhere in Studio.
+ */
 function isDataContractValue(value) {
     if (value === null || ['boolean', 'number', 'string'].includes(typeof value))
         return true;
@@ -129,6 +157,10 @@ function isDataContractValue(value) {
     const record = readRecord(value);
     return record !== null && Object.values(record).every(isDataContractValue);
 }
+/***
+ * Validate the DataOperationIntent literal union.
+ * @todo Move this guard beside `DataOperationIntent` in `@ankhorage/contracts/data`.
+ */
 function isIntent(value) {
     return (value === 'action' ||
         value === 'create' ||
@@ -136,11 +168,19 @@ function isIntent(value) {
         value === 'read' ||
         value === 'update');
 }
+/***
+ * Narrow an unknown non-array object to a string-keyed record.
+ * @utility @ankhorage/utility/object
+ */
 function readRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value)
         ? value
         : null;
 }
+/***
+ * Read a trimmed non-empty string from an unknown value.
+ * @utility @ankhorage/utility/string
+ */
 function readString(value) {
     return typeof value === 'string' && value.trim() ? value.trim() : undefined;
 }

package/dist/host/http/apiRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiRoutes.js","sourceRoot":"","sources":["../../../src/host/http/apiRoutes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apiRoutes.js","sourceRoot":"","sources":["../../../src/host/http/apiRoutes.ts"],"names":[],"mappings":"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"}

package/dist/host/http/authRoutes.d.ts

@@ -1,5 +1,6 @@
 import type { FastifyInstance } from 'fastify';
 import type { ProjectManager } from '../orchestrator/projectManager';
+/*** Register the Studio project-auth health HTTP adapter and compose its secret-store-backed service when available. */
 export declare function registerProjectAuthRoutes(fastify: FastifyInstance, options: {
     readonly projectManager: ProjectManager;
     readonly workspaceRoot?: string;

package/dist/host/http/authRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/authRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAM7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF,IAAI,CA+BN"}
+{"version":3,"file":"authRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/authRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAM7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,wHAAwH;AACxH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF,IAAI,CAgCN"}

package/dist/host/http/authRoutes.js

@@ -1,5 +1,6 @@
 import { ProjectAuthHealthService, } from '../auth/projectAuthHealthService';
 import { ProjectSecretService } from '../secrets/projectSecretService';
+/*** Register the Studio project-auth health HTTP adapter and compose its secret-store-backed service when available. */
 export function registerProjectAuthRoutes(fastify, options) {
     const healthService = options.workspaceRoot === undefined
         ? null
@@ -11,6 +12,7 @@ export function registerProjectAuthRoutes(fastify, options) {
                 workspaceRoot: options.workspaceRoot,
             }),
         });
+    /*** Resolve project auth health or return service-unavailable when the host secret-store bridge is absent. */
     fastify.get('/api/projects/:id/auth/health', async (request, reply) => {
         const { id } = request.params;
         const query = request.query;
@@ -26,6 +28,10 @@ export function registerProjectAuthRoutes(fastify, options) {
         return sendProjectAuthHealthResult(reply, await healthService.get({ projectId: id, environment: query.environment }));
     });
 }
+/***
+ * Return a successful `{ok}` result directly or send a failed result with a configured server-error status.
+ * @utility @ankhorage/utility/http/fastify
+ */
 function sendProjectAuthHealthResult(reply, result) {
     if (result.ok)
         return result;

package/dist/host/http/authRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"authRoutes.js","sourceRoot":"","sources":["../../../src/host/http/authRoutes.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,UAAU,yBAAyB,CACvC,OAAwB,EACxB,OAAqF;IAErF,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,wBAAwB,CAAC;YAC3B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,aAAa,EAAE,IAAI,oBAAoB,CAAC;gBACtC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC;SACH,CAAC,CAAC;IAET,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,OAAuB,EAAE,KAAK,EAAE,EAAE;QACpF,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAiC,CAAC;QACxD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC5B,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,2DAA2D;iBACrE;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,2BAA2B,CAChC,KAAK,EACL,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAC3E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAmB,EAAE,MAA+B;IACvF,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAE7B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"authRoutes.js","sourceRoot":"","sources":["../../../src/host/http/authRoutes.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,wHAAwH;AACxH,MAAM,UAAU,yBAAyB,CACvC,OAAwB,EACxB,OAAqF;IAErF,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,wBAAwB,CAAC;YAC3B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,aAAa,EAAE,IAAI,oBAAoB,CAAC;gBACtC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC;SACH,CAAC,CAAC;IAET,8GAA8G;IAC9G,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,OAAuB,EAAE,KAAK,EAAE,EAAE;QACpF,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAiC,CAAC;QACxD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC5B,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,2DAA2D;iBACrE;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,2BAA2B,CAChC,KAAK,EACL,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAC3E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,2BAA2B,CAAC,KAAmB,EAAE,MAA+B;IACvF,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAE7B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/host/http/deployRoutes.d.ts

@@ -1,6 +1,7 @@
 import type { FastifyInstance } from 'fastify';
 import { ProjectDeployService } from '../deploy/ProjectDeployService';
 import type { ProjectManager } from '../orchestrator/projectManager';
+/*** Register all Studio deployment config, listing, monetization and release HTTP adapters around ProjectDeployService. */
 export declare function registerProjectDeployRoutes(fastify: FastifyInstance, args: {
     readonly projectManager: ProjectManager;
     readonly workspaceRoot: string;

package/dist/host/http/deployRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/deployRoutes.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE;IACJ,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC,GACA,IAAI,CAaN"}
+{"version":3,"file":"deployRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/deployRoutes.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,2HAA2H;AAC3H,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE;IACJ,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC,GACA,IAAI,CAaN"}

package/dist/host/http/deployRoutes.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { ProjectDeployService } from '../deploy/ProjectDeployService';
 const MAX_STORE_ASSET_BYTES = 25 * 1024 * 1024;
+/*** Register all Studio deployment config, listing, monetization and release HTTP adapters around ProjectDeployService. */
 export function registerProjectDeployRoutes(fastify, args) {
     ensureBinaryBodyParser(fastify);
     const service = args.service ??
@@ -13,10 +14,12 @@ export function registerProjectDeployRoutes(fastify, args) {
     registerMonetizationRoutes(fastify, service);
     registerReleaseRoutes(fastify, service);
 }
+/*** Register deployment-config read/write routes. */
 function registerConfigRoutes(fastify, service) {
     fastify.get('/api/projects/:id/deploy/config', async (req, reply) => respond(reply, () => service.readConfig(projectId(req))));
     fastify.put('/api/projects/:id/deploy/config', async (req, reply) => respond(reply, () => service.updateConfig(projectId(req), req.body)));
 }
+/*** Register store-listing locale and asset routes. */
 function registerListingRoutes(fastify, service) {
     fastify.get('/api/projects/:id/deploy/listing', async (req, reply) => respond(reply, () => service.readListing(projectId(req))));
     fastify.put('/api/projects/:id/deploy/listing/locale', async (req, reply) => respond(reply, () => service.writeListingLocale(projectId(req), req.body)));
@@ -27,8 +30,11 @@ function registerListingRoutes(fastify, service) {
     registerListingAssetWrite(fastify, service);
     fastify.delete('/api/projects/:id/deploy/listing/asset', async (req, reply) => respond(reply, () => service.removeListingAsset(projectId(req), readAssetLocation(req.query))));
 }
+/*** Register bounded binary store-listing asset writes. */
 function registerListingAssetWrite(fastify, service) {
-    fastify.put('/api/projects/:id/deploy/listing/asset', { bodyLimit: MAX_STORE_ASSET_BYTES }, async (req, reply) => {
+    fastify.put('/api/projects/:id/deploy/listing/asset', { bodyLimit: MAX_STORE_ASSET_BYTES }, 
+    /*** Validate binary listing bytes and write them to the requested canonical asset location. */
+    async (req, reply) => {
         const { body } = req;
         if (!Buffer.isBuffer(body)) {
             return reply.status(400).send({ error: 'Store listing asset bytes required.' });
@@ -36,6 +42,7 @@ function registerListingAssetWrite(fastify, service) {
         return respond(reply, () => service.writeListingAsset(projectId(req), readAssetLocation(req.query), Uint8Array.from(body)));
     });
 }
+/*** Register deployment monetization read/write/inspect/execute routes. */
 function registerMonetizationRoutes(fastify, service) {
     fastify.get('/api/projects/:id/deploy/monetization', async (req, reply) => respond(reply, () => service.readMonetization(projectId(req))));
     fastify.put('/api/projects/:id/deploy/monetization', async (req, reply) => respond(reply, () => {
@@ -45,6 +52,7 @@ function registerMonetizationRoutes(fastify, service) {
     fastify.post('/api/projects/:id/deploy/monetization/inspect', async (req, reply) => respond(reply, () => service.inspectMonetization(projectId(req), req.body)));
     fastify.post('/api/projects/:id/deploy/monetization/execute', async (req, reply) => respond(reply, () => executeMonetizationRequest(service, req)));
 }
+/*** Project one monetization execute HTTP body into the ProjectDeployService operation input. */
 function executeMonetizationRequest(service, req) {
     const body = req.body;
     return service.executeMonetization({
@@ -54,6 +62,7 @@ function executeMonetizationRequest(service, req) {
         plan: body.plan,
     });
 }
+/*** Register release desired-state, inspection, mutation and history routes. */
 function registerReleaseRoutes(fastify, service) {
     fastify.get('/api/projects/:id/deploy/release', async (req, reply) => respond(reply, () => service.readRelease(projectId(req))));
     fastify.put('/api/projects/:id/deploy/release', async (req, reply) => respond(reply, () => service.writeRelease(projectId(req), req.body)));
@@ -61,11 +70,13 @@ function registerReleaseRoutes(fastify, service) {
     registerReleaseMutationRoutes(fastify, service);
     fastify.get('/api/projects/:id/deploy/release/history', async (req, reply) => respond(reply, () => service.listReleaseHistory(projectId(req))));
 }
+/*** Register release execute/resume/control mutation routes. */
 function registerReleaseMutationRoutes(fastify, service) {
     fastify.post('/api/projects/:id/deploy/release/execute', async (req, reply) => respond(reply, () => executeReleaseRequest(service, req)));
     fastify.post('/api/projects/:id/deploy/release/resume', async (req, reply) => respond(reply, () => resumeReleaseRequest(service, req)));
     fastify.post('/api/projects/:id/deploy/release/control', async (req, reply) => respond(reply, () => executeReleaseControlRequest(service, req)));
 }
+/*** Start a new release execution with a fresh UUID and return both execution id and service result. */
 async function executeReleaseRequest(service, req) {
     const body = req.body;
     const executionId = randomUUID();
@@ -78,6 +89,7 @@ async function executeReleaseRequest(service, req) {
     });
     return { executionId, result };
 }
+/*** Resume a prior release under a fresh execution UUID and return both execution id and result. */
 async function resumeReleaseRequest(service, req) {
     const body = req.body;
     const executionId = randomUUID();
@@ -89,6 +101,7 @@ async function resumeReleaseRequest(service, req) {
     });
     return { executionId, result };
 }
+/*** Project one release-control HTTP body into the ProjectDeployService control operation. */
 function executeReleaseControlRequest(service, req) {
     const body = req.body;
     return service.executeReleaseControl({
@@ -97,11 +110,18 @@ function executeReleaseControlRequest(service, req) {
         control: body.control,
     });
 }
+/***
+ * Ensure a Fastify instance has an octet-stream Buffer body parser.
+ * @utility @ankhorage/utility/http/fastify
+ */
 function ensureBinaryBodyParser(fastify) {
     if (fastify.hasContentTypeParser('application/octet-stream'))
         return;
-    fastify.addContentTypeParser('application/octet-stream', { parseAs: 'buffer' }, (_req, body, done) => done(null, body));
+    fastify.addContentTypeParser('application/octet-stream', { parseAs: 'buffer' }, 
+    /*** Pass the parsed binary body through unchanged. */
+    (_req, body, done) => done(null, body));
 }
+/*** Parse a deploy store-listing asset location from HTTP query data. */
 function readAssetLocation(value) {
     const query = value;
     if (query.kind === 'android-shared') {
@@ -125,9 +145,17 @@ function readAssetLocation(value) {
         filename: query.filename,
     };
 }
+/***
+ * Read the canonical `id` route parameter from a Fastify request.
+ * @utility @ankhorage/utility/http/fastify
+ */
 function projectId(req) {
     return req.params.id;
 }
+/***
+ * Execute an async Fastify route operation and map thrown failures to a configured HTTP error response.
+ * @utility @ankhorage/utility/http/fastify
+ */
 async function respond(reply, operation) {
     try {
         return await operation();
@@ -136,6 +164,10 @@ async function respond(reply, operation) {
         return reply.status(400).send({ error: readErrorMessage(error) });
     }
 }
+/***
+ * Convert an unknown thrown value to a human-readable message.
+ * @utility @ankhorage/utility/error
+ */
 function readErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }