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

package/dist/core/nextcloud/stat.js

@@ -1,67 +1,74 @@
-import { ResourceType } from '@struktoai/mirage-core/cache/index/config';
 import { FileStat, FileType } from '@struktoai/mirage-core/types';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { contentTypeForPath } from '@struktoai/mirage-core/utils/filetype';
-import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
 import { stripSlash } from '@struktoai/mirage-core/utils/slash';
-import { isNotFound, rawPathOf } from "./util.js";
-export async function stat(accessor, path, index) {
-    const prefix = mountPrefixOf(path.virtual, path.resourcePath);
+import { searchFiles } from "./search/index.js";
+import { isNotFound } from "./util.js";
+/**
+ * A listed row as `stat` renders it, the same from a listing and from a
+ * search. Mirrors Python's `stat_of`.
+ */
+export function statOf(name, folder, size, modified) {
+    if (folder) {
+        return new FileStat({ name, type: FileType.DIRECTORY, modified: modified || null });
+    }
+    return new FileStat({
+        name,
+        size,
+        modified: modified || null,
+        type: FileType.FILE,
+        content: contentTypeForPath(name),
+    });
+}
+/**
+ * Every file and folder under a directory, each as `stat` answers it after a
+ * listing, from Nextcloud's file search: a page of a thousand per request,
+ * where a walk sends one per folder. Null from a server without the search,
+ * for a path it cannot find or that is a file, and when a file comes back
+ * without its length, which only a stat of it fills. Mirrors `tree` in
+ * `mirage/core/nextcloud/stat.py`.
+ */
+export async function tree(accessor, path) {
+    const found = await searchFiles(accessor, path);
+    if (found === null)
+        return null;
+    const base = stripSlash(rawPathOf(path));
+    const lead = base === '' ? '/' : `/${base}/`;
+    const rows = new Map();
+    for (const entry of found) {
+        if (!entry.key.startsWith(lead))
+            continue;
+        const folder = entry.kind === 'd';
+        if (!folder && entry.size === null)
+            return null;
+        rows.set(entry.key.slice(lead.length), statOf(entry.key.slice(entry.key.lastIndexOf('/') + 1), folder, entry.size, entry.modified ?? ''));
+    }
+    return rows;
+}
+/** What is at `path`, asked by its WebDAV path. Mirrors Python's `stat`. */
+export async function stat(accessor, path) {
     const raw = rawPathOf(path);
     const key = stripSlash(raw);
     if (key === '')
         return new FileStat({ name: '/', type: FileType.DIRECTORY });
-    const virtualKey = prefix !== '' ? `${prefix}/${key}` : `/${key}`;
-    if (index !== undefined) {
-        const lookup = await index.get(virtualKey);
-        if (lookup.entry !== undefined && lookup.entry !== null) {
-            const entry = lookup.entry;
-            if (entry.resourceType === ResourceType.FOLDER) {
-                return new FileStat({
-                    name: entry.name,
-                    type: FileType.DIRECTORY,
-                    modified: entry.remoteTime || null,
-                });
-            }
-            return new FileStat({
-                name: entry.name,
-                size: entry.size ?? null,
-                modified: entry.remoteTime || null,
-                type: FileType.FILE,
-                content: contentTypeForPath(entry.name),
-            });
-        }
-        const parent = virtualKey.slice(0, virtualKey.lastIndexOf('/')) || '/';
-        const listing = await index.listDir(parent);
-        if (listing.entries !== undefined && listing.entries !== null)
-            throw enoent(path);
-    }
     const op = await accessor.operator();
-    let metadata = null;
+    let metadata;
     try {
         metadata = await op.stat(key);
     }
     catch (error) {
-        if (!isNotFound(error))
-            throw error;
+        if (isNotFound(error))
+            throw enoent(path);
+        throw error;
     }
-    if (metadata !== null && !metadata.isDirectory())
+    if (!metadata.isDirectory())
         return fileStat(key, raw, metadata);
-    try {
-        const directory = await op.stat(`${key}/`);
-        if (directory.isDirectory()) {
-            return new FileStat({
-                name: key.split('/').pop() ?? '/',
-                type: FileType.DIRECTORY,
-                modified: directory.lastModified,
-            });
-        }
-    }
-    catch (error) {
-        if (!isNotFound(error))
-            throw error;
-    }
-    throw enoent(path);
+    return new FileStat({
+        name: key.split('/').pop() ?? '/',
+        type: FileType.DIRECTORY,
+        modified: metadata.lastModified,
+    });
 }
 function fileStat(key, raw, metadata) {
     const etag = metadata.etag;

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

@@ -1 +1 @@
-{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/nextcloud/stat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/nextcloud/stat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAEjE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,IAAY,EACZ,MAAe,EACf,IAAmB,EACnB,QAAgB;IAEhB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAA;IACrF,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI;QACJ,IAAI;QACJ,QAAQ,EAAE,QAAQ,IAAI,IAAI;QAC1B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC;KAClC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,QAA2B,EAC3B,IAAc;IAEd,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAA;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAA;IACxC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,GAAG,CAAA;QACjC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/C,IAAI,CAAC,GAAG,CACN,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAC5B,MAAM,CACJ,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAC/C,MAAM,EACN,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,QAAQ,IAAI,EAAE,CACrB,CACF,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAA2B,EAAE,IAAc;IACpE,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;IAC5E,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;QAAE,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;IAChE,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG;QACjC,IAAI,EAAE,QAAQ,CAAC,SAAS;QACxB,QAAQ,EAAE,QAAQ,CAAC,YAAY;KAChC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,GAAW,EAAE,QAAkB;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG;QACjC,IAAI,EAAE,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7E,QAAQ,EAAE,QAAQ,CAAC,YAAY;QAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAChC,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;KACpD,CAAC,CAAA;AACJ,CAAC"}

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

@@ -1,6 +1,4 @@
-import type { IndexCacheStore } from '@struktoai/mirage-core/cache/index/store';
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { NextcloudAccessor } from '../../accessor/nextcloud.ts';
-export declare function rangeRead(accessor: NextcloudAccessor, path: PathSpec, start: number, end: number): Promise<Uint8Array>;
-export declare function stream(accessor: NextcloudAccessor, path: PathSpec, _index?: IndexCacheStore, chunkSize?: number): AsyncIterable<Uint8Array>;
+export declare function readStream(accessor: NextcloudAccessor, path: PathSpec, chunkSize?: number): AsyncIterable<Uint8Array>;
 //# sourceMappingURL=stream.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAKpE,wBAAgB,SAAS,CACvB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,wBAAuB,MAAM,CAC3B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,eAAe,EACxB,SAAS,SAAqB,GAC7B,aAAa,CAAC,UAAU,CAAC,CAkB3B"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAIpE,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,SAAS,SAAqB,GAC7B,aAAa,CAAC,UAAU,CAAC,CAkB3B"}

package/dist/core/nextcloud/stream.js

@@ -1,14 +1,10 @@
 import { recordStream } from '@struktoai/mirage-core/observe/context';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { DEFAULT_CHUNK_SIZE } from "./constants.js";
-import { read } from "./read.js";
 import { isNotFound, nextcloudKey } from "./util.js";
-export function rangeRead(accessor, path, start, end) {
-    return read(accessor, path, undefined, { offset: start, size: end - start });
-}
-export async function* stream(accessor, path, _index, chunkSize = DEFAULT_CHUNK_SIZE) {
+export async function* readStream(accessor, path, chunkSize = DEFAULT_CHUNK_SIZE) {
     const op = await accessor.operator();
-    const rec = recordStream('read', path.virtual, accessor.resourceName);
+    const rec = recordStream('read', path.virtual, accessor.vfsName);
     let reader;
     try {
         reader = await op.reader(nextcloudKey(path));

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

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/core/nextcloud/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,UAAU,SAAS,CACvB,QAA2B,EAC3B,IAAc,EACd,KAAa,EACb,GAAW;IAEX,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAA;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAC3B,QAA2B,EAC3B,IAAc,EACd,MAAwB,EACxB,SAAS,GAAG,kBAAkB;IAE9B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IACrE,IAAI,MAAM,CAAA;IACV,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACtC,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAC9C,IAAI,IAAI,IAAI,CAAC;YAAE,MAAK;QACpB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QACtD,IAAI,GAAG,KAAK,IAAI;YAAE,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAA;QAC/C,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/core/nextcloud/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,QAA2B,EAC3B,IAAc,EACd,SAAS,GAAG,kBAAkB;IAE9B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAChE,IAAI,MAAM,CAAA;IACV,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACtC,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAC9C,IAAI,IAAI,IAAI,CAAC;YAAE,MAAK;QACpB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QACtD,IAAI,GAAG,KAAK,IAAI;YAAE,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAA;QAC/C,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/truncate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf"}
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/truncate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,UAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/core/nextcloud/truncate.js

@@ -1,8 +1,10 @@
-import { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
+import { enotsup } from '@struktoai/mirage-core/errors/fs';
 import { record, startOp } from '@struktoai/mirage-core/observe/context';
-import { ResourceName } from '@struktoai/mirage-core/types';
+import { VFSName } from '@struktoai/mirage-core/types';
 import { isNotFound, nextcloudKey } from "./util.js";
-export async function truncate(accessor, path, length) {
+export async function truncate(accessor, path, length, noCreate = false) {
+    if (noCreate)
+        throw enotsup('nextcloud', 'truncate --no-create', path);
     const timer = startOp();
     const op = await accessor.operator();
     const key = nextcloudKey(path);
@@ -18,7 +20,6 @@ export async function truncate(accessor, path, length) {
     const next = Buffer.alloc(length);
     current.copy(next, 0, 0, Math.min(current.byteLength, length));
     await op.write(key, next);
-    record('truncate', path.virtual, ResourceName.NEXTCLOUD, 0, timer);
-    await invalidateAfterWrite(path);
+    record('truncate', path.virtual, VFSName.NEXTCLOUD, 0, timer);
 }
 //# sourceMappingURL=truncate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/core/nextcloud/truncate.ts"],"names":[],"mappings":"AAAA,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,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAA2B,EAC3B,IAAc,EACd,MAAc;IAEd,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,OAAe,CAAA;IACnB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QACnC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACjC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACzB,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;IAClE,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC"}
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/core/nextcloud/truncate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAE1D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAGtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAA2B,EAC3B,IAAc,EACd,MAAc,EACd,QAAQ,GAAG,KAAK;IAEhB,IAAI,QAAQ;QAAE,MAAM,OAAO,CAAC,WAAW,EAAE,sBAAsB,EAAE,IAAI,CAAC,CAAA;IACtE,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,OAAe,CAAA;IACnB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QACnC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACjC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACzB,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AAC/D,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"unlink.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/unlink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvF"}
+{"version":3,"file":"unlink.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/unlink.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvF"}

package/dist/core/nextcloud/unlink.js

@@ -1,7 +1,6 @@
-import { invalidateAfterUnlink } from '@struktoai/mirage-core/cache/context';
 import { record, startOp } from '@struktoai/mirage-core/observe/context';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { isNotFound, nextcloudKey } from "./util.js";
 export async function unlink(accessor, path) {
     const op = await accessor.operator();
@@ -14,7 +13,6 @@ export async function unlink(accessor, path) {
             throw enoent(path);
         throw error;
     }
-    record('unlink', path.virtual, ResourceName.NEXTCLOUD, 0, timer);
-    await invalidateAfterUnlink(path);
+    record('unlink', path.virtual, VFSName.NEXTCLOUD, 0, timer);
 }
 //# sourceMappingURL=unlink.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/core/nextcloud/unlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAC5E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAA2B,EAAE,IAAc;IACtE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;IAChE,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/core/nextcloud/unlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEzD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAA2B,EAAE,IAAc;IACtE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AAC7D,CAAC"}

package/dist/core/nextcloud/util.d.ts

@@ -1,5 +1,4 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
-export declare function rawPathOf(path: PathSpec): string;
 export declare function nextcloudKey(path: PathSpec): string;
 export declare function isNotFound(error: unknown): boolean;
 //# sourceMappingURL=util.d.ts.map

package/dist/core/nextcloud/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAKhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD"}

package/dist/core/nextcloud/util.js

@@ -1,11 +1,5 @@
-import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
 import { lstripSlash } from '@struktoai/mirage-core/utils/slash';
-export function rawPathOf(path) {
-    const prefix = mountPrefixOf(path.virtual, path.resourcePath);
-    return prefix !== '' && path.virtual.startsWith(prefix)
-        ? path.virtual.slice(prefix.length) || '/'
-        : path.virtual;
-}
 export function nextcloudKey(path) {
     return lstripSlash(rawPathOf(path));
 }

package/dist/core/nextcloud/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/core/nextcloud/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEhE,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IAC7D,OAAO,MAAM,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG;QAC1C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AACvE,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/core/nextcloud/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEhE,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AACvE,CAAC"}

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

@@ -1,5 +1,4 @@
-import type { IndexCacheStore } from '@struktoai/mirage-core/cache/index/store';
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { NextcloudAccessor } from '../../accessor/nextcloud.ts';
-export declare function write(accessor: NextcloudAccessor, path: PathSpec, data: Uint8Array, _index?: IndexCacheStore): Promise<void>;
+export declare function write(accessor: NextcloudAccessor, path: PathSpec, data: Uint8Array): Promise<void>;
 //# sourceMappingURL=write.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/write.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAG/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,KAAK,CACzB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAWf"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,KAAK,CACzB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/core/nextcloud/write.js

@@ -1,9 +1,8 @@
-import { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
 import { record, startOp } from '@struktoai/mirage-core/observe/context';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { isNotFound, nextcloudKey } from "./util.js";
-export async function write(accessor, path, data, _index) {
+export async function write(accessor, path, data) {
     const timer = startOp();
     try {
         const op = await accessor.operator();
@@ -14,7 +13,6 @@ export async function write(accessor, path, data, _index) {
             throw enoent(path);
         throw error;
     }
-    record('write', path.virtual, ResourceName.NEXTCLOUD, data.byteLength, timer);
-    await invalidateAfterWrite(path);
+    record('write', path.virtual, VFSName.NEXTCLOUD, data.byteLength, timer);
 }
 //# sourceMappingURL=write.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/nextcloud/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAE3E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,QAA2B,EAC3B,IAAc,EACd,IAAgB,EAChB,MAAwB;IAExB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;QACpC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC7E,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/nextcloud/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEzD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,QAA2B,EAC3B,IAAc,EACd,IAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;QACpC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AAC1E,CAAC"}

package/dist/core/ssh/append.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 appendBytes(accessor: SSHAccessor, p: PathSpec, data: Uint8Array): Promise<void>;
+export declare function appendStream(accessor: SSHAccessor, p: PathSpec, data: ByteSource, signal?: AbortSignal): Promise<void>;
 //# sourceMappingURL=append.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"append.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/append.ts"],"names":[],"mappings":"AAgBA,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,WAAW,CAC/B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/core/ssh/append.js

@@ -11,20 +11,44 @@
 // 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";
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { chunks } from '@struktoai/mirage-core/io/cooperative';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { joinRoot, openForWrite } from "./utils.js";
 export async function appendBytes(accessor, p, data) {
+    await appendStream(accessor, p, data);
+}
+export async function appendStream(accessor, p, data, signal) {
+    const timer = startOp();
     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.appendFile(remote, Buffer.from(data), (err) => {
-            if (err)
-                rejectFn(err);
-            else
-                resolveFn();
+    const handle = await openForWrite(sftp, remote, p, 'a');
+    let size = 0;
+    try {
+        for await (const chunk of chunks(data, signal)) {
+            await new Promise((resolveFn, rejectFn) => {
+                sftp.write(handle, Buffer.from(chunk), 0, chunk.byteLength, 0, (err) => {
+                    if (err)
+                        rejectFn(err);
+                    else
+                        resolveFn();
+                });
+            });
+            size += chunk.length;
+        }
+    }
+    finally {
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.close(handle, (err) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn();
+            });
         });
-    });
-    await invalidateAfterWrite(p);
+    }
+    record('append', p.virtual, VFSName.SSH, size, timer);
 }
 //# sourceMappingURL=append.js.map

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

@@ -1 +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"}
+{"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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AAE9D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAGtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAqB,EACrB,CAAW,EACX,IAAgB;IAEhB,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAqB,EACrB,CAAW,EACX,IAAgB,EAChB,MAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,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,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;IACvD,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;gBAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;oBACrE,IAAI,GAAG;wBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;wBACjB,SAAS,EAAE,CAAA;gBAClB,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;YACF,IAAI,IAAI,KAAK,CAAC,MAAM,CAAA;QACtB,CAAC;IACH,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,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;AACvD,CAAC"}

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

@@ -0,0 +1,9 @@
+import { type CapacityResult } from '@struktoai/mirage-core/types';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+/**
+ * The space of the filesystem the mount's root sits on, for df, from the
+ * server's statvfs, counted the way df counts a disk. A server without the
+ * statvfs extension is UNKNOWN. Mirrors Python's `capacity`.
+ */
+export declare function capacity(accessor: SSHAccessor): Promise<CapacityResult>;
+//# sourceMappingURL=capacity.d.ts.map

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

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

package/dist/core/ssh/capacity.js

@@ -0,0 +1,52 @@
+// ========= 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 { CapacityState } from '@struktoai/mirage-core/types';
+import { joinRoot } from "./utils.js";
+/**
+ * The space of the filesystem the mount's root sits on, for df, from the
+ * server's statvfs, counted the way df counts a disk. A server without the
+ * statvfs extension is UNKNOWN. Mirrors Python's `capacity`.
+ */
+export async function capacity(accessor) {
+    const sftp = await accessor.sftp();
+    const remote = joinRoot(accessor.config.root ?? '/', '');
+    let st;
+    try {
+        st = await new Promise((resolveFn, rejectFn) => {
+            sftp.ext_openssh_statvfs(remote, (err, info) => {
+                if (err !== undefined)
+                    rejectFn(err);
+                else
+                    resolveFn(info);
+            });
+        });
+    }
+    catch (error) {
+        console.debug(`ssh statvfs unanswered: ${String(error)}`);
+        return { state: CapacityState.UNKNOWN };
+    }
+    const frsize = Number(st.f_frsize) || Number(st.f_bsize);
+    const blocks = Number(st.f_blocks);
+    const files = Number(st.f_files);
+    return {
+        state: CapacityState.QUOTA,
+        total: blocks * frsize,
+        used: (blocks - Number(st.f_bfree)) * frsize,
+        available: Number(st.f_bavail) * frsize,
+        inodes: files,
+        inodesUsed: files - Number(st.f_ffree),
+        inodesFree: Number(st.f_favail),
+    };
+}
+//# sourceMappingURL=capacity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capacity.js","sourceRoot":"","sources":["../../../src/core/ssh/capacity.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,aAAa,EAAuB,MAAM,8BAA8B,CAAA;AAEjF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAqB;IAClD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IACxD,IAAI,EAUH,CAAA;IACD,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,IAAI,OAAO,CAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YACxD,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAe,EAAE,EAAE;gBACxD,IAAI,GAAG,KAAK,SAAS;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;oBAC/B,SAAS,CAAC,IAAI,CAAC,CAAA;YACtB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACzD,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,CAAA;IACzC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;IAChC,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,KAAK,EAAE,MAAM,GAAG,MAAM;QACtB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM;QAC5C,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,MAAM;QACvC,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC;QACtC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC;KAChC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare const SUMS: Readonly<Record<string, readonly [string, number]>>;
+/**
+ * A file's digest, by the matching coreutils sum on the server, so the bytes
+ * never cross the connection.
+ *
+ * Only an exit of 0 with nothing on stderr and one digest of the algorithm's
+ * length on stdout answers: a server that runs no commands or has no such
+ * tool, a directory or a file the tool could not read leaves the file to be
+ * read and hashed, which reports it. Mirrors Python's `checksum`.
+ */
+export declare function checksum(accessor: SSHAccessor, p: PathSpec, algorithm: string): Promise<string | null>;
+//# sourceMappingURL=checksum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/checksum.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAMpE,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBxB"}

package/dist/core/ssh/checksum.js

@@ -0,0 +1,60 @@
+// ========= 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 { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { singleQuote } from '@struktoai/mirage-core/utils/quote';
+import { joinRoot } from "./utils.js";
+export const SUMS = {
+    md5: ['md5sum', 32],
+    sha1: ['sha1sum', 40],
+    sha256: ['sha256sum', 64],
+    sha384: ['sha384sum', 96],
+    sha512: ['sha512sum', 128],
+};
+/**
+ * A file's digest, by the matching coreutils sum on the server, so the bytes
+ * never cross the connection.
+ *
+ * Only an exit of 0 with nothing on stderr and one digest of the algorithm's
+ * length on stdout answers: a server that runs no commands or has no such
+ * tool, a directory or a file the tool could not read leaves the file to be
+ * read and hashed, which reports it. Mirrors Python's `checksum`.
+ */
+export async function checksum(accessor, p, algorithm) {
+    const tool = Object.hasOwn(SUMS, algorithm) ? SUMS[algorithm] : undefined;
+    if (tool === undefined)
+        return null;
+    const [name, width] = tool;
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
+    let status;
+    let out;
+    let err;
+    try {
+        ;
+        [status, out, err] = await accessor.run(`${name} < ${singleQuote(remote)}`);
+    }
+    catch (error) {
+        console.debug(`ssh checksum left to the read: ${String(error)}`);
+        return null;
+    }
+    const text = new TextDecoder().decode(out);
+    const digest = text.slice(0, width);
+    if (status !== 0 ||
+        err.length > 0 ||
+        text.slice(width) !== '  -\n' ||
+        !new RegExp(`^[0-9a-f]{${String(width)}}$`).test(digest)) {
+        return null;
+    }
+    return digest;
+}
+//# sourceMappingURL=checksum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../src/core/ssh/checksum.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,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,MAAM,CAAC,MAAM,IAAI,GAAwD;IACvE,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IACnB,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;IACrB,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IACzB,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IACzB,MAAM,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC;CAC3B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAqB,EACrB,CAAW,EACX,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACzE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAA;IAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,IAAI,MAAqB,CAAA;IACzB,IAAI,GAAe,CAAA;IACnB,IAAI,GAAe,CAAA;IACnB,IAAI,CAAC;QACH,CAAC;QAAA,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAChE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IACnC,IACE,MAAM,KAAK,CAAC;QACZ,GAAG,CAAC,MAAM,GAAG,CAAC;QACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO;QAC7B,CAAC,IAAI,MAAM,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EACxD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

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

@@ -1,3 +1,5 @@
-export declare const SCOPE_WARN = 500;
 export declare const SCOPE_ERROR = 5000;
+/** SFTP open flags: write, creating a missing file and truncating none. */
+export declare const FXF_WRITE = 2;
+export declare const FXF_CREAT = 8;
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/constants.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,OAAO,CAAA;AAE/B,2EAA2E;AAC3E,eAAO,MAAM,SAAS,IAAa,CAAA;AACnC,eAAO,MAAM,SAAS,IAAa,CAAA"}