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

package/dist/core/email/readdir.js

@@ -0,0 +1,222 @@
+// ========= 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 { makeReaddir, } from '@struktoai/mirage-core/core/hierarchy/readdir';
+import { NAME_MAX_BYTES, byteLength, sanitizeLabel } from '@struktoai/mirage-core/utils/sanitize';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { fetchHeaders, listMessageUids } from "./client.js";
+import { listFolders } from "./folders.js";
+import { messageJsonBytes } from "./render.js";
+import { detectScope } from "./scope.js";
+const TITLE_MAX = 80;
+const EPOCH_DATE = '1970-01-01';
+const MSG_SUFFIX = '.email.json';
+// Routed through the shared sanitizer rather than a local copy of it. The
+// copy's `\w` was JS's ASCII-only one where python's is unicode, so every
+// accented or CJK subject came back as a row of underscores here and intact
+// there; it also measured the budget in UTF-16 units instead of code points.
+const sanitize = (text, maxBytes) => sanitizeLabel(text, {
+    fallback: 'No_Subject',
+    maxLen: TITLE_MAX,
+    ...(maxBytes !== undefined ? { maxBytes } : {}),
+});
+// 80 characters is 240 bytes of CJK, which overflows the 255-byte NAME_MAX
+// once the uid and `.email.json` are added, so the subject takes what they
+// leave rather than a flat character count.
+export function msgFilename(subject, uid) {
+    const fixed = 2 + byteLength(uid) + MSG_SUFFIX.length;
+    return `${sanitize(subject, NAME_MAX_BYTES - fixed)}__${uid}${MSG_SUFFIX}`;
+}
+// RFC 5322's obsolete zone names, the set `parsedate_to_datetime` knows.
+const NAMED_ZONES = {
+    UT: 0,
+    UTC: 0,
+    GMT: 0,
+    Z: 0,
+    EST: -300,
+    EDT: -240,
+    CST: -360,
+    CDT: -300,
+    MST: -420,
+    MDT: -360,
+    PST: -480,
+    PDT: -420,
+};
+/** Minutes east of UTC the timestamp states, null when it states none. */
+function statedOffset(value) {
+    const numeric = /([+-])(\d{2}):?(\d{2})\s*$/.exec(value);
+    if (numeric !== null) {
+        const sign = numeric[1] === '-' ? -1 : 1;
+        return sign * (Number(numeric[2]) * 60 + Number(numeric[3]));
+    }
+    const named = /([A-Z]{1,3})\s*$/.exec(value.toUpperCase());
+    return NAMED_ZONES[named?.[1] ?? ''] ?? null;
+}
+function ymd(year, month, day) {
+    return `${year.toString().padStart(4, '0')}-${month.toString().padStart(2, '0')}-${day.toString().padStart(2, '0')}`;
+}
+function parseDate(value) {
+    if (value.trim() === '')
+        return null;
+    const d = new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return null;
+    // The calendar date as written, with no zone conversion. RFC 3501
+    // defines SENTON/SENTBEFORE/SENTSINCE (and ON/BEFORE/SINCE) as
+    // comparing the date "disregarding time and timezone", so a message
+    // written 05 Jan 23:30 -0500 answers a search for the 5th and has to
+    // sit in the 5th's directory. `Date` only keeps the instant, so the
+    // stated offset is added back before reading the fields.
+    const offset = statedOffset(value);
+    // No zone stated: `new Date` read the wall clock as host-local, so the
+    // local fields hand it back exactly as written.
+    if (offset === null)
+        return ymd(d.getFullYear(), d.getMonth() + 1, d.getDate());
+    const shifted = new Date(d.getTime() + offset * 60_000);
+    return ymd(shifted.getUTCFullYear(), shifted.getUTCMonth() + 1, shifted.getUTCDate());
+}
+/**
+ * Picks the YYYY-MM-DD directory a message files under.
+ *
+ * The `Date:` header wins, because it is the timestamp the sender wrote
+ * and the one himalaya's date conditions search on (SENTON / SENTSINCE /
+ * SENTBEFORE). It is also optional, and a message without it used to
+ * fall straight to the epoch, collapsing the mount's only organizing
+ * axis into a single 1970 directory. IMAP's own INTERNALDATE (RFC 3501,
+ * server-assigned and always present) fills that hole.
+ */
+export function dateBucket(message) {
+    return parseDate(message.date) ?? parseDate(message.internalDate) ?? EPOCH_DATE;
+}
+/** One date directory's children, plus its attachment-dir seeds. */
+function dateChildren(headers) {
+    const children = [];
+    const seeds = {};
+    for (const hdr of headers) {
+        const uid = hdr.uid;
+        const subject = hdr.subject || 'No Subject';
+        const filename = msgFilename(subject, uid);
+        children.push([
+            filename,
+            new IndexEntry({
+                id: uid,
+                name: subject,
+                resourceType: 'email/message',
+                vfsName: filename,
+                size: messageJsonBytes(hdr).byteLength,
+            }),
+        ]);
+        const attachments = hdr.attachments;
+        if (attachments.length > 0) {
+            const attDirName = filename.replace('.email.json', '');
+            children.push([
+                attDirName,
+                new IndexEntry({
+                    id: uid,
+                    name: attDirName,
+                    resourceType: 'email/attachment_dir',
+                    vfsName: attDirName,
+                }),
+            ]);
+            seeds[attDirName] = attachments.map((att) => [
+                att.filename,
+                new IndexEntry({
+                    id: att.filename,
+                    name: att.filename,
+                    resourceType: 'email/attachment',
+                    vfsName: att.filename,
+                    size: att.size,
+                }),
+            ]);
+        }
+    }
+    return { children, seeds };
+}
+async function folderHeaders(accessor, folderName) {
+    const uids = await listMessageUids(accessor, folderName, 'ALL', accessor.config.maxMessages);
+    return fetchHeaders(accessor, folderName, uids);
+}
+async function listRoot(accessor, _match) {
+    const folders = await listFolders(accessor);
+    return folders.map((name) => [
+        name,
+        new IndexEntry({
+            id: name,
+            name,
+            resourceType: 'email/folder',
+            vfsName: name,
+        }),
+    ]);
+}
+async function listFolder(accessor, _match, own) {
+    const headersList = await folderHeaders(accessor, own.id);
+    const dateGroups = new Map();
+    for (const hdr of headersList) {
+        const dateStr = dateBucket(hdr);
+        let bucket = dateGroups.get(dateStr);
+        if (bucket === undefined) {
+            bucket = [];
+            dateGroups.set(dateStr, bucket);
+        }
+        bucket.push(hdr);
+    }
+    const sortedDates = [...dateGroups.keys()].sort(compareCodePoints).reverse();
+    const entries = [];
+    const seeds = {};
+    for (const dateStr of sortedDates) {
+        entries.push([
+            dateStr,
+            new IndexEntry({
+                id: dateStr,
+                name: dateStr,
+                resourceType: 'email/date',
+                vfsName: dateStr,
+            }),
+        ]);
+        const { children, seeds: attSeeds } = dateChildren(dateGroups.get(dateStr) ?? []);
+        seeds[dateStr] = children;
+        for (const [attDir, attEntries] of Object.entries(attSeeds)) {
+            seeds[`${dateStr}/${attDir}`] = attEntries;
+        }
+    }
+    return { entries, seeds };
+}
+async function listDay(accessor, match, _own) {
+    // Normally served from the folder lister's seed; reached only when the
+    // index evicted the day listing while the date entry survived.
+    const headersList = await folderHeaders(accessor, match.slots.folder ?? '');
+    const day = match.slots.day ?? '';
+    const { children, seeds } = dateChildren(headersList.filter((hdr) => dateBucket(hdr) === day));
+    const listing = { entries: children, seeds };
+    return listing;
+}
+async function listAttachmentDir(accessor, match, own) {
+    // Same eviction fallback: one header fetch rebuilds the listing.
+    const headersList = await fetchHeaders(accessor, match.slots.folder ?? '', [own.id]);
+    for (const hdr of headersList) {
+        const { seeds } = dateChildren([hdr]);
+        for (const attEntries of Object.values(seeds))
+            return attEntries;
+    }
+    return [];
+}
+export const readdir = makeReaddir(detectScope, {
+    listers: { root: listRoot },
+    entryListers: {
+        folder: listFolder,
+        day: listDay,
+        attachment_dir: listAttachmentDir,
+    },
+});
+//# sourceMappingURL=readdir.js.map

package/dist/core/email/readdir.js.map

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

package/dist/core/email/render.d.ts

@@ -0,0 +1,5 @@
+import type { FetchedMessage } from './client.ts';
+export declare function messageJsonText(message: FetchedMessage): string;
+export declare function messageJsonBytes(message: FetchedMessage): Uint8Array;
+export declare function messagesJsonBytes(messages: readonly FetchedMessage[]): Uint8Array;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/email/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/core/email/render.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAkBjD,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAOpE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,UAAU,CAEjF"}

package/dist/core/email/render.js

@@ -0,0 +1,42 @@
+// ========= 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. =========
+const encoder = new TextEncoder();
+/**
+ * Projects a fetched message onto the document mirage serves.
+ *
+ * INTERNALDATE is dropped: it is the mailbox's own arrival stamp, which
+ * picks the date directory when the `Date:` header is missing, not a
+ * field of the message. The gmail backend keeps its internalDate out of
+ * the rendered JSON the same way.
+ */
+function messageDocument(message) {
+    const body = { ...message };
+    delete body.internalDate;
+    return body;
+}
+export function messageJsonText(message) {
+    return JSON.stringify(messageDocument(message));
+}
+export function messageJsonBytes(message) {
+    // Single renderer for .email.json: the listing fetches the full message
+    // source and parses it exactly like read() does, so sizing a listed
+    // header dict here yields the byte length read() will return. Every
+    // other serializer of a fetched message routes through here too, so
+    // `himalaya message read` cannot drift from `cat`.
+    return encoder.encode(messageJsonText(message));
+}
+export function messagesJsonBytes(messages) {
+    return encoder.encode(JSON.stringify(messages.map((m) => messageDocument(m))));
+}
+//# sourceMappingURL=render.js.map

package/dist/core/email/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/core/email/render.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAIvE,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;AAEjC;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,OAAuB;IAC9C,MAAM,IAAI,GAA4B,EAAE,GAAG,OAAO,EAAE,CAAA;IACpD,OAAO,IAAI,CAAC,YAAY,CAAA;IACxB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,wEAAwE;IACxE,oEAAoE;IACpE,oEAAoE;IACpE,oEAAoE;IACpE,mDAAmD;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAmC;IACnE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAChF,CAAC"}

package/dist/core/email/scope.d.ts

@@ -0,0 +1,3 @@
+export declare const detectScope: import("@struktoai/mirage-core/core/hierarchy/scope").DetectFn;
+export declare const NATIVE_KINDS: ReadonlySet<string>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/core/email/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/core/email/scope.ts"],"names":[],"mappings":"AAgDA,eAAO,MAAM,WAAW,gEAA0B,CAAA;AAKlD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAA8B,CAAA"}

package/dist/core/email/scope.js

@@ -0,0 +1,49 @@
+// ========= 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 { Codec, DATE } from '@struktoai/mirage-core/core/hierarchy/codec';
+import { makeDetectScope, Scope, Slot } from '@struktoai/mirage-core/core/hierarchy/scope';
+import { ContentType } from '@struktoai/mirage-core/types';
+const EMAIL_JSON = new Codec({ suffix: '.email.json' });
+const FOLDER = [new Slot('folder')];
+const DAY = [...FOLDER, new Slot('day', DATE)];
+// One description of the tree: readdir, stat, read and the search push-down
+// all classify through it, so the file surface and the command surface
+// cannot disagree about what a path means. The message scope is declared
+// before the attachment dir because only the suffix separates the two at
+// that depth.
+const SCOPES = [
+    new Scope({ kind: 'folder', segments: FOLDER }),
+    new Scope({ kind: 'day', segments: DAY }),
+    new Scope({
+        kind: 'message',
+        segments: [...DAY, new Slot('message', EMAIL_JSON, 'uid')],
+        leaf: true,
+        filetype: ContentType.JSON,
+    }),
+    new Scope({
+        kind: 'attachment_dir',
+        segments: [...DAY, new Slot('attachment_dir', undefined, 'uid')],
+    }),
+    new Scope({
+        kind: 'attachment',
+        segments: [...DAY, new Slot('attachment_dir', undefined, 'uid'), new Slot('filename')],
+        leaf: true,
+    }),
+];
+export const detectScope = makeDetectScope(SCOPES);
+// Kinds the mailbox search push-down may answer for: one folder or one of
+// its days. IMAP search selects a folder, so the mount root cannot push
+// down, and a message or attachment names one node.
+export const NATIVE_KINDS = new Set(['folder', 'day']);
+//# sourceMappingURL=scope.js.map

package/dist/core/email/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/core/email/scope.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,KAAK,EAAE,IAAI,EAAE,MAAM,6CAA6C,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,6CAA6C,CAAA;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE1D,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;AAEvD,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAU,CAAA;AAC5C,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAU,CAAA;AAEvD,4EAA4E;AAC5E,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,cAAc;AACd,MAAM,MAAM,GAAqB;IAC/B,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC/C,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC;QACR,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,WAAW,CAAC,IAAI;KAC3B,CAAC;IACF,IAAI,KAAK,CAAC;QACR,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;KACjE,CAAC;IACF,IAAI,KAAK,CAAC;QACR,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QACtF,IAAI,EAAE,IAAI;KACX,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;AAElD,0EAA0E;AAC1E,wEAAwE;AACxE,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA"}

package/dist/core/email/search.d.ts

@@ -0,0 +1,5 @@
+import type { EmailAccessor } from '../../accessor/email.ts';
+import { type FetchedMessage } from './client.ts';
+export declare function buildVfsPath(prefix: string, folder: string, msg: FetchedMessage): string;
+export declare function searchAndFormat(accessor: EmailAccessor, folder: string, pattern: string, prefix: string, maxResults?: number | null): Promise<[string, string][]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/email/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/core/email/search.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAgDhF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAQxF;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAM,GAAG,IAAW,GAC/B,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAW7B"}

package/dist/core/email/search.js

@@ -0,0 +1,67 @@
+// ========= 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 { fetchMessage, listMessageUids } from "./client.js";
+import { dateBucket, msgFilename } from "./readdir.js";
+import { messageJsonText } from "./render.js";
+function buildSearchCriteria(opts) {
+    const parts = [];
+    if (opts.unseen === true)
+        parts.push('UNSEEN');
+    if (opts.text !== undefined && opts.text !== null && opts.text !== '') {
+        parts.push(`TEXT "${opts.text}"`);
+    }
+    if (opts.subject !== undefined && opts.subject !== null && opts.subject !== '') {
+        parts.push(`SUBJECT "${opts.subject}"`);
+    }
+    if (opts.fromAddr !== undefined && opts.fromAddr !== null && opts.fromAddr !== '') {
+        parts.push(`FROM "${opts.fromAddr}"`);
+    }
+    if (opts.toAddr !== undefined && opts.toAddr !== null && opts.toAddr !== '') {
+        parts.push(`TO "${opts.toAddr}"`);
+    }
+    if (opts.since !== undefined && opts.since !== null && opts.since !== '') {
+        parts.push(`SINCE ${opts.since}`);
+    }
+    if (opts.before !== undefined && opts.before !== null && opts.before !== '') {
+        parts.push(`BEFORE ${opts.before}`);
+    }
+    return parts.length > 0 ? parts.join(' ') : 'ALL';
+}
+async function searchMessages(accessor, folder, opts = {}, maxResults = null) {
+    const criteria = buildSearchCriteria(opts);
+    return listMessageUids(accessor, folder, criteria, maxResults);
+}
+export function buildVfsPath(prefix, folder, msg) {
+    const dateStr = dateBucket(msg);
+    // The same builder readdir names the file with, not a second spelling of
+    // it: the subject's budget depends on the uid and the suffix, so a hit
+    // composed here from a bare `sanitize` pointed at a path that does not
+    // exist as soon as a long subject was trimmed differently.
+    const filename = msgFilename(msg.subject !== '' ? msg.subject : 'No Subject', msg.uid);
+    return [prefix, folder, dateStr, filename].filter((p) => p !== '').join('/');
+}
+export async function searchAndFormat(accessor, folder, pattern, prefix, maxResults = null) {
+    if (folder === '')
+        return [];
+    const uids = await searchMessages(accessor, folder, { text: pattern }, maxResults);
+    const pairs = [];
+    for (const uid of uids) {
+        const msg = await fetchMessage(accessor, folder, uid);
+        const msgText = messageJsonText(msg);
+        const vfsPath = buildVfsPath(prefix, folder, msg);
+        pairs.push([vfsPath, msgText]);
+    }
+    return pairs;
+}
+//# sourceMappingURL=search.js.map

package/dist/core/email/search.js.map

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

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

@@ -0,0 +1,5 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import { FileStat } from '@struktoai/mirage-core/types';
+import type { EmailAccessor } from '../../accessor/email.ts';
+export declare const stat: (accessor: EmailAccessor, path: PathSpec, index?: import("@struktoai/mirage-core/cache/index/store").IndexCacheStore) => Promise<FileStat>;
+//# sourceMappingURL=stat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../../src/core/email/stat.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAe,QAAQ,EAAY,MAAM,8BAA8B,CAAA;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAoC5D,eAAO,MAAM,IAAI,4IAQf,CAAA"}

package/dist/core/email/stat.js

@@ -0,0 +1,56 @@
+// ========= 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 { makeStat } from '@struktoai/mirage-core/core/hierarchy/stat';
+import { ContentType, FileStat, FileType } from '@struktoai/mirage-core/types';
+import { contentTypeForPath } from '@struktoai/mirage-core/utils/filetype';
+import { readdir } from "./readdir.js";
+import { detectScope } from "./scope.js";
+function dirStat(_match, _path, entry) {
+    return new FileStat({ name: entry.vfsName, type: FileType.DIRECTORY });
+}
+function messageStat(_match, _path, entry) {
+    return new FileStat({
+        name: entry.vfsName,
+        type: FileType.FILE,
+        content: ContentType.JSON,
+        size: entry.size,
+        extra: { uid: entry.id },
+    });
+}
+function attachmentDirStat(_match, _path, entry) {
+    return new FileStat({
+        name: entry.vfsName,
+        type: FileType.DIRECTORY,
+        extra: { uid: entry.id },
+    });
+}
+function attachmentStat(_match, _path, entry) {
+    return new FileStat({
+        name: entry.vfsName,
+        type: FileType.FILE,
+        content: contentTypeForPath(entry.vfsName),
+        size: entry.size,
+        extra: { attachment_id: entry.id },
+    });
+}
+export const stat = makeStat(detectScope, readdir, {
+    entryStats: {
+        folder: dirStat,
+        day: dirStat,
+        message: messageStat,
+        attachment_dir: attachmentDirStat,
+        attachment: attachmentStat,
+    },
+});
+//# sourceMappingURL=stat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/email/stat.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAA;AAGrE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,SAAS,OAAO,CAAC,MAAkB,EAAE,KAAe,EAAE,KAAiB;IACrE,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,WAAW,CAAC,MAAkB,EAAE,KAAe,EAAE,KAAiB;IACzE,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,WAAW,CAAC,IAAI;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;KACzB,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAkB,EAAE,KAAe,EAAE,KAAiB;IAC/E,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,IAAI,EAAE,QAAQ,CAAC,SAAS;QACxB,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;KACzB,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAkB,EAAE,KAAe,EAAE,KAAiB;IAC5E,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,EAAE;KACnC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAgB,WAAW,EAAE,OAAO,EAAE;IAChE,UAAU,EAAE;QACV,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,OAAO;QACZ,OAAO,EAAE,WAAW;QACpB,cAAc,EAAE,iBAAiB;QACjC,UAAU,EAAE,cAAc;KAC3B;CACF,CAAC,CAAA"}

package/dist/core/gridfs/client.d.ts

@@ -0,0 +1,37 @@
+import type { Collection, Db, GridFSBucket, ObjectId } from 'mongodb';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { GridFSAccessor } from '../../accessor/gridfs.ts';
+import type { GridFSConfig } from '../../resource/gridfs/config.ts';
+export interface GridFSFileDoc {
+    _id: ObjectId;
+    filename: string;
+    length: number;
+    uploadDate: Date;
+}
+interface GridFSModule {
+    GridFSBucket: new (db: Db, options?: {
+        bucketName?: string;
+        chunkSizeBytes?: number;
+    }) => GridFSBucket;
+    ObjectId: new (id?: string) => ObjectId;
+}
+export declare function loadGridFSModule(): Promise<GridFSModule>;
+export declare function gridfsKey(path: string, config: GridFSConfig): string;
+export declare function gridfsPrefix(path: string, config: GridFSConfig): string;
+export declare function stripKeyPrefix(key: string, config: GridFSConfig): string;
+export declare function rawPathOf(path: PathSpec): string;
+export declare function filesColl(accessor: GridFSAccessor): Promise<Collection>;
+export declare function bucket(accessor: GridFSAccessor): Promise<GridFSBucket>;
+export declare function escapeRegex(raw: string): string;
+export declare function prefixQuery(pfx: string): Record<string, unknown>;
+export declare function latestFile(accessor: GridFSAccessor, key: string): Promise<GridFSFileDoc | null>;
+export declare function fileById(accessor: GridFSAccessor, id: ObjectId): Promise<GridFSFileDoc | null>;
+/**
+ * Yield the newest revision of each filename matching a query, sorted by
+ * filename. Mirrors Python's `iter_latest`.
+ */
+export declare function iterLatest(accessor: GridFSAccessor, query: Record<string, unknown>): AsyncIterable<GridFSFileDoc>;
+/** Delete every revision (file doc + chunks) matching a query. */
+export declare function deleteAll(accessor: GridFSAccessor, query: Record<string, unknown>): Promise<void>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/core/gridfs/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/client.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,EAAE,EAAY,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAEnE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,QAAQ,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,IAAI,CAAA;CACjB;AAED,UAAU,YAAY;IACpB,YAAY,EAAE,KACZ,EAAE,EAAE,EAAE,EACN,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,KACvD,YAAY,CAAA;IACjB,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAA;CACxC;AAUD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAM9D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAEpE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAEvE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAExE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAKhD;AAMD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAG7E;AAOD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAU5E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGhE;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAI/B;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAI/B;AAED;;;GAGG;AACH,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,aAAa,CAAC,aAAa,CAAC,CAuB9B;AAED,kEAAkE;AAClE,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAYf"}