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

package/dist/core/nextcloud/checksum.js

@@ -0,0 +1,75 @@
+// ========= 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 { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { CHECKSUM_PROPFIND, CHECKSUM_TYPES } from "./constants.js";
+import { davRequest, davUrl } from "./dav.js";
+import { parser, records } from "./search/response.js";
+/**
+ * The digest Nextcloud keeps for a file, from `oc:checksums`.
+ *
+ * A client that uploads with an `OC-Checksum` header (the desktop and mobile
+ * clients do) leaves its digest on the file, and a write without one clears
+ * it, so a digest the server reports names the bytes it holds. The property is
+ * one space-separated list of `TYPE:hex`; only the asked algorithm's, in hex of
+ * its length, answers. A server that keeps none, a collection, and any answer
+ * but a 207 leave the file to be read and hashed, which reports it. A digest
+ * answered is recorded as the read it stands in for. Mirrors Python's
+ * `checksum`.
+ */
+export async function checksum(accessor, path, algorithm) {
+    const kind = Object.hasOwn(CHECKSUM_TYPES, algorithm) ? CHECKSUM_TYPES[algorithm] : undefined;
+    if (kind === undefined)
+        return null;
+    const [name, width] = kind;
+    const timer = startOp();
+    const response = await davRequest(accessor, 'PROPFIND', davUrl(accessor, path), { Depth: '0', 'Content-Type': 'application/xml' }, CHECKSUM_PROPFIND);
+    if (response.status !== 207) {
+        console.debug(`nextcloud checksum of ${path.virtual} left to the read: HTTP ${String(response.status)}`);
+        return null;
+    }
+    const tree = parser.parse(await response.text());
+    const listed = [];
+    const groups = records(tree.multistatus)
+        .flatMap((multistatus) => records(multistatus.response))
+        .flatMap((answer) => records(answer.propstat));
+    for (const propstat of groups) {
+        const prop = records(propstat.prop)[0];
+        const status = typeof propstat.status === 'string' ? propstat.status : '';
+        if (prop === undefined || status.split(/\s+/)[1] !== '200')
+            continue;
+        if (records(prop.resourcetype).some((type) => 'collection' in type))
+            return null;
+        for (const sums of records(prop.checksums)) {
+            const values = Array.isArray(sums.checksum) ? sums.checksum : [sums.checksum];
+            for (const value of values) {
+                if (typeof value === 'string')
+                    listed.push(...value.split(/\s+/).filter((word) => word !== ''));
+            }
+        }
+    }
+    const hex = new RegExp(`^[0-9a-f]{${String(width)}}$`);
+    for (const entry of listed) {
+        const cut = entry.indexOf(':');
+        if (cut < 0 || entry.slice(0, cut).toUpperCase() !== name)
+            continue;
+        const digest = entry.slice(cut + 1).toLowerCase();
+        if (hex.test(digest)) {
+            record('read', path.virtual, VFSName.NEXTCLOUD, 0, timer);
+            return digest;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=checksum.js.map

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

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

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

@@ -1,3 +1,7 @@
 export declare const SCOPE_ERROR = 5000;
 export declare const DEFAULT_CHUNK_SIZE = 8192;
+export declare const QUOTA_PROPFIND: string;
+export declare const SPACE_UNLIMITED = -3;
+export declare const CHECKSUM_PROPFIND: string;
+export declare const CHECKSUM_TYPES: Readonly<Record<string, readonly [string, number]>>;
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +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"}
+{"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;AAEtC,eAAO,MAAM,cAAc,QAID,CAAA;AAE1B,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC,eAAO,MAAM,iBAAiB,QAGoC,CAAA;AAGlE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAI9E,CAAA"}

package/dist/core/nextcloud/constants.js

@@ -1,3 +1,19 @@
 export const SCOPE_ERROR = 5000;
 export const DEFAULT_CHUNK_SIZE = 8192;
+export const QUOTA_PROPFIND = '<?xml version="1.0" encoding="utf-8"?>' +
+    '<d:propfind xmlns:d="DAV:"><d:prop>' +
+    '<d:quota-available-bytes/><d:quota-used-bytes/>' +
+    '</d:prop></d:propfind>';
+// The quota-available-bytes Nextcloud answers for a user with no quota.
+export const SPACE_UNLIMITED = -3;
+export const CHECKSUM_PROPFIND = '<?xml version="1.0" encoding="utf-8"?>' +
+    '<d:propfind xmlns:d="DAV:" xmlns:oc="http://owncloud.org/ns">' +
+    '<d:prop><d:resourcetype/><oc:checksums/></d:prop></d:propfind>';
+// The hashlib names Nextcloud keeps a digest under, each with the type it
+// names it by in `oc:checksums` and the digest's length in hex.
+export const CHECKSUM_TYPES = {
+    md5: ['MD5', 32],
+    sha1: ['SHA1', 40],
+    sha256: ['SHA256', 64],
+};
 //# sourceMappingURL=constants.js.map

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

@@ -1 +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"}
+{"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;AAEtC,MAAM,CAAC,MAAM,cAAc,GACzB,wCAAwC;IACxC,qCAAqC;IACrC,iDAAiD;IACjD,wBAAwB,CAAA;AAC1B,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,CAAA;AAEjC,MAAM,CAAC,MAAM,iBAAiB,GAC5B,wCAAwC;IACxC,+DAA+D;IAC/D,gEAAgE,CAAA;AAClE,0EAA0E;AAC1E,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAwD;IACjF,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;CACvB,CAAA"}

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

@@ -1,4 +1,11 @@
-import type { PathSpec } from '@struktoai/mirage-core/types';
+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>;
+/**
+ * Copy a folder tree onto a fresh name in one WebDAV COPY. `cp -r` asks
+ * this only when nothing holds `dst`, so the copy goes with
+ * `Overwrite: F` and a taken name is refused, never replaced. A multistatus
+ * answer is a tree copied in part, refused for its first failed member.
+ */
+export declare function dirCopy(accessor: NextcloudAccessor, src: PathSpec, dst: PathSpec): Promise<void>;
 //# sourceMappingURL=copy.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/copy.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAMpE,wBAAsB,IAAI,CACxB,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,QAAQ,GACpB,OAAO,CAAC,IAAI,CAAC,CAQf;AAkBD;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/core/nextcloud/copy.js

@@ -1,5 +1,8 @@
-import { invalidateAfterWrite } from '@struktoai/mirage-core/cache/context';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { liftLost, lostCount, record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { eacces, eexist, enoent, fsError } from '@struktoai/mirage-core/errors/fs';
+import { davRequest, davUrl } from "./dav.js";
+import { parser, records } from "./search/response.js";
 import { isNotFound, nextcloudKey } from "./util.js";
 export async function copy(accessor, source, destination) {
     const op = await accessor.operator();
@@ -11,6 +14,54 @@ export async function copy(accessor, source, destination) {
             throw enoent(source);
         throw error;
     }
-    await invalidateAfterWrite(destination);
+}
+/**
+ * The first failure a COPY's multistatus reports for a member of the tree,
+ * 500 when it names none. Mirrors Python's `failed_status`.
+ */
+function failedStatus(text) {
+    const tree = parser.parse(text);
+    const statuses = records(tree.multistatus)
+        .flatMap((multistatus) => records(multistatus.response))
+        .flatMap((answer) => [answer.status, ...records(answer.propstat).map((group) => group.status)]);
+    for (const status of statuses) {
+        const code = typeof status === 'string' ? Number(status.trim().split(/\s+/)[1]) : Number.NaN;
+        if (code >= 300)
+            return code;
+    }
+    return 500;
+}
+/**
+ * Copy a folder tree onto a fresh name in one WebDAV COPY. `cp -r` asks
+ * this only when nothing holds `dst`, so the copy goes with
+ * `Overwrite: F` and a taken name is refused, never replaced. A multistatus
+ * answer is a tree copied in part, refused for its first failed member.
+ */
+export async function dirCopy(accessor, src, dst) {
+    const upto = lostCount();
+    const timer = startOp();
+    const response = await davRequest(accessor, 'COPY', davUrl(accessor, src, true), {
+        Destination: davUrl(accessor, dst, true),
+        Depth: 'infinity',
+        Overwrite: 'F',
+    });
+    let status = response.status;
+    if (status === 207) {
+        status = failedStatus(await response.text());
+    }
+    if (status === 404)
+        throw enoent(src);
+    if (status === 409)
+        throw enoent(dst);
+    if (status === 412)
+        throw eexist(dst);
+    if (status === 403 || status === 423)
+        throw eacces(dst);
+    if (response.status === 207)
+        throw fsError(dst, 'EIO');
+    if (!response.ok)
+        throw new Error(`Nextcloud COPY returned HTTP ${String(response.status)}`);
+    record('copy_prefix', dst.virtual, VFSName.NEXTCLOUD, 0, timer);
+    liftLost(dst, upto, true);
 }
 //# sourceMappingURL=copy.js.map

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

@@ -1 +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"}
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/core/nextcloud/copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AAC7F,OAAO,EAAE,OAAO,EAAiB,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAElF,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEtD,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;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAc,CAAA;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;SACvC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;SACvD,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACjG,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;QAC5F,IAAI,IAAI,IAAI,GAAG;YAAE,OAAO,IAAI,CAAA;IAC9B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAA2B,EAC3B,GAAa,EACb,GAAa;IAEb,MAAM,IAAI,GAAG,SAAS,EAAE,CAAA;IACxB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE;QAC/E,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC;QACxC,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,GAAG;KACf,CAAC,CAAA;IACF,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,MAAM,KAAK,GAAG;QAAE,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,MAAM,KAAK,GAAG;QAAE,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,MAAM,KAAK,GAAG;QAAE,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACtD,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC5F,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;IAC/D,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/dist/core/nextcloud/create.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 create(accessor: NextcloudAccessor, path: PathSpec, index?: IndexCacheStore): Promise<void>;
+export declare function create(accessor: NextcloudAccessor, path: PathSpec): Promise<void>;
 //# sourceMappingURL=create.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF"}

package/dist/core/nextcloud/create.js

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

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

@@ -1 +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"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/nextcloud/create.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,UAAU,MAAM,CAAC,QAA2B,EAAE,IAAc;IAChE,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC,CAAA;AAChD,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { NextcloudAccessor } from '../../accessor/nextcloud.ts';
+import type { XmlRecord } from './search/types.ts';
+/** The WebDAV URL of a path, its segments percent-encoded; `folder` ends it with a slash, as a collection's. */
+export declare function davUrl(accessor: NextcloudAccessor, path: PathSpec, folder?: boolean): string;
+/** Send one WebDAV request with the mount's credentials. */
+export declare function davRequest(accessor: NextcloudAccessor, method: string, url: string, headers?: Record<string, string>, body?: string): Promise<Response>;
+/**
+ * A property's text from a group the server answered 200 for, null when no
+ * such group holds it. Mirrors Python's `answered`.
+ */
+export declare function answered(tree: XmlRecord, name: string): string | null;
+//# sourceMappingURL=dav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dav.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/dav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGlD,gHAAgH;AAChH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAQ,GAAG,MAAM,CAI1F;AAED,4DAA4D;AAC5D,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,CAAC,CAQnB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYrE"}

package/dist/core/nextcloud/dav.js

@@ -0,0 +1,39 @@
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { auth } from "./search/client.js";
+import { records } from "./search/response.js";
+import { nextcloudKey } from "./util.js";
+/** The WebDAV URL of a path, its segments percent-encoded; `folder` ends it with a slash, as a collection's. */
+export function davUrl(accessor, path, folder = false) {
+    const key = rstripSlash(nextcloudKey(path)).split('/').map(encodeURIComponent).join('/');
+    const url = rstripSlash(accessor.config.url) + (key === '' ? '' : `/${key}`);
+    return folder ? `${url}/` : url;
+}
+/** Send one WebDAV request with the mount's credentials. */
+export async function davRequest(accessor, method, url, headers = {}, body) {
+    const basic = auth(accessor);
+    return fetch(url, {
+        method,
+        headers: basic === null ? headers : { ...headers, Authorization: basic },
+        ...(body === undefined ? {} : { body }),
+        signal: AbortSignal.timeout((accessor.config.timeout ?? 30) * 1000),
+    });
+}
+/**
+ * A property's text from a group the server answered 200 for, null when no
+ * such group holds it. Mirrors Python's `answered`.
+ */
+export function answered(tree, name) {
+    const groups = records(tree.multistatus)
+        .flatMap((multistatus) => records(multistatus.response))
+        .flatMap((answer) => records(answer.propstat));
+    for (const propstat of groups) {
+        const prop = records(propstat.prop)[0];
+        const status = typeof propstat.status === 'string' ? propstat.status : '';
+        if (prop === undefined || !(name in prop) || status.split(/\s+/)[1] !== '200')
+            continue;
+        const value = prop[name];
+        return typeof value === 'string' ? value.trim() : '';
+    }
+    return null;
+}
+//# sourceMappingURL=dav.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dav.js","sourceRoot":"","sources":["../../../src/core/nextcloud/dav.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEhE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,gHAAgH;AAChH,MAAM,UAAU,MAAM,CAAC,QAA2B,EAAE,IAAc,EAAE,MAAM,GAAG,KAAK;IAChF,MAAM,GAAG,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxF,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;IAC5E,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;AACjC,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAA2B,EAC3B,MAAc,EACd,GAAW,EACX,UAAkC,EAAE,EACpC,IAAa;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5B,OAAO,KAAK,CAAC,GAAG,EAAE;QAChB,MAAM;QACN,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE;QACxE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;KACpE,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,IAAY;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;SACrC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;SACvD,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChD,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QACzE,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK;YAAE,SAAQ;QACvF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACtD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

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

@@ -0,0 +1,28 @@
+import { type FileEvent, type JsonValue, type PathSpec } from '@struktoai/mirage-core/types';
+import type { NextcloudAccessor } from '../../accessor/nextcloud.ts';
+/**
+ * Map one Nextcloud `webhook_listeners` delivery onto mount paths.
+ *
+ * The consumer registers a webhook for the node events (Nextcloud 30 and
+ * later) and passes each delivery's `event.class` with its body. Nothing here
+ * runs a loop. A delivery names the node by its path in the instance,
+ * `/<user>/files/<path>`; the mount is rooted at the WebDAV folder its URL
+ * names, so the hook reads that root from the URL and maps only the nodes
+ * below it. A rename into the mount is a CREATE and one out of it a DELETE; a
+ * folder above the mount root deleted or renamed away removes the root, and
+ * one made or renamed into place leaves it UNKNOWN. Any other node outside it,
+ * or an event class the hook does not model, maps to nothing.
+ *
+ * Mirrors Python `NextcloudEventHook` (`core/nextcloud/events.py`).
+ */
+export declare class NextcloudEventHook {
+    private readonly root;
+    constructor(accessor: NextcloudAccessor);
+    toEvents(root: PathSpec, eventClass: string, payload: JsonValue): Promise<readonly FileEvent[]>;
+    /** The mount-relative path of an instance path, or null outside the mount. */
+    private relative;
+    /** Whether an instance path is a folder the mount root sits below. */
+    private above;
+    private map;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/events.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAA;AAGrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAepE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,QAAQ,EAAE,iBAAiB;IAIvC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;IAI/F,8EAA8E;IAC9E,OAAO,CAAC,QAAQ;IAQhB,sEAAsE;IACtE,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,GAAG;CAyBZ"}

package/dist/core/nextcloud/events.js

@@ -0,0 +1,125 @@
+// ========= 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 { FileChangeKind, } from '@struktoai/mirage-core/types';
+import { rstripSlash, stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { eventAt, field, textField } from '@struktoai/mirage-core/events/index';
+// The node event classes `webhook_listeners` sends, and the change each one
+// is.
+const KIND_BY_CLASS = {
+    'OCP\\Files\\Events\\Node\\NodeCreatedEvent': FileChangeKind.CREATE,
+    'OCP\\Files\\Events\\Node\\NodeWrittenEvent': FileChangeKind.UPDATE,
+    'OCP\\Files\\Events\\Node\\NodeTouchedEvent': FileChangeKind.UPDATE,
+    'OCP\\Files\\Events\\Node\\NodeDeletedEvent': FileChangeKind.DELETE,
+    'OCP\\Files\\Events\\Node\\NodeRenamedEvent': FileChangeKind.MOVE,
+};
+const DAV = '/remote.php/dav/files/';
+const WEBDAV = '/remote.php/webdav';
+/**
+ * Map one Nextcloud `webhook_listeners` delivery onto mount paths.
+ *
+ * The consumer registers a webhook for the node events (Nextcloud 30 and
+ * later) and passes each delivery's `event.class` with its body. Nothing here
+ * runs a loop. A delivery names the node by its path in the instance,
+ * `/<user>/files/<path>`; the mount is rooted at the WebDAV folder its URL
+ * names, so the hook reads that root from the URL and maps only the nodes
+ * below it. A rename into the mount is a CREATE and one out of it a DELETE; a
+ * folder above the mount root deleted or renamed away removes the root, and
+ * one made or renamed into place leaves it UNKNOWN. Any other node outside it,
+ * or an event class the hook does not model, maps to nothing.
+ *
+ * Mirrors Python `NextcloudEventHook` (`core/nextcloud/events.py`).
+ */
+export class NextcloudEventHook {
+    root;
+    constructor(accessor) {
+        this.root = filesRoot(accessor);
+    }
+    toEvents(root, eventClass, payload) {
+        return Promise.resolve(this.map(root, eventClass, payload));
+    }
+    /** The mount-relative path of an instance path, or null outside the mount. */
+    relative(node) {
+        const root = this.root;
+        if (node === null || root === null)
+            return null;
+        const path = rstripSlash(node);
+        if (path === root)
+            return '';
+        return path.startsWith(`${root}/`) ? path.slice(root.length + 1) : null;
+    }
+    /** Whether an instance path is a folder the mount root sits below. */
+    above(node) {
+        const root = this.root;
+        if (node === null || root === null)
+            return false;
+        return root.startsWith(`${rstripSlash(node)}/`);
+    }
+    map(root, eventClass, payload) {
+        const kind = Object.hasOwn(KIND_BY_CLASS, eventClass) ? KIND_BY_CLASS[eventClass] : undefined;
+        const event = field(payload, 'event');
+        if (kind === undefined)
+            return [];
+        if (kind !== FileChangeKind.MOVE) {
+            const node = textField(field(event, 'node'), 'path');
+            const place = this.relative(node);
+            if (place !== null)
+                return [eventAt(root, place, kind)];
+            if (this.above(node) && kind !== FileChangeKind.UPDATE) {
+                const gone = kind === FileChangeKind.DELETE;
+                return [eventAt(root, '', gone ? FileChangeKind.DELETE : FileChangeKind.UNKNOWN)];
+            }
+            return [];
+        }
+        const sourcePath = textField(field(event, 'source'), 'path');
+        const targetPath = textField(field(event, 'target'), 'path');
+        if (this.above(sourcePath))
+            return [eventAt(root, '', FileChangeKind.DELETE)];
+        if (this.above(targetPath))
+            return [eventAt(root, '', FileChangeKind.UNKNOWN)];
+        const source = this.relative(sourcePath);
+        const target = this.relative(targetPath);
+        if (source !== null && target !== null)
+            return [eventAt(root, target, kind, source)];
+        if (target !== null)
+            return [eventAt(root, target, FileChangeKind.CREATE)];
+        if (source !== null)
+            return [eventAt(root, source, FileChangeKind.DELETE)];
+        return [];
+    }
+}
+/**
+ * The instance path the mount's WebDAV URL is rooted at,
+ * `/<user>/files[/<folder>]`, or null for a URL of another shape.
+ */
+function filesRoot(accessor) {
+    const config = accessor.config;
+    const path = rstripSlash(decodeURIComponent(new URL(config.url).pathname));
+    let user;
+    let folder;
+    if (`${path}/`.includes(DAV)) {
+        const rest = `${path}/`.split(DAV).slice(1).join(DAV);
+        const cut = rest.indexOf('/');
+        user = rest.slice(0, cut);
+        folder = rest.slice(cut + 1);
+    }
+    else if (path.includes(WEBDAV) && config.username) {
+        user = config.username;
+        folder = path.split(WEBDAV).slice(1).join(WEBDAV);
+    }
+    else {
+        return null;
+    }
+    return rstripSlash(`/${user}/files/${stripSlash(folder)}`);
+}
+//# sourceMappingURL=events.js.map

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

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

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

@@ -1,4 +1,2 @@
-import type { PathSpec } from '@struktoai/mirage-core/types';
-import type { NextcloudAccessor } from '../../accessor/nextcloud.ts';
-export declare function exists(accessor: NextcloudAccessor, path: PathSpec): Promise<boolean>;
+export declare const exists: import("@struktoai/mirage-core/core/object_store/driver").ExistsFn<import("../../index.ts").NextcloudAccessor>;
 //# sourceMappingURL=exists.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/exists.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,wBAAsB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1F"}
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/exists.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,gHAAmB,CAAA"}

package/dist/core/nextcloud/exists.js

@@ -1,13 +1,4 @@
+import { makeExists } from '@struktoai/mirage-core/core/object_store/exists';
 import { stat } from "./stat.js";
-export async function exists(accessor, path) {
-    try {
-        await stat(accessor, path);
-        return true;
-    }
-    catch (error) {
-        if (error?.code === 'ENOENT')
-            return false;
-        throw error;
-    }
-}
+export const exists = makeExists(stat);
 //# sourceMappingURL=exists.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/core/nextcloud/exists.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAA2B,EAAE,IAAc;IACtE,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAAkC,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QACxE,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/core/nextcloud/exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA"}

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

@@ -1,15 +1,12 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { NextcloudAccessor } from '../../accessor/nextcloud.ts';
 /**
- * Create a collection; opendal creates missing parents either way.
+ * Create a collection.
  *
- * `parents` is accepted for the op signature and ignored, because
- * `createDir` is MKCOL over every missing level whatever it says. That is
- * also why the ancestor invalidation is unconditional: a bare `mkdir a/b/c`
- * materializes a whole chain here, and gating the walk on `parents` (as the
- * backends whose mkdir really does create one level correctly do) left every
- * ancestor above the parent serving a cached listing that hid the new levels
- * until the index TTL expired.
+ * opendal's `createDir` is MKCOL over every missing level, so a bare mkdir
+ * looks its parent up first and refuses a missing one, as mkdir(2) does; only
+ * `-p` materializes a chain, and only it walks the ancestor listings. With
+ * `parents`, a file in the way is named rather than the operand.
  */
-export declare function mkdir(accessor: NextcloudAccessor, path: PathSpec, _parents?: boolean): Promise<void>;
+export declare function mkdir(accessor: NextcloudAccessor, path: PathSpec, parents?: boolean): Promise<void>;
 //# sourceMappingURL=mkdir.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mkdir.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/mkdir.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CACzB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,QAAQ,UAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CAMf"}
+{"version":3,"file":"mkdir.d.ts","sourceRoot":"","sources":["../../../src/core/nextcloud/mkdir.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAmBpE;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,OAAO,UAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAkCf"}