// The teaser video (media/teaser, v8, a story): every CLI line it shows is real output of the command it names, the game // screens and screenshot tiles are the demo game's own, every desktop frame is a real capture of the app (desktop.ts), // every cut lands on a beat of the music, each caption is short and fully on screen for at least 2.5 s, the whole cut is // 56-62 s, and it is 16:9 only. import { afterAll, beforeAll, describe, expect, test } from 'bun:test'; import { generateKeyPairSync } from 'node:crypto'; import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'; import { tmpdir } from 'node:os'; import { dirname, join } from 'node:path'; import { ALPHA3 } from '../cli/lib/money'; import { SIZES } from '../cli/shots/lib'; const ROOT = join(import.meta.dir, '..'); const CLI = join(ROOT, 'cli', 'index.ts'); const FX = join(import.meta.dir, 'fixtures', 'scan'); const MOCK = join(import.meta.dir, 'helpers', 'teaser-store-mock.ts'); interface Scene { id: string; start: number; end: number; x: number } type Line = { at: number; text: string; cmd?: boolean; head?: boolean; final?: boolean }; interface Teaser { FORMAT: { w: number; h: number }; DURATION: number; SCENES: Scene[]; MONTAGE: string[]; CAPTIONS: { id: string; pos: 'top' | 'edge'; text: string; at: number; until: number }[]; captionTimes(): { id: string; text: string; pos: string; at: number; from: number; to: number; gone: number; hold: number }[]; veil(t: number): number; GAME_SCREENS: string[]; PRIVACY_ANSWERS: string[]; PRIVACY_STEPS: string[]; DATA_SAFETY_CSV: string[]; DECL_TOTAL: number; PRICE_ROWS: string[]; PRICE_CMD: string; PILE: { at: number; kind: string }[]; PILE_TITLES: Record; REJECT: { head: string; at: string }; PROMPT: string; BUILD_LINES: Line[]; SHOT_SIZES: { id: string }[]; SHOT_LANGS: string[]; PRODUCT_LINES: Line[]; DECL_LINES: { what: string; value: string; where: string }[]; DECL_ASK: string; CONSOLE_CMD: string; CONSOLE_LINES: Line[]; CONSOLES_SWAP: number[]; SCAN_CMD: string; RISKS_LINE: string; RESCAN_LINE: string; FINDINGS: string[]; FIX_AT: number[]; DESK: Record; DESK_SCENES: string[]; DESK_FRAMES: string[]; CLICK_T: number; END: { markAt: number; wordAt: number; lineAt: number; urlAt: number; d: number }; END_LINE: string; END_URL: string; } const T = (await import(join(ROOT, 'media/teaser/script.js'))) as Teaser; /** Output lines without the clock prefix and the "(0s)" timer, as the video shows them. */ const lines = (out: string): string[] => out.split('\n').map(l => l.replace(/^\d\d:\d\d:\d\d /, '').replace(/ \(\d+s\)$/, '').trimEnd()); const run = (argv: string[], cwd: string, env: Record = {}): { code: number; out: string } => { const r = Bun.spawnSync(['bun', CLI, ...argv], { cwd, env: { ...process.env, NO_COLOR: '1', ASC_KEY_ID: '', ASC_ISSUER_ID: '', ASC_P8: '', PLAY_SERVICE_ACCOUNT: '', ...env }, stdout: 'pipe', stderr: 'pipe' }); return { code: r.exitCode, out: r.stdout.toString() + r.stderr.toString() }; }; /** Every line is in the output, in the given order. */ function inOrder(out: string[], want: string[]): void { for (const l of want) expect(out, l).toContain(l); const idx = want.map(l => out.indexOf(l)); expect([...idx].sort((a, b) => a - b)).toEqual(idx); } // One throwaway project: `storebound init` in an empty folder plus two products, store answers from the teaser store // double (tests/helpers/teaser-store-mock.ts, preloaded through bunfig.toml), placeholder keys. let dir = '', keys: Record = {}; beforeAll(() => { dir = mkdtempSync(join(tmpdir(), 'sb-teaser-')); expect(run(['init'], dir).code).toBe(0); const cfg = join(dir, 'storebound.config.ts'); writeFileSync(cfg, readFileSync(cfg, 'utf8').replace(' dataSafety: {', ` products: [ { id: 'com.example.app.no_ads', type: 'non_consumable', usd: 2.99, listings: { en: { title: 'No Ads', description: 'Removes every ad.' }, tr: { title: 'Reklamsız', description: 'Tüm reklamları kaldırır.' } } }, { id: 'com.example.app.gems_100', type: 'consumable', usd: 0.99, listings: { en: { title: '100 Gems', description: 'A pouch of 100 gems.' }, tr: { title: '100 Mücevher', description: '100 mücevherlik bir kese.' } } }, ], dataSafety: {`)); writeFileSync(join(dir, 'bunfig.toml'), `preload = [${JSON.stringify(MOCK)}]\n`); const ec = generateKeyPairSync('ec', { namedCurve: 'P-256' }).privateKey.export({ type: 'pkcs8', format: 'pem' }).toString(); const rsa = generateKeyPairSync('rsa', { modulusLength: 2048 }).privateKey.export({ type: 'pkcs8', format: 'pem' }).toString(); writeFileSync(join(dir, 'k.p8'), ec); writeFileSync(join(dir, 'sa.json'), JSON.stringify({ client_email: 'sb@example.com', private_key: rsa, token_uri: 'https://oauth2.googleapis.com/token' })); keys = { ASC_KEY_ID: 'ABCDE12345', ASC_ISSUER_ID: '00000000-0000-0000-0000-000000000000', ASC_P8: join(dir, 'k.p8'), PLAY_SERVICE_ACCOUNT: join(dir, 'sa.json') }; }); afterAll(() => rmSync(dir, { recursive: true, force: true })); describe('teaser: every CLI line is real output', () => { test('pile + consoles: `storebound console plan apple-app-privacy` (offline): answer sheet, steps, never-press, the owner\'s Publish', () => { expect(T.CONSOLE_CMD).toBe('storebound console plan apple-app-privacy'); const r = run(T.CONSOLE_CMD.split(' ').slice(1), dir); expect(r.code).toBe(0); const out = lines(r.out); inOrder(out, T.PRIVACY_ANSWERS); inOrder(out, T.PRIVACY_STEPS); inOrder(out, T.CONSOLE_LINES.map(l => l.text)); const fin = T.CONSOLE_LINES.find(l => l.final)!; expect(fin.text).toBe("Final button (the owner's): Publish"); expect(T.CONSOLE_LINES.find(l => l.text.startsWith('Never press:'))!.text).toContain('"Publish"'); }); test('pile: the Data safety CSV of `storebound play data-safety --dry`, its row count from `storebound check`', () => { const r = run(['play', 'data-safety', '--dry'], dir); expect(r.code).toBe(0); inOrder(lines(r.out), T.DATA_SAFETY_CSV); expect(run(['check'], dir).out).toContain(`data safety: ${T.DECL_TOTAL} CSV rows`); expect(T.PILE_TITLES.csv).toContain(`${T.DECL_TOTAL} rows`); }); test('pile: the price sheet of `storebound prices ppp --offline --dry`', () => { const r = run(T.PRICE_CMD.split(' '), dir); expect(r.code).toBe(0); inOrder(lines(r.out), T.PRICE_ROWS); }); test('builds: `storebound apple build --dry` and `storebound play build --dry` in a Capacitor project', () => { const d = mkdtempSync(join(tmpdir(), 'sb-teaser-build-')); try { const touch = (p: string, s = '') => { mkdirSync(dirname(join(d, p)), { recursive: true }); writeFileSync(join(d, p), s); }; touch('storebound.config.ts', `export default { app: { name: 'Example', privacyPolicyUrl: 'https://example.com/p', supportUrl: 'https://example.com', website: 'https://example.com', contactEmail: 'hi@example.com' }, languages: [{ id: 'en', apple: 'en-US', play: 'en-US' }], apple: { bundleId: 'com.example.game', signing: { teamId: 'TEAMID1234' } }, play: { packageName: 'com.example.game' } };\n`); touch('capacitor.config.ts', 'export default {}'); touch('ios/App/App.xcodeproj/project.pbxproj'); touch('android/settings.gradle'); touch('android/gradlew', '#!/bin/sh'); touch('android/app/build.gradle', "android {\n defaultConfig {\n versionCode((project.findProperty('versionCode') ?: 1) as Integer)\n versionName project.findProperty('versionName') ?: '1.0'\n }\n}\n"); const cmds = T.BUILD_LINES.filter(l => l.cmd).map(l => l.text.replace(/^\$ storebound /, '')); expect(cmds).toEqual(['apple build --dry --build-number 52 --version 1.0.0', 'play build --dry --version-code 52']); const outs = cmds.map(c => run(c.split(' '), d, { HOME: join(d, 'home') })); for (const o of outs) expect(o.code).toBe(0); // each command's lines in its own output, in order const groups: string[][] = []; for (const l of T.BUILD_LINES) if (l.cmd) groups.push([]); else groups.at(-1)!.push(l.text); groups.forEach((g, i) => { const out = lines(outs[i]!.out); for (const l of g) expect(out, l).toContain(l); expect(out.indexOf(g[0]!)).toBeLessThan(out.lastIndexOf(g.at(-1)!)); }); } finally { rmSync(d, { recursive: true, force: true }); } }); test('products: `play products --dry` before, `catalog diff` after, with the two products in the config', () => { const cmds = T.PRODUCT_LINES.filter(l => l.cmd).map(l => l.text.replace(/^\$ storebound /, '')); expect(cmds).toEqual(['play products --dry', 'catalog diff']); const before = run(cmds[0]!.split(' '), dir, { ...keys, TEASER_STORE: 'new' }); const after = run(cmds[1]!.split(' '), dir, { ...keys, TEASER_STORE: 'catalog' }); expect(before.code).toBe(0); expect(after.code).toBe(0); const out = [...lines(before.out), ...lines(after.out)]; for (const l of T.PRODUCT_LINES.filter(x => !x.cmd)) expect(out, l.text).toContain(l.text); // "175 countries": the App Store's storefronts, the region prices shown expect(Object.keys(ALPHA3)).toHaveLength(175); expect(T.PRODUCT_LINES.some(l => l.text.includes('175 region prices'))).toBe(true); expect(T.CAPTIONS.find(c => c.id === 'products')!.text).toBe('Products, 175 countries.'); expect(out.join('\n')).toContain('0 mismatch(es), 0 warning(s), 0 price difference(s)'); }); }); describe('teaser: the scan text is real', () => { const scanText = (fixture: string, demo: boolean): string => { const env = { REVIEW_DEMO_USER: demo ? 'demo@example.com' : '', REVIEW_DEMO_PASSWORD: demo ? 'example' : '' }; const r = run(['scan', '--dir', join(FX, fixture)], ROOT, env); expect(r.code).toBe(demo ? 0 : 1); // exit 1 on blockers (before the fixes) return r.out; }; let before = '', after = ''; beforeAll(() => { before = scanText('teaser', false); after = scanText('teaser-fixed', true); }); test('reject: the account-deletion finding, its own header and evidence line', () => { const out = lines(before); expect(out).toContain(` 2. ${T.REJECT.head}`); expect(out).toContain(` ${T.REJECT.at}`); expect(T.REJECT.head).toContain('5.1.1(v)'); }); test('scan: the risks line, all five findings in order, and the clean re-scan of teaser-fixed', () => { expect(T.SCAN_CMD).toBe('storebound scan'); const out = lines(before); expect(out).toContain(T.RISKS_LINE); inOrder(out, T.FINDINGS.map((f, i) => ` ${i + 1}. ${f}`)); expect(T.FIX_AT).toHaveLength(T.FINDINGS.length); expect(after).toContain(T.RESCAN_LINE); }); test('forms: the declarations proposal lines and the ask-owner line', () => { for (const d of T.DECL_LINES) expect(before).toContain(`detected ${d.what}: ${d.value}`); for (const d of T.DECL_LINES) expect(before).toContain(`(${d.where})`); expect(before).toContain(T.DECL_ASK); }); }); describe('teaser: the game and its screenshots are the demo game\'s', () => { test('game: the screens are the demo game\'s own captures (its config\'s capture shots)', async () => { const cfg = (await import(join(ROOT, 'examples/demo-game/storebound.config.ts'))).default as { languages: { id: string }[]; shots: { capture: { shots: Record } } }; expect(T.GAME_SCREENS).toEqual(Object.keys(cfg.shots.capture.shots)); expect(T.SHOT_LANGS).toEqual(cfg.languages.map(l => l.id)); const render = readFileSync(join(ROOT, 'media/teaser/render.ts'), 'utf8'); expect(render).toContain("'examples/demo-game/store/shots/frames/en/phone'"); }); test('shots: seven store sizes the demo game renders (iPhone, iPad, Play phone and tablets, feature graphic)', () => { for (const s of T.SHOT_SIZES) expect(SIZES[s.id], s.id).toBeDefined(); expect(T.SHOT_SIZES).toHaveLength(7); // the caption claims sizes, not a language count the demo does not have expect(T.CAPTIONS.find(c => c.id === 'shots')!.text).toBe('Screenshots, every size.'); }); test('ask: the request is a plain sentence to the agent', () => { expect(T.PROMPT).toBe('Get this game ready for review on both stores.'); }); }); describe('teaser: timing and format', () => { test('16:9 only: the master is 1920x1080; the pipeline has no vertical output', () => { expect(T.FORMAT).toEqual({ w: 1920, h: 1080 }); const render = readFileSync(join(ROOT, 'media/teaser/render.ts'), 'utf8'); expect(render).not.toMatch(/1080\s*x\s*1920|w: 1080, h: 1920|vertical/i); expect(render).toContain('scale=1280:720'); }); test('the story: nine beats in order, the montage in the middle, 56-62 s', () => { expect(T.SCENES.map(s => s.id)).toEqual(['game', 'pile', 'reject', 'ask', 'builds', 'shots', 'products', 'forms', 'consoles', 'scan', 'button', 'waiting', 'end']); expect(T.MONTAGE).toEqual(['builds', 'shots', 'products', 'forms', 'consoles']); expect(T.DURATION).toBe(T.SCENES.at(-1)!.end); expect(T.DURATION).toBeGreaterThanOrEqual(56); expect(T.DURATION).toBeLessThanOrEqual(62); // the montage spans 19-37 s and speeds up (no beat longer than the one before) const m = T.MONTAGE.map(id => T.SCENES.find(s => s.id === id)!); expect(m[0]!.start).toBe(19); expect(m.at(-1)!.end).toBe(37); for (let i = 1; i < m.length; i++) expect(m[i]!.end - m[i]!.start).toBeLessThanOrEqual(m[i - 1]!.end - m[i - 1]!.start); for (const s of m) expect(s.x, s.id).toBeLessThanOrEqual(0.15); // cuts, not dissolves }); test('every cut lands on a beat of music.js (120 BPM: whole half seconds), scenes 3-6 s', () => { const music = readFileSync(join(ROOT, 'media/teaser/music.js'), 'utf8'); expect(music).toContain('export const STEP = 0.5;'); expect(T.SCENES[0]!.start).toBe(0); for (let i = 1; i < T.SCENES.length; i++) expect(T.SCENES[i]!.start).toBe(T.SCENES[i - 1]!.end); for (const s of T.SCENES) { expect(Number.isInteger(s.start / 0.5), s.id).toBe(true); expect(s.end - s.start, s.id).toBeGreaterThanOrEqual(3); expect(s.end - s.start, s.id).toBeLessThanOrEqual(6); } // the fixes chime on beats too const scan = T.SCENES.find(s => s.id === 'scan')!; for (const f of T.FIX_AT) expect(Number.isInteger((scan.start + f) / 0.5), String(f)).toBe(true); }); test('captions: at most one short line per scene, fully on screen for at least 2.5 s, inside its scene', () => { const c = T.captionTimes(); expect(new Set(c.map(x => x.id)).size).toBe(c.length); for (const x of c) { const s = T.SCENES.find(y => y.id === x.id)!; expect(x.hold, x.text).toBeGreaterThanOrEqual(2.5); expect(x.at, x.text).toBeGreaterThanOrEqual(s.start); expect(x.gone, x.text).toBeLessThanOrEqual(s.end); expect(x.text.split(' ').length, x.text).toBeLessThanOrEqual(8); } // the montage words sit at the edge, the story lines at the top; the click and the end card carry no caption for (const x of c) expect(x.pos, x.id).toBe(T.MONTAGE.includes(x.id) ? 'edge' : 'top'); expect(c.map(x => x.id)).not.toContain('waiting'); expect(c.map(x => x.id)).not.toContain('end'); expect(c.map(x => x.text)).toEqual(['The game is done.', 'Then come the stores.', 'One missing line, and you start over.', 'So I handed it all to my AI.', 'Builds.', 'Screenshots, every size.', 'Products, 175 countries.', 'Forms.', 'Consoles.', 'Nothing left for a reviewer to catch.', 'One button is yours.']); }); test('the end card: the two lines on screen for at least 2.5 s', () => { const e = T.SCENES.find(s => s.id === 'end')!; expect(T.END_LINE).toBe('From an empty folder to Submit.'); expect(T.END_URL).toBe('Open source · storebound.dev'); expect(e.end - e.start - T.END.urlAt - T.END.d).toBeGreaterThanOrEqual(2.5); }); test('the picture darkens over the rejection and lifts on the drop', () => { const r = T.SCENES.find(s => s.id === 'reject')!, b = T.SCENES.find(s => s.id === 'builds')!; expect(T.veil(r.start)).toBe(0); expect(T.veil(r.end - 0.1)).toBeGreaterThan(0.5); expect(T.veil(b.start)).toBe(0); }); test('the pile speeds up: each card lands sooner after the one before', () => { for (let i = 2; i < T.PILE.length; i++) expect(T.PILE[i]!.at - T.PILE[i - 1]!.at).toBeLessThanOrEqual(T.PILE[i - 1]!.at - T.PILE[i - 2]!.at + 1e-9); }); }); // The desktop frames: the real app (fixture mode) in the consoles beat, the button and the waiting scene, captured by // media/teaser/desktop.ts. The frames are gitignored output; the file checks run wherever they were captured // (render.ts captures them when they are missing). const DESK_DIR = join(ROOT, 'media/teaser/out/desktop'); const captured = existsSync(join(DESK_DIR, 'boxes.json')); /** Width and height of a JPEG (its first SOF marker). */ function jpegSize(buf: Buffer): { w: number; h: number } | null { if (buf[0] !== 0xff || buf[1] !== 0xd8) return null; for (let i = 2; i + 9 < buf.length;) { if (buf[i] !== 0xff) { i++; continue; } const m = buf[i + 1]!; if (m >= 0xc0 && m <= 0xcf && m !== 0xc4 && m !== 0xc8 && m !== 0xcc) return { w: buf.readUInt16BE(i + 7), h: buf.readUInt16BE(i + 5) }; i += 2 + buf.readUInt16BE(i + 2); } return null; } describe('teaser: the desktop scenes are real captures of the app', () => { test('consoles, the button and the click: the plan panel, Send for review, then Waiting for review', () => { expect(T.DESK_SCENES).toEqual(['consoles', 'button', 'waiting']); expect(T.DESK.consoles!.groups.map(g => g.frame)).toEqual(['console-plan']); expect(T.DESK.consoles!.show).toEqual(T.CONSOLES_SWAP); expect(T.DESK.button!.groups.map(g => g.frame)).toEqual(['submit-ready']); expect(T.DESK.waiting!.groups.map(g => g.frame)).toEqual(['submit-ready', 'submit-waiting']); // the pointer rests on Submit in the button scene and presses it once, at the start of the waiting scene expect(T.DESK.button!.pointer!.target).toBe('submitBtn'); expect(T.DESK.button!.pointer!.click).toBeUndefined(); expect(T.DESK.waiting!.pointer!.target).toBe('submitBtn'); const w = T.SCENES.find(s => s.id === 'waiting')!; expect(T.CLICK_T).toBe(w.start + T.DESK.waiting!.pointer!.click!); expect(T.DESK.waiting!.swap![0]).toBeGreaterThan(T.DESK.waiting!.pointer!.click!); // the waiting scene picks up exactly where the button scene's camera stopped (no jump on the cut) const cam = (id: string) => (T.DESK[id] as unknown as { cam: { from: unknown; to: unknown } }).cam; expect(cam('waiting').from).toEqual(cam('button').to); }); test('the console plan panel shows the real plan; no drawn system dialogs or mails', () => { const src = readFileSync(join(ROOT, 'media/teaser/desktop.ts'), 'utf8'); expect(src).toContain("realConsolePlan('apple-app-privacy')"); expect(src).toContain("['console', 'plan', form, '--json']"); const html = readFileSync(join(ROOT, 'media/teaser/index.html'), 'utf8'); expect(html).not.toMatch(/Submit for Review|id="sbtn"|id="mail"/); }); test('every frame a scene names is one desktop.ts captures from the app (no mock frames)', () => { const src = readFileSync(join(ROOT, 'media/teaser/desktop.ts'), 'utf8'); expect(src).toContain("VITE_FIXTURES: '1'"); for (const f of T.DESK_FRAMES) expect(src, f).toMatch(new RegExp(`shot\\([a-z.]+, '${f}'\\)`)); const js = readFileSync(join(ROOT, 'media/teaser/teaser.js'), 'utf8'); expect(js).toContain('out/desktop/${g.frame}.jpg'); }); test.if(captured)('the captured frames are present: 1280x800 @2x JPEGs, every ring and pointer target captured', () => { const boxes = JSON.parse(readFileSync(join(DESK_DIR, 'boxes.json'), 'utf8')) as Record & { source: string }; expect(boxes.source).toContain('VITE_FIXTURES=1'); for (const f of T.DESK_FRAMES) { const p = join(DESK_DIR, `${f}.jpg`); expect(existsSync(p), p).toBe(true); expect(jpegSize(readFileSync(p)), f).toEqual({ w: 2560, h: 1600 }); } for (const id of T.DESK_SCENES) { for (const c of T.DESK[id]!.rings) expect(boxes[c.target], c.target).toBeDefined(); if (T.DESK[id]!.pointer) expect(boxes[T.DESK[id]!.pointer!.target], id).toBeDefined(); } }); });