xit-wasm 0.1.0

package/dist/host.js

@@ -0,0 +1,164 @@
+/**
+ * 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 const HOST_STAT_BYTES = 48;
+export const KIND_FILE = 0;
+export const KIND_DIR = 1;
+export const KIND_SYMLINK = 2;
+export const KIND_OTHER = 3;
+export const LOCK_NONE = 0;
+export const LOCK_SHARED = 1;
+export 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 const OK = 0;
+export const ERR_GENERIC = 1;
+export const ERR_NOT_FOUND = 2;
+/**
+ * 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 function hostImports(host, getMemory) {
+    const dec = new TextDecoder();
+    const memU8 = () => new Uint8Array(getMemory().buffer);
+    const memDV = () => new DataView(getMemory().buffer);
+    const readStr = (ptr, len) => dec.decode(memU8().slice(ptr, ptr + len));
+    const writeStat = (ptr, s) => {
+        const dv = memDV();
+        dv.setBigUint64(ptr + 0, s.size, true);
+        dv.setBigInt64(ptr + 8, s.mtimeNs, true);
+        dv.setBigInt64(ptr + 16, s.atimeNs, true);
+        dv.setBigInt64(ptr + 24, s.ctimeNs, true);
+        dv.setBigUint64(ptr + 32, s.inode, true);
+        dv.setUint32(ptr + 40, s.kind, true);
+        dv.setUint32(ptr + 44, s.modeBits, true);
+    };
+    return {
+        host: {
+            host_dir_create_file: (dirH, p, plen, outH) => {
+                const r = host.dirCreateFile(dirH, readStr(p, plen));
+                if (r.code === OK)
+                    memDV().setInt32(outH, r.handle, true);
+                return r.code;
+            },
+            host_dir_open_file: (dirH, p, plen, outH) => {
+                const r = host.dirOpenFile(dirH, readStr(p, plen));
+                if (r.code === OK)
+                    memDV().setInt32(outH, r.handle, true);
+                return r.code;
+            },
+            host_dir_create_dir: (dirH, p, plen) => host.dirCreateDir(dirH, readStr(p, plen)),
+            host_dir_create_dir_path: (dirH, p, plen, outExisted) => {
+                const r = host.dirCreateDirPath(dirH, readStr(p, plen));
+                if (r.code === OK)
+                    memU8()[outExisted] = r.existed ? 1 : 0;
+                return r.code;
+            },
+            host_dir_create_dir_path_open: (dirH, p, plen, outH) => {
+                const r = host.dirCreateDirPathOpen(dirH, readStr(p, plen));
+                if (r.code === OK)
+                    memDV().setInt32(outH, r.handle, true);
+                return r.code;
+            },
+            host_dir_open_dir: (dirH, p, plen, outH) => {
+                const r = host.dirOpenDir(dirH, readStr(p, plen));
+                if (r.code === OK)
+                    memDV().setInt32(outH, r.handle, true);
+                return r.code;
+            },
+            host_dir_close: (h) => host.dirClose(h),
+            host_dir_delete_file: (dirH, p, plen) => host.dirDeleteFile(dirH, readStr(p, plen)),
+            host_dir_rename: (oldDir, op, olen, newDir, np, nlen) => host.dirRename(oldDir, readStr(op, olen), newDir, readStr(np, nlen)),
+            host_dir_stat_file: (dirH, p, plen, outStat) => {
+                const r = host.dirStatFile(dirH, readStr(p, plen));
+                if (r.code === OK && r.stat)
+                    writeStat(outStat, r.stat);
+                return r.code;
+            },
+            host_dir_access: (dirH, p, plen) => host.dirAccess(dirH, readStr(p, plen)),
+            host_dir_read_link: (dirH, p, plen, bufPtr, bufLen, outSize) => {
+                const r = host.dirReadLink(dirH, readStr(p, plen));
+                if (r.code > 0 && r.target !== undefined) {
+                    const bytes = new TextEncoder().encode(r.target);
+                    if (bytes.length > bufLen)
+                        return -1;
+                    memU8().set(bytes, bufPtr);
+                    memDV().setUint32(outSize, bytes.length, true);
+                    return bytes.length;
+                }
+                return r.code;
+            },
+            host_file_close: (h) => host.fileClose(h),
+            host_file_read: (h, offset, bufPtr, bufLen, outRead) => {
+                const r = host.fileRead(h, offset, bufLen);
+                if (r.code === OK) {
+                    memU8().set(r.data, bufPtr);
+                    // out_read is `*usize` which on wasm32 is 4 bytes
+                    memDV().setUint32(outRead, r.data.length, true);
+                }
+                return r.code;
+            },
+            host_file_write: (h, offset, bufPtr, bufLen, outWritten) => {
+                const data = memU8().slice(bufPtr, bufPtr + bufLen);
+                const r = host.fileWrite(h, offset, data);
+                if (r.code === OK)
+                    memDV().setUint32(outWritten, r.written, true);
+                return r.code;
+            },
+            host_file_stat: (h, outStat) => {
+                const r = host.fileStat(h);
+                if (r.code === OK && r.stat)
+                    writeStat(outStat, r.stat);
+                return r.code;
+            },
+            host_file_length: (h, outLen) => {
+                const r = host.fileLength(h);
+                if (r.code === OK)
+                    memDV().setBigUint64(outLen, r.length, true);
+                return r.code;
+            },
+            host_file_write_stream: (h, bufPtr, bufLen, outWritten) => {
+                const data = memU8().slice(bufPtr, bufPtr + bufLen);
+                const r = host.fileWriteStream(h, data);
+                if (r.code === OK)
+                    memDV().setUint32(outWritten, r.written, true);
+                return r.code;
+            },
+            host_file_read_stream: (h, bufPtr, bufLen, outRead) => {
+                const r = host.fileReadStream(h, bufLen);
+                if (r.code === OK) {
+                    memU8().set(r.data, bufPtr);
+                    memDV().setUint32(outRead, r.data.length, true);
+                }
+                return r.code;
+            },
+            host_file_seek_to: (h, offset) => host.fileSeekTo(h, offset),
+            host_file_seek_by: (h, relative) => host.fileSeekBy(h, relative),
+            host_file_lock: (h, kind) => host.fileLock(h, kind),
+            host_file_try_lock: (h, kind) => host.fileTryLock(h, kind),
+            host_file_unlock: (h) => host.fileUnlock(h),
+            host_file_sync: (h) => host.fileSync(h),
+            host_file_set_length: (h, len) => host.fileSetLength(h, len),
+            host_now_nanos: () => host.nowNanos(),
+            host_random: (bufPtr, bufLen) => {
+                const buf = new Uint8Array(bufLen);
+                host.random(buf);
+                memU8().set(buf, bufPtr);
+            },
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Public entry point.
+ *
+ * The headline API is the `Archive` class — a pure in-memory, browser-safe
+ * wrapper that hides every wasm/host/file detail. It's what plastron uses.
+ *
+ * The lower-level loader below (`load`) is kept for the existing smoke tests
+ * and any consumer who wants to drive the wasm directly. Most users want
+ * `Archive`.
+ */
+export { Archive, setDefaultWasmSource } from "./archive.ts";
+export type { CommitOptions, LoadOptions, WasmSource } from "./archive.ts";
+import type { Host } from "./host.ts";
+export interface XitInstance {
+    memory: WebAssembly.Memory;
+    abiVersion(): number;
+    initRepo(absPath: string): number;
+    smokeInitAddCommit(absPath: string): number;
+    smokeXitInitAddCommit(absPath: string): number;
+}
+export declare function load(wasmPath: string, host: Host): Promise<XitInstance>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;IAC3B,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAChD;AA+BD,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CA6C7E"}

package/dist/index.js

@@ -0,0 +1,83 @@
+/**
+ * Public entry point.
+ *
+ * The headline API is the `Archive` class — a pure in-memory, browser-safe
+ * wrapper that hides every wasm/host/file detail. It's what plastron uses.
+ *
+ * The lower-level loader below (`load`) is kept for the existing smoke tests
+ * and any consumer who wants to drive the wasm directly. Most users want
+ * `Archive`.
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+export { Archive, setDefaultWasmSource } from "./archive.js";
+import { hostImports } from "./host.js";
+/**
+ * Load and instantiate the xit wasm module against a host implementation.
+ * The host provides the 24 backing functions the wasm imports — see
+ * src/host.ts for the surface.
+ *
+ * Note: the wasm module currently has no host-side allocation hook. Every
+ * call that takes a path/buffer needs to copy the bytes into wasm linear
+ * memory before invoking. This is fine for a spike but a real binding
+ * would expose `xit_alloc` and `xit_free` from the wasm side and stage
+ * arguments through them.
+ *
+ * For now we sneak path bytes into a fixed scratch region inside the
+ * wasm's memory. Wasm pages are 64 KiB; the linker reserves the first
+ * page for stack + globals. We borrow the second page (offset 65536+)
+ * for path scratch — outside any compile-time-allocated symbols. This is
+ * a HACK for spike testing only.
+ */
+const SCRATCH_OFFSET = 1 << 16; // start of page 1
+const SCRATCH_SIZE = 4096;
+export async function load(wasmPath, host) {
+    // Dynamic import keeps the entry module browser-clean. `load()` is a
+    // Node-only smoke-test helper; bundlers that statically analyze a top-
+    // level `node:fs/promises` import would mark the whole module as
+    // node-only and fail to ship a browser build of the headline `Archive`
+    // API alongside it. The runtime-built specifier + @vite-ignore also
+    // suppresses Vite's "externalized for browser compatibility" warning
+    // for downstream consumers — `load()` is never reachable from a
+    // browser build path so the warning would be noise.
+    const nodeFsSpecifier = "node:fs/promises";
+    const fs = await import(__rewriteRelativeImportExtension(/* @vite-ignore */ nodeFsSpecifier));
+    const bytes = await fs.readFile(wasmPath);
+    const mod = await WebAssembly.compile(bytes);
+    let memory;
+    const imports = hostImports(host, () => memory);
+    const inst = await WebAssembly.instantiate(mod, imports);
+    const exp = inst.exports;
+    memory = exp.memory;
+    const enc = new TextEncoder();
+    const writeScratch = (s) => {
+        const bytes = enc.encode(s);
+        if (bytes.length > SCRATCH_SIZE)
+            throw new Error("path too long for scratch buffer");
+        new Uint8Array(memory.buffer, SCRATCH_OFFSET, bytes.length).set(bytes);
+        return { ptr: SCRATCH_OFFSET, len: bytes.length };
+    };
+    return {
+        memory,
+        abiVersion: () => exp.xit_abi_version(),
+        initRepo(absPath) {
+            const { ptr, len } = writeScratch(absPath);
+            return exp.xit_init_repo(ptr, len);
+        },
+        smokeInitAddCommit(absPath) {
+            const { ptr, len } = writeScratch(absPath);
+            return exp.xit_smoke_init_add_commit(ptr, len);
+        },
+        smokeXitInitAddCommit(absPath) {
+            const { ptr, len } = writeScratch(absPath);
+            return exp.xit_smoke_xit_init_add_commit(ptr, len);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;;;;;;;;AAEH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAoBxC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,kBAAkB;AAClD,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAAgB,EAAE,IAAU;IACrD,qEAAqE;IACrE,uEAAuE;IACvE,iEAAiE;IACjE,uEAAuE;IACvE,oEAAoE;IACpE,qEAAqE;IACrE,gEAAgE;IAChE,oDAAoD;IACpD,MAAM,eAAe,GAAG,kBAAkB,CAAC;IAC3C,MAAM,EAAE,GAAG,MAAM,MAAM,kCAAC,kBAAkB,CAAC,eAAe,EAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,MAA2B,CAAC;IAChC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IAEhD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAgC,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAEpB,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,CAAC,CAAS,EAAgC,EAAE;QAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACrF,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC,CAAC;IAEF,OAAO;QACL,MAAM;QACN,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE;QACvC,QAAQ,CAAC,OAAe;YACtB,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,kBAAkB,CAAC,OAAe;YAChC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,qBAAqB,CAAC,OAAe;YACnC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC,6BAA6B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "xit-wasm",
+  "version": "0.1.0",
+  "description": "Versioned in-memory archives via xit (Zig VCS) compiled to WebAssembly. Browser-friendly.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/host-node.d.ts",
+      "default": "./dist/host-node.js"
+    }
+  },
+  "files": ["dist", "src", "xit.wasm"],
+  "scripts": {
+    "build:wasm": "cp ../xit/zig-out/bin/xit.wasm xit.wasm",
+    "build:tsc": "tsc",
+    "build": "npm run build:wasm && npm run build:tsc",
+    "prepublishOnly": "npm run build",
+    "smoke": "node example/run-smoke.ts",
+    "smoke:archive": "node example/run-archive.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}