@struktoai/mirage-node 0.0.5 → 0.0.6

package/dist/core/hf_hub/tree.js

@@ -0,0 +1,334 @@
+// ========= 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 { IndexEntry } from '@struktoai/mirage-core/cache/index/config';
+import { LookupStatus } from '@struktoai/mirage-core/cache/index/config';
+import * as kp from '@struktoai/mirage-core/utils/key_prefix';
+import { HfHubError, apiUrl, hubGetResponse, revSegment } from "./client.js";
+import { MAX_TREE_PAGES, TREE_PAGE_SIZE, TREE_PAGE_SIZE_EXPANDED } from "./constants.js";
+import { isDirEntry } from "./tree_entry.js";
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+// `Link: <url>; rel="next"`, which is how the tree endpoint hands back its
+// cursor. Bounded repetition on the URL body so a pathological header cannot
+// backtrack quadratically.
+const NEXT_LINK = /<([^>]{1,4096})>\s*;\s*rel="next"/;
+// A repository the mount cannot see reads as an empty tree rather than as an
+// error: 404 is a revision or subtree that does not exist, and the Hub answers
+// 401 rather than 404 for a repo an anonymous caller may not know about, so
+// both mean "nothing to list here" to a mount.
+const ABSENT_STATUSES = new Set([401, 403, 404]);
+function str(value, fallback = '') {
+    return typeof value === 'string' ? value : fallback;
+}
+/** Turn one tree row into a TreeEntry. */
+export function parseEntry(item) {
+    const lfs = (item.lfs ?? {});
+    const commit = (item.lastCommit ?? {});
+    const size = item.size;
+    return {
+        path: str(item.path),
+        type: str(item.type, 'file'),
+        oid: str(item.oid),
+        size: typeof size === 'number' ? size : undefined,
+        lastModified: str(commit.date),
+        lastCommit: str(commit.id),
+        lfsOid: str(lfs.oid),
+        xetHash: str(item.xetHash),
+    };
+}
+/**
+ * The next page's URL, read out of the Link header.
+ *
+ * The Hub pages the tree with an opaque cursor rather than a page number, so
+ * the only way to ask for page two is to follow the URL it handed back.
+ */
+export function nextCursor(headers) {
+    const link = headers.link ?? '';
+    const match = link === '' ? null : NEXT_LINK.exec(link);
+    return match === null ? '' : (match[1] ?? '');
+}
+/** Query for one tree page. */
+export function pageParams(expand) {
+    return {
+        recursive: 'true',
+        expand: expand ? 'true' : 'false',
+        limit: String(expand ? TREE_PAGE_SIZE_EXPANDED : TREE_PAGE_SIZE),
+    };
+}
+/** The tree endpoint for the mount's revision and key prefix. */
+export function treeUrl(accessor) {
+    let suffix = `/tree/${revSegment(accessor.revision)}`;
+    // The prefix is normalized with a trailing slash, which the tree endpoint
+    // reads as a path segment of its own.
+    const stem = accessor.keyPrefix.replace(/^\/+|\/+$/g, '');
+    if (stem !== '')
+        suffix += `/${stem}`;
+    return apiUrl(accessor.endpoint, accessor.repoType, accessor.repoId, suffix);
+}
+/** Fold one page of tree rows into the mount's listing. */
+export function collect(rows, prefix, into) {
+    const stem = prefix.replace(/\/+$/, '');
+    for (const item of Array.isArray(rows) ? rows : []) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const entry = parseEntry(item);
+        if (entry.path === '')
+            continue;
+        // A prefix mount lists its own subtree, and the row naming that directory
+        // is not a child of anything. `kp.strip` cannot drop it on its own: the
+        // prefix is normalized with a trailing slash, so the bare directory path
+        // does not start with it and comes back unchanged, which would key the
+        // prefix itself under the mount root.
+        if (stem !== '' && entry.path === stem)
+            continue;
+        const rel = prefix === '' ? entry.path : kp.strip(prefix, entry.path);
+        if (rel !== '')
+            into.set(rel, entry);
+    }
+}
+/** Follow the cursor from one page to the last, folding as it goes. */
+/**
+ * The refusal for a listing the page ceiling cut short.
+ *
+ * Thrown rather than returned because this listing is not a cache in front
+ * of the Hub, it is seeded as the mount's whole index: a partial one reads
+ * as a complete one, so every file past the ceiling becomes a confident
+ * false absence and `hf download` silently omits it. An error the caller
+ * can see is the lesser failure.
+ */
+export function truncated(repoId) {
+    return new HfHubError(`hf: ${repoId}: listing exceeds ${String(MAX_TREE_PAGES)} pages`, 0);
+}
+export async function walkPages(accessor, url, params, into, limit = MAX_TREE_PAGES) {
+    let target = url;
+    let query = params;
+    for (let page = 0; page < limit; page += 1) {
+        let response;
+        try {
+            response = await hubGetResponse(accessor.token, target, query);
+        }
+        catch (err) {
+            if (err instanceof HfHubError && ABSENT_STATUSES.has(err.status))
+                return '';
+            throw err;
+        }
+        collect(response.data, accessor.keyPrefix, into);
+        target = nextCursor(response.headers);
+        if (target === '')
+            return '';
+        // The cursor URL carries the whole query already; sending the first
+        // page's params alongside it duplicates them.
+        query = undefined;
+    }
+    return target;
+}
+/**
+ * Every path under the mount's subtree, in one paged walk.
+ *
+ * `recursive=true` returns the whole subtree. Size, oid and the LFS and Xet
+ * hashes all ride the bare row, so the only thing `expand=true` adds is the
+ * commit that last touched each path -- a Hub file's only mtime -- and it
+ * costs a twentyfold drop in page size (1000 rows to 50, with any explicit
+ * limit above 100 refused).
+ *
+ * Which one is used is the mount's call, and its default is neither: ask for
+ * one expanded page, and if the whole repository fit in it, that page is the
+ * answer and the mtimes came free. Only a repository too big for one page
+ * falls back to the bare walk, and pays one wasted request for the attempt.
+ */
+export async function fetchTree(accessor) {
+    const url = treeUrl(accessor);
+    const expand = accessor.expandCommits;
+    let result = new Map();
+    if (expand !== false) {
+        // One page, and no cursor followed: whether a second page exists is
+        // exactly the question being asked.
+        const left = await walkPages(accessor, url, pageParams(true), result, 1);
+        if (left === '')
+            return result;
+        if (expand === true) {
+            if ((await walkPages(accessor, left, undefined, result)) !== '') {
+                throw truncated(accessor.repoId);
+            }
+            return result;
+        }
+        // Too big to expand. The bare walk restarts from the first page rather
+        // than continuing from this cursor, because the cursor belongs to the
+        // expanded query and its rows carry a different page size.
+        result = new Map();
+    }
+    if ((await walkPages(accessor, url, pageParams(false), result)) !== '') {
+        throw truncated(accessor.repoId);
+    }
+    return result;
+}
+/**
+ * Bucket a Hub tree by parent directory.
+ *
+ * Keyed by mount-absolute path, the way every other backend keys its index,
+ * so the shared cache machinery can spell an eviction without knowing which
+ * backend it is talking to. The tree itself stays mount-relative; `prefix` is
+ * what lifts it. This is the one shape both storage paths are built from, so
+ * the seeded index and the derived tables cannot disagree.
+ */
+export function indexDirs(tree, prefix) {
+    const stem = prefix.replace(/\/+$/, '');
+    const dirs = new Map();
+    // The repository root always exists, so it gets a row even when the tree is
+    // empty. Without it an empty repo is byte for byte a dropped index and every
+    // read would refetch.
+    dirs.set(stem === '' ? '/' : stem, []);
+    for (const [path, entry] of tree) {
+        const cut = path.lastIndexOf('/');
+        const parent = cut === -1 ? (stem === '' ? '/' : stem) : `${stem}/${path.slice(0, cut)}`;
+        const name = cut === -1 ? path : path.slice(cut + 1);
+        const extra = { oid: entry.oid };
+        if (entry.lastCommit !== '')
+            extra.last_commit = entry.lastCommit;
+        if (entry.lfsOid !== '')
+            extra.lfs_oid = entry.lfsOid;
+        if (entry.xetHash !== '')
+            extra.xet_hash = entry.xetHash;
+        const row = new IndexEntry({
+            id: entry.oid,
+            name,
+            resourceType: isDirEntry(entry) ? 'folder' : 'file',
+            remoteTime: entry.lastModified,
+            size: isDirEntry(entry) ? null : (entry.size ?? null),
+            extra,
+        });
+        const bucket = dirs.get(parent);
+        if (bucket === undefined)
+            dirs.set(parent, [[name, row]]);
+        else
+            bucket.push([name, row]);
+        // A tree row names its parent directories implicitly. The Hub's recursive
+        // listing does emit a row per directory, but a page boundary can deliver a
+        // child before its parent, so the parent's bucket is created here too and
+        // merged with its own row's.
+        let head = cut === -1 ? '' : path.slice(0, cut);
+        while (head !== '') {
+            const key = `${stem}/${head}`;
+            if (!dirs.has(key))
+                dirs.set(key, []);
+            const up = head.lastIndexOf('/');
+            head = up === -1 ? '' : head.slice(0, up);
+        }
+    }
+    return dirs;
+}
+/** The entry and children tables a no-index mount reads, from the buckets. */
+export function indexRows(tree, prefix) {
+    const entries = new Map();
+    const children = new Map();
+    for (const [parent, rows] of indexDirs(tree, prefix)) {
+        const base = parent.replace(/\/+$/, '');
+        for (const [name, row] of rows)
+            entries.set(`${base}/${name}`, row);
+        children.set(parent, rows.map(([name]) => `${base}/${name}`).sort(compareCodePoints));
+    }
+    return { entries, children };
+}
+/**
+ * Write the accessor's tree into `index` under `prefix`.
+ *
+ * One `setDir` per directory, the way the shared store spells a whole
+ * listing; the year-long expiry is what makes the index the listing rather
+ * than a cache in front of one.
+ */
+export async function seedIndex(accessor, index, prefix) {
+    const dirs = indexDirs(accessor.tree, prefix);
+    const expires = new Date(Date.now() + 365 * 24 * 60 * 60 * 1000);
+    await Promise.all([...dirs].map(([parent, rows]) => index.setDir(parent, rows, expires)));
+}
+/**
+ * Refetch the tree and re-seed the index from it.
+ *
+ * The mount fetches the whole tree once and seeds the index with it, so the
+ * index *is* the listing rather than a cache in front of one. That makes a
+ * cleared or expired index indistinguishable from an empty repository, which
+ * is why dropping the index has to mean "refetch".
+ */
+export async function refillIndex(accessor, index, prefix) {
+    accessor.tree = await fetchTree(accessor);
+    accessor.treeLoaded = true;
+    accessor.rowsCache = null;
+    await seedIndex(accessor, index, prefix);
+    return true;
+}
+/**
+ * Refetch when the index holds no listing at all.
+ *
+ * Every reader treats a missing listing as a real absence, which is right
+ * against a *live* index and wrong against one that was never filled or has
+ * been dropped. The root listing is what tells the two apart, in one lookup
+ * and no request: the tree is written whole, so while the index is live the
+ * mount root always has a row.
+ */
+export async function ensureLiveIndex(accessor, index, prefix) {
+    const root = prefix.replace(/\/+$/, '');
+    const listing = await index.listDir(root === '' ? '/' : root);
+    if (listing.status !== LookupStatus.NOT_FOUND)
+        return false;
+    return refillIndex(accessor, index, prefix);
+}
+/**
+ * Fetch the tree if this mount has not got one yet.
+ *
+ * Hydration is tracked by `treeLoaded`, never by whether the tree holds
+ * anything: an empty repository hydrates to an empty map, and reading that as
+ * "not hydrated" refetches it on every call forever.
+ */
+export async function ensureTree(accessor, index, prefix = '') {
+    if (accessor.treeLoaded)
+        return;
+    if (accessor.hydrating !== null) {
+        await accessor.hydrating;
+        return;
+    }
+    const run = (async () => {
+        if (index !== undefined) {
+            await refillIndex(accessor, index, prefix);
+            return;
+        }
+        accessor.tree = await fetchTree(accessor);
+        accessor.treeLoaded = true;
+        accessor.rowsCache = null;
+    })();
+    accessor.hydrating = run;
+    try {
+        await run;
+    }
+    finally {
+        accessor.hydrating = null;
+    }
+}
+/**
+ * The index tables built straight from the accessor's tree.
+ *
+ * What a mount with no index wired reads instead. Every reader has an index
+ * inside a workspace, but a backend constructed on its own has NULL_INDEX,
+ * whose every lookup is a miss -- so without this, readdir answered ENOENT for
+ * a repository it could list perfectly well. Built by the same `indexRows` the
+ * seeded path uses, so the two cannot disagree.
+ */
+export async function localRows(accessor, prefix) {
+    await ensureTree(accessor);
+    const cached = accessor.rowsCache;
+    if (cached !== null && cached.prefix === prefix)
+        return cached.rows;
+    const rows = indexRows(accessor.tree, prefix);
+    accessor.rowsCache = { prefix, rows };
+    return rows;
+}
+//# sourceMappingURL=tree.js.map

package/dist/core/hf_hub/tree.js.map

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

package/dist/core/hf_hub/tree_entry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * One row of a Hub repository tree.
+ *
+ * `path` is repo-relative with no leading slash. A subtree listing
+ * reports full repo-relative paths too, not paths relative to the
+ * subtree, which is what lets a keyPrefix mount fetch only its own
+ * subtree and strip the prefix.
+ *
+ * `size` is the *content* length. For an LFS file this is the real size,
+ * never the 135-byte pointer; reporting the pointer would make wc -c and
+ * ls -l lie and risk truncated copies over FUSE.
+ *
+ * `oid` is the git object sha. Content-addressed, so it is the strongest
+ * fingerprint available and identical bytes carry an identical oid.
+ */
+export interface TreeEntry {
+    path: string;
+    type: string;
+    oid: string;
+    size?: number | undefined;
+    /** The date of the commit that last touched the path, when the listing
+     * was expanded; '' otherwise. */
+    lastModified: string;
+    lastCommit: string;
+    /** The LFS sha256, '' for a regular git blob. */
+    lfsOid: string;
+    /** The Xet content hash, '' when the file is not Xet-backed. */
+    xetHash: string;
+}
+export declare function isDirEntry(entry: TreeEntry): boolean;
+//# sourceMappingURL=tree_entry.d.ts.map

package/dist/core/hf_hub/tree_entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree_entry.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/tree_entry.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;qCACiC;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEpD"}

package/dist/core/hf_hub/tree_entry.js

@@ -0,0 +1,17 @@
+// ========= 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 function isDirEntry(entry) {
+    return entry.type === 'directory';
+}
+//# sourceMappingURL=tree_entry.js.map

package/dist/core/hf_hub/tree_entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree_entry.js","sourceRoot":"","sources":["../../../src/core/hf_hub/tree_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;AAgCvE,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAA;AACnC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/watch.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AA+C7D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAEjE"}

package/dist/core/hf_hub/watch.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 { ListingDeltaHook } from '@struktoai/mirage-core/watch/delta';
+import { fetchTree } from "./tree.js";
+import { isDirEntry } from "./tree_entry.js";
+/**
+ * One tree fetch feeding the generic listing differ.
+ *
+ * The Hub's listing endpoint is recursive, so a pull is one paged walk
+ * whatever the repository's shape, and the fingerprint is the git object id:
+ * git is content-addressed, so identical bytes carry an identical oid and a
+ * rewrite that changed nothing correctly reports nothing.
+ *
+ * A mount reads one revision, so what this detects is that revision moving.
+ * Nothing is reported while the branch sits still, however much is pushed
+ * elsewhere in the repository.
+ */
+function hfHubWalk(accessor) {
+    return async function* walk(root) {
+        const prefix = mountPrefixOf(root.virtual, root.resourcePath);
+        const tree = await fetchTree(accessor);
+        // The tree just fetched is exactly what the accessor holds, and find, du
+        // and every no-index read consult it. Discarding it here would leave them
+        // answering from the pre-pull listing, so a pull that reported a CREATE
+        // would be followed by a find that could not see the file.
+        accessor.tree = tree;
+        accessor.treeLoaded = true;
+        accessor.rowsCache = null;
+        const stem = root.mountPath.replace(/^\/+|\/+$/g, '');
+        const base = stem === '' ? '' : `${stem}/`;
+        for (const entry of tree.values()) {
+            if (base !== '' && !entry.path.startsWith(base))
+                continue;
+            const virtual = prefix === '' ? `/${entry.path}` : `${prefix.replace(/\/+$/, '')}/${entry.path}`;
+            if (isDirEntry(entry)) {
+                yield { virtual, isDir: true, fingerprint: null };
+                continue;
+            }
+            yield {
+                virtual,
+                isDir: false,
+                fingerprint: entry.oid,
+                size: entry.size ?? null,
+            };
+        }
+    };
+}
+export function buildDeltaHook(accessor) {
+    return new ListingDeltaHook(hfHubWalk(accessor));
+}
+//# sourceMappingURL=watch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/core/hf_hub/watch.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;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;;;;;;;;;GAWG;AACH,SAAS,SAAS,CAAC,QAAuB;IACxC,OAAO,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAc;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC7D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;QACtC,yEAAyE;QACzE,0EAA0E;QAC1E,wEAAwE;QACxE,2DAA2D;QAC3D,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAA;QACpB,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAA;QAC1B,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;QACrD,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAA;QAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAClC,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAQ;YACzD,MAAM,OAAO,GACX,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAA;YAClF,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;gBACjD,SAAQ;YACV,CAAC;YACD,MAAM;gBACJ,OAAO;gBACP,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,KAAK,CAAC,GAAG;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;aACzB,CAAA;QACH,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAuB;IACpD,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;AAClD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,OAAO,CAAA;AAC/B,eAAO,MAAM,kBAAkB,OAAO,CAAA"}

package/dist/core/nextcloud/constants.js

@@ -0,0 +1,3 @@
+export const SCOPE_ERROR = 5000;
+export const DEFAULT_CHUNK_SIZE = 8192;
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/nextcloud/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAA;AAC/B,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/copy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,IAAI,CACxB,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,QAAQ,GACpB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/core/nextcloud/copy.js

@@ -0,0 +1,16 @@
+import { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { isNotFound, nextcloudKey } from "./util.js";
+export async function copy(accessor, source, destination) {
+    const op = await accessor.operator();
+    try {
+        await op.copy(nextcloudKey(source), nextcloudKey(destination));
+    }
+    catch (error) {
+        if (isNotFound(error))
+            throw enoent(source);
+        throw error;
+    }
+    await invalidateAfterWrite(destination);
+}
+//# sourceMappingURL=copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/core/nextcloud/copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAE3E,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEpD,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,QAA2B,EAC3B,MAAgB,EAChB,WAAqB;IAErB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAA;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3C,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAA;AACzC,CAAC"}

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

@@ -0,0 +1,5 @@
+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 create(accessor: NextcloudAccessor, path: PathSpec, index?: IndexCacheStore): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAgB,MAAM,CACpB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/core/nextcloud/create.js

@@ -0,0 +1,5 @@
+import { write } from "./write.js";
+export function create(accessor, path, index) {
+    return write(accessor, path, new Uint8Array(), index);
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/nextcloud/create.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,UAAU,MAAM,CACpB,QAA2B,EAC3B,IAAc,EACd,KAAuB;IAEvB,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,EAAE,KAAK,CAAC,CAAA;AACvD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../../../src/core/nextcloud/du/entries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAIvE,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAyBvC"}

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

@@ -0,0 +1,36 @@
+import { FileType } from '@struktoai/mirage-core/types';
+import { lstripSlash, stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { isNotFound, rawPathOf } from "../util.js";
+import { statOrNull } from "./walk.js";
+export async function entries(accessor, path) {
+    const info = await statOrNull(accessor, path);
+    if (info !== null && info.type !== FileType.DIRECTORY)
+        return [[], info.size ?? 0];
+    const prefix = stripSlash(rawPathOf(path));
+    const scanPath = prefix !== '' ? `${prefix}/` : '/';
+    const op = await accessor.operator();
+    const found = [];
+    let total = 0;
+    try {
+        for (const entry of await op.list(scanPath, { recursive: true })) {
+            const key = entry.path();
+            const metadata = entry.metadata();
+            if (key === '' || key.endsWith('/') || metadata.isDirectory())
+                continue;
+            const size = metadata.contentLength !== null ? Number(metadata.contentLength) : 0;
+            found.push([`/${lstripSlash(key)}`, size]);
+            total += size;
+        }
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    // Python is `found.sort()`, a code-point tuple sort. localeCompare applies
+    // ICU collation, which reorders ASCII (punctuation carries less weight)
+    // and disagrees with Python on far more than astral names.
+    found.sort(([left], [right]) => compareCodePoints(left, right));
+    return [found, total];
+}
+//# sourceMappingURL=entries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../../../src/core/nextcloud/du/entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAEvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAErE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAA2B,EAC3B,IAAc;IAEd,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC7C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,SAAS;QAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;IAClF,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;IACnD,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,KAAK,GAAuB,EAAE,CAAA;IACpC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;YACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YACjC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE;gBAAE,SAAQ;YACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YACjF,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAA;YAC1C,KAAK,IAAI,IAAI,CAAA;QACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;IACrC,CAAC;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,2DAA2D;IAC3D,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAC/D,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AACvB,CAAC"}

package/dist/core/nextcloud/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/nextcloud/du/index.d.ts.map

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

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

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

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

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

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

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