@struktoai/mirage-node 0.0.7-alpha.2 → 0.0.7

package/dist/core/ssh/stream.js

@@ -11,9 +11,13 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
 import { once } from 'node:events';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
-import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { enoent } from '@struktoai/mirage-core/errors/fs';
+import { singleQuote } from '@struktoai/mirage-core/utils/quote';
+import { isNoSuchFile, joinRoot } from "./utils.js";
+export const FOLLOW = 'test -f {path} && exec 3< {path} && command -v tail >/dev/null' +
+    ' && echo && exec tail -n {n} -f <&3 3<&-';
 async function waitForClose(rs) {
     try {
         await once(rs, 'close');
@@ -40,9 +44,9 @@ export async function* readChunks(rs) {
     if (closeError !== null)
         throw closeError;
 }
-export async function* stream(accessor, p) {
+export async function* readStream(accessor, p) {
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const virtual = rawPathOf(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
     const rs = sftp.createReadStream(remote);
     try {
@@ -54,30 +58,68 @@ export async function* stream(accessor, p) {
         throw err;
     }
 }
-export async function rangeRead(accessor, p, start, end) {
-    const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
-    const remote = joinRoot(accessor.config.root ?? '/', virtual);
-    const rs = sftp.createReadStream(remote, { start, end: end - 1 });
-    const chunks = [];
-    let total = 0;
+/**
+ * The file's last `n` lines, then each line added to it, from `tail -f` on the
+ * server over the mount's connection, so the file is not read again on each
+ * poll.
+ *
+ * The server's shell opens the file itself and, once it holds it open and
+ * finds a tail to run, says so with an empty line, and tail follows the
+ * descriptor it opened, so the file the open found is the file followed.
+ * Anything else (a server that runs no commands or has no tail, a missing or
+ * unreadable file, a directory, a file gone before the open) leaves the file
+ * to tail's poll, which reports it the way a failed open is reported and,
+ * under `--retry`, waits for it. The bytes are the server tail's own: whole
+ * lines, and the last line as it stands while the file has not ended it, as a
+ * tail there prints them. Its wait for growth is its own, so `interval` goes
+ * unused, and what it says on stderr (a truncation) is not shown. Mirrors
+ * Python's `follow`.
+ */
+export async function follow(accessor, p, n, _interval) {
+    const remote = singleQuote(joinRoot(accessor.config.root ?? '/', rawPathOf(p)));
+    const command = FOLLOW.replaceAll(/\{path\}|\{n\}/g, (slot) => slot === '{path}' ? remote : String(n));
+    const stream = accessor.runStream(command);
+    let first;
     try {
-        for await (const u8 of readChunks(rs)) {
-            chunks.push(u8);
-            total += u8.byteLength;
-        }
+        first = await stream.next();
     }
-    catch (err) {
-        if (isNoSuchFile(err))
-            throw enoent(p);
-        throw err;
+    catch (error) {
+        console.debug(`ssh follow left to the poll: ${String(error)}`);
+        await stream.return?.();
+        return null;
     }
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const c of chunks) {
-        out.set(c, offset);
-        offset += c.byteLength;
+    if (first.done === true || first.value[0] !== 0x0a) {
+        await stream.return?.();
+        return null;
     }
-    return out;
+    return followed(first.value.subarray(1), stream);
+}
+/**
+ * `head`, then the rest of the server tail's output. An iterator rather than a
+ * generator: a generator queues `return` behind a pull waiting for the next
+ * line and runs nothing when closed before its first pull, and this one holds
+ * the command open already, so `return` closes it at once, pulled or not.
+ * Mirrors Python's `_Followed`.
+ */
+function followed(head, stream) {
+    let pending = head.byteLength > 0 ? head : null;
+    const done = { value: undefined, done: true };
+    return {
+        next() {
+            if (pending === null)
+                return stream.next();
+            const value = pending;
+            pending = null;
+            return Promise.resolve({ value, done: false });
+        },
+        async return() {
+            pending = null;
+            await stream.return?.();
+            return done;
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
 }
 //# sourceMappingURL=stream.js.map

package/dist/core/ssh/stream.js.map

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

package/dist/core/ssh/truncate.d.ts

@@ -1,4 +1,4 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
-export declare function truncate(accessor: SSHAccessor, p: PathSpec, length: number): Promise<void>;
+export declare function truncate(accessor: SSHAccessor, p: PathSpec, length: number, noCreate?: boolean): Promise<void>;
 //# sourceMappingURL=truncate.d.ts.map

package/dist/core/ssh/truncate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/truncate.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchG"}
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/truncate.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,UAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/core/ssh/truncate.js

@@ -11,23 +11,38 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { read } from "./read.js";
-import { writeBytes } from "./write.js";
-export async function truncate(accessor, p, length) {
-    let data;
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { enotsup } from '@struktoai/mirage-core/errors/fs';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { joinRoot, openForWrite } from "./utils.js";
+export async function truncate(accessor, p, length, noCreate = false) {
+    if (noCreate)
+        throw enotsup('ssh', 'truncate --no-create', p);
+    const timer = startOp();
+    const sftp = await accessor.sftp();
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
+    const handle = await openForWrite(sftp, remote, p);
     try {
-        data = await read(accessor, p);
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.fsetstat(handle, { size: length }, (err) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn();
+            });
+        });
     }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            data = new Uint8Array(0);
-        }
-        else {
-            throw err;
-        }
+    finally {
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.close(handle, (err) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn();
+            });
+        });
     }
-    const out = new Uint8Array(length);
-    out.set(data.subarray(0, Math.min(data.byteLength, length)));
-    await writeBytes(accessor, p, out);
+    record('truncate', p.virtual, VFSName.SSH, 0, timer);
 }
 //# sourceMappingURL=truncate.js.map

package/dist/core/ssh/truncate.js.map

@@ -1 +1 @@
-{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/core/ssh/truncate.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAIvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAqB,EAAE,CAAW,EAAE,MAAc;IAC/E,IAAI,IAAgB,CAAA;IACpB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAAyB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjD,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IAClC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC5D,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;AACpC,CAAC"}
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/core/ssh/truncate.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAGtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAqB,EACrB,CAAW,EACX,MAAc,EACd,QAAQ,GAAG,KAAK;IAEhB,IAAI,QAAQ;QAAE,MAAM,OAAO,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC9C,IAAI,GAAG;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;oBACjB,SAAS,EAAE,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,GAAG;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;oBACjB,SAAS,EAAE,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AACtD,CAAC"}

package/dist/core/ssh/unlink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unlink.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/unlink.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9E"}
+{"version":3,"file":"unlink.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/unlink.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB9E"}

package/dist/core/ssh/unlink.js

@@ -11,25 +11,38 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { invalidateAfterUnlink } from '@struktoai/mirage-core/cache/context';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
-import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { eisdir, enoent } from '@struktoai/mirage-core/errors/fs';
+import { isDirectoryAttrs, isFailure, isNoSuchFile, joinRoot } from "./utils.js";
 export async function unlink(accessor, p) {
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const virtual = rawPathOf(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
-    await new Promise((resolveFn, rejectFn) => {
-        sftp.unlink(remote, (err) => {
-            if (!err) {
-                resolveFn();
-                return;
-            }
-            if (isNoSuchFile(err))
-                rejectFn(enoent(p));
-            else
-                rejectFn(err);
+    try {
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.unlink(remote, (err) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn();
+            });
         });
-    });
-    await invalidateAfterUnlink(p);
+    }
+    catch (err) {
+        if (isNoSuchFile(err))
+            throw enoent(p);
+        // OpenSSH answers a directory with SFTP 3's one generic refusal;
+        // Linux's unlink(2) says EISDIR.
+        if (isFailure(err)) {
+            const isDir = await new Promise((resolveFn) => {
+                sftp.stat(remote, (statErr, attrs) => {
+                    resolveFn(statErr ? false : isDirectoryAttrs(attrs));
+                });
+            });
+            if (isDir)
+                throw eisdir(p);
+        }
+        throw err;
+    }
 }
 //# sourceMappingURL=unlink.js.map

package/dist/core/ssh/unlink.js.map

@@ -1 +1 @@
-{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/core/ssh/unlink.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAE5E,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,CAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,SAAS,EAAE,CAAA;gBACX,OAAM;YACR,CAAC;YACD,IAAI,YAAY,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;;gBACrC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,qBAAqB,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC"}
+{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/core/ssh/unlink.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEhF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,CAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC1B,IAAI,GAAG;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;oBACjB,SAAS,EAAE,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,YAAY,CAAC,GAAG,CAAC;YAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;QACtC,iEAAiE;QACjE,iCAAiC;QACjC,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,SAAS,EAAE,EAAE;gBACrD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;oBACnC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;gBACtD,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;YACF,IAAI,KAAK;gBAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/core/ssh/utils.d.ts

@@ -1,7 +1,10 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
-export declare function stripPrefix(p: PathSpec): string;
+import type { OpenMode, SFTPWrapper } from 'ssh2';
+export declare const S_IFDIR = 16384;
+export declare const S_IFREG = 32768;
 export declare function joinRoot(root: string, rel: string): string;
 export declare function isNoSuchFile(err: unknown): boolean;
+export declare function isPermissionDenied(err: unknown): boolean;
 export declare function isFailure(err: unknown): boolean;
 export declare function isDirectoryAttrs(attrs: {
     mode?: number;
@@ -9,4 +12,12 @@ export declare function isDirectoryAttrs(attrs: {
 export declare function isFileAttrs(attrs: {
     mode?: number;
 }): boolean;
+/**
+ * Open a remote file with consistent filesystem errors.
+ *
+ * OpenSSH answers an open of a directory with SFTP 3's one generic refusal
+ * (SSH_FX_FAILURE), so a stat decides whether it was one; a missing parent
+ * is SSH_FX_NO_SUCH_FILE. Both leave in the errno every other backend uses.
+ */
+export declare function openForWrite(sftp: SFTPWrapper, remote: string, p: PathSpec, flags?: OpenMode | number): Promise<Buffer>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/core/ssh/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAQ5D,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAQ/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKlD;AAID,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK/C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAG7D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAIjD,eAAO,MAAM,OAAO,QAAW,CAAA;AAC/B,eAAO,MAAM,OAAO,QAAW,CAAA;AAE/B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKlD;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKxD;AAID,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK/C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAG7D;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,QAAQ,EACX,KAAK,GAAE,QAAQ,GAAG,MAA8B,GAC/C,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/core/ssh/utils.js

@@ -11,18 +11,12 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { eisdir, enoent } from '@struktoai/mirage-core/errors/fs';
 import { lstripSlash, rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { FXF_CREAT, FXF_WRITE } from "./constants.js";
 const S_IFMT = 0o170000;
-const S_IFDIR = 0o040000;
-const S_IFREG = 0o100000;
-export function stripPrefix(p) {
-    if (mountPrefixOf(p.virtual, p.resourcePath) &&
-        p.virtual.startsWith(mountPrefixOf(p.virtual, p.resourcePath))) {
-        return p.virtual.slice(mountPrefixOf(p.virtual, p.resourcePath).length) || '/';
-    }
-    return p.virtual;
-}
+export const S_IFDIR = 0o040000;
+export const S_IFREG = 0o100000;
 export function joinRoot(root, rel) {
     const r = rstripSlash(root);
     const stripped = lstripSlash(rel);
@@ -40,6 +34,16 @@ export function isNoSuchFile(err) {
     const code = err.code;
     return code === 2;
 }
+// SSH_FX_PERMISSION_DENIED: the server's own access check refused the
+// request, which the walk reports as EACCES against the path it named.
+export function isPermissionDenied(err) {
+    if (err === null || err === undefined)
+        return false;
+    if (typeof err !== 'object')
+        return false;
+    const code = err.code;
+    return code === 3;
+}
 // SFTP 3's one generic refusal (SSH_FX_FAILURE): the only vocabulary a
 // version-3 server has for a not-empty rmdir, among other refusals.
 export function isFailure(err) {
@@ -60,4 +64,37 @@ export function isFileAttrs(attrs) {
         return false;
     return (attrs.mode & S_IFMT) === S_IFREG;
 }
+/**
+ * Open a remote file with consistent filesystem errors.
+ *
+ * OpenSSH answers an open of a directory with SFTP 3's one generic refusal
+ * (SSH_FX_FAILURE), so a stat decides whether it was one; a missing parent
+ * is SSH_FX_NO_SUCH_FILE. Both leave in the errno every other backend uses.
+ */
+export async function openForWrite(sftp, remote, p, flags = FXF_WRITE | FXF_CREAT) {
+    try {
+        return await new Promise((resolveFn, rejectFn) => {
+            sftp.open(remote, flags, (err, opened) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn(opened);
+            });
+        });
+    }
+    catch (err) {
+        if (isNoSuchFile(err))
+            throw enoent(p);
+        if (isFailure(err)) {
+            const isDir = await new Promise((resolveFn) => {
+                sftp.stat(remote, (statErr, attrs) => {
+                    resolveFn(statErr ? false : isDirectoryAttrs(attrs));
+                });
+            });
+            if (isDir)
+                throw eisdir(p);
+        }
+        throw err;
+    }
+}
 //# sourceMappingURL=utils.js.map

package/dist/core/ssh/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/ssh/utils.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAE7E,MAAM,MAAM,GAAG,QAAQ,CAAA;AACvB,MAAM,OAAO,GAAG,QAAQ,CAAA;AACxB,MAAM,OAAO,GAAG,QAAQ,CAAA;AAExB,MAAM,UAAU,WAAW,CAAC,CAAW;IACrC,IACE,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACxC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,EAC9D,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,CAAA;IAChF,CAAC;IACD,OAAO,CAAC,CAAC,OAAO,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAW;IAChD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9C,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,QAAQ,EAAE,CAAA;IACnC,OAAO,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;IAC7C,OAAO,IAAI,KAAK,CAAC,CAAA;AACnB,CAAC;AAED,uEAAuE;AACvE,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;IAC7C,OAAO,IAAI,KAAK,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,OAAO,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,OAAO,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/ssh/utils.ts"],"names":[],"mappings":"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"}

package/dist/core/ssh/write.d.ts

@@ -1,4 +1,6 @@
+import type { ByteSource } from '@struktoai/mirage-core/io/types';
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
-export declare function writeBytes(accessor: SSHAccessor, p: PathSpec, data: Uint8Array): Promise<void>;
+export declare function write(accessor: SSHAccessor, p: PathSpec, data: Uint8Array): Promise<void>;
+export declare function writeStream(accessor: SSHAccessor, p: PathSpec, data: ByteSource, signal?: AbortSignal, atomic?: boolean): Promise<void>;
 //# sourceMappingURL=write.d.ts.map

package/dist/core/ssh/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/write.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAaf"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/write.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAGjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/F;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAkEf"}

package/dist/core/ssh/write.js

@@ -11,24 +11,96 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { randomUUID } from 'node:crypto';
+import { closeQuietly } from '@struktoai/mirage-core/io/stream';
+import { chunks } from '@struktoai/mirage-core/io/cooperative';
 import { record, startOp } from '@struktoai/mirage-core/observe/context';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { joinRoot, stripPrefix } from "./utils.js";
-export async function writeBytes(accessor, p, data) {
+import { VFSName } from '@struktoai/mirage-core/types';
+import { isNoSuchFile, joinRoot, openForWrite } from "./utils.js";
+export async function write(accessor, p, data) {
+    await writeStream(accessor, p, data);
+}
+export async function writeStream(accessor, p, data, signal, atomic = false) {
     const timer = startOp();
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
-    const remote = joinRoot(accessor.config.root ?? '/', virtual);
-    await new Promise((resolveFn, rejectFn) => {
-        sftp.writeFile(remote, Buffer.from(data), (err) => {
-            if (err)
-                rejectFn(err);
-            else
-                resolveFn();
-        });
-    });
-    record('write', virtual, ResourceName.SSH, data.byteLength, timer);
-    await invalidateAfterWrite(p);
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
+    const target = atomic ? remote + '.mirage-' + randomUUID() : remote;
+    let staged = false;
+    let size = 0;
+    try {
+        const mode = atomic
+            ? await new Promise((resolve, reject) => {
+                sftp.stat(remote, (error, attrs) => {
+                    if (error) {
+                        if (isNoSuchFile(error))
+                            resolve(null);
+                        else
+                            reject(error);
+                    }
+                    else
+                        resolve(attrs.mode);
+                });
+            })
+            : null;
+        const handle = await openForWrite(sftp, target, p, atomic ? 'wx' : 'w');
+        staged = atomic;
+        try {
+            for await (const part of chunks(data, signal)) {
+                await new Promise((resolve, reject) => {
+                    sftp.write(handle, Buffer.from(part), 0, part.length, size, (error) => {
+                        if (error)
+                            reject(error);
+                        else
+                            resolve();
+                    });
+                });
+                size += part.length;
+            }
+        }
+        finally {
+            await new Promise((resolve, reject) => {
+                sftp.close(handle, (error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                });
+            });
+        }
+        if (atomic) {
+            signal?.throwIfAborted();
+            if (mode !== null)
+                await new Promise((resolve, reject) => {
+                    sftp.chmod(target, mode & 0o7777, (error) => {
+                        if (error)
+                            reject(error);
+                        else
+                            resolve();
+                    });
+                });
+            await new Promise((resolve, reject) => {
+                sftp.ext_openssh_rename(target, remote, (error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                });
+            });
+            staged = false;
+        }
+    }
+    finally {
+        await closeQuietly(data);
+        if (staged)
+            await new Promise((resolve) => {
+                sftp.unlink(target, (error) => {
+                    if (error)
+                        console.debug(`Could not remove staged ${target}`, error);
+                    resolve();
+                });
+            });
+    }
+    record('write', p.virtual, VFSName.SSH, size, timer);
 }
 //# sourceMappingURL=write.js.map

package/dist/core/ssh/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/ssh/write.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAqB,EACrB,CAAW,EACX,IAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC9C,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;YAChD,IAAI,GAAG;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;gBACjB,SAAS,EAAE,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAClE,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAA;AAC/B,CAAC"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/ssh/write.ts"],"names":[],"mappings":"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"}

package/dist/fuse/backend.d.ts

@@ -31,14 +31,14 @@ export declare function checkPlatform(backend: MountBackend): void;
 export declare function checkMountpoint(backend: MountBackend, mountpoint: string): void;
 /**
  * Mounts under `rootPrefix` whose files cannot be sized without reading
- * them. Mirrors Python's `Ops.unsized_mounts`.
+ * them. Mirrors Python's `Files.unsized_mounts`.
  */
 export declare function unsizedMounts(ws: Workspace, rootPrefix?: string): [string, string][];
 /**
- * Warn when an fskit mount will serve size-unknown files as empty.
+ * Warn when an fskit or nfs mount will serve size-unknown files as empty.
  *
- * FSKit drives reads from the size the filesystem reports and has no
- * `direct_io` escape hatch, so a resource that cannot size a file without
+ * FSKit and the kernel NFS client drive reads from the size the filesystem
+ * reports and have no `direct_io` escape hatch, so a VFS that cannot size a file without
  * fetching it reports 0, the kernel issues no reads, and every such file
  * comes back empty with exit code 0 (verified on a live fskit mount: the
  * read clamp is pinned at lookup-time size and never refreshed). The mount
@@ -48,7 +48,7 @@ export declare function unsizedMounts(ws: Workspace, rootPrefix?: string): [stri
 export declare function checkSizes(backend: MountBackend, ws: Workspace, rootPrefix?: string): void;
 /**
  * Mounts that accept writes, in mount resolution order. Mirrors Python's
- * `Ops.writable_mounts`.
+ * `Files.writable_mounts`.
  */
 export declare function writableMounts(ws: Workspace, rootPrefix?: string): [string, string][];
 /**

package/dist/fuse/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/fuse/backend.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAmB,YAAY,EAAa,MAAM,8BAA8B,CAAA;AAEvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAWlE;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAOhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAOzD;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAShF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,IAAI,CAWtF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CASjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,IAAI,CAcvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,EAAE,CAAC,EAAE,SAAS,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,SAAK,GACd,YAAY,CAUd"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/fuse/backend.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,YAAY,EAAa,MAAM,8BAA8B,CAAA;AAEvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAWlE;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAOhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAOzD;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAShF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,IAAI,CAWtF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CASjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,IAAI,CAcvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,EAAE,CAAC,EAAE,SAAS,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,SAAK,GACd,YAAY,CAUd"}