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

package/dist/core/opendal/types.js

@@ -0,0 +1,15 @@
+// ========= 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. =========
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/opendal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/opendal/types.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"}

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

@@ -0,0 +1,23 @@
+import { type PathSpec, type WalkEntry } from '@struktoai/mirage-core/types';
+import type { OperatorAccessor } from './types.ts';
+/**
+ * Recursive opendal list feeding the generic listing differ.
+ *
+ * Reads through the operator directly (one recursive LIST), never through
+ * mirage's caches, as the DeltaHook contract requires. Fingerprints use
+ * mirage's default: the native ETag when the listing carries one, `mtime|size`
+ * otherwise.
+ *
+ * Some opendal services answer LIST without per-entry metadata (the hf lister
+ * does; WebDAV's PROPFIND does not), which would leave every file
+ * unfingerprinted and reduce detection to create/delete. When a listed file
+ * carries no metadata at all, one `stat` per affected file fills the gap,
+ * mirroring what the hf readdir already does for sizes. A backend whose lister
+ * is complete never pays for it.
+ */
+export declare class OpendalWalk {
+    private readonly accessor;
+    constructor(accessor: OperatorAccessor);
+    walk(root: PathSpec): AsyncGenerator<WalkEntry>;
+}
+//# sourceMappingURL=watch.d.ts.map

package/dist/core/opendal/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/core/opendal/watch.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAM5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAalD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,QAAQ,EAAE,gBAAgB;IAI/B,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC;CA4CvD"}

package/dist/core/opendal/watch.js

@@ -0,0 +1,96 @@
+// ========= 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 {} from '@struktoai/mirage-core/types';
+import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { statFingerprint } from '@struktoai/mirage-core/watch/index';
+import { isNotFound } from "../nextcloud/util.js";
+async function statOrNull(operator, key) {
+    try {
+        return await operator.stat(key);
+    }
+    catch (error) {
+        // Deleted between the listing and the stat; the next pull reports
+        // the DELETE from the snapshot diff.
+        if (isNotFound(error))
+            return null;
+        throw error;
+    }
+}
+/**
+ * Recursive opendal list feeding the generic listing differ.
+ *
+ * Reads through the operator directly (one recursive LIST), never through
+ * mirage's caches, as the DeltaHook contract requires. Fingerprints use
+ * mirage's default: the native ETag when the listing carries one, `mtime|size`
+ * otherwise.
+ *
+ * Some opendal services answer LIST without per-entry metadata (the hf lister
+ * does; WebDAV's PROPFIND does not), which would leave every file
+ * unfingerprinted and reduce detection to create/delete. When a listed file
+ * carries no metadata at all, one `stat` per affected file fills the gap,
+ * mirroring what the hf readdir already does for sizes. A backend whose lister
+ * is complete never pays for it.
+ */
+export class OpendalWalk {
+    accessor;
+    constructor(accessor) {
+        this.accessor = accessor;
+    }
+    async *walk(root) {
+        const prefix = mountPrefixOf(root.virtual, root.resourcePath);
+        const base = stripSlash(root.resourcePath);
+        const listPath = base !== '' ? `${base}/` : '/';
+        const operator = await this.accessor.operator();
+        let entries;
+        try {
+            entries = await operator.list(listPath, { recursive: true });
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return;
+            throw error;
+        }
+        for (const entry of entries) {
+            const relative = entry.path();
+            if (relative === '' || relative === listPath)
+                continue;
+            let metadata = entry.metadata();
+            const isDir = relative.endsWith('/') || metadata.isDirectory();
+            const resourcePath = stripSlash(relative);
+            const virtual = prefix !== '' ? `${prefix}/${resourcePath}` : `/${resourcePath}`;
+            if (isDir) {
+                yield { virtual, isDir: true, fingerprint: null };
+                continue;
+            }
+            if (metadata.etag === null &&
+                metadata.lastModified === null &&
+                metadata.contentLength === null) {
+                metadata = await statOrNull(operator, resourcePath);
+            }
+            const modified = metadata?.lastModified ?? null;
+            const size = metadata?.contentLength === null || metadata?.contentLength === undefined
+                ? null
+                : Number(metadata.contentLength);
+            yield {
+                virtual,
+                isDir: false,
+                fingerprint: statFingerprint(metadata?.etag ?? null, modified, size),
+                size,
+                modified,
+            };
+        }
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/core/opendal/watch.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"append.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/append.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/core/ssh/append.js

@@ -0,0 +1,30 @@
+// ========= 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 { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
+import { joinRoot, stripPrefix } from "./utils.js";
+export async function appendBytes(accessor, p, data) {
+    const sftp = await accessor.sftp();
+    const virtual = stripPrefix(p);
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    await new Promise((resolveFn, rejectFn) => {
+        sftp.appendFile(remote, Buffer.from(data), (err) => {
+            if (err)
+                rejectFn(err);
+            else
+                resolveFn();
+        });
+    });
+    await invalidateAfterWrite(p);
+}
+//# sourceMappingURL=append.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"append.js","sourceRoot":"","sources":["../../../src/core/ssh/append.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;AAG3E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAqB,EACrB,CAAW,EACX,IAAgB;IAEhB,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,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;YACjD,IAAI,GAAG;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;gBACjB,SAAS,EAAE,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAA;AAC/B,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare const SCOPE_WARN = 500;
+export declare const SCOPE_ERROR = 5000;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/constants.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,UAAU,MAAM,CAAA;AAC7B,eAAO,MAAM,WAAW,OAAO,CAAA"}

package/dist/core/ssh/constants.js

@@ -0,0 +1,16 @@
+// ========= 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. =========
+export const SCOPE_WARN = 500;
+export const SCOPE_ERROR = 5000;
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/ssh/constants.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,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAA;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAA"}

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

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

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

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

package/dist/core/ssh/copy.js

@@ -0,0 +1,20 @@
+// ========= 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 copy(accessor, src, dst) {
+    const data = await read(accessor, src);
+    await writeBytes(accessor, dst, data);
+}
+//# sourceMappingURL=copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/core/ssh/copy.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,IAAI,CAAC,QAAqB,EAAE,GAAa,EAAE,GAAa;IAC5E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACtC,MAAM,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;AACvC,CAAC"}

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

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

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

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

package/dist/core/ssh/create.js

@@ -0,0 +1,18 @@
+// ========= 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 { writeBytes } from "./write.js";
+export function create(accessor, path) {
+    return writeBytes(accessor, path, new Uint8Array());
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/ssh/create.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,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,UAAU,MAAM,CAAC,QAAqB,EAAE,IAAc;IAC1D,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC,CAAA;AACrD,CAAC"}

package/dist/core/ssh/du/entries.d.ts

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

package/dist/core/ssh/du/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../../../src/core/ssh/du/entries.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAI3D,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,GACV,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAMvD"}

package/dist/core/ssh/du/entries.js

@@ -0,0 +1,25 @@
+// ========= 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 { norm } from '@struktoai/mirage-core/utils/path';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { stripPrefix } from "../utils.js";
+import { walkAll } from "./walk.js";
+export async function entries(accessor, p) {
+    const virtual = norm(stripPrefix(p));
+    const entries = [];
+    const total = await walkAll(accessor, virtual, entries);
+    entries.sort((a, b) => compareCodePoints(a[0], b[0]));
+    return [entries, total];
+}
+//# sourceMappingURL=entries.js.map

package/dist/core/ssh/du/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../../../src/core/ssh/du/entries.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,IAAI,EAAE,MAAM,mCAAmC,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAqB,EACrB,CAAW;IAEX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACrD,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AACzB,CAAC"}

package/dist/core/ssh/du/index.d.ts

@@ -0,0 +1,3 @@
+export { entries } from './entries.ts';
+export { size } from './size.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ssh/du/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/ssh/du/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}

package/dist/core/ssh/du/index.js

@@ -0,0 +1,16 @@
+// ========= 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. =========
+export { entries } from "./entries.js";
+export { size } from "./size.js";
+//# sourceMappingURL=index.js.map

package/dist/core/ssh/du/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/ssh/du/index.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,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}

package/dist/core/ssh/du/size.d.ts

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

package/dist/core/ssh/du/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../../../src/core/ssh/du/size.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAI3D,wBAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E"}

package/dist/core/ssh/du/size.js

@@ -0,0 +1,20 @@
+// ========= 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 { stripPrefix } from "../utils.js";
+import { walkSizes } from "./walk.js";
+export async function size(accessor, p) {
+    const virtual = stripPrefix(p);
+    return walkSizes(accessor, virtual);
+}
+//# sourceMappingURL=size.js.map

package/dist/core/ssh/du/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../../../src/core/ssh/du/size.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,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAAqB,EAAE,CAAW;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC9B,OAAO,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACrC,CAAC"}

package/dist/core/ssh/du/walk.d.ts

@@ -0,0 +1,4 @@
+import type { SSHAccessor } from '../../../accessor/ssh.ts';
+export declare function walkSizes(accessor: SSHAccessor, virtual: string): Promise<number>;
+export declare function walkAll(accessor: SSHAccessor, virtual: string, entries: [string, number][]): Promise<number>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/core/ssh/du/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../../src/core/ssh/du/walk.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AA6C3D,wBAAsB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBvF;AAED,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/core/ssh/du/walk.js

@@ -0,0 +1,105 @@
+// ========= 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 { isDirectoryAttrs, isFileAttrs, joinRoot } from "../utils.js";
+async function readRemoteDir(accessor, remote) {
+    const sftp = await accessor.sftp();
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.readdir(remote, (err, entries) => {
+            if (err !== undefined) {
+                const code = err.code;
+                if (code === 2) {
+                    resolveFn(null);
+                    return;
+                }
+                rejectFn(err);
+                return;
+            }
+            resolveFn(entries);
+        });
+    });
+}
+async function statRemote(accessor, remote) {
+    const sftp = await accessor.sftp();
+    return new Promise((resolveFn, rejectFn) => {
+        sftp.lstat(remote, (err, stats) => {
+            if (err !== undefined) {
+                const code = err.code;
+                if (code === 2) {
+                    resolveFn(null);
+                    return;
+                }
+                rejectFn(err);
+                return;
+            }
+            resolveFn({ mode: stats.mode, size: stats.size });
+        });
+    });
+}
+export async function walkSizes(accessor, virtual) {
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    const st = await statRemote(accessor, remote);
+    if (st === null)
+        return 0;
+    if (isFileAttrs(st))
+        return st.size;
+    if (!isDirectoryAttrs(st))
+        return 0;
+    const entries = await readRemoteDir(accessor, remote);
+    if (entries === null)
+        return 0;
+    let total = 0;
+    for (const entry of entries) {
+        if (entry.filename === '.' || entry.filename === '..')
+            continue;
+        const child = virtual === '/' ? `/${entry.filename}` : `${virtual}/${entry.filename}`;
+        if (isDirectoryAttrs(entry.attrs)) {
+            total += await walkSizes(accessor, child);
+        }
+        else {
+            total += entry.attrs.size;
+        }
+    }
+    return total;
+}
+export async function walkAll(accessor, virtual, entries) {
+    const remote = joinRoot(accessor.config.root ?? '/', virtual);
+    const st = await statRemote(accessor, remote);
+    if (st === null)
+        return 0;
+    if (isFileAttrs(st)) {
+        entries.push([virtual, st.size]);
+        return st.size;
+    }
+    if (!isDirectoryAttrs(st))
+        return 0;
+    const list = await readRemoteDir(accessor, remote);
+    if (list === null)
+        return 0;
+    let total = 0;
+    for (const entry of list) {
+        if (entry.filename === '.' || entry.filename === '..')
+            continue;
+        const child = virtual === '/' ? `/${entry.filename}` : `${virtual}/${entry.filename}`;
+        if (isDirectoryAttrs(entry.attrs)) {
+            total += await walkAll(accessor, child, entries);
+        }
+        else {
+            const size = entry.attrs.size;
+            entries.push([child, size]);
+            total += size;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=walk.js.map

package/dist/core/ssh/du/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../../../src/core/ssh/du/walk.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,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAErE,KAAK,UAAU,aAAa,CAC1B,QAAqB,EACrB,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,OAAO,IAAI,OAAO,CAA8B,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QACtE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;gBAC7C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,SAAS,CAAC,IAAI,CAAC,CAAA;oBACf,OAAM;gBACR,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,CAAA;gBACb,OAAM;YACR,CAAC;YACD,SAAS,CAAC,OAAO,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,QAAqB,EACrB,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,OAAO,IAAI,OAAO,CAAwC,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAChF,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAChC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;gBAC7C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,SAAS,CAAC,IAAI,CAAC,CAAA;oBACf,OAAM;gBACR,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,CAAA;gBACb,OAAM;YACR,CAAC;YACD,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACnD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAqB,EAAE,OAAe;IACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7C,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IACzB,IAAI,WAAW,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC,IAAI,CAAA;IACnC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACrD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IAC9B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAQ;QAC/D,MAAM,KAAK,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;QACrF,IAAI,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,KAAK,IAAI,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC3C,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAqB,EACrB,OAAe,EACf,OAA2B;IAE3B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7C,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IACzB,IAAI,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;QAChC,OAAO,EAAE,CAAC,IAAI,CAAA;IAChB,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAClD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAQ;QAC/D,MAAM,KAAK,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;QACrF,IAAI,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,KAAK,IAAI,MAAM,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAA;YAC3B,KAAK,IAAI,IAAI,CAAA;QACf,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,11 @@
+import { FileStat } from '@struktoai/mirage-core/types';
+export interface SshAttrs {
+    size?: number;
+    mode?: number;
+    mtime?: number;
+    atime?: number;
+    uid?: number;
+    gid?: number;
+}
+export declare function attrsToFileStat(name: string, attrs: SshAttrs): FileStat;
+//# sourceMappingURL=entry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/entry.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAY,MAAM,8BAA8B,CAAA;AAIjE,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAwCvE"}

package/dist/core/ssh/entry.js

@@ -0,0 +1,61 @@
+// ========= 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 { FileStat, FileType } from '@struktoai/mirage-core/types';
+import { contentTypeForPath } from '@struktoai/mirage-core/utils/filetype';
+import { isDirectoryAttrs } from "./utils.js";
+export function attrsToFileStat(name, attrs) {
+    const modified = attrs.mtime !== undefined ? new Date(attrs.mtime * 1000).toISOString() : null;
+    const extra = {};
+    if (attrs.mode !== undefined)
+        extra.mode = attrs.mode;
+    if (attrs.uid !== undefined)
+        extra.uid = attrs.uid;
+    if (attrs.gid !== undefined)
+        extra.gid = attrs.gid;
+    // Fields setattr applies natively (mode, times) surface from the
+    // remote inode, so external chmod/utime stays visible, mirroring
+    // disk. Ownership can never be applied natively (chown over SFTP
+    // needs privileges), so it lives wholly in the namespace overlay;
+    // server-side uid/gid stay in extra only.
+    const mode = attrs.mode !== undefined ? attrs.mode & 0o7777 : null;
+    const atime = attrs.atime !== undefined ? new Date(attrs.atime * 1000).toISOString() : null;
+    // The remote mtime is the only cheap change token SFTP offers, so it is
+    // also the fingerprint: without one, the ALWAYS consistency policy has
+    // nothing to compare and keeps serving a cached copy that the server has
+    // already replaced. Mirrors the python stat.
+    if (isDirectoryAttrs(attrs)) {
+        return new FileStat({
+            name,
+            size: null,
+            modified,
+            fingerprint: modified,
+            type: FileType.DIRECTORY,
+            mode,
+            atime,
+            extra,
+        });
+    }
+    return new FileStat({
+        name,
+        size: attrs.size ?? null,
+        modified,
+        fingerprint: modified,
+        type: FileType.FILE,
+        content: contentTypeForPath(name),
+        mode,
+        atime,
+        extra,
+    });
+}
+//# sourceMappingURL=entry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/core/ssh/entry.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,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAW7C,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAe;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC9F,MAAM,KAAK,GAA4B,EAAE,CAAA;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACrD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAA;IAClD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAA;IAClD,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,kEAAkE;IAClE,0CAA0C;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;IAClE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3F,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,6CAA6C;IAC7C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,QAAQ,CAAC;YAClB,IAAI;YACJ,IAAI,EAAE,IAAI;YACV,QAAQ;YACR,WAAW,EAAE,QAAQ;YACrB,IAAI,EAAE,QAAQ,CAAC,SAAS;YACxB,IAAI;YACJ,KAAK;YACL,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;QACxB,QAAQ;QACR,WAAW,EAAE,QAAQ;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC;QACjC,IAAI;QACJ,KAAK;QACL,KAAK;KACN,CAAC,CAAA;AACJ,CAAC"}

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

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

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

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