xit-wasm 0.1.0

package/dist/host-node.js

@@ -0,0 +1,376 @@
+/**
+ * Node-fs-backed Host implementation.
+ *
+ * Strategy:
+ *   - Dir handles are i32s mapped to absolute filesystem paths. Handle 0 is
+ *     reserved for the "root" directory provided to NodeHost's constructor;
+ *     all sub-path operations resolve relative to it.
+ *   - File handles are i32s mapped to Node file descriptors (fs.openSync), but
+ *     wrapped with a small extra state object so we can track current position
+ *     (for seek-by) and locked state without re-querying the fs.
+ *   - All ops use Node sync APIs. Plenty fast for spike-grade testing; can
+ *     swap for a Worker-driven async model later if needed.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+import { KIND_FILE, KIND_DIR, KIND_SYMLINK, KIND_OTHER, OK, ERR_GENERIC, ERR_NOT_FOUND, } from "./host.js";
+export class NodeHost {
+    dirs = new Map();
+    files = new Map();
+    nextHandle = 100;
+    trace = false;
+    constructor(rootPath) {
+        this.dirs.set(0, rootPath);
+    }
+    log(...args) {
+        if (this.trace)
+            console.error("[host]", ...args);
+    }
+    resolve(dirHandle, sub) {
+        const base = this.dirs.get(dirHandle);
+        if (base === undefined)
+            throw new Error(`unknown dir handle ${dirHandle}`);
+        return path.resolve(base, sub);
+    }
+    allocHandle() {
+        return this.nextHandle++;
+    }
+    statToResult(s) {
+        let kind = KIND_OTHER;
+        if (s.isFile())
+            kind = KIND_FILE;
+        else if (s.isDirectory())
+            kind = KIND_DIR;
+        else if (s.isSymbolicLink())
+            kind = KIND_SYMLINK;
+        // Node's plain Stats has *Ms (number); promote to ns BigInt by hand. The
+        // bigint variant of Stats has *Ns directly but it forces every access to
+        // BigInt and is hairier to thread through.
+        const msToNs = (ms) => BigInt(Math.floor(ms)) * 1000000n;
+        return {
+            size: BigInt(s.size),
+            mtimeNs: msToNs(s.mtimeMs),
+            atimeNs: msToNs(s.atimeMs),
+            ctimeNs: msToNs(s.ctimeMs),
+            inode: BigInt(s.ino),
+            kind,
+            modeBits: s.mode & 0o777,
+        };
+    }
+    // ----- dir -----
+    dirCreateFile(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            const fd = fs.openSync(abs, "w+");
+            const handle = this.allocHandle();
+            this.files.set(handle, { fd, position: 0n });
+            this.log("dirCreateFile", abs, "->", handle);
+            return { code: OK, handle };
+        }
+        catch (err) {
+            this.log("dirCreateFile FAIL", abs, err.code);
+            return { code: ERR_GENERIC, handle: -1 };
+        }
+    }
+    dirOpenFile(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            const fd = fs.openSync(abs, "r+");
+            const handle = this.allocHandle();
+            this.files.set(handle, { fd, position: 0n });
+            this.log("dirOpenFile", abs, "->", handle);
+            return { code: OK, handle };
+        }
+        catch (err) {
+            this.log("dirOpenFile FAIL", abs, err.code);
+            return { code: ERR_NOT_FOUND, handle: -1 };
+        }
+    }
+    dirCreateDir(dirHandle, sub) {
+        try {
+            fs.mkdirSync(this.resolve(dirHandle, sub));
+            return OK;
+        }
+        catch (err) {
+            if (err.code === "EEXIST")
+                return ERR_GENERIC; // xit treats this as already-exists
+            return ERR_GENERIC;
+        }
+    }
+    dirCreateDirPath(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        let existed = false;
+        try {
+            fs.statSync(abs);
+            existed = true;
+        }
+        catch { }
+        try {
+            fs.mkdirSync(abs, { recursive: true });
+            return { code: OK, existed };
+        }
+        catch {
+            return { code: ERR_GENERIC, existed: false };
+        }
+    }
+    dirCreateDirPathOpen(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            fs.mkdirSync(abs, { recursive: true });
+            const handle = this.allocHandle();
+            this.dirs.set(handle, abs);
+            this.log("dirCreateDirPathOpen", abs, "->", handle);
+            return { code: OK, handle };
+        }
+        catch (err) {
+            this.log("dirCreateDirPathOpen FAIL", abs, err.code);
+            return { code: ERR_GENERIC, handle: -1 };
+        }
+    }
+    dirOpenDir(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            const s = fs.statSync(abs);
+            if (!s.isDirectory())
+                return { code: ERR_NOT_FOUND, handle: -1 };
+            const handle = this.allocHandle();
+            this.dirs.set(handle, abs);
+            return { code: OK, handle };
+        }
+        catch {
+            return { code: ERR_NOT_FOUND, handle: -1 };
+        }
+    }
+    dirClose(handle) {
+        if (handle === 0)
+            return; // never close the root
+        this.dirs.delete(handle);
+    }
+    dirDeleteFile(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            fs.unlinkSync(abs);
+            this.log("dirDeleteFile", abs);
+            return OK;
+        }
+        catch (err) {
+            this.log("dirDeleteFile FAIL", abs, err.code);
+            return ERR_NOT_FOUND;
+        }
+    }
+    dirRename(oldDir, oldSub, newDir, newSub) {
+        const oldAbs = this.resolve(oldDir, oldSub);
+        const newAbs = this.resolve(newDir, newSub);
+        try {
+            fs.renameSync(oldAbs, newAbs);
+            this.log("dirRename", oldAbs, "->", newAbs);
+            return OK;
+        }
+        catch (err) {
+            this.log("dirRename FAIL", oldAbs, "->", newAbs, err.code);
+            return ERR_GENERIC;
+        }
+    }
+    dirStatFile(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            const s = fs.lstatSync(abs);
+            this.log("dirStatFile", abs, "size", s.size);
+            return { code: OK, stat: this.statToResult(s) };
+        }
+        catch (err) {
+            this.log("dirStatFile FAIL", abs, err.code);
+            return { code: ERR_NOT_FOUND };
+        }
+    }
+    dirReadLink(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            const target = fs.readlinkSync(abs);
+            this.log("dirReadLink", abs, "->", target);
+            return { code: 1, target };
+        }
+        catch (err) {
+            if (err.code === "EINVAL") {
+                // not a symlink — xit needs to know this distinction
+                this.log("dirReadLink", abs, "(not a symlink)");
+                return { code: 0 };
+            }
+            this.log("dirReadLink FAIL", abs, err.code);
+            return { code: -1 };
+        }
+    }
+    dirAccess(dirHandle, sub) {
+        const abs = this.resolve(dirHandle, sub);
+        try {
+            fs.accessSync(abs);
+            this.log("dirAccess OK", abs);
+            return OK;
+        }
+        catch {
+            this.log("dirAccess MISSING", abs);
+            return ERR_NOT_FOUND;
+        }
+    }
+    // ----- file -----
+    fileClose(handle) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return;
+        try {
+            fs.closeSync(entry.fd);
+        }
+        catch { }
+        this.files.delete(handle);
+    }
+    fileRead(handle, offset, len) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return { code: ERR_GENERIC, data: new Uint8Array(0) };
+        const buf = Buffer.alloc(len);
+        try {
+            const n = fs.readSync(entry.fd, buf, 0, len, Number(offset));
+            this.log("fileRead", handle, "offset", offset, "len", len, "got", n);
+            return { code: OK, data: new Uint8Array(buf.buffer, buf.byteOffset, n) };
+        }
+        catch (err) {
+            this.log("fileRead FAIL", handle, err.code);
+            return { code: ERR_GENERIC, data: new Uint8Array(0) };
+        }
+    }
+    fileWriteStream(handle, data) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return { code: ERR_GENERIC, written: 0 };
+        const buf = Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+        try {
+            const n = fs.writeSync(entry.fd, buf, 0, buf.length, Number(entry.position));
+            entry.position += BigInt(n);
+            this.log("fileWriteStream", handle, "wrote", n, "newPos", entry.position);
+            return { code: OK, written: n };
+        }
+        catch (err) {
+            this.log("fileWriteStream FAIL", handle, err.code);
+            return { code: ERR_GENERIC, written: 0 };
+        }
+    }
+    fileReadStream(handle, len) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return { code: ERR_GENERIC, data: new Uint8Array(0) };
+        const buf = Buffer.alloc(len);
+        try {
+            const n = fs.readSync(entry.fd, buf, 0, len, Number(entry.position));
+            entry.position += BigInt(n);
+            this.log("fileReadStream", handle, "got", n, "newPos", entry.position);
+            return { code: OK, data: new Uint8Array(buf.buffer, buf.byteOffset, n) };
+        }
+        catch (err) {
+            this.log("fileReadStream FAIL", handle, err.code);
+            return { code: ERR_GENERIC, data: new Uint8Array(0) };
+        }
+    }
+    fileWrite(handle, offset, data) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return { code: ERR_GENERIC, written: 0 };
+        const buf = Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+        try {
+            const n = fs.writeSync(entry.fd, buf, 0, buf.length, Number(offset));
+            this.log("fileWrite", handle, "offset", offset, "len", buf.length, "wrote", n);
+            return { code: OK, written: n };
+        }
+        catch (err) {
+            this.log("fileWrite FAIL", handle, err.code);
+            return { code: ERR_GENERIC, written: 0 };
+        }
+    }
+    fileStat(handle) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return { code: ERR_GENERIC };
+        try {
+            const s = fs.fstatSync(entry.fd);
+            this.log("fileStat", handle, "size", s.size, "kind", this.statToResult(s).kind);
+            return { code: OK, stat: this.statToResult(s) };
+        }
+        catch (err) {
+            this.log("fileStat FAIL", handle, err.code);
+            return { code: ERR_GENERIC };
+        }
+    }
+    fileLength(handle) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return { code: ERR_GENERIC, length: 0n };
+        try {
+            const s = fs.fstatSync(entry.fd);
+            this.log("fileLength", handle, "->", s.size);
+            return { code: OK, length: BigInt(s.size) };
+        }
+        catch (err) {
+            this.log("fileLength FAIL", handle, err.code);
+            return { code: ERR_GENERIC, length: 0n };
+        }
+    }
+    fileSeekTo(handle, offset) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return ERR_GENERIC;
+        entry.position = offset;
+        return OK;
+    }
+    fileSeekBy(handle, relative) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return ERR_GENERIC;
+        entry.position += relative;
+        return OK;
+    }
+    fileLock(_handle, _kind) {
+        // Spike: no real flock. We're single-process, single-threaded — index/db
+        // mutexes inside one xit run are guaranteed serial via JS event loop.
+        return OK;
+    }
+    fileTryLock(_handle, _kind) {
+        return 1; // always acquired in spike mode
+    }
+    fileUnlock(_handle) {
+        /* no-op */
+    }
+    fileSync(handle) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return ERR_GENERIC;
+        try {
+            fs.fsyncSync(entry.fd);
+            return OK;
+        }
+        catch {
+            return ERR_GENERIC;
+        }
+    }
+    fileSetLength(handle, length) {
+        const entry = this.files.get(handle);
+        if (!entry)
+            return ERR_GENERIC;
+        try {
+            fs.ftruncateSync(entry.fd, Number(length));
+            this.log("fileSetLength", handle, "->", length);
+            return OK;
+        }
+        catch (err) {
+            this.log("fileSetLength FAIL", handle, err.code);
+            return ERR_GENERIC;
+        }
+    }
+    // ----- misc -----
+    nowNanos() {
+        return BigInt(Date.now()) * 1000000n;
+    }
+    random(buf) {
+        crypto.randomFillSync(buf);
+    }
+}
+//# sourceMappingURL=host-node.js.map

package/dist/host-node.js.map

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

package/dist/host.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Host import surface. The wasm module declares 24 `host.*` extern functions;
+ * a Host implementation provides their JS-side bodies. This module defines:
+ *
+ *   - The Host interface (signatures matching src/host_io.zig).
+ *   - HostStat: byte-layout helper that mirrors the Zig HostStat extern struct.
+ *   - hostImports(): converts a Host into the WebAssembly imports object the
+ *     wasm module expects.
+ *
+ * The wasm passes pointers + lengths into linear memory; Host implementations
+ * take a `WebAssembly.Memory` reference at construction time so they can read
+ * and write into wasm memory directly.
+ */
+/** Wire layout matches `HostStat` in src/host_io.zig — 48 bytes, 8-aligned. */
+export declare const HOST_STAT_BYTES = 48;
+export type Kind = "file" | "directory" | "sym_link" | "other";
+export declare const KIND_FILE = 0;
+export declare const KIND_DIR = 1;
+export declare const KIND_SYMLINK = 2;
+export declare const KIND_OTHER = 3;
+export declare const LOCK_NONE = 0;
+export declare const LOCK_SHARED = 1;
+export declare const LOCK_EXCLUSIVE = 2;
+/** Status codes the Host returns. 0 = success; non-zero values are passed
+ *  through to xit and surface as errors there. Keeping this enum loose for
+ *  now — finer-grained error mapping is a follow-up. */
+export declare const OK = 0;
+export declare const ERR_GENERIC = 1;
+export declare const ERR_NOT_FOUND = 2;
+export interface StatResult {
+    size: bigint;
+    mtimeNs: bigint;
+    atimeNs: bigint;
+    ctimeNs: bigint;
+    inode: bigint;
+    kind: number;
+    modeBits: number;
+}
+/**
+ * The behavior surface a Host has to provide. Each method takes already-decoded
+ * arguments (paths as strings, handles as numbers) — the wasm-import shims in
+ * hostImports() handle pointer-decoding before calling into the host.
+ *
+ * Handles are opaque i32s; the host owns the mapping (e.g. dir handle 0 is the
+ * "root" the host chose to expose to xit). xit itself only ever passes them
+ * back through the same set of host calls.
+ */
+export interface Host {
+    dirCreateFile(dirHandle: number, path: string): {
+        code: number;
+        handle: number;
+    };
+    dirOpenFile(dirHandle: number, path: string): {
+        code: number;
+        handle: number;
+    };
+    dirCreateDir(dirHandle: number, path: string): number;
+    dirCreateDirPath(dirHandle: number, path: string): {
+        code: number;
+        existed: boolean;
+    };
+    dirCreateDirPathOpen(dirHandle: number, path: string): {
+        code: number;
+        handle: number;
+    };
+    dirOpenDir(dirHandle: number, path: string): {
+        code: number;
+        handle: number;
+    };
+    dirClose(handle: number): void;
+    dirDeleteFile(dirHandle: number, path: string): number;
+    dirRename(oldDir: number, oldPath: string, newDir: number, newPath: string): number;
+    dirStatFile(dirHandle: number, path: string): {
+        code: number;
+        stat?: StatResult;
+    };
+    dirAccess(dirHandle: number, path: string): number;
+    /** Returns:
+     *   - { code: 1+, target } — symlink with target string
+     *   - { code: 0 } — path exists but is not a symlink (xit needs the distinction)
+     *   - { code: -1 } — path does not exist or unreadable
+     */
+    dirReadLink(dirHandle: number, path: string): {
+        code: number;
+        target?: string;
+    };
+    fileClose(handle: number): void;
+    fileRead(handle: number, offset: bigint, len: number): {
+        code: number;
+        data: Uint8Array;
+    };
+    fileWrite(handle: number, offset: bigint, data: Uint8Array): {
+        code: number;
+        written: number;
+    };
+    fileWriteStream(handle: number, data: Uint8Array): {
+        code: number;
+        written: number;
+    };
+    fileReadStream(handle: number, len: number): {
+        code: number;
+        data: Uint8Array;
+    };
+    fileStat(handle: number): {
+        code: number;
+        stat?: StatResult;
+    };
+    fileLength(handle: number): {
+        code: number;
+        length: bigint;
+    };
+    fileSeekTo(handle: number, offset: bigint): number;
+    fileSeekBy(handle: number, relative: bigint): number;
+    fileLock(handle: number, kind: number): number;
+    /** Returns 1 if acquired, 0 if would-block, negative on error. */
+    fileTryLock(handle: number, kind: number): number;
+    fileUnlock(handle: number): void;
+    fileSync(handle: number): number;
+    fileSetLength(handle: number, length: bigint): number;
+    nowNanos(): bigint;
+    random(buf: Uint8Array): void;
+}
+/**
+ * Build the WebAssembly imports object expected by the wasm module. Pointer-
+ * decoding lives here (centralized) so individual Host implementations can stay
+ * focused on their own backing store.
+ */
+export declare function hostImports(host: Host, getMemory: () => WebAssembly.Memory): {
+    host: {
+        host_dir_create_file: (dirH: number, p: number, plen: number, outH: number) => number;
+        host_dir_open_file: (dirH: number, p: number, plen: number, outH: number) => number;
+        host_dir_create_dir: (dirH: number, p: number, plen: number) => number;
+        host_dir_create_dir_path: (dirH: number, p: number, plen: number, outExisted: number) => number;
+        host_dir_create_dir_path_open: (dirH: number, p: number, plen: number, outH: number) => number;
+        host_dir_open_dir: (dirH: number, p: number, plen: number, outH: number) => number;
+        host_dir_close: (h: number) => void;
+        host_dir_delete_file: (dirH: number, p: number, plen: number) => number;
+        host_dir_rename: (oldDir: number, op: number, olen: number, newDir: number, np: number, nlen: number) => number;
+        host_dir_stat_file: (dirH: number, p: number, plen: number, outStat: number) => number;
+        host_dir_access: (dirH: number, p: number, plen: number) => number;
+        host_dir_read_link: (dirH: number, p: number, plen: number, bufPtr: number, bufLen: number, outSize: number) => number;
+        host_file_close: (h: number) => void;
+        host_file_read: (h: number, offset: bigint, bufPtr: number, bufLen: number, outRead: number) => number;
+        host_file_write: (h: number, offset: bigint, bufPtr: number, bufLen: number, outWritten: number) => number;
+        host_file_stat: (h: number, outStat: number) => number;
+        host_file_length: (h: number, outLen: number) => number;
+        host_file_write_stream: (h: number, bufPtr: number, bufLen: number, outWritten: number) => number;
+        host_file_read_stream: (h: number, bufPtr: number, bufLen: number, outRead: number) => number;
+        host_file_seek_to: (h: number, offset: bigint) => number;
+        host_file_seek_by: (h: number, relative: bigint) => number;
+        host_file_lock: (h: number, kind: number) => number;
+        host_file_try_lock: (h: number, kind: number) => number;
+        host_file_unlock: (h: number) => void;
+        host_file_sync: (h: number) => number;
+        host_file_set_length: (h: number, len: bigint) => number;
+        host_now_nanos: () => bigint;
+        host_random: (bufPtr: number, bufLen: number) => void;
+    };
+};
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

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