@struktoai/mirage-node 0.0.5 → 0.0.7-alpha.1

package/dist/core/ssh/rm.js

@@ -0,0 +1,86 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { invalidateSubtree } from '@struktoai/mirage-core/cache/context';
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { isDirectoryAttrs, isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+async function statRemote(sftp, remote) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.lstat(remote, (err, stats) => {
+            if (err !== undefined)
+                rejectFn(err);
+            else
+                resolveFn(stats);
+        });
+    });
+}
+async function readdirRemote(sftp, remote) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.readdir(remote, (err, list) => {
+            if (err !== undefined)
+                rejectFn(err);
+            else
+                resolveFn(list);
+        });
+    });
+}
+async function unlinkRemote(sftp, remote) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.unlink(remote, (err) => {
+            if (err)
+                rejectFn(err);
+            else
+                resolveFn();
+        });
+    });
+}
+async function rmdirRemote(sftp, remote) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.rmdir(remote, (err) => {
+            if (err)
+                rejectFn(err);
+            else
+                resolveFn();
+        });
+    });
+}
+async function rmRecurse(sftp, remote) {
+    const stats = await statRemote(sftp, remote);
+    if (isDirectoryAttrs(stats)) {
+        const entries = await readdirRemote(sftp, remote);
+        for (const entry of entries) {
+            if (entry.filename === '.' || entry.filename === '..')
+                continue;
+            const child = remote === '/' ? `/${entry.filename}` : `${remote}/${entry.filename}`;
+            await rmRecurse(sftp, child);
+        }
+        await rmdirRemote(sftp, remote);
+        return;
+    }
+    await unlinkRemote(sftp, remote);
+}
+export async function rmR(accessor, p) {
+    const sftp = await accessor.sftp();
+    const virtual = stripPrefix(p);
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    try {
+        await rmRecurse(sftp, remote);
+    }
+    catch (err) {
+        if (isNoSuchFile(err))
+            throw enoent(p);
+        throw err;
+    }
+    await invalidateSubtree(p);
+}
+//# sourceMappingURL=rm.js.map

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

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

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

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

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

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

package/dist/core/ssh/rmdir.js

@@ -0,0 +1,69 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// 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, enotempty } from '@struktoai/mirage-core/utils/errors';
+import { isFailure, isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+// The probe behind the version-3 arm below: whether the directory
+// still lists children. A probe that fails is a negative probe, never
+// an error to surface; the caller re-raises what the server said.
+async function holdsEntries(accessor, remote) {
+    const sftp = await accessor.sftp();
+    try {
+        return await new Promise((resolveFn, rejectFn) => {
+            sftp.readdir(remote, (err, entries) => {
+                if (err !== undefined) {
+                    rejectFn(err);
+                    return;
+                }
+                resolveFn(entries.some((e) => e.filename !== '.' && e.filename !== '..'));
+            });
+        });
+    }
+    catch {
+        return false;
+    }
+}
+// SFTP 3 has one generic code for a not-empty refusal (SSH_FX_FAILURE),
+// which is what ssh2 always speaks, so one listing probe decides
+// instead of a blind translation: only a directory that still shows
+// entries converts to ENOTEMPTY, anything else keeps the server's own
+// answer. Without the conversion the hidden-remnant guard never fires
+// on ssh (it keys on the errno), and the raw SFTP failure leaks.
+export async function rmdir(accessor, p) {
+    const sftp = await accessor.sftp();
+    const virtual = stripPrefix(p);
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    try {
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.rmdir(remote, (err) => {
+                if (!err) {
+                    resolveFn();
+                    return;
+                }
+                if (isNoSuchFile(err))
+                    rejectFn(enoent(p));
+                else
+                    rejectFn(err);
+            });
+        });
+    }
+    catch (err) {
+        if (isFailure(err) && (await holdsEntries(accessor, remote))) {
+            throw enotempty(p);
+        }
+        throw err;
+    }
+    await invalidateAfterUnlink(p);
+}
+//# sourceMappingURL=rmdir.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rmdir.js","sourceRoot":"","sources":["../../../src/core/ssh/rmdir.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,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAEvE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3E,kEAAkE;AAClE,sEAAsE;AACtE,kEAAkE;AAClE,KAAK,UAAU,YAAY,CAAC,QAAqB,EAAE,MAAc;IAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,OAAO,CAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YACxD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;gBACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,QAAQ,CAAC,GAAG,CAAC,CAAA;oBACb,OAAM;gBACR,CAAC;gBACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAA;YAC3E,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,iEAAiE;AACjE,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAqB,EAAE,CAAW;IAC5D,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,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,SAAS,EAAE,CAAA;oBACX,OAAM;gBACR,CAAC;gBACD,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;;oBACrC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACpB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,SAAS,CAAC,CAAC,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IACD,MAAM,qBAAqB,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export interface SetAttrsFields {
+    mode?: number;
+    uid?: number | string;
+    gid?: number | string;
+    atime?: string;
+    mtime?: string;
+}
+export declare function setAttrs(accessor: SSHAccessor, path: PathSpec, fields: SetAttrsFields): Promise<Record<string, number | string>>;
+//# sourceMappingURL=set_attrs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set_attrs.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/set_attrs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA+CD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAoB1C"}

package/dist/core/ssh/set_attrs.js

@@ -0,0 +1,81 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+function sftpStat(sftp, remote, p) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.stat(remote, (err, stats) => {
+            if (err !== undefined) {
+                if (isNoSuchFile(err))
+                    rejectFn(enoent(p));
+                else
+                    rejectFn(err);
+                return;
+            }
+            resolveFn(stats);
+        });
+    });
+}
+function sftpChmod(sftp, remote, mode) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.chmod(remote, mode, (err) => {
+            if (err !== undefined && err !== null)
+                rejectFn(err);
+            else
+                resolveFn();
+        });
+    });
+}
+function sftpUtimes(sftp, remote, atime, mtime) {
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.utimes(remote, atime, mtime, (err) => {
+            if (err !== undefined && err !== null)
+                rejectFn(err);
+            else
+                resolveFn();
+        });
+    });
+}
+// Write metadata fields (the write side of stat), mirroring disk. Applies
+// natively what the remote inode can take and returns the residual: fields
+// the caller must overlay elsewhere. Times always apply via SFTP utimes, so
+// touch results live on the real file and out-of-band readers see them.
+// `mode` is applied with owner access kept (`chmod 000` must not lock
+// mirage's own SFTP session out of reads; mount mode does real access
+// control), so clamped bits come back as residual. Ownership never applies
+// (chown over SFTP needs privileges the login user does not have) and is
+// always residual.
+export async function setAttrs(accessor, path, fields) {
+    const sftp = await accessor.sftp();
+    const remote = joinRoot(accessor.config.root ?? '/', stripPrefix(path));
+    const st = await sftpStat(sftp, remote, path);
+    const residual = {};
+    if (fields.mode !== undefined) {
+        const keep = st.isDirectory() ? 0o700 : 0o600;
+        await sftpChmod(sftp, remote, fields.mode | keep);
+        if ((fields.mode | keep) !== fields.mode)
+            residual.mode = fields.mode;
+    }
+    if (fields.uid !== undefined)
+        residual.uid = fields.uid;
+    if (fields.gid !== undefined)
+        residual.gid = fields.gid;
+    if (fields.atime !== undefined || fields.mtime !== undefined) {
+        const newAtime = fields.atime !== undefined ? Math.floor(Date.parse(fields.atime) / 1000) : st.atime;
+        const newMtime = fields.mtime !== undefined ? Math.floor(Date.parse(fields.mtime) / 1000) : st.mtime;
+        await sftpUtimes(sftp, remote, newAtime, newMtime);
+    }
+    return residual;
+}
+//# sourceMappingURL=set_attrs.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { FileStat, PathSpec } from '@struktoai/mirage-core/types';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare function stat(accessor: SSHAccessor, p: PathSpec): Promise<FileStat>;
+//# sourceMappingURL=stat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/stat.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAItE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,wBAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBhF"}

package/dist/core/ssh/stat.js

@@ -0,0 +1,40 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { attrsToFileStat } from "./entry.js";
+import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+export async function stat(accessor, p) {
+    const sftp = await accessor.sftp();
+    const virtual = stripPrefix(p);
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    const attrs = await new Promise((resolveFn, rejectFn) => {
+        // Follow symlinks (stat, not lstat), like the Python core: reads
+        // follow the link, so the reported size must be the target's.
+        sftp.stat(remote, (err, stats) => {
+            if (err !== undefined) {
+                if (isNoSuchFile(err))
+                    rejectFn(enoent(p));
+                else
+                    rejectFn(err);
+                return;
+            }
+            resolveFn(stats);
+        });
+    });
+    const cleaned = rstripSlash(virtual);
+    const name = cleaned.length === 0 ? '/' : (cleaned.split('/').pop() ?? '/');
+    return attrsToFileStat(name, attrs);
+}
+//# sourceMappingURL=stat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/ssh/stat.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,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAAqB,EAAE,CAAW;IAC3D,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,KAAK,GAAG,MAAM,IAAI,OAAO,CAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC7D,iEAAiE;QACjE,8DAA8D;QAC9D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC/B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;;oBACrC,QAAQ,CAAC,GAAG,CAAC,CAAA;gBAClB,OAAM;YACR,CAAC;YACD,SAAS,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAA;IAC3E,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACrC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { ReadStream } from 'ssh2';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare function readChunks(rs: ReadStream): AsyncIterable<Uint8Array>;
+export declare function stream(accessor: SSHAccessor, p: PathSpec): AsyncIterable<Uint8Array>;
+export declare function rangeRead(accessor: SSHAccessor, p: PathSpec, start: number, end: number): Promise<Uint8Array>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/stream.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAYxD,wBAAuB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAa3E;AAED,wBAAuB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAW3F;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/dist/core/ssh/stream.js

@@ -0,0 +1,83 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { once } from 'node:events';
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+async function waitForClose(rs) {
+    try {
+        await once(rs, 'close');
+        return null;
+    }
+    catch (error) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+}
+export async function* readChunks(rs) {
+    const closed = waitForClose(rs);
+    let closeError = null;
+    try {
+        for await (const chunk of rs) {
+            const buf = chunk;
+            yield new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+        }
+    }
+    finally {
+        if (!rs.destroyed)
+            rs.destroy();
+        closeError = await closed;
+    }
+    if (closeError !== null)
+        throw closeError;
+}
+export async function* stream(accessor, p) {
+    const sftp = await accessor.sftp();
+    const virtual = stripPrefix(p);
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    const rs = sftp.createReadStream(remote);
+    try {
+        yield* readChunks(rs);
+    }
+    catch (err) {
+        if (isNoSuchFile(err))
+            throw enoent(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;
+    try {
+        for await (const u8 of readChunks(rs)) {
+            chunks.push(u8);
+            total += u8.byteLength;
+        }
+    }
+    catch (err) {
+        if (isNoSuchFile(err))
+            throw enoent(p);
+        throw err;
+    }
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const c of chunks) {
+        out.set(c, offset);
+        offset += c.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=stream.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +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>;
+//# sourceMappingURL=truncate.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/ssh/truncate.js

@@ -0,0 +1,33 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// 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;
+    try {
+        data = await read(accessor, p);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            data = new Uint8Array(0);
+        }
+        else {
+            throw err;
+        }
+    }
+    const out = new Uint8Array(length);
+    out.set(data.subarray(0, Math.min(data.byteLength, length)));
+    await writeBytes(accessor, p, out);
+}
+//# sourceMappingURL=truncate.js.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

package/dist/core/ssh/unlink.js

@@ -0,0 +1,35 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// 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";
+export async function unlink(accessor, p) {
+    const sftp = await accessor.sftp();
+    const virtual = stripPrefix(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);
+        });
+    });
+    await invalidateAfterUnlink(p);
+}
+//# sourceMappingURL=unlink.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,12 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function stripPrefix(p: PathSpec): string;
+export declare function joinRoot(root: string, rel: string): string;
+export declare function isNoSuchFile(err: unknown): boolean;
+export declare function isFailure(err: unknown): boolean;
+export declare function isDirectoryAttrs(attrs: {
+    mode?: number;
+}): boolean;
+export declare function isFileAttrs(attrs: {
+    mode?: number;
+}): boolean;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/ssh/utils.js

@@ -0,0 +1,63 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// 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 { lstripSlash, rstripSlash } from '@struktoai/mirage-core/utils/slash';
+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 function joinRoot(root, rel) {
+    const r = rstripSlash(root);
+    const stripped = lstripSlash(rel);
+    if (stripped === '')
+        return r === '' ? '/' : r;
+    if (r === '')
+        return `/${stripped}`;
+    return `${r}/${stripped}`;
+}
+export function isNoSuchFile(err) {
+    if (err === null || err === undefined)
+        return false;
+    if (typeof err !== 'object')
+        return false;
+    const code = err.code;
+    return code === 2;
+}
+// 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) {
+    if (err === null || err === undefined)
+        return false;
+    if (typeof err !== 'object')
+        return false;
+    const code = err.code;
+    return code === 4;
+}
+export function isDirectoryAttrs(attrs) {
+    if (attrs.mode === undefined)
+        return false;
+    return (attrs.mode & S_IFMT) === S_IFDIR;
+}
+export function isFileAttrs(attrs) {
+    if (attrs.mode === undefined)
+        return false;
+    return (attrs.mode & S_IFMT) === S_IFREG;
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,4 @@
+import { type DeltaHook } from '@struktoai/mirage-core/watch/index';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare function buildDeltaHook(accessor: SSHAccessor): DeltaHook;
+//# sourceMappingURL=watch.d.ts.map