@mpgd/cli 0.26.0 → 0.28.0

package/dist/build-targets.js

@@ -40,12 +40,16 @@ export function normalizeConfiguredBuildTargets(configuredTargets) {
 }
 function resolveBuildTarget(target, configuredTargets) {
     const configuredWebTarget = isConfiguredWebTarget(target, configuredTargets);
-    if (configuredWebTarget) {
+    const configuredMiniGameTarget = isConfiguredMiniGameTarget(target, configuredTargets);
+    if (configuredWebTarget || configuredMiniGameTarget) {
         assertDeploymentTargetName(target);
     }
     if (target === 'web' && configuredWebTarget) {
         return target;
     }
+    if (configuredMiniGameTarget) {
+        return target;
+    }
     const builtInTarget = normalizeBuiltInBuildTarget(target);
     if (builtInTarget !== undefined) {
         return builtInTarget;
@@ -55,6 +59,17 @@ function resolveBuildTarget(target, configuredTargets) {
     }
     return undefined;
 }
+function isConfiguredMiniGameTarget(target, configuredTargets) {
+    if (!Object.prototype.hasOwnProperty.call(configuredTargets, target)) {
+        return false;
+    }
+    const configuredTarget = configuredTargets[target];
+    return typeof configuredTarget === 'object'
+        && configuredTarget !== null
+        && !Array.isArray(configuredTarget)
+        && 'kind' in configuredTarget
+        && configuredTarget.kind === 'wechat-minigame';
+}
 function normalizeBuiltInBuildTarget(target) {
     if (target === 'browser' || target === 'web') {
         return 'web-preview';

package/dist/production-target-readiness.d.ts

@@ -5,6 +5,7 @@ export interface ProductionTargetReadinessInput {
   readonly gameRoot: string;
   readonly gameServicesUrl?: string;
   readonly targetPolicy?: ProductionTargetPolicy;
+  readonly environment?: NodeJS.ProcessEnv;
 }
 export interface ProductionTargetPolicy {
   readonly runtime: string;

package/dist/production-target-readiness.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import { isIP } from 'node:net';
 import path from 'node:path';
+const wechatStagingAppId = 'wx0000000000000000';
 const ownerPathByTarget = {
     ait: 'wrapperApp',
     android: 'shellApp',
@@ -23,6 +24,7 @@ export function assertProductionTargetReadiness(input) {
     if (!isRecord(targetConfig)) {
         throw new Error(`Missing target configuration for ${input.target}.`);
     }
+    assertExperimentalTargetReadiness(input, targetConfig);
     const targetPolicy = targetConfig.authoritativeGameServices === false
         ? disableMonetization(input.targetPolicy)
         : input.targetPolicy;
@@ -83,6 +85,24 @@ export function assertProductionTargetReadiness(input) {
         assertAuthoritativeGameServicesUrl(input.gameServicesUrl, input.target);
     }
 }
+function assertExperimentalTargetReadiness(input, targetConfig) {
+    if (targetConfig.experimental !== true) {
+        return;
+    }
+    const environment = input.environment ?? process.env;
+    if (environment.MPGD_ALLOW_EXPERIMENTAL_TARGET !== '1') {
+        throw new Error(`Production build for experimental target ${input.target} is blocked.\n`
+            + 'Set MPGD_ALLOW_EXPERIMENTAL_TARGET=1 only for platform validation builds.');
+    }
+    if (targetConfig.kind === 'wechat-minigame') {
+        const appId = environment.MPGD_WECHAT_APP_ID?.trim();
+        if (appId === undefined
+            || appId === wechatStagingAppId
+            || !/^wx[0-9a-f]{16}$/u.test(appId)) {
+            throw new Error('Production WeChat Mini Game builds require MPGD_WECHAT_APP_ID.');
+        }
+    }
+}
 function disableMonetization(policy) {
     if (policy === undefined) {
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -52,19 +52,19 @@
     "@types/node": "^24.0.0",
     "ttsc": "0.18.4",
     "typescript": "7.0.2",
-    "@mpgd/adapter-ait": "0.11.0",
-    "@mpgd/adapter-browser": "0.7.1",
-    "@mpgd/adapter-capacitor": "0.4.7",
-    "@mpgd/adapter-devvit": "0.9.4",
-    "@mpgd/adapter-verse8": "0.3.2",
-    "@mpgd/analytics": "0.3.10",
+    "@mpgd/adapter-ait": "0.12.1",
+    "@mpgd/adapter-browser": "0.7.3",
+    "@mpgd/adapter-capacitor": "0.4.9",
+    "@mpgd/adapter-devvit": "0.9.6",
+    "@mpgd/adapter-verse8": "0.3.4",
+    "@mpgd/analytics": "0.3.12",
+    "@mpgd/catalog": "0.7.2",
+    "@mpgd/i18n": "0.6.0",
+    "@mpgd/game-services": "0.14.0",
     "@mpgd/bridge": "0.9.0",
-    "@mpgd/game-services": "0.13.0",
-    "@mpgd/i18n": "0.5.6",
-    "@mpgd/catalog": "0.7.0",
     "@mpgd/phaser-assets": "0.4.1",
-    "@mpgd/target-config": "0.13.0",
-    "@mpgd/platform": "0.10.0"
+    "@mpgd/platform": "0.12.0",
+    "@mpgd/target-config": "0.14.0"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/templates/phaser-game/README.md

@@ -277,13 +277,22 @@ and non-native flow checks:
 ```sh
 pnpm ait:wrapper:dev
 pnpm ait:wrapper:dev:plain
+pnpm ait:wrapper:dev:sandbox
 ```
 
 `ait:wrapper:dev` loads the last game bundle copied by `pnpm build:ait` from the
 wrapper's `public/game` directory, so run `pnpm build:ait` again after game
 changes before opening it. The local mock deliberately keeps ads, promotions,
-and IAP unavailable; test those flows from the Apps in Toss console QR sandbox
-or a real device after uploading the `.ait` bundle.
+and IAP unavailable.
+
+`ait:wrapper:dev:sandbox` disables every local bridge and identity mock so the
+official Apps in Toss Sandbox host can inject its native SDK. Supply any
+game-owned staging endpoints, product SKUs, and server-authority configuration
+as environment variables before starting it. Use this route for native identity,
+one-time IAP, and Game Center tests; it is not a normal browser preview. The
+Sandbox does not support ads, so upload a staging `.ait` bundle and use the
+console `intoss-private://` QR in the Toss app for test-ad and final integration
+checks.
 
 The starter includes `@ait-co/console-cli`, the Apps in Toss community console
 CLI, as a dev dependency for project-local console automation:

package/templates/phaser-game/apps/target-ait/package.json

@@ -6,6 +6,7 @@
   "scripts": {
     "dev": "MPGD_AIT_LOCAL_MOCK=1 VITE_MPGD_AIT_MOCK_IDENTITY=1 vite --host 0.0.0.0",
     "dev:plain": "pnpm dev",
+    "dev:sandbox": "MPGD_AIT_LOCAL_MOCK=0 VITE_MPGD_AIT_MOCK_IDENTITY=0 vite --host 0.0.0.0",
     "build": "vite build && ait build",
     "ait:build": "ait build",
     "ait:deploy": "ait deploy --api-key \"$AIT_API_KEY\"",

package/templates/phaser-game/apps/target-ait/src/main.ts

@@ -1,21 +1,16 @@
 import './styles.css';
 
-import type { AitAdPlacementType } from '@mpgd/adapter-ait/ad-config';
 import { installAitHostBridge, type InstallAitHostBridgeOptions } from '@mpgd/adapter-ait/host';
 import { installAitSafeAreaCssVariables } from '@mpgd/adapter-ait/safe-area';
 import { mountAitGameBundle } from '@mpgd/adapter-ait/wrapper';
 
-declare const __MPGD_AIT_APP_NAME__: string;
-declare const __MPGD_AIT_AD_GROUP_IDS__: Readonly<Record<string, string>>;
-declare const __MPGD_AIT_AD_PLACEMENT_TYPES__: Readonly<
-  Record<string, AitAdPlacementType>
->;
+import runtimeConfig from 'virtual:mpgd-ait-runtime-config';
 
 installAitSafeAreaCssVariables();
 installAitHostBridge({
-  appName: __MPGD_AIT_APP_NAME__,
-  adGroupIds: __MPGD_AIT_AD_GROUP_IDS__,
-  adPlacementTypes: __MPGD_AIT_AD_PLACEMENT_TYPES__,
+  appName: runtimeConfig.appName,
+  adGroupIds: runtimeConfig.adGroupIds,
+  adPlacementTypes: runtimeConfig.adPlacementTypes,
   ...identityBridgeOptions(),
 });
 

package/templates/phaser-game/apps/target-ait/src/runtime-config.types.ts

@@ -0,0 +1,12 @@
+declare module 'virtual:mpgd-ait-runtime-config' {
+  const runtimeConfig: Readonly<{
+    readonly appName: string;
+    readonly adGroupIds: Readonly<Record<string, string>>;
+    readonly adPlacementTypes: Readonly<Record<
+      string,
+      import('@mpgd/adapter-ait/ad-config').AitAdPlacementType
+    >>;
+  }>;
+
+  export default runtimeConfig;
+}

package/templates/phaser-game/apps/target-ait/vite.config.ts

@@ -5,7 +5,7 @@ import {
   type AitAdBridgeConfig,
 } from '@mpgd/adapter-ait/ad-config';
 import ttsc from '@ttsc/unplugin/vite';
-import { defineConfig } from 'vite';
+import { defineConfig, type Plugin } from 'vite';
 
 const aitAppName = process.env.MPGD_AIT_APP_NAME?.trim() || '__GAME_NAME__';
 const aitAdConfig = readAitAdConfig(process.env.MPGD_AD_PLACEMENTS_FILE);
@@ -16,11 +16,6 @@ export default defineConfig(({ command, isPreview }) => {
     && process.env.MPGD_AIT_LOCAL_MOCK !== '0';
 
   return {
-    define: {
-      __MPGD_AIT_APP_NAME__: JSON.stringify(aitAppName),
-      __MPGD_AIT_AD_GROUP_IDS__: JSON.stringify(aitAdConfig.adGroupIds),
-      __MPGD_AIT_AD_PLACEMENT_TYPES__: JSON.stringify(aitAdConfig.adPlacementTypes),
-    },
     // Browser-only local development must not pretend that native rewards or
     // purchases are available. Production and console builds use the real SDK.
     ...(enableLocalAitMock
@@ -33,7 +28,14 @@ export default defineConfig(({ command, isPreview }) => {
         }
       : {}),
     plugins: [
-      ttsc({ project: 'tsconfig.json', plugins: false }),
+      createAitRuntimeConfigPlugin({
+        appName: aitAppName,
+        adGroupIds: aitAdConfig.adGroupIds,
+        adPlacementTypes: aitAdConfig.adPlacementTypes,
+      }),
+      ...(command === 'build'
+        ? [ttsc({ project: 'tsconfig.json', plugins: false })]
+        : []),
     ],
     build: {
       target: 'es2022',
@@ -43,6 +45,26 @@ export default defineConfig(({ command, isPreview }) => {
   };
 });
 
+function createAitRuntimeConfigPlugin(input: Readonly<{
+  readonly appName: string;
+  readonly adGroupIds: Readonly<Record<string, string>>;
+  readonly adPlacementTypes: AitAdBridgeConfig['adPlacementTypes'];
+}>): Plugin {
+  const publicId = 'virtual:mpgd-ait-runtime-config';
+  const resolvedId = `\0${publicId}`;
+  return {
+    name: 'mpgd-ait-runtime-config',
+    resolveId(id) {
+      return id === publicId ? resolvedId : null;
+    },
+    load(id) {
+      return id === resolvedId
+        ? `export default Object.freeze(${JSON.stringify(input)});\n`
+        : null;
+    },
+  };
+}
+
 function readAitAdConfig(path: string | undefined): AitAdBridgeConfig {
   if (path === undefined || path.trim().length === 0) {
     return { adGroupIds: {}, adPlacementTypes: {} };

package/templates/phaser-game/package.json

@@ -19,6 +19,7 @@
     "smoke:ait": "pnpm exec mpgd target smoke ait --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "ait:wrapper:dev": "pnpm --dir apps/target-ait run dev",
     "ait:wrapper:dev:plain": "pnpm --dir apps/target-ait run dev:plain",
+    "ait:wrapper:dev:sandbox": "pnpm --dir apps/target-ait run dev:sandbox",
     "ait:console:login": "aitcc login",
     "ait:console:whoami": "aitcc whoami",
     "ait:console:init": "aitcc app init",

package/templates/phaser-game/src/platform/runtimeDetector.ts

@@ -9,6 +9,8 @@ const validTargets = new Set<string>([
   'verse8',
   'telegram',
   'tauri',
+  'wechat',
+  'tiktok',
 ] satisfies readonly PlatformTarget[]);
 
 export interface RuntimeConfig {

package/templates/phaser-game/vite.runtime-target-config.ts

@@ -20,6 +20,8 @@ const runtimeKinds = valueSet({
   'apps-in-toss': true,
   'devvit-web': true,
   'verse8-web': true,
+  'wechat-minigame': true,
+  'tiktok-minigame': true,
 } satisfies Record<TargetRuntimeKind, true>);
 const releaseProfiles = valueSet({
   web: true,
@@ -30,6 +32,8 @@ const releaseProfiles = valueSet({
   'apps-in-toss': true,
   'devvit': true,
   'verse8': true,
+  'wechat-minigame': true,
+  'tiktok-minigame': true,
 } satisfies Record<ReleaseProfile, true>);
 const storageSupportValues = valueSet({
   local: true,

package/templates/phaser-game/vite.shared.ts

@@ -138,6 +138,16 @@ export function resolveBuildGatewayModule(input: {
       return 'src/platform/buildGateways/verse8.ts';
     case 'microsoft-store':
       return 'src/platform/buildGateways/microsoftStore.ts';
+    case 'telegram':
+    case 'tauri':
+      throw new Error(
+        `Direct APP_TARGET=${input.target} builds are unavailable until its native platform gateway is installed.`,
+      );
+    case 'wechat':
+    case 'tiktok':
+      throw new Error(
+        `Direct APP_TARGET=${input.target} builds are unavailable until the native mini-game gateway and artifact emitter are installed.`,
+      );
     default:
       return 'src/platform/buildGateways/browser.ts';
   }