@scriptc/compiler 0.4.5 → 0.4.6

package/dist/node-islands/libnode-pack.test.js

@@ -0,0 +1,258 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { afterEach, describe, expect, test } from "vitest";
+import { compilerReleaseVersion } from "../library/sidecar.js";
+import { NODE_BRIDGE_ABI, libnodeRecord } from "./libnode.js";
+import { LIBNODE_PACK_SCHEMA, LibnodePackError, findInstalledLibnodePack, hostLibnodeTarget, libnodePackPackage, parseLibnodeSetting, readLibnodePack, writeLibnodeNotices, } from "./libnode-pack.js";
+const repo = fileURLToPath(new URL("../../../..", import.meta.url));
+const dirs = [];
+afterEach(() => {
+    for (const dir of dirs.splice(0))
+        rmSync(dir, { recursive: true, force: true });
+});
+function temp() {
+    const dir = mkdtempSync(join(tmpdir(), "scriptc-libnode-pack-"));
+    dirs.push(dir);
+    return dir;
+}
+function entry(bytes) {
+    return {
+        size: Buffer.byteLength(bytes),
+        sha256: createHash("sha256").update(bytes).digest("hex"),
+    };
+}
+/** A published-style pack with stand-in libraries; `edit` adjusts the
+ * manifest build-pack.mjs would write. */
+function fakePack(dir, edit = () => { }, name = "@scriptc/libnode-linux-x64-gnu") {
+    mkdirSync(dir, { recursive: true });
+    const libnode = "stand-in libnode";
+    const bridge = "stand-in bridge";
+    writeFileSync(join(dir, "libnode.so.137"), libnode);
+    writeFileSync(join(dir, "libscr_node_bridge.so"), bridge);
+    writeFileSync(join(dir, "LICENSE"), "Node.js is licensed for use as follows:\n\nMIT\n");
+    writeFileSync(join(dir, "package.json"), JSON.stringify({ name, version: compilerReleaseVersion() }));
+    const manifest = {
+        schema: LIBNODE_PACK_SCHEMA,
+        nodeVersion: "24.22.0",
+        moduleVersion: 137,
+        bridgeAbi: NODE_BRIDGE_ABI,
+        platform: "linux",
+        arch: "x64",
+        libnode: "libnode.so.137",
+        bridge: "libscr_node_bridge.so",
+        package: name,
+        version: compilerReleaseVersion(),
+        target: "linux-x64-gnu",
+        license: "LICENSE",
+        files: { "libnode.so.137": entry(libnode), "libscr_node_bridge.so": entry(bridge) },
+    };
+    edit(manifest);
+    writeFileSync(join(dir, "manifest.json"), JSON.stringify(manifest));
+    return dir;
+}
+function thrown(run) {
+    try {
+        run();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(LibnodePackError);
+        return error;
+    }
+    throw new Error("expected a LibnodePackError");
+}
+describe("the pack packages", () => {
+    test("every libnode platform package is the pack of one native target", () => {
+        const packages = readdirSync(join(repo, "packages"))
+            .filter((name) => name.startsWith("libnode-") && name !== "libnode-common")
+            .map((name) => JSON.parse(readFileSync(join(repo, "packages", name, "package.json"), "utf8")).name)
+            .sort();
+        const targets = ["linux-x64-gnu", "linux-arm64-gnu", "macos-arm64", "macos-x64"];
+        expect(targets.map((target) => libnodePackPackage(target)).sort()).toEqual(packages);
+        expect(libnodePackPackage("linux-x64-musl")).toBeNull();
+        expect(libnodePackPackage("windows-x64-msvc")).toBeNull();
+        expect(libnodePackPackage("wasm32-wasi")).toBeNull();
+    });
+    test("host targets map to native target names", () => {
+        expect(hostLibnodeTarget("linux", "x64")).toBe("linux-x64-gnu");
+        expect(hostLibnodeTarget("linux", "arm64")).toBe("linux-arm64-gnu");
+        expect(hostLibnodeTarget("darwin", "arm64")).toBe("macos-arm64");
+        expect(hostLibnodeTarget("darwin", "x64")).toBe("macos-x64");
+    });
+});
+describe("parseLibnodeSetting", () => {
+    test("accepts embedded, beside and absolute directories", () => {
+        expect(parseLibnodeSetting("embedded")).toEqual({ kind: "embedded" });
+        expect(parseLibnodeSetting("beside")).toEqual({ kind: "beside" });
+        expect(parseLibnodeSetting("/opt/scriptc/libnode-24.22.0")).toEqual({
+            kind: "path",
+            path: "/opt/scriptc/libnode-24.22.0",
+        });
+    });
+    test("rejects relative paths and other values", () => {
+        expect(parseLibnodeSetting("libnode")).toBe('must be "embedded", "beside" or an absolute directory, not the relative path "libnode"');
+        expect(parseLibnodeSetting(true)).toBe('must be "embedded", "beside" or an absolute directory');
+    });
+});
+describe("finding the installed pack", () => {
+    test("in the nearest node_modules above the project", () => {
+        const root = temp();
+        const pack = fakePack(join(root, "node_modules/@scriptc/libnode-linux-x64-gnu"));
+        const project = join(root, "apps/web/src");
+        mkdirSync(project, { recursive: true });
+        expect(findInstalledLibnodePack({
+            targetName: "linux-x64-gnu",
+            projectDir: project,
+            resolveInstalled: () => null,
+        })).toBe(pack);
+    });
+    test("next to the compiler when the project has none", () => {
+        const pack = fakePack(join(temp(), "libnode-darwin-arm64"));
+        expect(findInstalledLibnodePack({
+            targetName: "macos-arm64",
+            projectDir: temp(),
+            resolveInstalled: (name) => (name === "@scriptc/libnode-darwin-arm64" ? pack : null),
+        })).toBe(pack);
+        expect(findInstalledLibnodePack({
+            targetName: "macos-arm64",
+            projectDir: temp(),
+            resolveInstalled: () => null,
+        })).toBeNull();
+    });
+    test("targets without packs have none", () => {
+        expect(findInstalledLibnodePack({ targetName: "linux-x64-musl", projectDir: temp() })).toBe(null);
+    });
+    test("libnodeRecord uses the installed pack when nothing names one", () => {
+        const root = temp();
+        const name = libnodePackPackage(hostLibnodeTarget());
+        if (name === null)
+            return;
+        const pack = fakePack(join(root, "node_modules", name), () => { }, name);
+        expect(libnodeRecord(undefined, join(root, "app"), {}, root)).toEqual({
+            libnode: pack,
+            nodeVersion: "24.22.0",
+        });
+        // SCRIPTC_LIBNODE still wins.
+        const other = fakePack(join(temp(), "other"), (m) => {
+            m["nodeVersion"] = "24.13.1";
+        });
+        expect(libnodeRecord(undefined, join(root, "app"), { SCRIPTC_LIBNODE: other }, root)).toEqual({
+            libnode: other,
+            nodeVersion: "24.13.1",
+        });
+    });
+});
+test("an installed pack of another scriptc version is refused", () => {
+    const root = temp();
+    const name = libnodePackPackage(hostLibnodeTarget());
+    if (name === null)
+        return;
+    const pack = fakePack(join(root, "node_modules", name), (m) => {
+        m["version"] = "0.0.1";
+    }, name);
+    expect(libnodeRecord(undefined, join(root, "app"), {}, root)).toBe(`the installed libnode pack ${name} at ${pack} is version 0.0.1; this scriptc is ${compilerReleaseVersion()}: install ${name}@${compilerReleaseVersion()}`);
+});
+test("an installed pack whose files do not match their digests is refused", () => {
+    const root = temp();
+    const name = libnodePackPackage(hostLibnodeTarget());
+    if (name === null)
+        return;
+    const pack = fakePack(join(root, "node_modules", name), () => { }, name);
+    // Same size, other bytes.
+    writeFileSync(join(pack, "libnode.so.137"), "stand-in libnodX");
+    expect(libnodeRecord(undefined, join(root, "app"), {}, root)).toBe(`libnode.so.137 in the libnode pack at ${pack} does not match its manifest`);
+});
+describe("readLibnodePack", () => {
+    test("reads a pack in build-pack.mjs's format and checks its package", () => {
+        const pack = fakePack(join(temp(), "pack"));
+        expect(readLibnodePack(pack, { packageName: "@scriptc/libnode-linux-x64-gnu", verifyHashes: true })
+            .manifest.nodeVersion).toBe("24.22.0");
+        expect(thrown(() => readLibnodePack(pack, { packageName: "@scriptc/libnode-linux-arm64-gnu" }))
+            .message).toBe(`the libnode pack at ${pack} is @scriptc/libnode-linux-x64-gnu; this target needs @scriptc/libnode-linux-arm64-gnu`);
+    });
+    test("refuses other manifest schemas and file names outside the pack", () => {
+        const schema = fakePack(join(temp(), "pack"), (m) => {
+            m["schema"] = "scriptc.libnode-pack.v0";
+        });
+        expect(thrown(() => readLibnodePack(schema)).kind).toBe("invalid");
+        for (const name of [
+            "lib/libnode.so.137",
+            "../libnode.so.137",
+            "..",
+            "/etc/libnode.so",
+            "a\\b",
+            "a\0b",
+        ]) {
+            const pack = fakePack(join(temp(), "pack"), (m) => {
+                m["libnode"] = name;
+                m["files"] = { ...m["files"], [name]: entry("stand-in libnode") };
+            });
+            expect(thrown(() => readLibnodePack(pack)).message).toBe(`the libnode pack at ${pack} names a file outside the pack (${JSON.stringify(name)})`);
+        }
+    });
+    test("checks sizes always and hashes on request", () => {
+        const pack = fakePack(join(temp(), "pack"));
+        writeFileSync(join(pack, "libnode.so.137"), "stand-in libnodE");
+        expect(readLibnodePack(pack).root).toBe(pack);
+        expect(thrown(() => readLibnodePack(pack, { verifyHashes: true })).message).toBe(`libnode.so.137 in the libnode pack at ${pack} does not match its manifest`);
+        writeFileSync(join(pack, "libnode.so.137"), "short");
+        expect(thrown(() => readLibnodePack(pack)).kind).toBe("invalid");
+    });
+    test("a directory without a manifest is missing", () => {
+        const dir = temp();
+        expect(thrown(() => readLibnodePack(dir)).message).toBe(`no libnode pack at ${dir} (manifest.json is missing or unreadable)`);
+    });
+});
+test("the license notices carry Node's LICENSE", () => {
+    const pack = readLibnodePack(fakePack(join(temp(), "pack")));
+    const out = join(temp(), "server");
+    const path = writeLibnodeNotices(pack, out);
+    expect(path).toBe(`${out}.licenses.txt`);
+    expect(readFileSync(path, "utf8")).toBe([
+        `server runs part of its code in Node.js 24.22.0, loaded from libnode.so.137 (@scriptc/libnode-linux-x64-gnu@${compilerReleaseVersion()}).`,
+        "Node.js and the components it bundles are licensed as follows. The scriptc bridge,",
+        "libscr_node_bridge.so, is licensed under Apache-2.0.",
+        "",
+        "Node.js is licensed for use as follows:",
+        "",
+        "MIT",
+        "",
+    ].join("\n"));
+});
+test("beside refuses an installed pack whose manifest names a file outside it", () => {
+    const root = temp();
+    const name = libnodePackPackage(hostLibnodeTarget());
+    if (name === null)
+        return;
+    const pack = fakePack(join(root, "node_modules", name), (m) => {
+        m["files"] = { ...m["files"], "../escaped": entry("payload") };
+    }, name);
+    // The pack's "../escaped" and the file it would replace next to the output.
+    writeFileSync(join(pack, "..", "escaped"), "payload");
+    writeFileSync(join(root, "escaped"), "victim");
+    expect(libnodeRecord("beside", join(root, "app"), {}, root)).toBe(`the libnode pack at ${pack} names a file outside the pack ("../escaped")`);
+    expect(readFileSync(join(root, "escaped"), "utf8")).toBe("victim");
+    expect(existsSync(join(root, "app.libnode"))).toBe(false);
+});
+test("readLibnodePack refuses any listed file or license outside the pack", () => {
+    for (const edit of [
+        (m) => {
+            m["files"] = { ...m["files"], "../escaped": entry("payload") };
+        },
+        (m) => {
+            m["files"] = { ...m["files"], "/etc/passwd": entry("payload") };
+        },
+        (m) => {
+            m["license"] = "../../secret";
+        },
+        (m) => {
+            m["license"] = 7;
+        },
+    ]) {
+        const pack = fakePack(join(temp(), "pack"), edit);
+        expect(thrown(() => readLibnodePack(pack)).kind).toBe("invalid");
+    }
+});
+//# sourceMappingURL=libnode-pack.test.js.map

package/dist/node-islands/libnode-pack.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libnode-pack.test.js","sourceRoot":"","sources":["../../src/node-islands/libnode-pack.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,MAAM,IAAI,GAAa,EAAE,CAAC;AAC1B,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAAE,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,SAAS,IAAI;IACX,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KACzD,CAAC;AACJ,CAAC;AAED;0CAC0C;AAC1C,SAAS,QAAQ,CACf,GAAW,EACX,IAAI,GAAgD,GAAG,EAAE,GAAE,CAAC,EAC5D,IAAI,GAAG,gCAAgC;IAEvC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC;IACnC,MAAM,MAAM,GAAG,iBAAiB,CAAC;IACjC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;IACpD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,kDAAkD,CAAC,CAAC;IACxF,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EACzB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAC5D,CAAC;IACF,MAAM,QAAQ,GAA4B;QACxC,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,GAAG;QAClB,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE,uBAAuB;QAC/B,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,sBAAsB,EAAE;QACjC,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,EAAE,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,uBAAuB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;KACpF,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,CAAC;IACf,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAAC,GAAkB;IAChC,IAAI,CAAC;QACH,GAAG,EAAE,CAAC;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAC/C,OAAO,KAAyB,CAAC;IACnC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AACjD,CAAC;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;QAC3E,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;aACjD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,KAAK,gBAAgB,CAAC;aAC1E,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CACtF;aACA,IAAI,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,CAAC,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QACjF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrF,MAAM,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxD,MAAM,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1D,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChE,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpE,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,MAAM,CAAC,mBAAmB,CAAC,8BAA8B,CAAC,CAAC,CAAC,OAAO,CAAC;YAClE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,8BAA8B;SACrC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CACzC,wFAAwF,CACzF,CAAC;QACF,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3C,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,CACJ,wBAAwB,CAAC;YACvB,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,OAAO;YACnB,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI;SAC7B,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAC5D,MAAM,CACJ,wBAAwB,CAAC;YACvB,UAAU,EAAE,aAAa;YACzB,UAAU,EAAE,IAAI,EAAE;YAClB,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;SACrF,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,CACJ,wBAAwB,CAAC;YACvB,UAAU,EAAE,aAAa;YACzB,UAAU,EAAE,IAAI,EAAE;YAClB,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI;SAC7B,CAAC,CACH,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,wBAAwB,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACzF,IAAI,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACrD,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACxE,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACpE,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;QACH,8BAA8B;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YAClD,CAAC,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5F,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,MAAM,IAAI,GAAG,QAAQ,CACnB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAChC,CAAC,CAAC,EAAE,EAAE;QACJ,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IACzB,CAAC,EACD,IAAI,CACL,CAAC;IACF,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAChE,8BAA8B,IAAI,OAAO,IAAI,sCAAsC,sBAAsB,EAAE,aAAa,IAAI,IAAI,sBAAsB,EAAE,EAAE,CAC3J,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qEAAqE,EAAE,GAAG,EAAE;IAC/E,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACxE,0BAA0B;IAC1B,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAChE,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAChE,yCAAyC,IAAI,8BAA8B,CAC5E,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,MAAM,CACJ,eAAe,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;aACzF,QAAQ,CAAC,WAAW,CACxB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClB,MAAM,CACJ,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC,CAAC;aACrF,OAAO,CACX,CAAC,IAAI,CACJ,uBAAuB,IAAI,wFAAwF,CACpH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YAClD,CAAC,CAAC,QAAQ,CAAC,GAAG,yBAAyB,CAAC;QAC1C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI;YACjB,oBAAoB;YACpB,mBAAmB;YACnB,IAAI;YACJ,iBAAiB;YACjB,MAAM;YACN,MAAM;SACP,EAAE,CAAC;YACF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;gBAChD,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;gBACpB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAI,CAAC,CAAC,OAAO,CAAY,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAChF,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACtD,uBAAuB,IAAI,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CACtF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAChE,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAC9E,yCAAyC,IAAI,8BAA8B,CAC5E,CAAC;QACF,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACrD,sBAAsB,GAAG,2CAA2C,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACpD,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC;IACzC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CACrC;QACE,+GAA+G,sBAAsB,EAAE,IAAI;QAC3I,oFAAoF;QACpF,sDAAsD;QACtD,EAAE;QACF,yCAAyC;QACzC,EAAE;QACF,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,MAAM,IAAI,GAAG,QAAQ,CACnB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAChC,CAAC,CAAC,EAAE,EAAE;QACJ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAI,CAAC,CAAC,OAAO,CAAY,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;IAC7E,CAAC,EACD,IAAI,CACL,CAAC;IACF,4EAA4E;IAC5E,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IACtD,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAC/D,uBAAuB,IAAI,+CAA+C,CAC3E,CAAC;IACF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qEAAqE,EAAE,GAAG,EAAE;IAC/E,KAAK,MAAM,IAAI,IAAI;QACjB,CAAC,CAA0B,EAAE,EAAE;YAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAI,CAAC,CAAC,OAAO,CAAY,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7E,CAAC;QACD,CAAC,CAA0B,EAAE,EAAE;YAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAI,CAAC,CAAC,OAAO,CAAY,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9E,CAAC;QACD,CAAC,CAA0B,EAAE,EAAE;YAC7B,CAAC,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC;QAChC,CAAC;QACD,CAAC,CAA0B,EAAE,EAAE;YAC7B,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACF,EAAE,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/node-islands/libnode.d.ts

@@ -0,0 +1,32 @@
+/** The oldest Node.js release Node islands support: synchronous
+ * module.registerHooks, which shared modules need, is a release candidate
+ * from here on (decision 5). */
+export declare const NODE_ISLAND_MIN_NODE = "24.13.1";
+/** The bridge ABI this compiler's runtime speaks (scr_node_bridge.h). */
+export declare const NODE_BRIDGE_ABI = 9;
+/** The prefix of a recorded path relative to the executable's directory. */
+export declare const ORIGIN = "$ORIGIN/";
+export interface LibnodeRecord {
+    /** The pack directory: absolute, or `$ORIGIN/`-relative. */
+    libnode: string;
+    /** The exact Node version the pack's bridge links. */
+    nodeVersion: string;
+}
+/** The native target whose libnode pack a build records: the codegen
+ * target (SCRIPTC_TARGET, and the host's libc), else the host. */
+export declare function libnodeTarget(env?: NodeJS.ProcessEnv): string;
+/** What to record for a program that calls into Node, or the reason the
+ * build cannot (an SC8005 message). `option` is --libnode. */
+export declare function libnodeRecord(option: string | undefined, outPath: string, env?: NodeJS.ProcessEnv, projectDir?: string): LibnodeRecord | string;
+/** The identity of the libnode pack a build that calls into Node.js
+ * records, which the program's executable cache entry keeps
+ * (EarlyExecutableCacheOptions.libnodeIdentity): the option, the pack
+ * directory (named by --libnode or SCRIPTC_LIBNODE, or the installed pack
+ * found from `projectDir`), and a digest of the pack's manifest.json. A pack
+ * upgraded in place, removed, or replaced by another installed pack changes
+ * it. Undefined when no pack is named or installed. */
+export declare function libnodeCacheKey(option: string | undefined, env?: NodeJS.ProcessEnv, projectDir?: string): string | undefined;
+/** The libnode pack directory the build-time probe of deferred islands
+ * runs in (scope-B NI-7): the same pack libnodeRecord records (before a
+ * `beside` copy), or null when the build host has none to run. */
+export declare function libnodeProbePack(option: string | undefined, env?: NodeJS.ProcessEnv, projectDir?: string): string | null;

package/dist/node-islands/libnode.js

@@ -0,0 +1,212 @@
+/* The libnode pack a program with Node islands loads Node from (scope-B
+ * design §2.11, §2.13, §2.16). The build reads the pack's manifest and
+ * records the pack directory and its Node version into the executable;
+ * the executable loads that pack on its first call into Node, checks that
+ * its bridge links exactly that Node, and never searches for another.
+ * SCRIPTC_LIBNODE overrides the recorded directory at run time.
+ *
+ * Where the build finds the pack: `--libnode=<pack directory>`, else
+ * SCRIPTC_LIBNODE in the build's environment, else the installed
+ * @scriptc/libnode-<platform> pack (libnode-pack.ts).
+ * `--libnode=beside` takes that pack and copies it next to the executable
+ * as `<output>.libnode/`, recorded as `$ORIGIN/<output>.libnode`, so the
+ * executable and its Node travel together; a recorded `$ORIGIN/` path is
+ * also the hook for bundling Node into the executable itself later. */
+import { createHash } from "node:crypto";
+import { constants, copyFileSync, linkSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, } from "node:fs";
+import { basename, isAbsolute, join, resolve, sep } from "node:path";
+import { compilerReleaseVersion } from "../library/sidecar.js";
+import { nativeCodegenTarget } from "../backend/targets.js";
+import { findInstalledLibnodePack, hostLibnodeTarget, LibnodePackError, libnodePackPackage, readLibnodePack, } from "./libnode-pack.js";
+/** The oldest Node.js release Node islands support: synchronous
+ * module.registerHooks, which shared modules need, is a release candidate
+ * from here on (decision 5). */
+export const NODE_ISLAND_MIN_NODE = "24.13.1";
+/** The bridge ABI this compiler's runtime speaks (scr_node_bridge.h). */
+export const NODE_BRIDGE_ABI = 9;
+/** The prefix of a recorded path relative to the executable's directory. */
+export const ORIGIN = "$ORIGIN/";
+function versionAtLeast(version, floor) {
+    const a = version.split(".").map(Number);
+    const b = floor.split(".").map(Number);
+    for (let i = 0; i < 3; i++)
+        if (a[i] !== b[i])
+            return (a[i] ?? 0) > (b[i] ?? 0);
+    return true;
+}
+function readManifest(dir) {
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(join(dir, "manifest.json"), "utf8"));
+    }
+    catch {
+        return `no libnode pack at ${dir} (manifest.json is missing or unreadable)`;
+    }
+    if (typeof manifest.nodeVersion !== "string" || typeof manifest.bridgeAbi !== "number")
+        return `the libnode pack at ${dir} has a malformed manifest.json`;
+    if (manifest.bridgeAbi !== NODE_BRIDGE_ABI)
+        return `the libnode pack at ${dir} has bridge ABI ${manifest.bridgeAbi}; this scriptc needs ${NODE_BRIDGE_ABI}`;
+    if (!versionAtLeast(manifest.nodeVersion, NODE_ISLAND_MIN_NODE))
+        return `the libnode pack at ${dir} is Node ${manifest.nodeVersion}; Node islands need Node.js >=${NODE_ISLAND_MIN_NODE}`;
+    return {
+        nodeVersion: manifest.nodeVersion,
+        bridgeAbi: manifest.bridgeAbi,
+        files: manifest.files ?? {},
+    };
+}
+/** Copies the pack next to the executable (hard links where possible), or
+ * returns why it cannot: the target would replace the pack itself, the
+ * manifest names a file outside the pack, or a pack file is not a regular
+ * file (a symbolic link could point anywhere). Every destination is checked
+ * to resolve inside the target directory. */
+function placeBeside(source, manifest, target) {
+    const names = ["manifest.json", "LICENSE", ...Object.keys(manifest.files)];
+    const unsafe = names.find((name) => name === "" || name === "." || name === ".." || /[/\\\0]/.test(name) || isAbsolute(name));
+    if (unsafe !== undefined)
+        return `the libnode pack at ${source} lists a file outside the pack ('${unsafe}')`;
+    const from = realpathOr(source);
+    const to = realpathOr(target);
+    if (from === to || from.startsWith(to + sep) || to.startsWith(from + sep))
+        return `--libnode=beside would replace the libnode pack it copies (${source}); point SCRIPTC_LIBNODE at a pack outside ${target}`;
+    const present = [];
+    for (const name of names) {
+        let info;
+        try {
+            info = lstatSync(join(source, name));
+        }
+        catch {
+            continue;
+        }
+        if (!info.isFile())
+            return `the libnode pack at ${source} holds ${name} as a ${info.isSymbolicLink() ? "symbolic link" : "non-regular file"}; pack files must be regular files`;
+        present.push(name);
+    }
+    rmSync(target, { recursive: true, force: true });
+    mkdirSync(target, { recursive: true });
+    const inside = resolve(target) + sep;
+    for (const name of present) {
+        const destination = resolve(target, name);
+        if (!destination.startsWith(inside))
+            return `the libnode pack at ${source} lists a file outside the pack ('${name}')`;
+        const file = join(source, name);
+        try {
+            linkSync(file, destination);
+        }
+        catch {
+            copyFileSync(file, destination, constants.COPYFILE_EXCL);
+        }
+    }
+    return undefined;
+}
+/** The canonical path of `path`, or `path` resolved when it does not exist. */
+function realpathOr(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+/** The native target whose libnode pack a build records: the codegen
+ * target (SCRIPTC_TARGET, and the host's libc), else the host. */
+export function libnodeTarget(env = process.env) {
+    return nativeCodegenTarget(env)?.name ?? hostLibnodeTarget();
+}
+/** Why the installed pack in `dir` cannot serve this compiler, or null: it
+ * must be the target's package at the compiler's own version. */
+function installedPackProblem(dir, packageName) {
+    let pack;
+    try {
+        // An installed pack is found, not named: check its files' digests too.
+        pack = readLibnodePack(dir, { packageName, verifyHashes: true });
+    }
+    catch (error) {
+        return error instanceof LibnodePackError ? error.message : String(error);
+    }
+    const version = compilerReleaseVersion();
+    if (pack.manifest.version !== version)
+        return `the installed libnode pack ${packageName} at ${dir} is version ${pack.manifest.version ?? "unknown"}; this scriptc is ${version}: install ${packageName}@${version}`;
+    return null;
+}
+/** What to record for a program that calls into Node, or the reason the
+ * build cannot (an SC8005 message). `option` is --libnode. */
+export function libnodeRecord(option, outPath, env = process.env, projectDir = process.cwd()) {
+    const fromEnv = env["SCRIPTC_LIBNODE"];
+    const beside = option === "beside";
+    const explicit = option !== undefined && !beside ? option : fromEnv;
+    const target = libnodeTarget(env);
+    // Without an explicit pack, the installed @scriptc/libnode-<target>.
+    const installed = explicit !== undefined && explicit !== ""
+        ? null
+        : findInstalledLibnodePack({ targetName: target, projectDir });
+    const source = installed ?? explicit;
+    if (source === undefined || source === null || source === "") {
+        const pack = libnodePackPackage(target);
+        return pack === null
+            ? `this program calls into Node.js (@scriptc/node), but there is no libnode pack for ${target}: set SCRIPTC_LIBNODE or pass --libnode=<pack directory>`
+            : `this program calls into Node.js (@scriptc/node), but no libnode pack is installed: install ${pack}, set SCRIPTC_LIBNODE or pass --libnode=<pack directory>`;
+    }
+    if (installed !== null) {
+        const problem = installedPackProblem(installed, libnodePackPackage(target));
+        if (problem !== null)
+            return problem;
+    }
+    if (source.startsWith(ORIGIN)) {
+        // A pack the deployment places next to the executable: nothing to read.
+        return { libnode: source, nodeVersion: "" };
+    }
+    if (!isAbsolute(source))
+        return `the libnode pack directory must be absolute, got '${source}'`;
+    const manifest = readManifest(source);
+    if (typeof manifest === "string")
+        return manifest;
+    if (!beside)
+        return { libnode: resolve(source), nodeVersion: manifest.nodeVersion };
+    const name = `${basename(outPath)}.libnode`;
+    const refused = placeBeside(source, manifest, `${outPath}.libnode`);
+    if (refused !== undefined)
+        return refused;
+    return { libnode: `${ORIGIN}${name}`, nodeVersion: manifest.nodeVersion };
+}
+/** The identity of the libnode pack a build that calls into Node.js
+ * records, which the program's executable cache entry keeps
+ * (EarlyExecutableCacheOptions.libnodeIdentity): the option, the pack
+ * directory (named by --libnode or SCRIPTC_LIBNODE, or the installed pack
+ * found from `projectDir`), and a digest of the pack's manifest.json. A pack
+ * upgraded in place, removed, or replaced by another installed pack changes
+ * it. Undefined when no pack is named or installed. */
+export function libnodeCacheKey(option, env = process.env, projectDir = process.cwd()) {
+    const fromEnv = env["SCRIPTC_LIBNODE"];
+    const explicit = option !== undefined && option !== "beside" ? option : fromEnv;
+    const source = explicit !== undefined && explicit !== ""
+        ? explicit
+        : findInstalledLibnodePack({ targetName: libnodeTarget(env), projectDir });
+    if (source === undefined || source === null)
+        return option === undefined ? undefined : option;
+    let manifest = "none";
+    if (isAbsolute(source)) {
+        try {
+            manifest = createHash("sha256")
+                .update(readFileSync(join(source, "manifest.json")))
+                .digest("hex");
+        }
+        catch {
+            // A missing pack fails the build that records it (libnodeRecord).
+        }
+    }
+    return `${option ?? ""}|${source}|${manifest}`;
+}
+/** The libnode pack directory the build-time probe of deferred islands
+ * runs in (scope-B NI-7): the same pack libnodeRecord records (before a
+ * `beside` copy), or null when the build host has none to run. */
+export function libnodeProbePack(option, env = process.env, projectDir = process.cwd()) {
+    const fromEnv = env["SCRIPTC_LIBNODE"];
+    const explicit = option !== undefined && option !== "beside" ? option : fromEnv;
+    const source = explicit !== undefined && explicit !== ""
+        ? explicit
+        : findInstalledLibnodePack({ targetName: hostLibnodeTarget(), projectDir });
+    if (source === undefined || source === null || source === "" || !isAbsolute(source))
+        return null;
+    return typeof readManifest(source) === "string" ? null : resolve(source);
+}
+//# sourceMappingURL=libnode.js.map

package/dist/node-islands/libnode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libnode.js","sourceRoot":"","sources":["../../src/node-islands/libnode.ts"],"names":[],"mappings":"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"}

package/dist/node-islands/libnode.test.d.ts

@@ -0,0 +1 @@
+export {};