toiljs 0.0.115 → 0.0.117

package/test/version-check.test.ts

@@ -1,130 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import {
-    CHECK_TTL_MS,
-    compareSemver,
-    findOutdated,
-    installCommand,
-    isCacheFresh,
-    isOutdated,
-    parseCheckCache,
-} from '../src/cli/version-check';
-
-describe('compareSemver', () => {
-    it('orders plain versions', () => {
-        expect(compareSemver('0.0.31', '0.0.32')).toBeLessThan(0);
-        expect(compareSemver('0.0.32', '0.0.31')).toBeGreaterThan(0);
-        expect(compareSemver('0.0.31', '0.0.31')).toBe(0);
-        expect(compareSemver('0.9.9', '0.10.0')).toBeLessThan(0);
-        expect(compareSemver('1.0.0', '0.99.99')).toBeGreaterThan(0);
-    });
-
-    it('treats a prerelease as older than its release', () => {
-        expect(compareSemver('0.1.0-beta.1', '0.1.0')).toBeLessThan(0);
-        expect(compareSemver('0.1.0', '0.1.0-beta.1')).toBeGreaterThan(0);
-        expect(compareSemver('0.1.0-alpha', '0.1.0-beta')).toBeLessThan(0);
-    });
-
-    it('tolerates a leading v and garbage input', () => {
-        expect(compareSemver('v1.2.3', '1.2.3')).toBe(0);
-        expect(compareSemver('garbage', '0.0.0')).toBe(0);
-    });
-});
-
-describe('isOutdated', () => {
-    it('is true only when installed is behind latest', () => {
-        expect(isOutdated('0.0.31', '0.0.32')).toBe(true);
-        expect(isOutdated('0.0.32', '0.0.32')).toBe(false);
-        // A local build ahead of the registry must not warn.
-        expect(isOutdated('0.0.33', '0.0.32')).toBe(false);
-    });
-});
-
-describe('parseCheckCache', () => {
-    it('parses a valid cache entry', () => {
-        expect(parseCheckCache('{"latest":"0.0.32","checkedAt":1000}')).toEqual({
-            latest: '0.0.32',
-            checkedAt: 1000,
-        });
-    });
-
-    it('keeps a cached failure (latest null) so offline machines back off', () => {
-        expect(parseCheckCache('{"latest":null,"checkedAt":1000}')).toEqual({
-            latest: null,
-            checkedAt: 1000,
-        });
-    });
-
-    it('rejects malformed contents', () => {
-        expect(parseCheckCache('not json')).toBeNull();
-        expect(parseCheckCache('[]')).toBeNull();
-        expect(parseCheckCache('{"latest":"0.0.32"}')).toBeNull();
-        expect(parseCheckCache('{"latest":42,"checkedAt":"soon"}')).toBeNull();
-    });
-});
-
-describe('isCacheFresh', () => {
-    const cache = { latest: '0.0.32', checkedAt: 10_000 };
-
-    it('is fresh within the TTL and stale after it', () => {
-        expect(isCacheFresh(cache, 10_000 + CHECK_TTL_MS - 1)).toBe(true);
-        expect(isCacheFresh(cache, 10_000 + CHECK_TTL_MS)).toBe(false);
-    });
-
-    it('is stale when the clock went backwards past checkedAt', () => {
-        expect(isCacheFresh(cache, 9_999)).toBe(false);
-    });
-});
-
-describe('installCommand', () => {
-    it('targets the project with the detected package manager', () => {
-        expect(installCommand('npm', 'project')).toBe('npm install toiljs@latest');
-        expect(installCommand('pnpm', 'project')).toBe('pnpm add toiljs@latest');
-        expect(installCommand('yarn', 'project')).toBe('yarn add toiljs@latest');
-        expect(installCommand('bun', 'project')).toBe('bun add toiljs@latest');
-    });
-
-    it('targets the global install', () => {
-        expect(installCommand('npm', 'global')).toBe('npm install -g toiljs@latest');
-        expect(installCommand('pnpm', 'global')).toBe('pnpm add -g toiljs@latest');
-    });
-});
-
-describe('findOutdated', () => {
-    it('flags an outdated project install with the project command', () => {
-        const rows = findOutdated('0.0.32', '0.0.31', '0.0.31', true, 'pnpm');
-        expect(rows).toEqual([
-            { scope: 'project', installed: '0.0.31', command: 'pnpm add toiljs@latest' },
-        ]);
-    });
-
-    it('flags an outdated global CLI even when the project is current', () => {
-        const rows = findOutdated('0.0.32', '0.0.32', '0.0.30', false, 'npm');
-        expect(rows).toEqual([
-            { scope: 'global', installed: '0.0.30', command: 'npm install -g toiljs@latest' },
-        ]);
-    });
-
-    it('flags both when a stale global CLI runs inside a stale project', () => {
-        const rows = findOutdated('0.0.32', '0.0.31', '0.0.30', false, 'npm');
-        expect(rows.map((r) => r.scope)).toEqual(['project', 'global']);
-    });
-
-    it('does not double-report when the running CLI is the project install', () => {
-        const rows = findOutdated('0.0.32', '0.0.31', '0.0.31', true, 'npm');
-        expect(rows).toHaveLength(1);
-        expect(rows[0].scope).toBe('project');
-    });
-
-    it('reports nothing when everything is current or ahead', () => {
-        expect(findOutdated('0.0.32', '0.0.32', '0.0.32', true, 'npm')).toEqual([]);
-        expect(findOutdated('0.0.32', null, '0.0.33', false, 'npm')).toEqual([]);
-    });
-
-    it('handles a missing project install (npx outside a project)', () => {
-        const rows = findOutdated('0.0.32', null, '0.0.31', false, 'npm');
-        expect(rows).toEqual([
-            { scope: 'global', installed: '0.0.31', command: 'npm install -g toiljs@latest' },
-        ]);
-    });
-});

package/tests/data-parity/generated-parity.ts

@@ -1,99 +0,0 @@
-// Proves the fork's GENERATED @data class (from --rpcModule) matches the AS @data
-// wire byte-for-byte. Compiles spec.ts (which has `@data class Foo`) with the
-// ToilScript fork, emitting both the wasm and the generated server.ts, then checks
-// the generated Foo class against the AS Foo.encode() bytes, both directions.
-// Run with: node tests/data-parity/generated-parity.ts
-import { readFileSync, writeFileSync, mkdtempSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join, dirname } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { spawnSync } from "node:child_process";
-const here = dirname(fileURLToPath(import.meta.url));
-// The generated module imports DataWriter/DataReader from this specifier.
-const codec = join(here, "..", "..", "src", "io", "codec.ts");
-const fork = "/root/toil-stuff/toilscript";
-const spec = join(here, "spec.ts");
-const tmp = mkdtempSync(join(tmpdir(), "gen-parity-"));
-const wasmPath = join(tmp, "spec.wasm");
-const modPath = join(tmp, "server.ts");
-writeFileSync(join(tmp, "package.json"), '{ "type": "module" }\n');
-
-const compile = spawnSync(
-    "node",
-    [join(fork, "bin", "toilscript.js"), spec, "-o", wasmPath, "--runtime", "stub", "--initialMemory", "32", "--rpcModule", modPath, "--rpcRuntime", codec],
-    { stdio: "inherit" },
-);
-if (compile.status !== 0) {
-    console.error("generated parity: COMPILE FAILED");
-    rmSync(tmp, { recursive: true, force: true });
-    process.exit(1);
-}
-
-function fail(msg: string): never {
-    console.error("generated parity: FAIL,", msg);
-    rmSync(tmp, { recursive: true, force: true });
-    process.exit(1);
-}
-function bytesEqual(a: Uint8Array, b: Uint8Array): boolean {
-    if (a.length !== b.length) return false;
-    for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
-    return true;
-}
-const hex = (b: Uint8Array): string => Buffer.from(b).toString("hex");
-
-// the known sample (must match spec.ts `sample()`)
-const ID = 0xcafebabedeadbeefn;
-const COUNT = -42;
-const FLAG = true;
-const BIG = 123456789n;
-const NAME = "cross-lang";
-
-// AS side: instantiate and read the sample bytes out of linear memory.
-const { instance } = await WebAssembly.instantiate(readFileSync(wasmPath), {
-    env: { abort: (_m: number, _f: number, line: number) => { throw new Error("wasm abort @ line " + line); } },
-});
-const x = instance.exports as Record<string, CallableFunction> & { memory: WebAssembly.Memory };
-const SCRATCH = 0x100000;
-const len = x.encodeSampleTo(SCRATCH) as number;
-const wasmBytes = new Uint8Array(x.memory.buffer, SCRATCH, len).slice();
-
-// Generated side: build the same value with the generated Foo class and encode.
-const gen = (await import(pathToFileURL(modPath).href)) as {
-    Foo: new () => {
-        id: bigint; count: number; flag: boolean; big: bigint; name: string;
-        encode(): Uint8Array;
-    } & Record<string, unknown>;
-};
-const FooClass = gen.Foo as unknown as {
-    new (): { id: bigint; count: number; flag: boolean; big: bigint; name: string; encode(): Uint8Array };
-    decode(buf: Uint8Array): { id: bigint; count: number; flag: boolean; big: bigint; name: string };
-    dataId(): number;
-};
-
-const foo = new FooClass();
-foo.id = ID;
-foo.count = COUNT;
-foo.flag = FLAG;
-foo.big = BIG;
-foo.name = NAME;
-const genBytes = foo.encode();
-
-// 1) byte-for-byte identical to the AS @data encoding.
-if (!bytesEqual(genBytes, wasmBytes)) {
-    fail(`byte mismatch\n  AS:        ${hex(wasmBytes)}\n  generated: ${hex(genBytes)}`);
-}
-
-// 2) the generated decode round-trips the AS bytes back to the sample.
-const back = FooClass.decode(wasmBytes);
-if (back.id !== ID) fail("id (decode)");
-if (back.count !== COUNT) fail("count (decode)");
-if (back.flag !== FLAG) fail("flag (decode)");
-if (back.big !== BIG) fail("big (decode)");
-if (back.name !== NAME) fail("name (decode)");
-
-// 3) the AS side accepts the generated bytes.
-new Uint8Array(x.memory.buffer, SCRATCH, genBytes.length).set(genBytes);
-if ((x.checkBytes(SCRATCH, genBytes.length) as number) !== 1) fail("AS rejected generated bytes");
-
-console.log(`@data generated-class parity: PASS (generated <-> AS both ways, byte-for-byte, ${len} bytes)`);
-rmSync(tmp, { recursive: true, force: true });

package/tests/data-parity/parity.ts

@@ -1,80 +0,0 @@
-// Cross-language @data byte-parity proof. Compiles spec.ts with the ToilScript
-// fork (which has @data), then checks the TS codec (src/io/codec.ts) against it
-// both directions, including byte-for-byte. Run with: node tests/data-parity/parity.ts
-import { readFileSync, mkdtempSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-import { DataWriter, DataReader } from "../../src/io/codec.ts";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const fork = "/root/toil-stuff/toilscript";
-const spec = join(here, "spec.ts");
-const tmp = mkdtempSync(join(tmpdir(), "parity-"));
-const wasmPath = join(tmp, "spec.wasm");
-
-const compile = spawnSync(
-    "node",
-    [join(fork, "bin", "toilscript.js"), spec, "-o", wasmPath, "--runtime", "stub", "--initialMemory", "32"],
-    { stdio: "inherit" },
-);
-if (compile.status !== 0) {
-    console.error("@data parity: COMPILE FAILED");
-    rmSync(tmp, { recursive: true, force: true });
-    process.exit(1);
-}
-
-function fail(msg: string): never {
-    console.error("@data parity: FAIL,", msg);
-    rmSync(tmp, { recursive: true, force: true });
-    process.exit(1);
-}
-function bytesEqual(a: Uint8Array, b: Uint8Array): boolean {
-    if (a.length !== b.length) return false;
-    for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
-    return true;
-}
-const hex = (b: Uint8Array): string => Buffer.from(b).toString("hex");
-
-const { instance } = await WebAssembly.instantiate(readFileSync(wasmPath), {
-    env: { abort: (_m: number, _f: number, line: number) => { throw new Error("wasm abort @ line " + line); } },
-});
-const x = instance.exports as Record<string, CallableFunction> & { memory: WebAssembly.Memory };
-const mem = x.memory;
-const SCRATCH = 0x100000; // 1 MiB, above the low heap
-
-// the known sample (must match spec.ts)
-const ID = 0xcafebabedeadbeefn;
-const COUNT = -42;
-const FLAG = true;
-const BIG = 123456789n;
-const NAME = "cross-lang";
-const fooId = (x.fooId() as number) >>> 0;
-
-// 1) ToilScript encodes the sample; read its bytes out of linear memory.
-const len = x.encodeSampleTo(SCRATCH) as number;
-const wasmBytes = new Uint8Array(mem.buffer, SCRATCH, len).slice();
-
-// 2) TS decodes the ToilScript bytes.
-const r = new DataReader(wasmBytes);
-if ((r.readU32() >>> 0) !== fooId) fail("typeId mismatch");
-if (r.readU64() !== ID) fail("id (ToilScript -> TS)");
-if (r.readI32() !== COUNT) fail("count (ToilScript -> TS)");
-if (r.readBool() !== FLAG) fail("flag (ToilScript -> TS)");
-if (r.readU128() !== BIG) fail("big (ToilScript -> TS)");
-if (r.readString() !== NAME) fail("name (ToilScript -> TS)");
-if (!r.ok || r.remaining() !== 0) fail("trailing/ok (ToilScript -> TS)");
-
-// 3) TS encodes the same value; it must be byte-for-byte identical.
-const w = new DataWriter();
-w.writeU32(fooId).writeU64(ID).writeI32(COUNT).writeBool(FLAG).writeU128(BIG).writeString(NAME);
-const tsBytes = w.toBytes();
-if (!bytesEqual(tsBytes, wasmBytes)) fail(`byte mismatch\n  ToilScript: ${hex(wasmBytes)}\n  TS:         ${hex(tsBytes)}`);
-
-// 4) ToilScript decodes the TS bytes and confirms the value.
-new Uint8Array(mem.buffer, SCRATCH, tsBytes.length).set(tsBytes);
-if ((x.checkBytes(SCRATCH, tsBytes.length) as number) !== 1) fail("ToilScript rejected TS bytes (TS -> ToilScript)");
-
-console.log(`@data parity: PASS (ToilScript<->TS both ways, byte-for-byte, ${len} bytes)`);
-rmSync(tmp, { recursive: true, force: true });

package/tests/data-parity/spec.ts

@@ -1,46 +0,0 @@
-// ToilScript side of the cross-language @data parity proof. Compiled by the
-// ToilScript fork (which has @data + std/assembly/data.ts). Exposes a known sample so the
-// TS codec can be checked against it byte-for-byte, both directions.
-//
-// A fixed scratch region (high in linear memory, away from the low heap) is used
-// to move bytes across the JS boundary without the loader.
-
-@data
-class Foo {
-  id: u64 = 0;
-  count: i32 = 0;
-  flag: bool = false;
-  big: u128 = u128.Zero;
-  name: string = "";
-}
-
-function sample(): Foo {
-  const f = new Foo();
-  f.id = 0xCAFEBABEDEADBEEF;
-  f.count = -42;
-  f.flag = true;
-  f.big = u128.fromU64(123456789);
-  f.name = "cross-lang";
-  return f;
-}
-
-export function fooId(): u32 {
-  return Foo.dataId();
-}
-
-/** Encode the sample, copy it to `out`, return the byte length. */
-export function encodeSampleTo(out: usize): i32 {
-  const bytes = sample().encode();
-  memory.copy(out, bytes.dataStart, <usize>bytes.length);
-  return bytes.length;
-}
-
-/** Decode `len` bytes at `inp` and return 1 if they equal the sample, else 0. */
-export function checkBytes(inp: usize, len: i32): i32 {
-  const bytes = new Uint8Array(len);
-  memory.copy(bytes.dataStart, inp, <usize>len);
-  const f = Foo.decode(bytes);
-  const s = sample();
-  const ok = f.id == s.id && f.count == s.count && f.flag == s.flag && f.big == s.big && f.name == s.name;
-  return ok ? 1 : 0;
-}