paperclip/packages/paperclip-runner/scripts/provider-pack-layout.test.mjs

110 lines
6.5 KiB
JavaScript

import assert from "node:assert/strict";
import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, symlinkSync } from "node:fs";
import { execFileSync } from "node:child_process";
import { dirname, join } from "node:path";
import { tmpdir } from "node:os";
import test from "node:test";
import { normalizeProviderPackLayout, normalizeProviderPackMetadata } from "./provider-pack-layout.mjs";
import { sha256Tree } from "./provider-pack-integrity.mjs";
function fixture(t) {
const root = mkdtempSync(join(tmpdir(), "provider-pack-layout-"));
t.after(() => rmSync(root, { recursive: true, force: true }));
mkdirSync(join(root, "dist", "cli"), { recursive: true });
writeFileSync(join(root, "dist", "cli", "provider.cjs"), "provider bytes\n");
return root;
}
test("app and sandbox image build orders produce the same provider layout", (t) => {
const app = fixture(t), image = fixture(t);
mkdirSync(join(app, "dist", "bin"));
writeFileSync(join(app, "dist", "bin", "paperclip-runnerd"), "separately verified native binary");
normalizeProviderPackLayout(app);
normalizeProviderPackLayout(image);
assert.deepEqual(readdirSync(join(app, "dist")), readdirSync(join(image, "dist")));
assert.deepEqual(readFileSync(join(app, "dist", "cli", "provider.cjs")), readFileSync(join(image, "dist", "cli", "provider.cjs")));
});
test("normalization removes only redundant runnerd and retains other bin entries", (t) => {
const root = fixture(t);
mkdirSync(join(root, "dist", "bin"));
writeFileSync(join(root, "dist", "bin", "paperclip-runnerd"), "runnerd");
writeFileSync(join(root, "dist", "bin", "future-provider"), "keep me");
normalizeProviderPackLayout(root);
normalizeProviderPackLayout(root);
assert.deepEqual(readdirSync(join(root, "dist", "bin")), ["future-provider"]);
assert.equal(readFileSync(join(root, "dist", "bin", "future-provider"), "utf8"), "keep me");
});
test("normalization never follows a substituted bin directory", (t) => {
const root = fixture(t), outside = fixture(t);
writeFileSync(join(outside, "paperclip-runnerd"), "keep outside bytes");
symlinkSync(outside, join(root, "dist", "bin"));
assert.throws(() => normalizeProviderPackLayout(root), /must be a directory/);
assert.equal(readFileSync(join(outside, "paperclip-runnerd"), "utf8"), "keep outside bytes");
});
function metadataFixture(t, date) {
const root = fixture(t), provider = join(root, "node_modules/.pnpm/tool@1/node_modules/tool");
const shim = join(provider, "node_modules/.bin/tool");
mkdirSync(dirname(shim), { recursive: true });
mkdirSync(join(root, "runtime-extra/only-through-node-path"), { recursive: true });
writeFileSync(join(root, "runtime-extra/only-through-node-path/index.js"), 'module.exports = "dependency resolved";');
writeFileSync(join(provider, "cli.cjs"), 'console.log(JSON.stringify({value:require("only-through-node-path"),args:process.argv.slice(2),nodePath:process.env.NODE_PATH}));');
writeFileSync(shim, ["#!/bin/sh", 'basedir=$(dirname "$0")',
'if [ -z "$NODE_PATH" ]; then', ` export NODE_PATH="${root}/runtime-extra"`,
"else", ` export NODE_PATH="${root}/runtime-extra:$NODE_PATH"`, "fi",
'exec node "$basedir/../../cli.cjs" "$@"', ""].join("\n"), { mode: 0o755 });
symlinkSync(".pnpm/tool@1/node_modules/tool", join(root, "node_modules/tool"));
writeFileSync(join(root, "node_modules/.modules.yaml"), `packageManager: pnpm@9.15.4\nprunedAt: ${date}\nvirtualStoreDir: .pnpm\n`);
return { root, shim };
}
test("independent build paths and pruning times produce identical complete content trees", (t) => {
const a = metadataFixture(t, "Wed, 09 Sep 2026 21:44:13 GMT"), b = metadataFixture(t, "Wed, 09 Sep 2026 21:45:40 GMT");
assert.notEqual(sha256Tree(a.root), sha256Tree(b.root));
for (const pack of [a, b]) assert.equal(normalizeProviderPackMetadata(pack.root).normalizedShims, 1);
assert.equal(sha256Tree(a.root), sha256Tree(b.root));
const before = sha256Tree(a.root);
assert.equal(normalizeProviderPackMetadata(a.root).normalizedShims, 0);
assert.equal(sha256Tree(a.root), before);
});
test("normalized nested launcher resolves dependencies and arguments after relocation and symlink invocation", (t) => {
const pack = metadataFixture(t, "Wed, 09 Sep 2026 21:44:13 GMT");
normalizeProviderPackMetadata(pack.root);
const parent = mkdtempSync(join(tmpdir(), "provider move ' "));
t.after(() => rmSync(parent, { recursive: true, force: true }));
const moved = join(parent, "moved pack"); renameSync(pack.root, moved);
const logical = join(moved, "node_modules/tool/node_modules/.bin/tool");
symlinkSync(logical, join(parent, "absolute")); symlinkSync("absolute", join(parent, "relative"));
for (const existing of [undefined, "/existing caller path"]) {
const env = { ...process.env, PATH: dirname(process.execPath) + ":" + process.env.PATH };
if (existing === undefined) delete env.NODE_PATH; else env.NODE_PATH = existing;
for (const command of [logical, join(parent, "absolute"), join(parent, "relative")]) {
const result = JSON.parse(execFileSync(command, ["argument with spaces", "'quoted'"], { cwd: "/", encoding: "utf8", env }));
assert.equal(result.value, "dependency resolved");
assert.deepEqual(result.args, ["argument with spaces", "'quoted'"]);
assert.equal(result.nodePath, join(realpathSync(moved), "runtime-extra") + (existing ? ":" + existing : ""));
assert(!result.nodePath.includes(pack.root));
}
}
});
test("metadata normalization rejects substituted node_modules and bookkeeping links", (t) => {
const root = fixture(t), outside = metadataFixture(t, "original timestamp");
symlinkSync(join(outside.root, "node_modules"), join(root, "node_modules"));
assert.throws(() => normalizeProviderPackMetadata(root), /physical directory/);
assert(readFileSync(outside.shim, "utf8").includes(outside.root));
const pack = metadataFixture(t, "original timestamp"), metadata = join(pack.root, "node_modules/.modules.yaml");
rmSync(metadata); symlinkSync(join(outside.root, "node_modules/.modules.yaml"), metadata);
assert.throws(() => normalizeProviderPackMetadata(pack.root), /regular file/);
assert(readFileSync(join(outside.root, "node_modules/.modules.yaml"), "utf8").includes("original timestamp"));
});
test("unrecognized build-dependent shims fail instead of hiding unstable executable bytes", (t) => {
const pack = metadataFixture(t, "original timestamp");
writeFileSync(pack.shim, `#!/bin/sh\nexec "${pack.root}/somewhere"\n`);
assert.throws(() => normalizeProviderPackMetadata(pack.root), /Unrecognized/);
});