@scriptc/compiler 0.4.5 → 0.4.6

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

@@ -0,0 +1,170 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, test } from "vitest";
+import { USES_TIMERS_LIB_FNS } from "../backend/llvm/lib-shared.js";
+import { libnodeCacheKey, libnodeRecord, libnodeTarget, NODE_BRIDGE_ABI } from "./libnode.js";
+import { libnodePackPackage } from "./libnode-pack.js";
+import { findInstalledLibnodePack, hostLibnodeTarget } from "./libnode-pack.js";
+function pack(nodeVersion, bridgeAbi = NODE_BRIDGE_ABI) {
+    const dir = mkdtempSync(join(tmpdir(), "scriptc-libnode-"));
+    writeFileSync(join(dir, "libnode.so.137"), "lib");
+    writeFileSync(join(dir, "libscr_node_bridge.so"), "bridge");
+    writeFileSync(join(dir, "manifest.json"), JSON.stringify({
+        nodeVersion,
+        bridgeAbi,
+        files: { "libnode.so.137": {}, "libscr_node_bridge.so": {} },
+    }));
+    return dir;
+}
+describe("the recorded libnode pack", () => {
+    test("records the pack directory and its exact Node version", () => {
+        const dir = pack("24.22.0");
+        expect(libnodeRecord(dir, "/out/app", {})).toEqual({ libnode: dir, nodeVersion: "24.22.0" });
+        expect(libnodeRecord(undefined, "/out/app", { SCRIPTC_LIBNODE: dir })).toEqual({
+            libnode: dir,
+            nodeVersion: "24.22.0",
+        });
+    });
+    test("refuses a missing, too old or incompatible pack", () => {
+        // Unless a workspace build of the host's @scriptc/libnode-<platform>
+        // resolves next to the compiler, which libnodeRecord then uses.
+        const installed = findInstalledLibnodePack({
+            targetName: hostLibnodeTarget(),
+            projectDir: "/nonexistent",
+        });
+        if (installed === null) {
+            expect(libnodeRecord(undefined, "/out/app", {}, "/nonexistent")).toMatch(/no libnode pack is installed/);
+        }
+        else {
+            expect(libnodeRecord(undefined, "/out/app", {}, "/nonexistent")).toMatchObject({
+                libnode: installed,
+            });
+        }
+        expect(libnodeRecord("/nonexistent", "/out/app", {})).toBe("no libnode pack at /nonexistent (manifest.json is missing or unreadable)");
+        expect(libnodeRecord(pack("24.12.0"), "/out/app", {})).toMatch(/is Node 24\.12\.0; Node islands need Node\.js >=24\.13\.1$/);
+        expect(libnodeRecord(pack("24.22.0", 99), "/out/app", {})).toMatch(/has bridge ABI 99/);
+        expect(libnodeRecord("relative/pack", "/out/app", {})).toBe("the libnode pack directory must be absolute, got 'relative/pack'");
+    });
+    test("beside copies the pack next to the executable and records it relative to it", () => {
+        const dir = pack("24.22.0");
+        const out = mkdtempSync(join(tmpdir(), "scriptc-libnode-out-"));
+        mkdirSync(out, { recursive: true });
+        expect(libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: dir })).toEqual({
+            libnode: "$ORIGIN/app.libnode",
+            nodeVersion: "24.22.0",
+        });
+        expect(readFileSync(join(out, "app.libnode/libscr_node_bridge.so"), "utf8")).toBe("bridge");
+        expect(existsSync(join(out, "app.libnode/manifest.json"))).toBe(true);
+    });
+    test("beside places the pack again after the outputs were deleted", () => {
+        // A cached executable restored without its pack gets it again (compile, index.ts).
+        const dir = pack("24.22.0");
+        const out = mkdtempSync(join(tmpdir(), "scriptc-libnode-out-"));
+        libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: dir });
+        rmSync(join(out, "app.libnode"), { recursive: true, force: true });
+        expect(libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: dir })).toEqual({
+            libnode: "$ORIGIN/app.libnode",
+            nodeVersion: "24.22.0",
+        });
+        expect(readFileSync(join(out, "app.libnode/libscr_node_bridge.so"), "utf8")).toBe("bridge");
+    });
+    test("beside refuses to replace the pack it copies", () => {
+        const out = mkdtempSync(join(tmpdir(), "scriptc-libnode-out-"));
+        const first = pack("24.22.0");
+        libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: first });
+        // The placed copy as the source of the next beside build.
+        const placed = join(out, "app.libnode");
+        expect(libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: placed })).toMatch(/^--libnode=beside would replace the libnode pack it copies/);
+        expect(readFileSync(join(placed, "libscr_node_bridge.so"), "utf8")).toBe("bridge");
+    });
+    test("beside refuses manifest file names outside the pack", () => {
+        const dir = pack("24.22.0");
+        writeFileSync(join(dir, "manifest.json"), JSON.stringify({ nodeVersion: "24.22.0", bridgeAbi: NODE_BRIDGE_ABI, files: { "../x": {} } }));
+        const out = mkdtempSync(join(tmpdir(), "scriptc-libnode-out-"));
+        expect(libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: dir })).toBe(`the libnode pack at ${dir} lists a file outside the pack ('../x')`);
+        expect(existsSync(join(out, "app.libnode"))).toBe(false);
+    });
+    test("beside refuses manifest file names outside the pack", () => {
+        for (const name of ["..", ".", "../escaped", "/etc/passwd", "a/b", "a\\b", "x\u0000y"]) {
+            const dir = pack("24.22.0");
+            writeFileSync(join(dir, "manifest.json"), JSON.stringify({
+                nodeVersion: "24.22.0",
+                bridgeAbi: NODE_BRIDGE_ABI,
+                files: { [name]: {} },
+            }));
+            const out = mkdtempSync(join(tmpdir(), "scriptc-libnode-out-"));
+            expect(libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: dir })).toBe(`the libnode pack at ${dir} lists a file outside the pack ('${name}')`);
+            expect(existsSync(join(out, "app.libnode"))).toBe(false);
+            expect(existsSync(join(out, "escaped"))).toBe(false);
+        }
+    });
+    test("beside refuses pack files that are symbolic links", () => {
+        const dir = pack("24.22.0");
+        const elsewhere = join(mkdtempSync(join(tmpdir(), "scriptc-libnode-elsewhere-")), "secret");
+        writeFileSync(elsewhere, "secret");
+        rmSync(join(dir, "libnode.so.137"));
+        symlinkSync(elsewhere, join(dir, "libnode.so.137"));
+        const out = mkdtempSync(join(tmpdir(), "scriptc-libnode-out-"));
+        expect(libnodeRecord("beside", join(out, "app"), { SCRIPTC_LIBNODE: dir })).toBe(`the libnode pack at ${dir} holds libnode.so.137 as a symbolic link; pack files must be regular files`);
+        expect(existsSync(join(out, "app.libnode"))).toBe(false);
+    });
+    test("a pack the deployment places beside the executable needs no manifest at build time", () => {
+        expect(libnodeRecord("$ORIGIN/node", "/out/app", {})).toEqual({
+            libnode: "$ORIGIN/node",
+            nodeVersion: "",
+        });
+    });
+});
+describe("the libnode pack identity a cached build keeps", () => {
+    // A workspace build of the target's @scriptc/libnode-<platform> that
+    // resolves next to the compiler (CI assembles one) is installed for every
+    // project, so without a pack in the project the identity names it.
+    const nextToCompiler = findInstalledLibnodePack({
+        targetName: libnodeTarget({}),
+        projectDir: "/nonexistent",
+    });
+    const withoutProjectPack = (key) => {
+        if (nextToCompiler === null)
+            expect(key).toBeUndefined();
+        else
+            expect(key).toContain(`|${nextToCompiler}|`);
+    };
+    test("is absent when no pack is named or installed", () => {
+        withoutProjectPack(libnodeCacheKey(undefined, {}, "/nonexistent"));
+    });
+    test("names the installed pack, and changes with it", () => {
+        const project = mkdtempSync(join(tmpdir(), "scriptc-libnode-project-"));
+        const name = libnodePackPackage(libnodeTarget({}));
+        if (name === null)
+            return;
+        const installed = join(project, "node_modules", name);
+        mkdirSync(installed, { recursive: true });
+        writeFileSync(join(installed, "manifest.json"), JSON.stringify({ nodeVersion: "24.22.0" }));
+        const before = libnodeCacheKey(undefined, {}, project);
+        expect(before).toContain(installed);
+        writeFileSync(join(installed, "manifest.json"), JSON.stringify({ nodeVersion: "24.23.0" }));
+        expect(libnodeCacheKey(undefined, {}, project)).not.toBe(before);
+        rmSync(installed, { recursive: true, force: true });
+        withoutProjectPack(libnodeCacheKey(undefined, {}, project));
+    });
+    test("changes when the pack in the same directory is upgraded", () => {
+        const dir = pack("24.22.0");
+        const before = libnodeCacheKey(dir, {});
+        expect(libnodeCacheKey(dir, {})).toBe(before);
+        writeFileSync(join(dir, "manifest.json"), JSON.stringify({ nodeVersion: "24.23.0", bridgeAbi: NODE_BRIDGE_ABI, files: {} }));
+        expect(libnodeCacheKey(dir, {})).not.toBe(before);
+    });
+    test("names the pack beside copies from", () => {
+        const a = pack("24.22.0");
+        const b = pack("24.22.0");
+        expect(libnodeCacheKey("beside", { SCRIPTC_LIBNODE: a })).not.toBe(libnodeCacheKey("beside", { SCRIPTC_LIBNODE: b }));
+        expect(libnodeCacheKey("beside", { SCRIPTC_LIBNODE: a })).not.toBe(libnodeCacheKey(a, {}));
+    });
+});
+test("calls into Node keep the program's event loop running", () => {
+    // Node's ref'd timers and I/O run on the program's loop (scr_node_island.c).
+    expect(USES_TIMERS_LIB_FNS.has("nodeIsland.call")).toBe(true);
+    expect(USES_TIMERS_LIB_FNS.has("nodeIsland.callSync")).toBe(true);
+});
+//# sourceMappingURL=libnode.test.js.map

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

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

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

@@ -0,0 +1,96 @@
+import type { IrNodeIslandModules } from "../ir/ir.js";
+export type NodeIslandModuleTree = IrNodeIslandModules;
+export declare class NodeIslandModuleCollector {
+    /** Real paths of collected files. */
+    private readonly files;
+    /** Link path (its directory real) → real target. */
+    private readonly links;
+    private readonly packages;
+    private readonly traced;
+    /** Real paths of the calling modules. */
+    private readonly callers;
+    /** Real paths of the files loads name (addLoaded, addProvided). */
+    private readonly loaded;
+    /** Program modules whose source the program provides (addProvided). */
+    private readonly provided;
+    /** Collects the module `specifier` names from `caller` (a real path).
+     * Returns null, or the reason the build cannot ship it. */
+    add(caller: string, specifier: string): string | null;
+    /** Collects the module a load names by its resolved path (a real path):
+     * the package that holds it, or a module of the program with what it
+     * loads. Returns null, or the reason the build cannot ship it. */
+    addLoaded(file: string): string | null;
+    /** Collects a module whose source the program provides (a shared module,
+     * runtime scr_node_island_hooks.cjs): Node still resolves it to its file,
+     * so its package is in the tree, or, for a program module, a placeholder
+     * at its path (providedModulePlaceholder): the program's source stays out
+     * of the executable. Island code that imports it loads the program's
+     * module too, so it is not traced either. */
+    addProvided(file: string): void;
+    /** The collected tree, or null when no call loads a file. */
+    tree(): NodeIslandModuleTree | null;
+    /** The tree path a caller's module has: relative to the tree root. */
+    static callerPath(tree: NodeIslandModuleTree | null, caller: string): string;
+    /** The name a load gives a collected file: `./` and its path relative to
+     * the tree root (the runtime resolves it under the root). */
+    static loadPath(tree: NodeIslandModuleTree | null, file: string): string;
+    private resolveFrom;
+    /** The real path of `path`, recording a link for each component of it
+     * that is a symbolic link (a linked directory on the way, or the file
+     * itself), so that the path resolves inside the tree as it does here. */
+    private placed;
+    /** The real path of the file an absolute or relative `specifier` names
+     * from `fromFile`, or null when there is none. */
+    resolvedPath(fromFile: string, specifier: string): string | null;
+    /** A specifier that names `target` from `caller` inside the tree: the
+     * relative path between them, with `/` separators. */
+    static relativeSpecifier(caller: string, target: string): string;
+    /** A module of the program: collected with the package.json that scopes
+     * it (Node reads its "type"), and its imports traced. */
+    private addModule;
+    /** A package: its whole directory, then its dependencies. */
+    private addPackage;
+    /** Every file below `dir`, except nested node_modules (dependencies come
+     * through package.json and the package's imports) and .git; the
+     * JavaScript files among them also go to `scripts`. */
+    private addDirectory;
+}
+interface Token {
+    kind: "name" | "string" | "punct" | "other";
+    value: string;
+    at: number;
+}
+/** The significant tokens of a JavaScript or TypeScript source: names,
+ * string literals (cooked) and punctuators, without comments, template
+ * text or regular expressions. */
+export declare function moduleTokens(text: string): Token[];
+export interface ModuleSpecifierScan {
+    /** String-literal specifiers of require(), require.resolve(), import(),
+     * import.meta.resolve() and import/export declarations, in source order. */
+    specifiers: string[];
+    /** Loads whose module the source does not name with a string literal. */
+    computed: {
+        at: number;
+        form: string;
+    }[];
+}
+/** The string-literal arguments of `requireModule(...)` calls in source
+ * code, comments and template text excluded. */
+export declare function requireModuleSpecifiers(text: string): string[];
+export declare function scanModuleSpecifiers(text: string): ModuleSpecifierScan;
+/** What the tree ships at the path of a program module the islands share:
+ * Node resolves the module to this file and the program's loader hooks
+ * answer its source (runtime scr_node_island_hooks.cjs), so the file holds
+ * none of the program's source. Evaluating it throws. */
+export declare function providedModulePlaceholder(path: string): Uint8Array;
+/** The manifest the executable records (scr_node_island.c reads it):
+ * `{"files":[[path,size,sha256],...],"links":[[path,target],...]}`. Its
+ * SHA-256 names the tree. */
+export declare function nodeIslandManifest(modules: IrNodeIslandModules): string;
+/** The tree's files concatenated in manifest order, each checked against
+ * the digest the build recorded, or the reason one no longer matches. */
+export declare function readNodeIslandModules(modules: IrNodeIslandModules): Uint8Array | string;
+/** Writes the tree to `target` (replacing it), for `--libnode=beside`, or
+ * returns the reason it cannot. */
+export declare function placeNodeIslandModules(modules: IrNodeIslandModules, target: string): string | null;
+export {};