@ttmg/cli 0.4.6-vibe-beta.15 → 0.4.6-vibe-beta.17

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttmg/cli",
-  "version": "0.4.6-vibe-beta.15",
+  "version": "0.4.6-vibe-beta.17",
   "description": "TikTok Mini Game Command Line Tool",
   "license": "ISC",
   "bin": {
@@ -17,7 +17,7 @@
   "scripts": {
     "demo:vibe": "npm run build && node scripts/vibe-upload-demo.js",
     "test:game-categories": "node scripts/run-ts-test.js src/commands/common/game/categories.test.ts",
-    "test:vibe": "npm run test:game-categories && node scripts/run-ts-test.js src/commands/common/vibe/vibe.test.ts",
+    "test:vibe": "npm run test:game-categories && node scripts/run-ts-test.js src/commands/common/vibe/vibe.test.ts && node scripts/run-ts-test.js src/commands/common/vibe/preview.test.ts",
     "test:vibe-process": "node scripts/vibe-upload-smoke.js",
     "prepack": "npm run build && npm run verify:dist-version && npm run verify:agent-contract",
     "build": "node scripts/build.js",

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

@@ -133,7 +133,8 @@ assert.equal(categoryCatalog.platformWrite, false);
 assert.equal(categoryCatalog.categoryCount, 12);
 assert.equal(categoryCatalog.subcategoryCount, 114);
 assert.equal(capabilities.commands.gameCategories.catalogVersion, categoryCatalog.catalogVersion);
-assert.match(capabilities.commands.vibeUpload.command, /--vibe --web/);
+assert.match(capabilities.commands.vibeUpload.command, /--vibe --dir/);
+assert.equal(capabilities.commands.vibeUpload.webAuthorization.available, false);
 assert.equal(capabilities.commands.vibeUpload.skillWorkflow.keepUploadProcessRunning, true);
 assert.equal(capabilities.commands.vibeUpload.skillWorkflow.realUploadSuccess.simulation, false);
 assert.equal(capabilities.commands.vibeUpload.appInfoFields.defaultedByCli.includes('privacy_policy'), true);
@@ -400,7 +401,7 @@ const uploadHelp = runCli(['upload', '--help']);
 assert.doesNotMatch(uploadHelp.stdout, /--app-info/);
 assert.match(uploadHelp.stdout.replace(/\s+/g, ' '), /only title and icon|只收集标题和头像/);
 assertExit(uploadHelp, 0, 'upload help');
-assert.match(uploadHelp.stdout, /--vibe --web --dir/);
+assert.match(uploadHelp.stdout, /--vibe --dir/);
 assert.match(uploadHelp.stdout, /authorizationOpenCommand/);
 assert.match(uploadHelp.stdout, /simulation=false/);
 assert.match(uploadHelp.stdout, /--category <category>/);

package/dist/scripts/vibe-ppe-test-preload.cjs

@@ -10,7 +10,7 @@ https.request = (options, callback) => {
   assert.equal(typeof options, 'object');
   assert.equal(options.hostname, 'developers.tiktok.com');
   assert.equal(options.protocol, 'https:');
-  assert.match(options.path, /^\/bff\/app_info\/minis_import\/(create_minis_import_task_for_agent|get_minis_import_task_status_for_agent|upload_minis_import_app_icon_for_agent|submit_minis_import_info_for_agent|upload_minis_import_package_for_agent)\//);
+  assert.match(options.path, /^\/bff\/app_info\/minis_import\/(create_minis_import_task_for_agent|get_minis_import_task_detail_for_agent|upload_minis_import_app_icon_for_agent|submit_minis_import_info_for_agent|upload_minis_import_package_for_agent)\//);
   const request = http.request({
     ...options,
     protocol: 'http:', hostname: '127.0.0.1', host: undefined, port,

package/dist/scripts/vibe-upload-smoke.js

@@ -145,10 +145,10 @@ async function main() {
   }
   const launches = fs.readFileSync(browserReceipt, 'utf8').trim().split('\n').map(JSON.parse);
   assert.equal(launches.length, 2);
-  assert.ok(launches.every(item => item.args.includes(ready.url + '/authorize')));
+  assert.ok(launches.every(item => item.args.includes(ready.url)));
   const redirect = await fetch(ready.url + '/authorize', {redirect: 'manual'});
-  assert.equal(redirect.headers.get('location'), landing);
-  assert.equal(redirect.status, 302);
+  assert.equal(redirect.headers.get('location'), null);
+  assert.equal(redirect.status, 410);
   rendered = workerMessage(message => message.type === 'rendered' && message.id === 2);
   authWorker.send({type: 'render', id: 2, html: '<h1>Complete</h1>'});
   await rendered;
@@ -171,7 +171,7 @@ async function main() {
     for await (const chunk of req) chunks.push(chunk);
     const body = Buffer.concat(chunks);
     const create = url.pathname.endsWith('/create_minis_import_task_for_agent/');
-    const status = url.pathname.endsWith('/get_minis_import_task_status_for_agent/');
+    const status = url.pathname.endsWith('/get_minis_import_task_detail_for_agent/');
     const iconUpload = url.pathname.endsWith('/upload_minis_import_app_icon_for_agent/');
     const infoUpload = url.pathname.endsWith('/submit_minis_import_info_for_agent/');
     const packageUpload = url.pathname.endsWith('/upload_minis_import_package_for_agent/');
@@ -217,7 +217,11 @@ async function main() {
     } : iconUpload ? {icon_uri: 'web-icon-receipt'}
       : infoUpload ? {}
       : packageUpload ? {status: 3, package_uri: 'web-package-receipt'}
-      : { status: webMode && webPolls >= 5 ? 2 : 1, ready_for_input: webMode && webPolls >= 5 };
+      : { status: webMode && webPolls > 5 ? 6 : webMode && webPolls === 5 ? 2 : 1,
+          ready_for_input: webMode && webPolls === 5,
+          ...(webMode && webPolls >= 7 ? { preview_url: 'https://www.tiktok.com/minis/process-preview',
+            app_id: '7686101169281894417', code_asset_id: '7686101169281894418',
+            client_key: 'process-client', minis_center_history_id: '7686101169281894419' } : {}) };
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ ...data, error_info: { code: (failStatus && status) || url.pathname === webFailureEndpoint ? 420500 : 0 } }));
   });
@@ -306,7 +310,7 @@ async function main() {
         task_id: '7684370037737619477', import_token: 'receipt-test-secret',
         landing_url: 'https://example.invalid/auth', poll_interval_seconds: 0.01,
       },
-      get_minis_import_task_status_for_agent: { status: 2, ready_for_input: true },
+      get_minis_import_task_detail_for_agent: { status: 2, ready_for_input: true, preview_url: 'https://www.tiktok.com/minis/receipt-preview' },
       upload_minis_import_app_icon_for_agent: { icon_uri: 'test-icon' },
       submit_minis_import_info_for_agent: {},
       upload_minis_import_package_for_agent: { status: 2, package_uri: 'test-package' },
@@ -328,9 +332,10 @@ async function main() {
     assert.equal(savedFinal.taskStatusRaw, 2);
     assert.equal(savedEvents.filter(e => e.terminal).length, 1);
     assert.deepEqual(uploadPaths, [
-      'create_minis_import_task_for_agent', 'get_minis_import_task_status_for_agent',
+      'create_minis_import_task_for_agent', 'get_minis_import_task_detail_for_agent',
       'upload_minis_import_app_icon_for_agent', 'submit_minis_import_info_for_agent',
       'upload_minis_import_package_for_agent',
+      'get_minis_import_task_detail_for_agent',
     ]);
     assert.doesNotMatch(saved.stdout + saved.stderr, /receipt-test-secret|test-package/);
   } finally {
@@ -389,7 +394,7 @@ async function main() {
 
   const beforeWeb = requests.length;
   const webConflict = await run([...input, '--web', '--mock', '--format', 'json']);
-  assert.equal(events(webConflict)[0].errorCode, 'VIBE_WEB_OPTION_CONFLICT');
+  assert.equal(events(webConflict)[0].errorCode, 'VIBE_WEB_DISABLED');
   const legacyWeb = await run(['upload', '--web', '--format', 'json']);
   assert.equal(events(legacyWeb)[0].errorCode, 'VIBE_OPTION_REQUIRES_VIBE');
   assert.equal(requests.length, beforeWeb);
@@ -402,7 +407,7 @@ async function main() {
     [['--category', 'Unknown', '--subcategory', 'Other'], 'VIBE_INVALID_CATEGORY'],
     [['--category', '', '--subcategory', ''], 'VIBE_INVALID_CATEGORY'],
   ]) {
-    const invalid = await run([...input.filter(v => v !== '--no-open'), '--web', ...args, '--format', 'json']);
+    const invalid = await run([...input, ...args, '--format', 'json']);
     assert.equal(invalid.code, 1);
     const result = events(invalid)[0];
     assert.equal(result.errorCode, code);
@@ -412,36 +417,46 @@ async function main() {
   }
   assert.equal(requests.length, beforeWeb, 'Invalid metadata must not create tasks or upload');
   webMode = true;
+  for (const authorizationMode of ['qr']) {
   for (const format of ['json', 'ndjson']) {
     expectedWebDescription = format === 'json' ? 'Discover the fun of TikTok Mini Games.' : 'Stack cats on a rooftop 🐈';
     const descriptionArgs = format === 'json' ? [] : ['--description', expectedWebDescription];
     expectedWebCategory = format === 'json' ? {category: 'Other', subcategory: 'Other'} : {category: 'Puzzle', subcategory: 'Physics'};
     const categoryArgs = format === 'json' ? [] : ['--category', 'Puzzle', '--subcategory', 'Physics'];
-    const receipt = path.join(temp, `upload-web-${format}.ndjson`);
+    const receipt = path.join(temp, `upload-${authorizationMode}-${format}.ndjson`);
     const requestStart = requests.length;
-    const web = await run([...input.filter(v => v !== '--no-open'), '--web', ...categoryArgs, ...descriptionArgs, '--format', format, '--poll-interval', '0.2'], async event => {
+    const web = await run([...input.filter(v => v !== '--no-open'), ...(authorizationMode === 'web' ? ['--web'] : []), ...categoryArgs, ...descriptionArgs, '--format', format, '--poll-interval', '0.2'], async event => {
       if (event.status === 'prepared') assert.equal(event.description, expectedWebDescription);
       if (event.status === 'prepared') assert.deepEqual(
         {category: event.classification.category, subcategory: event.classification.subcategory},
         expectedWebCategory);
       if (event.status === 'waiting_authorization') {
-        assert.equal(event.authorizationMode, 'web');
+        assert.equal(event.authorizationMode, authorizationMode);
         assert.equal(event.browserOpenRequested, true);
         assert.equal(event.simulation, false);
-        assert.equal(event.nextAction, 'open_browser');
-        assert.equal(event.qrPurpose, undefined);
+        assert.equal(event.nextAction, authorizationMode === 'web' ? 'open_browser' : 'scan_qr');
+        assert.equal(event.qrPurpose, authorizationMode === 'web' ? undefined : 'authorization_binding');
         const response = await fetch(event.pageUrl + '/authorize', {redirect: 'manual'});
-        assert.equal(response.status, 302);
-        assert.match(response.headers.get('location'), /^https:\/\/developers\.tiktok\.com\/portal_h5\/minis_import\?/);
+        assert.equal(response.status, 410);
+        assert.equal(response.headers.get('location'), null);
         const html = await (await fetch(event.pageUrl)).text();
-        assert.match(html, /Authorize in your browser/);
-        assert.doesNotMatch(html, /alt="Authorization QR"|Scan the QR code/);
+        assert.ok(html.includes(expectedWebDescription));
+        assert.ok(html.includes(expectedWebCategory.category));
+        assert.ok(html.includes(expectedWebCategory.subcategory));
+        assert.doesNotMatch(html, /<header class="brand"/);
+        if (authorizationMode === 'web') {
+          assert.match(html, /Authorize in your browser/);
+          assert.doesNotMatch(html, /alt="Authorization QR"|Scan the QR code/);
+        } else {
+          assert.match(html, /alt="Authorization QR"/);
+          assert.match(html, /data:image\/png;base64/);
+        }
       }
     }, {
       NODE_OPTIONS: env.NODE_OPTIONS + ' --require=' + path.join(__dirname, 'vibe-auth-open-test-preload.cjs'),
       TTMG_AUTH_OPEN_TEST_RECEIPT: receipt,
       // Explicit --web must not inherit an old Mock backend setting.
-      TTMG_VIBE_BACKEND: 'mock',
+      TTMG_VIBE_BACKEND: authorizationMode === 'web' ? 'mock' : '',
       TTMG_VIBE_TEST_RETAIN_UPLOAD_SOCKET: '1',
     });
     assert.equal(web.code, 0, web.stderr);
@@ -458,24 +473,35 @@ async function main() {
     assert.equal(output.at(-1).classification.source, format === 'json' ? 'defaults' : 'arguments');
     assert.equal(output.at(-1).description, expectedWebDescription);
     assert.equal(output.at(-1).descriptionSource, format === 'json' ? 'defaults' : 'arguments');
-    assert.equal(output.at(-1).taskStatusRaw, 3);
+    assert.equal(output.at(-1).taskStatusRaw, 6);
+    assert.equal(output.at(-1).previewReady, true);
+    assert.equal(output.at(-1).previewUrl, 'https://www.tiktok.com/minis/process-preview');
+    assert.equal(output.at(-1).codeAssetId, '7686101169281894418');
+    assert.equal(output.at(-1).qrPurpose, 'game_preview');
+    const readyPage = await (await fetch(output.at(-1).pageUrl)).text();
+    assert.match(readyPage, /Game preview QR/);
+    assert.match(readyPage, /data-phase="preview"/);
     assert.equal(output.filter(e => e.terminal).length, 1);
-    assert.equal(webPolls, 5, 'Only true backend readiness unlocks authorization');
+    assert.equal(webPolls, 7, 'Keep polling the same task until preview URL is available');
     assert.deepEqual(requests.slice(requestStart).map(r => r.path.split('/').filter(Boolean).at(-1)), [
-      'create_minis_import_task_for_agent', ...Array(5).fill('get_minis_import_task_status_for_agent'),
+      'create_minis_import_task_for_agent', ...Array(5).fill('get_minis_import_task_detail_for_agent'),
       'upload_minis_import_app_icon_for_agent', 'submit_minis_import_info_for_agent', 'upload_minis_import_package_for_agent',
+      'get_minis_import_task_detail_for_agent', 'get_minis_import_task_detail_for_agent',
     ]);
     if (format === 'json') assert.equal(output.length, 1);
     const opens = fs.readFileSync(receipt, 'utf8').trim().split('\n').map(line => JSON.parse(line));
     assert.equal(opens.length, 1);
-    assert.ok(opens[0].args.some(arg => /^http:\/\/127\.0\.0\.1:\d+\/[a-f0-9]{48}\/authorize$/.test(arg)));
+    assert.ok(opens[0].args.some(arg => (authorizationMode === 'web'
+      ? /^http:\/\/127\.0\.0\.1:\d+\/[a-f0-9]{48}\/authorize$/
+      : /^http:\/\/127\.0\.0\.1:\d+\/[a-f0-9]{48}$/).test(arg)));
     assert.doesNotMatch(JSON.stringify(opens) + web.stdout + web.stderr, /process-test-secret|import_token|web-icon-receipt|web-package-receipt|aweme:\/\//);
   }
+  }
   expectedWebCategory = {category: 'Other', subcategory: 'Other'};
   expectedWebDescription = 'Discover the fun of TikTok Mini Games.';
   webFailureEndpoint = '/bff/app_info/minis_import/submit_minis_import_info_for_agent/';
   const failedStart = requests.length;
-  const webUploadFailure = await run([...input.filter(v => v !== '--no-open'), '--web', '--format', 'json'], undefined, {
+  const webUploadFailure = await run([...input.filter(v => v !== '--no-open'), '--format', 'json'], undefined, {
     NODE_OPTIONS: env.NODE_OPTIONS + ' --require=' + path.join(__dirname, 'vibe-auth-open-test-preload.cjs'),
     TTMG_AUTH_OPEN_TEST_RECEIPT: path.join(temp, 'web-failure-open.ndjson'),
     TTMG_VIBE_TEST_RETAIN_UPLOAD_SOCKET: '1',
@@ -600,7 +626,9 @@ async function main() {
   assert.equal(events(projectRun)[0].status, 'prepared');
   assert.ok(events(projectRun)[0].packageSizeBytes > 0);
 
-  const missingBackend = await run([...input, '--format', 'json']);
+  const missingBackend = await run([...input, '--format', 'json'], undefined, {
+    TTMG_VIBE_BACKEND: 'unsupported',
+  });
   assert.equal(missingBackend.code, 1);
   assert.equal(
     events(missingBackend)[0].errorCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttmg/cli",
-  "version": "0.4.6-vibe-beta.15",
+  "version": "0.4.6-vibe-beta.17",
   "description": "TikTok Mini Game Command Line Tool",
   "license": "ISC",
   "bin": {
@@ -17,7 +17,7 @@
   "scripts": {
     "demo:vibe": "npm run build && node scripts/vibe-upload-demo.js",
     "test:game-categories": "node scripts/run-ts-test.js src/commands/common/game/categories.test.ts",
-    "test:vibe": "npm run test:game-categories && node scripts/run-ts-test.js src/commands/common/vibe/vibe.test.ts",
+    "test:vibe": "npm run test:game-categories && node scripts/run-ts-test.js src/commands/common/vibe/vibe.test.ts && node scripts/run-ts-test.js src/commands/common/vibe/preview.test.ts",
     "test:vibe-process": "node scripts/vibe-upload-smoke.js",
     "prepack": "npm run build && npm run verify:dist-version && npm run verify:agent-contract",
     "build": "node scripts/build.js",