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

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttmg/cli",
-  "version": "0.4.6-vibe-beta.2",
+  "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",
@@ -80,7 +83,7 @@
     "qs": "6.12.1",
     "semver": "^7.7.2",
     "socks-proxy-agent": "^9.0.0",
-    "ttmg-pack": "0.4.8",
+    "ttmg-pack": "0.4.13-beta.1",
     "ws": "^8.18.3"
   },
   "devDependencies": {

package/dist/scripts/dev-game-ready-smoke.js

@@ -65,8 +65,6 @@ async function run() {
       'dev',
       '--client-key',
       'smoke-client',
-      '--format',
-      'json',
       '--events',
       'ndjson',
       '--no-open',
@@ -98,6 +96,33 @@ async function run() {
     const exitCode = await new Promise(resolve => child.once('close', resolve));
     assert.equal(exitCode, 0, stderr || stdout);
 
+    const stdoutEvents = stdout
+      .trim()
+      .split(/\r?\n/)
+      .filter(Boolean)
+      .map(line => JSON.parse(line));
+    assert.ok(stdoutEvents.length > 0, 'dev did not emit NDJSON events');
+    assert.equal(
+      stdoutEvents.every(
+        event =>
+          event.schemaVersion === '1' &&
+          typeof event.sessionId === 'string' &&
+          Number.isInteger(event.seq) &&
+          typeof event.type === 'string',
+      ),
+      true,
+      'dev stdout contained a non-event JSON object',
+    );
+    assert.equal(
+      stdoutEvents.some(
+        event =>
+          event.type === 'lifecycle' &&
+          event.payload?.state === 'GAME_READY',
+      ),
+      true,
+      'dev stdout did not contain the GAME_READY event',
+    );
+
     const events = fs
       .readFileSync(path.join(evidenceDirectory, 'events.ndjson'), 'utf8')
       .trim()

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

@@ -94,11 +94,86 @@ assert.equal(
 );
 assert.equal(capabilities.commands.build.platformWrite, false);
 assert.equal(capabilities.commands.dev.platformWrite, false);
+assert.equal(
+  capabilities.commands.dev.command,
+  'ttmg dev --format json --no-open',
+);
+assert.equal(
+  capabilities.commands.dev.eventsCommand,
+  'ttmg dev --events ndjson --no-open',
+);
+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');
 
+const conflictingDevOutput = runCli([
+  'dev',
+  '--format',
+  'json',
+  '--events',
+  'ndjson',
+  '--no-open',
+]);
+assertExit(conflictingDevOutput, 1, 'conflicting dev output modes');
+assert.equal(
+  conflictingDevOutput.stdout,
+  '',
+  'conflicting dev output modes must not write protocol data to stdout',
+);
+assert.match(
+  conflictingDevOutput.stderr,
+  /output modes cannot be combined|输出模式不能同时使用/,
+);
+
 const checkHelp = runCli(['check', '--help']);
 assertExit(checkHelp, 0, 'check help');
 assert.match(checkHelp.stdout, /Usage: ttmg check \[options\]/);
@@ -115,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.2",
+  "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",
@@ -80,7 +83,7 @@
     "qs": "6.12.1",
     "semver": "^7.7.2",
     "socks-proxy-agent": "^9.0.0",
-    "ttmg-pack": "0.4.8",
+    "ttmg-pack": "0.4.13-beta.1",
     "ws": "^8.18.3"
   },
   "devDependencies": {