@stablemodels/durable-bash 0.1.0

package/dist/durable-fs.js

@@ -0,0 +1,175 @@
+import { normalizePath } from "./fs-object.js";
+/**
+ * IFileSystem implementation backed by a Durable Object.
+ * Every filesystem operation is delegated to the FsObject DO over RPC.
+ *
+ * Use the static `create()` factory for easy setup:
+ * ```ts
+ * const fs = await DurableFs.create(env.FS, "my-agent");
+ * ```
+ */
+export class DurableFs {
+    stub;
+    cwd;
+    _cachedPaths = new Set();
+    constructor(stub, cwd = "/") {
+        this.stub = stub;
+        this.cwd = cwd;
+    }
+    /**
+     * Create a ready-to-use DurableFs from a DO namespace and instance name.
+     * Handles stub creation and initial sync in one call.
+     */
+    static async create(namespace, name, cwd = "/") {
+        const id = namespace.idFromName(name);
+        const stub = namespace.get(id);
+        const fs = new DurableFs(stub, cwd);
+        await fs.sync();
+        return fs;
+    }
+    /**
+     * Refresh the local path cache from the DO.
+     * Called automatically by `create()`. Only needed if you modify
+     * the DO outside of this DurableFs instance.
+     */
+    async sync() {
+        const paths = await this.stub.getAllPaths();
+        this._cachedPaths = new Set(paths);
+    }
+    async readFile(path, _options) {
+        const result = await this.stub.readFile(this.resolve(path));
+        return result.content;
+    }
+    async readFileBuffer(path) {
+        const result = await this.stub.readFileBuffer(this.resolve(path));
+        return result.content;
+    }
+    async writeFile(path, content, _options) {
+        const resolved = this.resolve(path);
+        await this.stub.writeFile(resolved, content);
+        this.addToCache(resolved);
+    }
+    async appendFile(path, content, _options) {
+        const resolved = this.resolve(path);
+        await this.stub.appendFile(resolved, content);
+        this.addToCache(resolved);
+    }
+    async exists(path) {
+        return this.stub.exists(this.resolve(path));
+    }
+    async stat(path) {
+        const data = await this.stub.stat(this.resolve(path));
+        return toFsStat(data);
+    }
+    async lstat(path) {
+        const data = await this.stub.lstat(this.resolve(path));
+        return toFsStat(data);
+    }
+    async mkdir(path, options) {
+        const resolved = this.resolve(path);
+        await this.stub.mkdir(resolved, options);
+        this.addToCache(resolved);
+    }
+    async readdir(path) {
+        return this.stub.readdir(this.resolve(path));
+    }
+    async readdirWithFileTypes(path) {
+        const entries = await this.stub.readdirWithFileTypes(this.resolve(path));
+        return entries.map((e) => ({
+            name: e.name,
+            isFile: e.isFile,
+            isDirectory: e.isDirectory,
+            isSymbolicLink: e.isSymlink,
+        }));
+    }
+    async rm(path, options) {
+        const resolved = this.resolve(path);
+        await this.stub.rm(resolved, options);
+        this.removeFromCache(resolved);
+    }
+    async cp(src, dest, options) {
+        await this.stub.cp(this.resolve(src), this.resolve(dest), options);
+        // Re-sync cache since cp can create many paths
+        await this.sync();
+    }
+    async mv(src, dest) {
+        await this.stub.mv(this.resolve(src), this.resolve(dest));
+        // Re-sync cache since mv can move many paths
+        await this.sync();
+    }
+    resolvePath(base, path) {
+        if (path.startsWith("/"))
+            return normalizePath(path);
+        return normalizePath(`${base}/${path}`);
+    }
+    getAllPaths() {
+        return [...this._cachedPaths].sort();
+    }
+    async chmod(path, mode) {
+        await this.stub.chmod(this.resolve(path), mode);
+    }
+    async symlink(target, linkPath) {
+        const resolved = this.resolve(linkPath);
+        await this.stub.symlink(target, resolved);
+        this.addToCache(resolved);
+    }
+    async link(existingPath, newPath) {
+        const resolvedNew = this.resolve(newPath);
+        await this.stub.link(this.resolve(existingPath), resolvedNew);
+        this.addToCache(resolvedNew);
+    }
+    async readlink(path) {
+        return this.stub.readlink(this.resolve(path));
+    }
+    async realpath(path) {
+        return this.stub.realpath(this.resolve(path));
+    }
+    async utimes(path, atime, mtime) {
+        await this.stub.utimes(this.resolve(path), atime.getTime(), mtime.getTime());
+    }
+    // --- Private helpers ---
+    resolve(path) {
+        return this.resolvePath(this.cwd, path);
+    }
+    /**
+     * Add a path and all its ancestor directories to the cache.
+     * The DO auto-creates parent dirs on write, so the cache must reflect them.
+     */
+    addToCache(path) {
+        this._cachedPaths.add(path);
+        let dir = path;
+        while (true) {
+            const idx = dir.lastIndexOf("/");
+            if (idx <= 0) {
+                this._cachedPaths.add("/");
+                break;
+            }
+            dir = dir.substring(0, idx);
+            if (this._cachedPaths.has(dir))
+                break;
+            this._cachedPaths.add(dir);
+        }
+    }
+    removeFromCache(path) {
+        this._cachedPaths.delete(path);
+        const prefix = `${path}/`;
+        // Safe to delete during Set iteration per ES spec — the iterator
+        // will not visit deleted entries but will complete correctly.
+        for (const p of this._cachedPaths) {
+            if (p.startsWith(prefix)) {
+                this._cachedPaths.delete(p);
+            }
+        }
+    }
+}
+function toFsStat(data) {
+    return {
+        isFile: !data.isDir && !data.isSymlink,
+        isDirectory: data.isDir,
+        isSymbolicLink: data.isSymlink,
+        mode: data.mode,
+        size: data.size,
+        mtime: new Date(data.mtimeMs),
+    };
+}
+//# sourceMappingURL=durable-fs.js.map

package/dist/durable-fs.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class FsError extends Error {
+    readonly code: string;
+    readonly path?: string | undefined;
+    constructor(code: string, message: string, path?: string | undefined);
+}
+export declare const ENOENT: (path: string) => FsError;
+export declare const EEXIST: (path: string) => FsError;
+export declare const EISDIR: (path: string) => FsError;
+export declare const ENOTDIR: (path: string) => FsError;
+export declare const ENOTEMPTY: (path: string) => FsError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAQ,SAAQ,KAAK;aAEhB,IAAI,EAAE,MAAM;aAEZ,IAAI,CAAC,EAAE,MAAM;gBAFb,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAK9B;AAED,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,YACsB,CAAC;AAC1D,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,YACgB,CAAC;AACpD,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,YAC6B,CAAC;AACjE,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,YACY,CAAC;AACjD,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,YACgB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,16 @@
+export class FsError extends Error {
+    code;
+    path;
+    constructor(code, message, path) {
+        super(`${code}: ${message}${path ? `, '${path}'` : ""}`);
+        this.code = code;
+        this.path = path;
+        this.name = "FsError";
+    }
+}
+export const ENOENT = (path) => new FsError("ENOENT", "no such file or directory", path);
+export const EEXIST = (path) => new FsError("EEXIST", "file already exists", path);
+export const EISDIR = (path) => new FsError("EISDIR", "illegal operation on a directory", path);
+export const ENOTDIR = (path) => new FsError("ENOTDIR", "not a directory", path);
+export const ENOTEMPTY = (path) => new FsError("ENOTEMPTY", "directory not empty", path);
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAEhB;IAEA;IAHjB,YACiB,IAAY,EAC5B,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAJzC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;CACD;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CACtC,IAAI,OAAO,CAAC,QAAQ,EAAE,2BAA2B,EAAE,IAAI,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CACtC,IAAI,OAAO,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CACtC,IAAI,OAAO,CAAC,QAAQ,EAAE,kCAAkC,EAAE,IAAI,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CACvC,IAAI,OAAO,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CACzC,IAAI,OAAO,CAAC,WAAW,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC"}

package/dist/fs-object.d.ts

@@ -0,0 +1,68 @@
+import { DurableObject } from "cloudflare:workers";
+import type { DirentData, FsStatData } from "./types.js";
+/**
+ * Normalize a path: resolve `.` and `..`, remove trailing slashes, ensure leading `/`.
+ */
+export declare function normalizePath(p: string): string;
+export declare class FsObject extends DurableObject<any> {
+    private sql;
+    constructor(ctx: DurableObjectState, env: Record<string, unknown>);
+    private getRow;
+    private resolveSymlinks;
+    /**
+     * Resolve path through symlinks if it exists and is a symlink, otherwise return as-is.
+     */
+    private resolveTarget;
+    private ensureParentDirs;
+    private childPrefix;
+    private toBytes;
+    private bufferToString;
+    private bufferToUint8Array;
+    private extractChildName;
+    private ensureDirRow;
+    /**
+     * Insert or update a file entry.
+     */
+    private upsertFile;
+    readFile(path: string): {
+        content: string;
+        encoding: string;
+    };
+    readFileBuffer(path: string): {
+        content: Uint8Array;
+    };
+    writeFile(path: string, content: string | Uint8Array, opts?: {
+        mode?: number;
+    }): void;
+    appendFile(path: string, content: string | Uint8Array): void;
+    exists(path: string): boolean;
+    stat(path: string): FsStatData;
+    lstat(path: string): FsStatData;
+    mkdir(path: string, opts?: {
+        recursive?: boolean;
+    }): void;
+    readdir(path: string): string[];
+    readdirWithFileTypes(path: string): DirentData[];
+    rm(path: string, opts?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): void;
+    cp(src: string, dest: string, opts?: {
+        recursive?: boolean;
+    }): void;
+    mv(src: string, dest: string): void;
+    chmod(path: string, mode: number): void;
+    symlink(target: string, linkPath: string): void;
+    /**
+     * Create a hard link. Note: this copies content at call time rather than
+     * sharing underlying storage — subsequent writes to one path will not
+     * update the other. This matches the IFileSystem contract but differs
+     * from POSIX hard link semantics.
+     */
+    link(existingPath: string, newPath: string): void;
+    readlink(path: string): string;
+    realpath(path: string): string;
+    utimes(path: string, _atimeMs: number, mtimeMs: number): void;
+    getAllPaths(): string[];
+}
+//# sourceMappingURL=fs-object.d.ts.map

package/dist/fs-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-object.d.ts","sourceRoot":"","sources":["../src/fs-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMzD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAa/C;AA6BD,qBAAa,QAAS,SAAQ,aAAa,CAAC,GAAG,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAa;gBAEZ,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA4BjE,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAwClB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAQ7D,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE;IAQrD,SAAS,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtB,IAAI;IAsBP,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAmC5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAa9B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAa/B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA0BzD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAsB/B,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IA4ChD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAwBvE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA6CnE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IA0CnC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOvC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAe/C;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAsBjD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAW7D,WAAW,IAAI,MAAM,EAAE;CAMvB"}