@ttmg/cli 0.4.6-vibe-beta.3 → 0.4.6-vibe-beta.4

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttmg/cli",
-  "version": "0.4.6-vibe-beta.3",
+  "version": "0.4.6-vibe-beta.4",
   "description": "TikTok Mini Game Command Line Tool",
   "license": "ISC",
   "bin": {
@@ -20,6 +20,9 @@
     "verify:agent-contract": "node scripts/verify-agent-contract.js",
     "test:network": "node -r ts-node/register src/commands/native/dev/utils/getLocalIPs.test.ts",
     "test:upload-preview": "node scripts/run-ts-test.js src/commands/common/upload.test.ts",
+    "test:preview-page": "node scripts/run-ts-test.js src/commands/common/previewPageServer.test.ts",
+    "test:preview-page-detached": "node scripts/run-ts-test.js src/commands/common/previewPageDetached.test.ts",
+    "test:preview-page-process": "node scripts/preview-page-server-smoke.js",
     "test:login": "node scripts/run-ts-test.js src/commands/common/login.test.ts",
     "test:auth": "node scripts/run-ts-test.js src/commands/common/auth.test.ts",
     "test:capabilities": "node scripts/run-ts-test.js src/commands/common/capabilities.test.ts",
@@ -33,7 +36,7 @@
     "test:check-ai": "node scripts/run-ts-test.js src/commands/native/check/ai.test.ts",
     "test:build-structured": "node scripts/run-ts-test.js src/commands/native/build/build.test.ts",
     "test:doctor": "node scripts/run-ts-test.js src/commands/native/doctor/doctor.test.ts",
-    "test:agent-contract": "npm run test:login && npm run test:auth && npm run test:capabilities && npm run test:test-account && npm run test:upload-preview && npm run test:check && npm run test:check-ai && npm run test:build-structured && npm run test:doctor && npm run test:dev-session && npm run test:dev-session-command && npm run test:dev-runtime-event && npm run test:network && npx tsc --noEmit && npm run build && npm run verify:dist-version && npm run verify:agent-contract",
+    "test:agent-contract": "npm run test:login && npm run test:auth && npm run test:capabilities && npm run test:test-account && npm run test:upload-preview && npm run test:preview-page && npm run test:check && npm run test:check-ai && npm run test:build-structured && npm run test:doctor && npm run test:dev-session && npm run test:dev-session-command && npm run test:dev-runtime-event && npm run test:network && npx tsc --noEmit && npm run build && npm run test:preview-page-process && npm run test:preview-page-detached && npm run verify:dist-version && npm run verify:agent-contract",
     "test:agent-contract:full": "npm run test:agent-contract && npm run test:dev-default-process && npm run test:dev-game-ready-process",
     "publish:beta": "npm publish --registry=https://registry.npmjs.org/ --access public --tag beta",
     "setup": "node scripts/setup.js",

package/dist/scripts/preview-page-server-smoke.js

@@ -0,0 +1,63 @@
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+
+const entryPath = path.resolve(__dirname, '../dist/index.js');
+const child = spawn(process.execPath, [entryPath, '__preview-page-server'], {
+  detached: true,
+  windowsHide: true,
+  stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+});
+
+const ready = new Promise((resolve, reject) => {
+  const timeout = setTimeout(
+    () => reject(new Error('preview page worker did not become ready')),
+    5000,
+  );
+  child.once('error', reject);
+  child.once('exit', code =>
+    reject(new Error(`preview page worker exited early (${code})`)),
+  );
+  child.on('message', message => {
+    if (message?.type === 'error') reject(new Error(message.error));
+    if (message?.type === 'ready') {
+      clearTimeout(timeout);
+      resolve(message);
+    }
+  });
+});
+
+async function main() {
+  child.send({
+    type: 'start',
+    authorizationUrl: 'https://www.tiktok.com/ttmg/dev/client-key',
+    previewUrl: 'https://www.tiktok.com/preview/process-smoke',
+    clientKey: 'client-key',
+    projectName: 'Process Smoke Game',
+    versionId: 'asset-smoke',
+    token: 'b'.repeat(48),
+    ttlMs: 5000,
+  });
+  const result = await ready;
+  assert.match(result.url, /^http:\/\/127\.0\.0\.1:\d+\/preview\/b{48}$/);
+  const response = await fetch(result.url);
+  assert.equal(response.status, 200);
+  assert.equal(
+    response.headers.get('content-type'),
+    'text/html; charset=utf-8',
+  );
+  const html = await response.text();
+  assert.match(html, /Process Smoke Game/);
+  assert.equal((html.match(/data:image\/png;base64,/g) || []).length, 2);
+  console.log('preview page server process smoke passed');
+}
+
+main()
+  .catch(error => {
+    console.error(error);
+    process.exitCode = 1;
+  })
+  .finally(() => {
+    if (child.connected) child.disconnect();
+    child.kill();
+  });

package/dist/scripts/verify-agent-contract.js

@@ -104,6 +104,53 @@ assert.equal(
 );
 assert.equal(capabilities.commands.dev.outputModesMutuallyExclusive, true);
 assert.equal(capabilities.commands.uploadPreview.platformWrite, true);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.option,
+  '--serve-preview-page',
+);
+assert.equal(capabilities.commands.uploadPreview.previewPage.inMemory, true);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.reuseScope,
+  'clientKey',
+);
+assert.equal(capabilities.commands.uploadPreview.previewPage.latestOnly, true);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.renewsTtlOnUpload,
+  true,
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.textModeAutoOpen,
+  true,
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.structuredModeAutoOpen,
+  false,
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.noOpenOption,
+  '--no-open',
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.presentation.preferredAction,
+  'open_url',
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.presentation.terminalInline,
+  false,
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.presentation.sameHostRequired,
+  true,
+);
+assert.equal(capabilities.commands.uploadPreview.previewPage.ttlSeconds, 3600);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.expiredNoticeTtlSeconds,
+  3600,
+);
+assert.equal(
+  capabilities.commands.uploadPreview.previewPage.localhostOnly,
+  true,
+);
 assert.equal(capabilities.dev.gameReadyProtocol, true);
 assert.equal(capabilities.dev.gameReady, false);
 assertNoSecretKeys(capabilities, 'capabilities');
@@ -143,6 +190,8 @@ assert.notEqual(
 const uploadHelp = runCli(['upload', '--help']);
 assertExit(uploadHelp, 0, 'upload help');
 assert.match(uploadHelp.stdout, /--preview\b/);
+assert.match(uploadHelp.stdout, /--serve-preview-page\b/);
+assert.match(uploadHelp.stdout, /--no-open\b/);
 assert.doesNotMatch(uploadHelp.stdout, /--allow-upload\b/);
 
 const tempDirectory = fs.mkdtempSync(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttmg/cli",
-  "version": "0.4.6-vibe-beta.3",
+  "version": "0.4.6-vibe-beta.4",
   "description": "TikTok Mini Game Command Line Tool",
   "license": "ISC",
   "bin": {
@@ -20,6 +20,9 @@
     "verify:agent-contract": "node scripts/verify-agent-contract.js",
     "test:network": "node -r ts-node/register src/commands/native/dev/utils/getLocalIPs.test.ts",
     "test:upload-preview": "node scripts/run-ts-test.js src/commands/common/upload.test.ts",
+    "test:preview-page": "node scripts/run-ts-test.js src/commands/common/previewPageServer.test.ts",
+    "test:preview-page-detached": "node scripts/run-ts-test.js src/commands/common/previewPageDetached.test.ts",
+    "test:preview-page-process": "node scripts/preview-page-server-smoke.js",
     "test:login": "node scripts/run-ts-test.js src/commands/common/login.test.ts",
     "test:auth": "node scripts/run-ts-test.js src/commands/common/auth.test.ts",
     "test:capabilities": "node scripts/run-ts-test.js src/commands/common/capabilities.test.ts",
@@ -33,7 +36,7 @@
     "test:check-ai": "node scripts/run-ts-test.js src/commands/native/check/ai.test.ts",
     "test:build-structured": "node scripts/run-ts-test.js src/commands/native/build/build.test.ts",
     "test:doctor": "node scripts/run-ts-test.js src/commands/native/doctor/doctor.test.ts",
-    "test:agent-contract": "npm run test:login && npm run test:auth && npm run test:capabilities && npm run test:test-account && npm run test:upload-preview && npm run test:check && npm run test:check-ai && npm run test:build-structured && npm run test:doctor && npm run test:dev-session && npm run test:dev-session-command && npm run test:dev-runtime-event && npm run test:network && npx tsc --noEmit && npm run build && npm run verify:dist-version && npm run verify:agent-contract",
+    "test:agent-contract": "npm run test:login && npm run test:auth && npm run test:capabilities && npm run test:test-account && npm run test:upload-preview && npm run test:preview-page && npm run test:check && npm run test:check-ai && npm run test:build-structured && npm run test:doctor && npm run test:dev-session && npm run test:dev-session-command && npm run test:dev-runtime-event && npm run test:network && npx tsc --noEmit && npm run build && npm run test:preview-page-process && npm run test:preview-page-detached && npm run verify:dist-version && npm run verify:agent-contract",
     "test:agent-contract:full": "npm run test:agent-contract && npm run test:dev-default-process && npm run test:dev-game-ready-process",
     "publish:beta": "npm publish --registry=https://registry.npmjs.org/ --access public --tag beta",
     "setup": "node scripts/setup.js",