@mpgd/cli 0.63.0 → 0.65.0

package/dist/app-store-iap-asc.d.ts

@@ -1,20 +1,11 @@
 import type { AscIapPort } from './app-store-iap-port.js';
+import { type AscCommandRunner, type AscCredential } from './asc-session.js';
+export type { AscCommandRunner, AscCredential } from './asc-session.js';
 /**
-* The in-app purchase port on the pinned `asc` 5.5.0 CLI, with the same
-* binary pin, isolated environment and API key as the TestFlight
-* submission. Each method is one `asc ... --output json` command; the JSON
-* is App Store Connect's own resource document, which `asc` prints as it
-* received it (`internal/asc/types/resources.go` at the 5.5.0 tag).
+* The in-app purchase port on the pinned `asc` 5.5.0 CLI (`asc-session.ts`).
+* Each method is one `asc ... --output json` command.
 */
-/** Runs one asc command with `--output json` appended and returns the parsed JSON. */
-export type AscCommandRunner = (args: readonly string[], timeoutMs: number) => Promise<unknown>;
-export interface AscCredential {
-  readonly ascBinary: string;
-  readonly apiKeyId: string;
-  readonly apiIssuerId: string;
-  readonly apiPrivateKeyBase64: string;
-}
-/** Copy and verify the pinned binary into a private directory; `close` removes it. */
+/** Copy and verify the pinned binary; `close` removes it. */
 export declare function openAscIapSession(credential: AscCredential, signal?: AbortSignal): Promise<{
   readonly port: AscIapPort;
   close(): void;

package/dist/app-store-iap-asc.js

@@ -1,58 +1,14 @@
-import { chmodSync, copyFileSync, mkdtempSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { ReleaseProcessError, runReleaseProcess } from './deploy-process.js';
+import { ascExitNotFound, isEmptyResource, isRecord, list, ascListTimeoutMs as listTimeoutMs, ascLookupTimeoutMs as lookupTimeoutMs, openAscSession, optionalString, relationshipId, requiredString, single, ascUploadTimeoutMs as uploadTimeoutMs, } from './asc-session.js';
+import { ReleaseProcessError } from './deploy-process.js';
 import { sameDecimal } from './store-products.js';
-import { isolatedAscEnvironment, verifyPinnedAscBinary } from './testflight-submission.js';
-const lookupTimeoutMs = 60_000;
-const listTimeoutMs = 3 * 60_000;
-const uploadTimeoutMs = 10 * 60_000;
-const maxJsonBytes = 8 * 1024 * 1024;
-/** asc exit code for an App Store Connect 404 (`cmd/exit_codes.go`, 5.5.0). */
-const ascExitNotFound = 4;
-/** Copy and verify the pinned binary into a private directory; `close` removes it. */
+/**
+ * The in-app purchase port on the pinned `asc` 5.5.0 CLI (`asc-session.ts`).
+ * Each method is one `asc ... --output json` command.
+ */
+/** Copy and verify the pinned binary; `close` removes it. */
 export async function openAscIapSession(credential, signal) {
-    if (!path.isAbsolute(credential.ascBinary)) {
-        throw new Error('asc binary must be an absolute file path.');
-    }
-    const tempRoot = mkdtempSync(path.join(tmpdir(), 'mpgd-asc-iap-'));
-    try {
-        const binary = path.join(tempRoot, 'asc');
-        copyFileSync(credential.ascBinary, binary);
-        chmodSync(binary, 0o700);
-        await verifyPinnedAscBinary(binary);
-        const environment = isolatedAscEnvironment(credential, tempRoot);
-        const run = async (args, timeoutMs) => {
-            const result = await runReleaseProcess({
-                command: binary,
-                args: [...args, '--output', 'json'],
-                cwd: tempRoot,
-                environment,
-                timeoutMs,
-                maxOutputBytes: maxJsonBytes,
-                captureMachineStdout: true,
-                secretValues: [credential.apiKeyId, credential.apiIssuerId, credential.apiPrivateKeyBase64],
-                signal,
-            });
-            if (result.truncated || result.machineStdout === undefined) {
-                throw new Error('asc JSON output was truncated or unavailable.');
-            }
-            try {
-                return JSON.parse(result.machineStdout);
-            }
-            catch {
-                throw new Error('asc returned invalid JSON.');
-            }
-        };
-        return {
-            port: createAscIapPort(run),
-            close: () => rmSync(tempRoot, { recursive: true, force: true }),
-        };
-    }
-    catch (error) {
-        rmSync(tempRoot, { recursive: true, force: true });
-        throw error;
-    }
+    const session = await openAscSession(credential, signal);
+    return { port: createAscIapPort(session.run), close: () => session.close() };
 }
 /** The port over any runner; the tests drive it with recorded asc output. */
 export function createAscIapPort(run, today = () => new Date().toISOString().slice(0, 10)) {
@@ -261,66 +217,3 @@ export function createAscIapPort(run, today = () => new Date().toISOString().sli
         },
     };
 }
-function single(value, command) {
-    const resource = isRecord(value) ? toResource(value.data) : undefined;
-    if (resource === undefined) {
-        throw new Error(`asc ${command} returned no resource.`);
-    }
-    return resource;
-}
-function list(value, command) {
-    const resources = isRecord(value) && Array.isArray(value.data)
-        ? value.data.map(toResource)
-        : undefined;
-    if (resources === undefined || resources.some((resource) => resource === undefined)) {
-        throw new Error(`asc ${command} returned no resource list.`);
-    }
-    return resources;
-}
-function toResource(value) {
-    if (!isRecord(value) || typeof value.id !== 'string' || value.id === '') {
-        return undefined;
-    }
-    return {
-        id: value.id,
-        attributes: isRecord(value.attributes) ? value.attributes : {},
-        ...(value.relationships === undefined ? {} : { relationships: value.relationships }),
-    };
-}
-/**
- * App Store Connect's `data: null`, or asc's rendering of it: asc 5.5.0
- * decodes into a non-pointer resource and prints `{ "type": "", "id": "" }`.
- */
-function isEmptyResource(value) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    return value.data === null
-        || (isRecord(value.data) && (value.data.id === undefined || value.data.id === ''));
-}
-function relationshipId(relationships, name) {
-    if (!isRecord(relationships)) {
-        return undefined;
-    }
-    const relationship = relationships[name];
-    if (!isRecord(relationship) || !isRecord(relationship.data)) {
-        return undefined;
-    }
-    return typeof relationship.data.id === 'string' ? relationship.data.id : undefined;
-}
-function requiredString(value, label) {
-    if (typeof value !== 'string') {
-        throw new Error(`asc output has no ${label}.`);
-    }
-    return value;
-}
-function optionalString(key, value) {
-    const result = {};
-    if (typeof value === 'string' && value !== '') {
-        result[key] = value;
-    }
-    return result;
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}

package/dist/app-store-presence-asc.d.ts

@@ -0,0 +1,23 @@
+import type { AscStorePresencePort } from './app-store-presence-port.js';
+import { type AscCommandRunner, type AscCredential } from './asc-session.js';
+/**
+* The store page port on the pinned `asc` 5.5.0 CLI. Commands (5.5.0 source,
+* `internal/cli/...`):
+*
+* - `apps view`, `apps info list` (`apps/app_infos.go`)
+* - `localizations list --type app-info` and `--version` (`localizations/localizations.go`)
+* - `app-setup info set` (`apps/app_setup.go`): creates or updates one app
+*   information localization
+* - `versions list` (`versions/versions.go`)
+* - `localizations create` and `localizations update --id` (`localizations/create.go`, `update.go`)
+* - `screenshots list|upload|delete` (`assets/assets_screenshots*.go`): an
+*   upload of one file appends it to the set and waits for the asset
+*   delivery to reach `COMPLETE`, failing on `FAILED`
+*/
+/** Copy and verify the pinned binary; `close` removes it. */
+export declare function openAscStorePresenceSession(credential: AscCredential, signal?: AbortSignal): Promise<{
+  readonly port: AscStorePresencePort;
+  close(): void;
+}>;
+/** The port over any runner; the tests drive it with recorded asc output. */
+export declare function createAscStorePresencePort(run: AscCommandRunner): AscStorePresencePort;

package/dist/app-store-presence-asc.js

@@ -0,0 +1,162 @@
+import { ascListTimeoutMs, ascLookupTimeoutMs, ascUploadTimeoutMs, isRecord, list, openAscSession, optionalString, requiredString, single, } from './asc-session.js';
+/**
+ * The store page port on the pinned `asc` 5.5.0 CLI. Commands (5.5.0 source,
+ * `internal/cli/...`):
+ *
+ * - `apps view`, `apps info list` (`apps/app_infos.go`)
+ * - `localizations list --type app-info` and `--version` (`localizations/localizations.go`)
+ * - `app-setup info set` (`apps/app_setup.go`): creates or updates one app
+ *   information localization
+ * - `versions list` (`versions/versions.go`)
+ * - `localizations create` and `localizations update --id` (`localizations/create.go`, `update.go`)
+ * - `screenshots list|upload|delete` (`assets/assets_screenshots*.go`): an
+ *   upload of one file appends it to the set and waits for the asset
+ *   delivery to reach `COMPLETE`, failing on `FAILED`
+ */
+/** Copy and verify the pinned binary; `close` removes it. */
+export async function openAscStorePresenceSession(credential, signal) {
+    const session = await openAscSession(credential, signal);
+    return { port: createAscStorePresencePort(session.run), close: () => session.close() };
+}
+/** The port over any runner; the tests drive it with recorded asc output. */
+export function createAscStorePresencePort(run) {
+    return {
+        async readAppBundleId(appId) {
+            const app = single(await run(['apps', 'view', '--id', appId], ascLookupTimeoutMs), 'apps view');
+            const bundleId = app.attributes.bundleId;
+            if (app.id !== appId || typeof bundleId !== 'string') {
+                throw new Error('asc apps view returned no bundle ID for the app.');
+            }
+            return bundleId;
+        },
+        async listAppInfos(appId) {
+            return list(await run(['apps', 'info', 'list', '--app', appId], ascLookupTimeoutMs), 'apps info list')
+                .map((resource) => ({
+                id: resource.id,
+                ...optionalString('state', resource.attributes.state ?? resource.attributes.appStoreState),
+            }));
+        },
+        async listAppInfoLocalizations(appId, appInfoId) {
+            return list(await run([
+                'localizations', 'list',
+                '--type', 'app-info',
+                '--app', appId,
+                '--app-info', appInfoId,
+                '--paginate',
+            ], ascListTimeoutMs), 'localizations list --type app-info').map((resource) => ({
+                id: resource.id,
+                locale: requiredString(resource.attributes.locale, 'app info localization locale'),
+                ...optionalString('name', resource.attributes.name),
+                ...optionalString('subtitle', resource.attributes.subtitle),
+                ...optionalString('privacyPolicyUrl', resource.attributes.privacyPolicyUrl),
+            }));
+        },
+        async listVersions(appId) {
+            return list(await run(['versions', 'list', '--app', appId, '--platform', 'IOS', '--paginate'], ascListTimeoutMs), 'versions list').map((resource) => ({
+                id: resource.id,
+                ...optionalString('versionString', resource.attributes.versionString),
+                ...optionalString('state', resource.attributes.appVersionState ?? resource.attributes.appStoreState),
+                ...optionalString('appStoreState', resource.attributes.appStoreState),
+                ...optionalString('createdDate', resource.attributes.createdDate),
+            }));
+        },
+        async listVersionLocalizations(versionId) {
+            return list(await run(['localizations', 'list', '--version', versionId, '--paginate'], ascListTimeoutMs), 'localizations list').map((resource) => ({
+                id: resource.id,
+                locale: requiredString(resource.attributes.locale, 'version localization locale'),
+                ...versionFields(resource),
+            }));
+        },
+        async listScreenshotSets(versionLocalizationId) {
+            const result = await run(['screenshots', 'list', '--version-localization', versionLocalizationId], ascListTimeoutMs);
+            if (!isRecord(result) || !Array.isArray(result.sets)) {
+                throw new Error('asc screenshots list returned no screenshot sets.');
+            }
+            return result.sets.map((entry) => {
+                const set = isRecord(entry) ? single({ data: entry.set }, 'screenshots list set') : undefined;
+                const screenshots = isRecord(entry) ? list({ data: entry.screenshots }, 'screenshots list') : undefined;
+                if (set === undefined || screenshots === undefined) {
+                    throw new Error('asc screenshots list returned a malformed set.');
+                }
+                return {
+                    id: set.id,
+                    displayType: requiredString(set.attributes.screenshotDisplayType, 'screenshot display type'),
+                    screenshots: screenshots.map(toScreenshot),
+                };
+            });
+        },
+        async upsertAppInfoLocalization(input) {
+            await run([
+                'app-setup', 'info', 'set',
+                '--app', input.appId,
+                '--app-info', input.appInfoId,
+                '--locale', input.locale,
+                '--name', input.name,
+                ...(input.subtitle === undefined ? [] : ['--subtitle', input.subtitle]),
+                ...(input.privacyPolicyUrl === undefined ? [] : ['--privacy-policy-url', input.privacyPolicyUrl]),
+            ], ascLookupTimeoutMs);
+        },
+        async createVersionLocalization(input) {
+            return single(await run([
+                'localizations', 'create',
+                '--version', input.versionId,
+                '--locale', input.locale,
+                ...fieldFlags(input.fields),
+            ], ascLookupTimeoutMs), 'localizations create').id;
+        },
+        async updateVersionLocalization(input) {
+            const flags = fieldFlags(input.fields);
+            if (flags.length === 0) {
+                return;
+            }
+            await run(['localizations', 'update', '--id', input.localizationId, ...flags], ascLookupTimeoutMs);
+        },
+        async uploadScreenshot(input) {
+            const result = await run([
+                'screenshots', 'upload',
+                '--version-localization', input.versionLocalizationId,
+                '--path', input.file,
+                '--device-type', input.displayType,
+            ], ascUploadTimeoutMs);
+            const results = isRecord(result) && Array.isArray(result.results) ? result.results : [];
+            const [item] = results;
+            if (results.length !== 1 || !isRecord(item) || typeof item.assetId !== 'string' || item.assetId === '') {
+                throw new Error('asc screenshots upload returned no uploaded screenshot.');
+            }
+            const state = typeof item.state === 'string' ? item.state.toUpperCase() : '';
+            if (state !== 'COMPLETE') {
+                throw new Error(`App Store Connect reports screenshot ${item.assetId} as ${state || 'not delivered'}.`);
+            }
+            return { id: item.assetId, deliveryState: state };
+        },
+        async deleteScreenshot(screenshotId) {
+            await run(['screenshots', 'delete', '--id', screenshotId, '--confirm'], ascLookupTimeoutMs);
+        },
+    };
+}
+const fieldNames = [
+    ['description', '--description'],
+    ['keywords', '--keywords'],
+    ['promotionalText', '--promotional-text'],
+    ['whatsNew', '--whats-new'],
+    ['supportUrl', '--support-url'],
+    ['marketingUrl', '--marketing-url'],
+];
+function fieldFlags(fields) {
+    return fieldNames.flatMap(([field, flag]) => {
+        const value = fields[field];
+        return value === undefined ? [] : [flag, value];
+    });
+}
+function versionFields(resource) {
+    return Object.assign({}, ...fieldNames.map(([field]) => optionalString(field, resource.attributes[field])));
+}
+function toScreenshot(resource) {
+    const delivery = resource.attributes.assetDeliveryState;
+    return {
+        id: resource.id,
+        ...optionalString('fileName', resource.attributes.fileName),
+        ...optionalString('sourceFileChecksum', resource.attributes.sourceFileChecksum),
+        ...optionalString('deliveryState', isRecord(delivery) ? delivery.state : undefined),
+    };
+}

package/dist/app-store-presence-port.d.ts

@@ -0,0 +1,101 @@
+/**
+* App Store Connect store page port: app information localizations (name,
+* subtitle, privacy policy URL), App Store version localizations (description,
+* keywords, promotional text, what's new, URLs) and their screenshot sets.
+* `app-store-presence-asc.ts` implements it with the pinned `asc` CLI; the
+* planner and tests see only these shapes.
+*
+* Resources (App Store Connect API):
+* - App infos and their localizations: https://developer.apple.com/documentation/appstoreconnectapi/app-infos
+* - App Store versions and their localizations: https://developer.apple.com/documentation/appstoreconnectapi/app-store-versions
+* - Screenshot sets and screenshots: https://developer.apple.com/documentation/appstoreconnectapi/app-screenshot-sets
+*/
+export interface AscAppInfo {
+  readonly id: string;
+  /** `AppInfoState` (`state`, or the older `appStoreState`), for example `PREPARE_FOR_SUBMISSION`. */
+  readonly state?: string | undefined;
+}
+export interface AscAppInfoLocalization {
+  readonly id: string;
+  readonly locale: string;
+  readonly name?: string | undefined;
+  readonly subtitle?: string | undefined;
+  readonly privacyPolicyUrl?: string | undefined;
+}
+export interface AscAppStoreVersion {
+  readonly id: string;
+  readonly versionString?: string | undefined;
+  /** `appVersionState`, or `appStoreState` when App Store Connect sends only that. */
+  readonly state?: string | undefined;
+  /** The legacy `appStoreState`; App Store Connect fills the two inconsistently. */
+  readonly appStoreState?: string | undefined;
+  readonly createdDate?: string | undefined;
+}
+/** The version localization fields the sync writes. */
+export interface AscVersionLocalizationFields {
+  readonly description?: string | undefined;
+  readonly keywords?: string | undefined;
+  readonly promotionalText?: string | undefined;
+  readonly whatsNew?: string | undefined;
+  readonly supportUrl?: string | undefined;
+  readonly marketingUrl?: string | undefined;
+}
+export interface AscVersionLocalization extends AscVersionLocalizationFields {
+  readonly id: string;
+  readonly locale: string;
+}
+export interface AscScreenshot {
+  readonly id: string;
+  readonly fileName?: string | undefined;
+  /** MD5 of the uploaded file, as App Store Connect records it. */
+  readonly sourceFileChecksum?: string | undefined;
+  /** `assetDeliveryState.state`: `AWAITING_UPLOAD`, `UPLOAD_COMPLETE`, `COMPLETE` or `FAILED`. */
+  readonly deliveryState?: string | undefined;
+}
+export interface AscScreenshotSet {
+  readonly id: string;
+  /** `screenshotDisplayType`, for example `APP_IPHONE_67`. */
+  readonly displayType: string;
+  /** In the set's order. */
+  readonly screenshots: readonly AscScreenshot[];
+}
+export interface AscStorePresencePort {
+  /** The app record's bundle ID (`apps view`). */
+  readAppBundleId(appId: string): Promise<string>;
+  listAppInfos(appId: string): Promise<AscAppInfo[]>;
+  listAppInfoLocalizations(appId: string, appInfoId: string): Promise<AscAppInfoLocalization[]>;
+  /** iOS App Store versions of the app. */
+  listVersions(appId: string): Promise<AscAppStoreVersion[]>;
+  listVersionLocalizations(versionId: string): Promise<AscVersionLocalization[]>;
+  listScreenshotSets(versionLocalizationId: string): Promise<AscScreenshotSet[]>;
+  /** Creates the locale's app information localization or updates it. */
+  upsertAppInfoLocalization(input: {
+    readonly appId: string;
+    readonly appInfoId: string;
+    readonly locale: string;
+    readonly name: string;
+    readonly subtitle?: string;
+    readonly privacyPolicyUrl?: string;
+  }): Promise<void>;
+  /** Returns the new localization's ID. */
+  createVersionLocalization(input: {
+    readonly versionId: string;
+    readonly locale: string;
+    readonly fields: AscVersionLocalizationFields;
+  }): Promise<string>;
+  updateVersionLocalization(input: {
+    readonly localizationId: string;
+    readonly fields: AscVersionLocalizationFields;
+  }): Promise<void>;
+  /**
+  * Appends one screenshot to the set of `displayType` (creating the set),
+  * waiting until App Store Connect reports the asset delivered. Throws when
+  * the delivery fails.
+  */
+  uploadScreenshot(input: {
+    readonly versionLocalizationId: string;
+    readonly displayType: string;
+    readonly file: string;
+  }): Promise<AscScreenshot>;
+  deleteScreenshot(screenshotId: string): Promise<void>;
+}

package/dist/app-store-presence-port.js

@@ -0,0 +1,13 @@
+/**
+ * App Store Connect store page port: app information localizations (name,
+ * subtitle, privacy policy URL), App Store version localizations (description,
+ * keywords, promotional text, what's new, URLs) and their screenshot sets.
+ * `app-store-presence-asc.ts` implements it with the pinned `asc` CLI; the
+ * planner and tests see only these shapes.
+ *
+ * Resources (App Store Connect API):
+ * - App infos and their localizations: https://developer.apple.com/documentation/appstoreconnectapi/app-infos
+ * - App Store versions and their localizations: https://developer.apple.com/documentation/appstoreconnectapi/app-store-versions
+ * - Screenshot sets and screenshots: https://developer.apple.com/documentation/appstoreconnectapi/app-screenshot-sets
+ */
+export {};

package/dist/asc-session.d.ts

@@ -0,0 +1,43 @@
+/**
+* One session on the pinned `asc` 5.5.0 CLI, with the same binary pin,
+* isolated environment and API key as the TestFlight submission, and the
+* JSON helpers every asc-backed port reads its output with. Each command is
+* one `asc ... --output json` subprocess; the JSON is App Store Connect's
+* own resource document, as `asc` received it
+* (`internal/asc/types/resources.go` at the 5.5.0 tag).
+*/
+/** Runs one asc command with `--output json` appended and returns the parsed JSON. */
+export type AscCommandRunner = (args: readonly string[], timeoutMs: number) => Promise<unknown>;
+export interface AscCredential {
+  readonly ascBinary: string;
+  readonly apiKeyId: string;
+  readonly apiIssuerId: string;
+  readonly apiPrivateKeyBase64: string;
+}
+export declare const ascLookupTimeoutMs = 60000;
+export declare const ascListTimeoutMs: number;
+export declare const ascUploadTimeoutMs: number;
+/** asc exit code for an App Store Connect 404 (`cmd/exit_codes.go`, 5.5.0). */
+export declare const ascExitNotFound = 4;
+/** Copy and verify the pinned binary into a private directory; `close` removes it. */
+export declare function openAscSession(credential: AscCredential, signal?: AbortSignal): Promise<{
+  readonly run: AscCommandRunner;
+  close(): void;
+}>;
+export interface AscJsonResource {
+  readonly id: string;
+  readonly attributes: Record<string, unknown>;
+  readonly relationships?: unknown;
+}
+export declare function single(value: unknown, command: string): AscJsonResource;
+export declare function list(value: unknown, command: string): AscJsonResource[];
+export declare function toResource(value: unknown): AscJsonResource | undefined;
+/**
+* App Store Connect's `data: null`, or asc's rendering of it: asc 5.5.0
+* decodes into a non-pointer resource and prints `{ "type": "", "id": "" }`.
+*/
+export declare function isEmptyResource(value: unknown): boolean;
+export declare function relationshipId(relationships: unknown, name: string): string | undefined;
+export declare function requiredString(value: unknown, label: string): string;
+export declare function optionalString<K extends string>(key: K, value: unknown): Partial<Record<K, string>>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/asc-session.js

@@ -0,0 +1,118 @@
+import { chmodSync, copyFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { runReleaseProcess } from './deploy-process.js';
+import { isolatedAscEnvironment, verifyPinnedAscBinary } from './testflight-submission.js';
+export const ascLookupTimeoutMs = 60_000;
+export const ascListTimeoutMs = 3 * 60_000;
+export const ascUploadTimeoutMs = 10 * 60_000;
+const maxJsonBytes = 8 * 1024 * 1024;
+/** asc exit code for an App Store Connect 404 (`cmd/exit_codes.go`, 5.5.0). */
+export const ascExitNotFound = 4;
+/** Copy and verify the pinned binary into a private directory; `close` removes it. */
+export async function openAscSession(credential, signal) {
+    if (!path.isAbsolute(credential.ascBinary)) {
+        throw new Error('asc binary must be an absolute file path.');
+    }
+    const tempRoot = mkdtempSync(path.join(tmpdir(), 'mpgd-asc-iap-'));
+    try {
+        const binary = path.join(tempRoot, 'asc');
+        copyFileSync(credential.ascBinary, binary);
+        chmodSync(binary, 0o700);
+        await verifyPinnedAscBinary(binary);
+        const environment = isolatedAscEnvironment(credential, tempRoot);
+        const run = async (args, timeoutMs) => {
+            const result = await runReleaseProcess({
+                command: binary,
+                args: [...args, '--output', 'json'],
+                cwd: tempRoot,
+                environment,
+                timeoutMs,
+                maxOutputBytes: maxJsonBytes,
+                captureMachineStdout: true,
+                secretValues: [credential.apiKeyId, credential.apiIssuerId, credential.apiPrivateKeyBase64],
+                signal,
+            });
+            if (result.truncated || result.machineStdout === undefined) {
+                throw new Error('asc JSON output was truncated or unavailable.');
+            }
+            try {
+                return JSON.parse(result.machineStdout);
+            }
+            catch {
+                throw new Error('asc returned invalid JSON.');
+            }
+        };
+        return {
+            run,
+            close: () => rmSync(tempRoot, { recursive: true, force: true }),
+        };
+    }
+    catch (error) {
+        rmSync(tempRoot, { recursive: true, force: true });
+        throw error;
+    }
+}
+export function single(value, command) {
+    const resource = isRecord(value) ? toResource(value.data) : undefined;
+    if (resource === undefined) {
+        throw new Error(`asc ${command} returned no resource.`);
+    }
+    return resource;
+}
+export function list(value, command) {
+    const resources = isRecord(value) && Array.isArray(value.data)
+        ? value.data.map(toResource)
+        : undefined;
+    if (resources === undefined || resources.some((resource) => resource === undefined)) {
+        throw new Error(`asc ${command} returned no resource list.`);
+    }
+    return resources;
+}
+export function toResource(value) {
+    if (!isRecord(value) || typeof value.id !== 'string' || value.id === '') {
+        return undefined;
+    }
+    return {
+        id: value.id,
+        attributes: isRecord(value.attributes) ? value.attributes : {},
+        ...(value.relationships === undefined ? {} : { relationships: value.relationships }),
+    };
+}
+/**
+ * App Store Connect's `data: null`, or asc's rendering of it: asc 5.5.0
+ * decodes into a non-pointer resource and prints `{ "type": "", "id": "" }`.
+ */
+export function isEmptyResource(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return value.data === null
+        || (isRecord(value.data) && (value.data.id === undefined || value.data.id === ''));
+}
+export function relationshipId(relationships, name) {
+    if (!isRecord(relationships)) {
+        return undefined;
+    }
+    const relationship = relationships[name];
+    if (!isRecord(relationship) || !isRecord(relationship.data)) {
+        return undefined;
+    }
+    return typeof relationship.data.id === 'string' ? relationship.data.id : undefined;
+}
+export function requiredString(value, label) {
+    if (typeof value !== 'string') {
+        throw new Error(`asc output has no ${label}.`);
+    }
+    return value;
+}
+export function optionalString(key, value) {
+    const result = {};
+    if (typeof value === 'string' && value !== '') {
+        result[key] = value;
+    }
+    return result;
+}
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/index.d.ts

@@ -13,6 +13,12 @@ export { applyStoreProducts, planStoreProducts, saveStoreProductPlan, type Store
 export { applyPlayProductPlan, formatPlayProductPlan, planPlayProducts, PlayProductApplyError, type PlannedPlayProduct, type PlayProductApplyResult, type PlayProductChange, type PlayProductPlan, type PlayProductPlanInput, } from './store-products-play.js';
 export { AppStoreProductApplyError, applyAppStoreProductPlan, formatAppStoreProductPlan, planAppStoreProducts, type AppStoreProductApplyResult, type AppStoreProductChange, type AppStoreProductPlan, type AppStoreProductPlanInput, type PlannedAppStoreProduct, } from './store-products-app-store.js';
 export { StoreProductPlanStaleError } from './store-products.js';
+export { StorePlanStaleError } from './store-sync.js';
+export { applyStorePresence, planStorePresence, saveStorePresencePlan, type StorePresenceApplyOptions, type StorePresencePlanFile, type StorePresencePlanOptions, type StorePresencePorts, type StorePresenceStore, } from './store-presence-command.js';
+export { applyPlayPresence, formatPlayPresencePlan, planPlayPresence, PlayPresenceApplyError, type PlannedPlayImageSlot, type PlannedPlayLanguage, type PlayPresenceApplyResult, type PlayPresencePlan, type PlayPresencePlanInput, } from './store-presence-play.js';
+export { applyAppStorePresence, AppStorePresenceApplyError, formatAppStorePresencePlan, planAppStorePresence, type AppStorePresenceApplyResult, type AppStorePresencePlan, type AppStorePresencePlanInput, type PlannedAppStoreLocale, type PlannedAscScreenshotSet, } from './store-presence-app-store.js';
+export type { AscAppInfo, AscAppInfoLocalization, AscAppStoreVersion, AscScreenshot, AscScreenshotSet, AscStorePresencePort, AscVersionLocalization, AscVersionLocalizationFields, } from './app-store-presence-port.js';
+export type { PlayAppDetails, PlayImage, PlayImageType, PlayListing, PlayStoreListingPort, } from './play-listing-port.js';
 export { PlayPromoteUncertainError, promotePlayRelease, type PlayPromoteInput, type PlayPromoteResult, } from './play-release-promote.js';
 export { PlayRolloutUncertainError, changePlayRollout, type PlayRolloutAction, type PlayRolloutInput, type PlayRolloutResult, } from './play-release-rollout.js';
 export { IosSubmissionUncertainError, submitVerifiedIosBuild, type IosTestFlightStatus, type IosTestFlightSubmissionInput, type IosTestFlightSubmissionResult, } from './testflight-submission.js';