@mpgd/cli 0.62.0 → 0.64.0

package/dist/store-products.js

@@ -0,0 +1,56 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { assertProductCatalog, assertStoreListingCatalog, } from '@mpgd/catalog';
+import { readJsonFile, StorePlanStaleError } from './store-sync.js';
+export { canonicalLanguageTag, mapWithConcurrency, stableJson, stableSha256, } from './store-sync.js';
+export const defaultStoreListingFileName = 'mpgd.store-listings.json';
+export const defaultProductCatalogFileName = 'mpgd.catalog.json';
+/**
+ * Read and cross-check the game's product catalog and store listing file.
+ * Given paths resolve against the current directory, like every other mpgd
+ * file flag (`deploy --plan`, `--release-notes`); the defaults are the
+ * game's own files.
+ */
+export function readStoreProductSources(input) {
+    const catalogFile = input.catalogFile === undefined
+        ? path.join(path.resolve(input.gameRoot), defaultProductCatalogFileName)
+        : path.resolve(input.catalogFile);
+    const listingsFile = input.listingsFile === undefined
+        ? path.join(path.resolve(input.gameRoot), defaultStoreListingFileName)
+        : path.resolve(input.listingsFile);
+    for (const file of [catalogFile, listingsFile]) {
+        if (!existsSync(file)) {
+            throw new Error(`Store product sync needs ${file}.`);
+        }
+    }
+    const catalog = assertProductCatalog(readJsonFile(catalogFile));
+    const listings = assertStoreListingCatalog(readJsonFile(listingsFile), catalog);
+    return { catalogFile, listingsFile, catalog, listings };
+}
+export class StoreProductPlanStaleError extends StorePlanStaleError {
+    constructor(detail) {
+        super(detail, 'mpgd store products plan');
+        this.name = 'StoreProductPlanStaleError';
+    }
+}
+/** Decimal string (`"0.99"`) as whole units and nanos, without floating point. */
+export function decimalToUnitsAndNanos(amount) {
+    const match = /^(0|[1-9]\d{0,11})(?:\.(\d{1,9}))?$/u.exec(amount);
+    if (match === null) {
+        throw new Error(`Price ${amount} is not a plain decimal amount.`);
+    }
+    return {
+        units: match[1] ?? '0',
+        nanos: Number((match[2] ?? '').padEnd(9, '0')),
+    };
+}
+/** Decimal strings compared by value: `0.99` equals `0.990`. */
+export function sameDecimal(left, right) {
+    const normal = (value) => {
+        const [whole = '0', fraction = ''] = value.trim().split('.');
+        const trimmedFraction = fraction.replace(/0+$/u, '');
+        const trimmedWhole = whole.replace(/^0+(?=\d)/u, '');
+        return trimmedFraction === '' ? trimmedWhole : `${trimmedWhole}.${trimmedFraction}`;
+    };
+    return normal(left) === normal(right);
+}

package/dist/store-sync.d.ts

@@ -0,0 +1,50 @@
+import type { AscCredential } from './app-store-iap-asc.js';
+/**
+* What every `mpgd store <kind> plan|apply` shares: the app and credential
+* the deployment profile names, the saved plan file, the stable digests
+* apply compares, and moving a reviewed plan to another checkout.
+*/
+export type StoreSyncStore = 'google-play' | 'app-store';
+/** The store app the deployment profile names, with its credential. */
+export type StoreSyncApp = {
+  readonly store: 'google-play';
+  readonly packageName: string;
+  readonly serviceAccountFile: string;
+} | {
+  readonly store: 'app-store';
+  /** Numeric App Store Connect app ID. */
+  readonly appId: string;
+  readonly bundleId: string;
+  readonly credential: AscCredential;
+};
+/**
+* Resolve the app and credential of `store` from the game's deployment
+* profile, the same ones `deploy submit` uses.
+*/
+export declare function resolveStoreSyncApp(options: {
+  readonly game: string;
+  readonly profile: string;
+  readonly store: StoreSyncStore;
+}, environment: NodeJS.ProcessEnv): StoreSyncApp;
+export declare function assertStoreSyncStore(store: string): asserts store is StoreSyncStore;
+/**
+* A file a saved plan read, moved to the game directory apply runs in
+* (`apply --game`). Files outside the saved game directory cannot move.
+*/
+export declare function relocateStoreSyncFile(savedGameRoot: string, gameRoot: string | undefined, file: string): string;
+/** JSON with object keys sorted, so equal values always hash the same. */
+export declare function stableJson(value: unknown): string;
+export declare function stableSha256(value: unknown): string;
+/** A new plan file, never overwriting one (the same rule as `deploy plan --out`). */
+export declare function writeStorePlanFile(file: string, plan: unknown): string;
+/** A saved plan's top-level object; the caller checks its fields. */
+export declare function readStorePlanFile(file: string, label: string): Record<string, unknown>;
+/** The store or the game files moved past the reviewed plan. */
+export declare class StorePlanStaleError extends Error {
+  constructor(detail: string, planCommand: string);
+}
+/** BCP-47 casing: language lowercase, script title case, region uppercase. */
+export declare function canonicalLanguageTag(tag: string): string;
+/** `map` with at most `limit` calls in flight; results keep input order. */
+export declare function mapWithConcurrency<T, R>(items: readonly T[], limit: number, map: (item: T) => Promise<R>): Promise<R[]>;
+export declare function readJsonFile(file: string): unknown;

package/dist/store-sync.js

@@ -0,0 +1,137 @@
+import { createHash } from 'node:crypto';
+import { readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { planNativeDeployment } from './deploy-planning.js';
+import { readStoreCredential } from './native-deploy-run.js';
+/**
+ * Resolve the app and credential of `store` from the game's deployment
+ * profile, the same ones `deploy submit` uses.
+ */
+export function resolveStoreSyncApp(options, environment) {
+    assertStoreSyncStore(options.store);
+    const target = options.store === 'google-play' ? 'android' : 'ios';
+    const deployment = planNativeDeployment({
+        game: path.resolve(options.game),
+        profile: options.profile,
+        targets: [target],
+    });
+    const planned = deployment.targets.find((entry) => entry.target === target);
+    if (planned === undefined) {
+        throw new Error(`Deployment profile ${options.profile} has no ${target} target.`);
+    }
+    const credential = readStoreCredential(deployment, target, environment);
+    if (credential.target === 'android') {
+        return {
+            store: 'google-play',
+            packageName: planned.appId,
+            serviceAccountFile: credential.serviceAccountFile,
+        };
+    }
+    return {
+        store: 'app-store',
+        appId: credential.appStoreAppId,
+        bundleId: planned.appId,
+        credential: {
+            ascBinary: credential.ascBinary,
+            apiKeyId: credential.apiKeyId,
+            apiIssuerId: credential.apiIssuerId,
+            apiPrivateKeyBase64: credential.apiPrivateKeyBase64,
+        },
+    };
+}
+export function assertStoreSyncStore(store) {
+    if (store !== 'google-play' && store !== 'app-store') {
+        throw new Error('--store must be google-play or app-store.');
+    }
+}
+/**
+ * A file a saved plan read, moved to the game directory apply runs in
+ * (`apply --game`). Files outside the saved game directory cannot move.
+ */
+export function relocateStoreSyncFile(savedGameRoot, gameRoot, file) {
+    if (gameRoot === undefined) {
+        return file;
+    }
+    const relative = path.relative(savedGameRoot, file);
+    if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error(`The saved plan reads ${file}, outside its game directory; --game cannot move it. Plan again.`);
+    }
+    return path.resolve(gameRoot, relative);
+}
+/** JSON with object keys sorted, so equal values always hash the same. */
+export function stableJson(value) {
+    return JSON.stringify(sortKeys(value));
+}
+export function stableSha256(value) {
+    return createHash('sha256').update(stableJson(value)).digest('hex');
+}
+/** A new plan file, never overwriting one (the same rule as `deploy plan --out`). */
+export function writeStorePlanFile(file, plan) {
+    const resolved = path.resolve(file);
+    writeFileSync(resolved, `${JSON.stringify(plan, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+    return resolved;
+}
+/** A saved plan's top-level object; the caller checks its fields. */
+export function readStorePlanFile(file, label) {
+    const raw = readJsonFile(path.resolve(file));
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new Error(`Saved ${label} is malformed.`);
+    }
+    return raw;
+}
+/** The store or the game files moved past the reviewed plan. */
+export class StorePlanStaleError extends Error {
+    constructor(detail, planCommand) {
+        super(`${detail} Run "${planCommand}" again and review the new plan.`);
+        this.name = 'StorePlanStaleError';
+    }
+}
+/** BCP-47 casing: language lowercase, script title case, region uppercase. */
+export function canonicalLanguageTag(tag) {
+    return tag.split('-').map((part, index) => {
+        if (index === 0) {
+            return part.toLowerCase();
+        }
+        if (/^[A-Za-z]{4}$/u.test(part)) {
+            return `${part.slice(0, 1).toUpperCase()}${part.slice(1).toLowerCase()}`;
+        }
+        if (/^[A-Za-z]{2}$/u.test(part)) {
+            return part.toUpperCase();
+        }
+        return part.toLowerCase();
+    }).join('-');
+}
+/** `map` with at most `limit` calls in flight; results keep input order. */
+export async function mapWithConcurrency(items, limit, map) {
+    const results = new Array(items.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < items.length) {
+            const index = next;
+            next += 1;
+            results[index] = await map(items[index]);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+    return results;
+}
+export function readJsonFile(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`${file} is not valid JSON: ${error.message}`);
+    }
+}
+function sortKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortKeys);
+    }
+    if (typeof value === 'object' && value !== null) {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .filter((key) => value[key] !== undefined)
+            .map((key) => [key, sortKeys(value[key])]));
+    }
+    return value;
+}

package/dist/testflight-submission.d.ts

@@ -53,6 +53,6 @@ export declare function classifyInternalBuildState(state: string): {
   readonly status: Extract<IosTestFlightStatus, 'processing' | 'action-required' | 'failed' | 'unknown'>;
   readonly detail?: string;
 } | undefined;
-export declare function isolatedAscEnvironment(input: IosTestFlightSubmissionInput, directory: string, source?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function isolatedAscEnvironment(input: Pick<IosTestFlightSubmissionInput, 'apiKeyId' | 'apiIssuerId' | 'apiPrivateKeyBase64'>, directory: string, source?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 /** The package consumes one reviewed asc pin; it does not trust PATH or version text. */
 export declare function verifyPinnedAscBinary(binary: string, pinFile?: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.62.0",
+  "version": "0.64.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -70,10 +70,10 @@
     "parse5": "7.3.0",
     "postcss": "8.5.28",
     "postcss-value-parser": "4.2.0",
-    "@mpgd/catalog": "0.11.3",
-    "@mpgd/phaser-assets": "0.9.1",
-    "@mpgd/target-config": "0.24.1",
-    "@mpgd/platform": "0.32.0"
+    "@mpgd/catalog": "0.13.0",
+    "@mpgd/platform": "0.32.0",
+    "@mpgd/target-config": "0.24.3",
+    "@mpgd/phaser-assets": "0.9.1"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -81,17 +81,17 @@
     "@types/yauzl": "3.4.0",
     "ttsc": "0.32.1",
     "typescript": "7.0.2",
-    "@mpgd/adapter-ait": "0.21.3",
+    "@mpgd/adapter-ait": "0.21.5",
     "@mpgd/adapter-browser": "0.12.1",
-    "@mpgd/adapter-capacitor": "0.16.1",
-    "@mpgd/adapter-verse8": "0.7.14",
+    "@mpgd/adapter-capacitor": "0.16.3",
+    "@mpgd/adapter-devvit": "0.14.7",
+    "@mpgd/adapter-verse8": "0.7.16",
     "@mpgd/bridge": "0.16.4",
-    "@mpgd/capacitor-play-billing": "0.4.3",
-    "@mpgd/adapter-devvit": "0.14.5",
-    "@mpgd/capacitor-storekit": "0.4.3",
     "@mpgd/analytics": "0.5.5",
-    "@mpgd/game-runtime": "0.8.7",
-    "@mpgd/game-services": "0.30.3",
+    "@mpgd/game-runtime": "0.8.9",
+    "@mpgd/capacitor-play-billing": "0.4.5",
+    "@mpgd/capacitor-storekit": "0.4.5",
+    "@mpgd/game-services": "0.30.5",
     "@mpgd/i18n": "0.6.26",
     "@mpgd/lite-shell": "0.1.0"
   },