@danceiny/gotry 0.0.1-rc.15 → 0.0.1-rc.17

package/dist/scripts/extension-distribution-tests.js

@@ -0,0 +1,341 @@
+import assert from 'node:assert/strict';
+import { execFileSync, spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_RELEASE_BASE, DIST_ASSET_MANIFEST, DIST_ASSET_STORE_ZIP, DIST_ASSET_TARBALL, compareVersions, distAssetUrls, installExtensionFromGithub, parseDistManifest, readExtensionKey, sha256Hex } from '../capabilities/session/extension-distribution.js';
+const repoRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+const EXT_SRC = join(repoRoot, 'extension');
+const EXT_FILES = [
+    'manifest.json',
+    'background.js',
+    'content-main.js',
+    'content-bridge.js',
+    'README.md'
+];
+let passed = 0;
+function ok(cond, label) {
+    if (!cond) {
+        console.error(`  ✗ ${label}`);
+        process.exit(1);
+    }
+    passed += 1;
+    console.log(`  ok - ${label}`);
+}
+{
+    const urls = distAssetUrls();
+    ok(urls.tarball === `${DEFAULT_RELEASE_BASE}/latest/download/${DIST_ASSET_TARBALL}`, `tarball URL 形态(${urls.tarball})`);
+    ok(urls.manifest.endsWith(`/latest/download/${DIST_ASSET_MANIFEST}`), 'manifest URL 形态(latest/download 永久链)');
+    ok(distAssetUrls('https://x.example/releases/').tarball === 'https://x.example/releases/latest/download/gotry-session-bridge.tar.gz', 'releaseBase 尾斜杠归一');
+    const pkgSrc = readFileSync(join(repoRoot, 'scripts', 'package-extension.mjs'), 'utf8');
+    ok(pkgSrc.includes(`const ASSET_TARBALL = '${DIST_ASSET_TARBALL}'`), 'package-extension.mjs tarball 资产名一致');
+    ok(pkgSrc.includes(`const ASSET_STORE_ZIP = '${DIST_ASSET_STORE_ZIP}'`), 'package-extension.mjs store zip 资产名一致');
+    ok(pkgSrc.includes(`const ASSET_MANIFEST = '${DIST_ASSET_MANIFEST}'`), 'package-extension.mjs dist-manifest 资产名一致');
+    ok(pkgSrc.includes("const STAGE = join(OUT, 'gotry-session-bridge')"), '打包根目录名固定 gotry-session-bridge/(下载端 strip-components 依赖)');
+    ok(pkgSrc.includes('delete m.key'), 'store zip 变体剥离 manifest key(2026-08-30 商店首传实测拒绝 key;tar.gz 保留 key 保通道 ID 不变量)');
+}{
+    const good = JSON.stringify({
+        version: '0.1.0',
+        tarball: DIST_ASSET_TARBALL,
+        tarballSha256: 'a'.repeat(64),
+        zip: DIST_ASSET_STORE_ZIP,
+        zipSha256: 'b'.repeat(64)
+    });
+    ok(parseDistManifest(good).version === '0.1.0', '合法 dist-manifest 解析');
+    const rejects = [
+        [
+            '{bad json',
+            '坏 JSON'
+        ],
+        [
+            JSON.stringify({
+                version: 'x',
+                tarball: DIST_ASSET_TARBALL,
+                tarballSha256: 'a'.repeat(64),
+                zip: DIST_ASSET_STORE_ZIP,
+                zipSha256: 'b'.repeat(64)
+            }),
+            'version 非 x.y.z'
+        ],
+        [
+            JSON.stringify({
+                tarball: DIST_ASSET_TARBALL,
+                tarballSha256: 'a'.repeat(64),
+                zip: DIST_ASSET_STORE_ZIP,
+                zipSha256: 'b'.repeat(64)
+            }),
+            '缺 version'
+        ],
+        [
+            JSON.stringify({
+                version: '0.1.0',
+                tarball: 'other-name.tar.gz',
+                tarballSha256: 'a'.repeat(64),
+                zip: DIST_ASSET_STORE_ZIP,
+                zipSha256: 'b'.repeat(64)
+            }),
+            'tarball 资产名漂移'
+        ],
+        [
+            JSON.stringify({
+                version: '0.1.0',
+                tarball: DIST_ASSET_TARBALL,
+                tarballSha256: 'zz',
+                zip: DIST_ASSET_STORE_ZIP,
+                zipSha256: 'b'.repeat(64)
+            }),
+            'tarballSha256 非 64-hex'
+        ]
+    ];
+    for (const [raw, label] of rejects){
+        let threw = false;
+        try {
+            parseDistManifest(raw);
+        } catch  {
+            threw = true;
+        }
+        ok(threw, `fail-closed:${label}`);
+    }
+}{
+    ok(compareVersions('0.1.0', '0.1.1') < 0, '0.1.0 < 0.1.1');
+    ok(compareVersions('0.2.0', '0.1.9') > 0, '0.2.0 > 0.1.9');
+    ok(compareVersions('1.0.0', '0.9.9') > 0, '1.0.0 > 0.9.9');
+    ok(compareVersions('0.1.0', '0.1.0') === 0, '相等为 0');
+    ok(compareVersions('0.1', '0.1.0') === 0, '缺段按 0 补齐');
+}async function startLoopback(manifestJson, tarball) {
+    let hits = 0;
+    const server = createServer((req, res)=>{
+        if (req.url?.endsWith(DIST_ASSET_MANIFEST)) {
+            res.writeHead(200, {
+                'content-type': 'application/json'
+            });
+            res.end(manifestJson);
+        } else if (req.url?.endsWith(DIST_ASSET_TARBALL)) {
+            hits += 1;
+            res.writeHead(200, {
+                'content-type': 'application/gzip'
+            });
+            res.end(tarball);
+        } else {
+            res.writeHead(404);
+            res.end('not found');
+        }
+    });
+    await new Promise((r)=>server.listen(0, '127.0.0.1', r));
+    const addr = server.address();
+    const base = `http://127.0.0.1:${typeof addr === 'object' && addr ? addr.port : 0}/releases`;
+    return {
+        base,
+        manifestJson,
+        tarball,
+        tarballHits: ()=>hits,
+        close: ()=>new Promise((r)=>server.close(()=>r()))
+    };
+}
+function buildTarball(sourceDir, versionOverride) {
+    const stage = mkdtempSync(join(tmpdir(), 'extdist-stage-'));
+    const root = join(stage, 'gotry-session-bridge');
+    mkdirSync(root);
+    for (const f of EXT_FILES)copyFileSync(join(sourceDir, f), join(root, f));
+    if (versionOverride != null) {
+        const m = JSON.parse(readFileSync(join(root, 'manifest.json'), 'utf8'));
+        writeFileSync(join(root, 'manifest.json'), JSON.stringify({
+            ...m,
+            version: versionOverride
+        }));
+    }
+    const tarPath = join(stage, DIST_ASSET_TARBALL);
+    execFileSync('tar', [
+        '-czf',
+        tarPath,
+        '-C',
+        stage,
+        'gotry-session-bridge'
+    ]);
+    const tarball = readFileSync(tarPath);
+    rmSync(stage, {
+        recursive: true,
+        force: true
+    });
+    return {
+        tarball,
+        sha: sha256Hex(tarball)
+    };
+}
+function distManifestJson(version, sha) {
+    return JSON.stringify({
+        version,
+        tarball: DIST_ASSET_TARBALL,
+        tarballSha256: sha,
+        zip: DIST_ASSET_STORE_ZIP,
+        zipSha256: 'c'.repeat(64),
+        builtFromCommit: 'test'
+    });
+}
+{
+    const work = mkdtempSync(join(tmpdir(), 'extdist-e2e-'));
+    const { tarball, sha } = buildTarball(EXT_SRC, '9.9.9');
+    const srcVersion = JSON.parse(readFileSync(join(EXT_SRC, 'manifest.json'), 'utf8'));
+    const remoteVersion = '9.9.9';
+    {
+        const dest = join(work, 'dest1');
+        const lb = await startLoopback(distManifestJson(remoteVersion, sha), tarball);
+        const r = await installExtensionFromGithub({
+            destDir: dest,
+            pinnedSourceDir: EXT_SRC,
+            releaseBase: lb.base
+        });
+        lb.close();
+        ok(r.ok && r.action === 'installed' && r.version === remoteVersion, `installed 全链(action=${r.action},v=${r.version},err=${r.error ?? '无'})`);
+        ok(readExtensionKey(dest) === srcVersion.key, '落位产物 key 与 bundled 逐字一致(同扩展 ID)');
+        ok(JSON.parse(readFileSync(join(dest, 'manifest.json'), 'utf8')).version === remoteVersion, '落位产物为远端版本');
+        for (const f of EXT_FILES)ok(existsSync(join(dest, f)), `文件就位:${f}`);
+    }
+    {
+        const dest = join(work, 'dest2');
+        const lb = await startLoopback(distManifestJson(remoteVersion, '0'.repeat(64)), tarball);
+        const r = await installExtensionFromGithub({
+            destDir: dest,
+            pinnedSourceDir: EXT_SRC,
+            releaseBase: lb.base
+        });
+        lb.close();
+        ok(!r.ok && r.action === 'fallback-bundled' && /SHA256/.test(r.error ?? ''), `SHA256 不符拒绝(${r.error})`);
+        ok(!existsSync(dest), '失败路径零落盘');
+    }
+    {
+        const dest = join(work, 'dest3');
+        const lb = await startLoopback(distManifestJson(remoteVersion, sha), tarball);
+        lb.close();
+        const r = await installExtensionFromGithub({
+            destDir: dest,
+            releaseBase: lb.base
+        });
+        ok(!r.ok && r.action === 'fallback-bundled', `无网降级 fallback-bundled(${(r.error ?? '').slice(0, 40)})`);
+    }
+    {
+        const rogue = mkdtempSync(join(work, 'rogue-'));
+        const rogueManifest = {
+            ...srcVersion,
+            version: remoteVersion,
+            key: `ROGUE-${srcVersion.key}`
+        };
+        writeFileSync(join(rogue, 'manifest.json'), JSON.stringify(rogueManifest));
+        for (const f of EXT_FILES.filter((x)=>x !== 'manifest.json'))copyFileSync(join(EXT_SRC, f), join(rogue, f));
+        const { tarball: rTar, sha: rSha } = buildTarball(rogue);
+        const dest = join(work, 'dest4');
+        const lb = await startLoopback(distManifestJson(remoteVersion, rSha), rTar);
+        const r = await installExtensionFromGithub({
+            destDir: dest,
+            pinnedSourceDir: EXT_SRC,
+            releaseBase: lb.base
+        });
+        lb.close();
+        ok(!r.ok && /key 漂移/.test(r.error ?? ''), `key 漂移拒绝(${r.error})`);
+        ok(!existsSync(dest), '漂移路径零落盘');
+        rmSync(rogue, {
+            recursive: true,
+            force: true
+        });
+    }
+    {
+        const dest = join(work, 'dest5');
+        mkdirSync(dest, {
+            recursive: true
+        });
+        writeFileSync(join(dest, 'manifest.json'), JSON.stringify({
+            ...srcVersion,
+            version: remoteVersion
+        }));
+        const lb = await startLoopback(distManifestJson(remoteVersion, sha), tarball);
+        const r = await installExtensionFromGithub({
+            destDir: dest,
+            pinnedSourceDir: EXT_SRC,
+            releaseBase: lb.base
+        });
+        const hits = lb.tarballHits();
+        lb.close();
+        ok(r.ok && r.action === 'up-to-date' && hits === 0, `up-to-date 跳过(tarball 下载 ${hits} 次)`);
+    }
+    {
+        const dest = join(work, 'dest6');
+        const lb = await startLoopback(distManifestJson(remoteVersion, sha), tarball);
+        const r = await installExtensionFromGithub({
+            destDir: dest,
+            releaseBase: lb.base,
+            checkOnly: true
+        });
+        lb.close();
+        ok(r.ok && r.version === remoteVersion && !existsSync(dest), 'check-only 报告远端版本且零落盘');
+    }
+    rmSync(work, {
+        recursive: true,
+        force: true
+    });
+}{
+    const { tarball, sha } = buildTarball(EXT_SRC, '9.9.9');
+    const srcVersion = JSON.parse(readFileSync(join(EXT_SRC, 'manifest.json'), 'utf8'));
+    const lb = await startLoopback(distManifestJson('9.9.9', sha), tarball);
+    const dest = mkdtempSync(join(tmpdir(), 'extdist-cli-'));
+    const cli = join(repoRoot, 'ts', 'scripts', 'extension-distribution-cli.ts');
+    const run = (args)=>new Promise((resolve)=>{
+            const child = spawn('npx', [
+                '--yes',
+                'tsx',
+                cli,
+                ...args
+            ], {
+                cwd: join(repoRoot, 'ts'),
+                stdio: [
+                    'ignore',
+                    'pipe',
+                    'inherit'
+                ]
+            });
+            let buf = '';
+            child.stdout.on('data', (c)=>{
+                buf += c.toString('utf8');
+            });
+            child.on('close', (code)=>{
+                const line = buf.trim().split('\n').pop() ?? '';
+                let json = null;
+                if (line.startsWith('{')) {
+                    try {
+                        json = JSON.parse(line);
+                    } catch  {}
+                }
+                resolve({
+                    code: code ?? -1,
+                    json
+                });
+            });
+        });
+    const r1 = await run([
+        '--dest',
+        dest,
+        '--source-dir',
+        EXT_SRC,
+        '--release-base',
+        lb.base
+    ]);
+    ok(r1.code === 0 && r1.json?.ok === true && r1.json?.action === 'installed', `CLI installed 单行 JSON + exit 0(action=${String(r1.json?.action)})`);
+    const r2 = await run([
+        '--dest',
+        dest,
+        '--source-dir',
+        EXT_SRC,
+        '--release-base',
+        'http://127.0.0.1:1/releases'
+    ]);
+    ok(r2.code === 2 && r2.json?.ok === false && r2.json?.action === 'fallback-bundled', `CLI 失败 exit 2 + fallback-bundled JSON`);
+    lb.close();
+    rmSync(dest, {
+        recursive: true,
+        force: true
+    });
+}console.log(`EXTENSION DISTRIBUTION: ${passed} pass, 0 fail`);
+
+
+//# sourceURL=ts/scripts/extension-distribution-tests.ts