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

package/dist/core/email/client.js

@@ -0,0 +1,328 @@
+// ========= 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 { parseRfc822, parseWithPayloads } from "./_parse.js";
+function internalDateOf(value) {
+    if (value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    return value.toISOString();
+}
+export async function listFolderEntries(accessor) {
+    const imap = await accessor.getImap();
+    const tree = await imap.list();
+    return tree.map((m) => ({ name: m.pathAsListed, specialUse: m.specialUse ?? null }));
+}
+export async function listFolders(accessor) {
+    return (await listFolderEntries(accessor)).map((entry) => entry.name);
+}
+/**
+ * Selects and locks a mailbox, failing loudly when it does not exist.
+ *
+ * imapflow reports every refused command as a bare "Command failed" and
+ * keeps the server's own words on `responseText`, so a missing mailbox
+ * arrives naming neither itself nor the problem. A `responseText` means
+ * the server answered and refused, which is the same condition python
+ * checks through the SELECT response code.
+ */
+export async function lockMailbox(imap, folder) {
+    try {
+        return await imap.getMailboxLock(folder);
+    }
+    catch (error) {
+        const answered = error.responseText !== undefined;
+        if (answered)
+            throw new Error(`no such mailbox '${folder}'`);
+        throw error;
+    }
+}
+export async function listMessageUids(accessor, folder, searchCriteria = 'ALL', maxResults = null) {
+    const imap = await accessor.getImap();
+    const lock = await lockMailbox(imap, folder);
+    try {
+        const query = parseSearchCriteria(searchCriteria);
+        const uidsRaw = await imap.search(query, { uid: true });
+        // imapflow answers `false` when the server refused the search. That
+        // must not read as "matched nothing": it would hide criteria the
+        // server cannot answer behind an empty result.
+        if (uidsRaw === false)
+            throw new Error(`IMAP rejected the search: ${searchCriteria}`);
+        const uids = uidsRaw.map((n) => String(n));
+        if (maxResults !== null && uids.length > maxResults) {
+            return uids.slice(uids.length - maxResults);
+        }
+        return uids;
+    }
+    finally {
+        lock.release();
+    }
+}
+const FLAG_KEYS = {
+    SEEN: 'seen',
+    ANSWERED: 'answered',
+    FLAGGED: 'flagged',
+    DRAFT: 'draft',
+    DELETED: 'deleted',
+};
+const TEXT_KEYS = {
+    BODY: 'body',
+    TEXT: 'text',
+    SUBJECT: 'subject',
+    FROM: 'from',
+    TO: 'to',
+};
+// ON/SINCE/BEFORE match the mailbox's internal date, SENT* the `Date:`
+// header. They are different searches, so both spellings map through.
+const DATE_KEYS = {
+    ON: 'on',
+    SINCE: 'since',
+    BEFORE: 'before',
+    SENTON: 'sentOn',
+    SENTSINCE: 'sentSince',
+    SENTBEFORE: 'sentBefore',
+};
+/**
+ * ANDs two search objects.
+ *
+ * imapflow ANDs the keys of one object, so a plain merge works until the
+ * same key appears twice (`SUBJECT a SUBJECT b`). De Morgan expresses
+ * that case without dropping either half, which a merge would do
+ * silently.
+ */
+function andQueries(left, right) {
+    const collides = Object.keys(right).some((key) => key in left);
+    if (!collides)
+        return { ...left, ...right };
+    return { not: { or: [{ not: left }, { not: right }] } };
+}
+class CriteriaParser {
+    tokens;
+    index = 0;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    peek() {
+        return this.tokens[this.index];
+    }
+    take() {
+        const token = this.peek();
+        if (token === undefined)
+            throw new Error('email: truncated IMAP search criteria');
+        this.index += 1;
+        return token;
+    }
+    atEnd() {
+        return this.index >= this.tokens.length;
+    }
+    /** One or more keys juxtaposed, which IMAP reads as AND. */
+    parseSequence(stopAtParen = false) {
+        let query = null;
+        while (!this.atEnd()) {
+            if (stopAtParen && this.peek() === ')')
+                break;
+            const next = this.parseKey();
+            query = query === null ? next : andQueries(query, next);
+        }
+        return query ?? { all: true };
+    }
+    parseKey() {
+        const token = this.take();
+        if (token === '(') {
+            const inner = this.parseSequence(true);
+            if (this.peek() !== ')')
+                throw new Error('email: unbalanced IMAP search criteria');
+            this.index += 1;
+            return inner;
+        }
+        const word = token.toUpperCase();
+        if (word === 'ALL')
+            return { all: true };
+        if (word === 'NOT')
+            return { not: this.parseKey() };
+        if (word === 'OR')
+            return { or: [this.parseKey(), this.parseKey()] };
+        if (word === 'UNSEEN')
+            return { seen: false };
+        const flag = FLAG_KEYS[word];
+        if (flag !== undefined)
+            return { [flag]: true };
+        const textKey = TEXT_KEYS[word];
+        if (textKey !== undefined)
+            return { [textKey]: this.take() };
+        const dateKey = DATE_KEYS[word];
+        if (dateKey !== undefined) {
+            const parsed = parseImapDate(this.take());
+            if (parsed === null)
+                throw new Error(`email: bad date in IMAP search criteria: ${token}`);
+            return { [dateKey]: parsed };
+        }
+        // Never fall through silently: a dropped key would widen the search
+        // and quietly return the wrong messages.
+        throw new Error(`email: unsupported IMAP search key '${token}'`);
+    }
+}
+export function parseSearchCriteria(criteria) {
+    if (criteria === 'ALL' || criteria === '')
+        return { all: true };
+    return new CriteriaParser(tokenizeCriteria(criteria)).parseSequence();
+}
+function tokenizeCriteria(criteria) {
+    const tokens = [];
+    let i = 0;
+    while (i < criteria.length) {
+        const char = criteria.charAt(i);
+        if (char === ' ') {
+            i += 1;
+            continue;
+        }
+        if (char === '(' || char === ')') {
+            tokens.push(char);
+            i += 1;
+            continue;
+        }
+        if (char === '"') {
+            let value = '';
+            let j = i + 1;
+            while (j < criteria.length && criteria.charAt(j) !== '"') {
+                if (criteria.charAt(j) === '\\' && j + 1 < criteria.length)
+                    j += 1;
+                value += criteria.charAt(j);
+                j += 1;
+            }
+            tokens.push(value);
+            i = j + 1;
+            continue;
+        }
+        let end = i;
+        while (end < criteria.length && !' ()'.includes(criteria.charAt(end)))
+            end += 1;
+        tokens.push(criteria.slice(i, end));
+        i = end;
+    }
+    return tokens;
+}
+function parseImapDate(s) {
+    const m = /^(\d{1,2})-([A-Za-z]{3})-(\d{4})$/.exec(s);
+    if (m === null)
+        return null;
+    const months = {
+        Jan: 0,
+        Feb: 1,
+        Mar: 2,
+        Apr: 3,
+        May: 4,
+        Jun: 5,
+        Jul: 6,
+        Aug: 7,
+        Sep: 8,
+        Oct: 9,
+        Nov: 10,
+        Dec: 11,
+    };
+    const day = Number.parseInt(m[1] ?? '0', 10);
+    const monKey = (m[2] ?? '').slice(0, 1).toUpperCase() + (m[2] ?? '').slice(1).toLowerCase();
+    const mon = months[monKey];
+    const year = Number.parseInt(m[3] ?? '1970', 10);
+    // An unknown month defaulting to January, or a day rolling over into
+    // the next month, would hand the server a confidently wrong date.
+    if (mon === undefined)
+        return null;
+    const value = new Date(Date.UTC(year, mon, day));
+    if (value.getUTCMonth() !== mon || value.getUTCDate() !== day)
+        return null;
+    return value;
+}
+export async function fetchRawMessage(accessor, folder, uid) {
+    const imap = await accessor.getImap();
+    const lock = await lockMailbox(imap, folder);
+    try {
+        const msg = await imap.fetchOne(uid, { source: true, uid: true }, { uid: true });
+        if (msg === false) {
+            throw new Error(`email: uid ${uid} not found in ${folder}`);
+        }
+        return msg.source instanceof Buffer ? new Uint8Array(msg.source) : new Uint8Array(0);
+    }
+    finally {
+        lock.release();
+    }
+}
+export async function fetchMessage(accessor, folder, uid) {
+    const imap = await accessor.getImap();
+    const lock = await lockMailbox(imap, folder);
+    try {
+        const msg = await imap.fetchOne(uid, { source: true, flags: true, uid: true, internalDate: true }, { uid: true });
+        if (msg === false) {
+            throw new Error(`email: uid ${uid} not found in ${folder}`);
+        }
+        const source = msg.source instanceof Buffer ? new Uint8Array(msg.source) : new Uint8Array(0);
+        const parsed = await parseRfc822(source);
+        return {
+            ...parsed,
+            uid,
+            flags: msg.flags !== undefined ? [...msg.flags] : [],
+            internalDate: internalDateOf(msg.internalDate),
+        };
+    }
+    finally {
+        lock.release();
+    }
+}
+export async function fetchHeaders(accessor, folder, uids) {
+    if (uids.length === 0)
+        return [];
+    const imap = await accessor.getImap();
+    const lock = await lockMailbox(imap, folder);
+    try {
+        const results = [];
+        for (const uid of uids) {
+            // Full source (not headers-only): listings need the MIME structure
+            // to surface attachment dirs, mirroring the python backend.
+            const msg = await imap.fetchOne(uid, { source: true, flags: true, uid: true, internalDate: true }, { uid: true });
+            if (msg === false)
+                continue;
+            const source = msg.source instanceof Buffer ? new Uint8Array(msg.source) : new Uint8Array(0);
+            const parsed = await parseRfc822(source);
+            results.push({
+                ...parsed,
+                uid,
+                flags: msg.flags !== undefined ? [...msg.flags] : [],
+                internalDate: internalDateOf(msg.internalDate),
+            });
+        }
+        return results;
+    }
+    finally {
+        lock.release();
+    }
+}
+export async function fetchAttachment(accessor, folder, uid, filename) {
+    const imap = await accessor.getImap();
+    const lock = await lockMailbox(imap, folder);
+    try {
+        const msg = await imap.fetchOne(uid, { source: true }, { uid: true });
+        if (msg === false)
+            return null;
+        const source = msg.source instanceof Buffer ? new Uint8Array(msg.source) : new Uint8Array(0);
+        const attachments = await parseWithPayloads(source);
+        for (const att of attachments) {
+            if (att.filename === filename)
+                return att.payload;
+        }
+        return null;
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,21 @@
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+export declare const EmailConfigSchema: z.ZodObject<{
+    imapHost: z.ZodString;
+    imapPort: z.ZodDefault<z.ZodNumber>;
+    smtpHost: z.ZodString;
+    smtpPort: z.ZodDefault<z.ZodNumber>;
+    username: z.ZodString;
+    password: z.ZodString;
+    useSsl: z.ZodDefault<z.ZodBoolean>;
+    maxMessages: z.ZodDefault<z.ZodNumber>;
+    saveCopy: z.ZodDefault<z.ZodBoolean>;
+    sentFolder: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type EmailConfig = ConfigOf<typeof EmailConfigSchema>;
+export type EmailConfigRedacted = RedactedConfig<EmailConfig, 'password'>;
+export declare function redactEmailConfig(config: EmailConfig): EmailConfigRedacted;
+export type EmailConfigInput = z.input<typeof EmailConfigSchema>;
+export declare function buildEmailConfig(input: EmailConfigInput): EmailConfig;
+export declare function normalizeEmailConfig(input: Record<string, unknown>): EmailConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/email/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,CAAC,EACF,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAKvF,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAgB5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE5D,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;AAEzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAE1E;AAGD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEhE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAarE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAEhF"}

package/dist/core/email/config.js

@@ -0,0 +1,55 @@
+// ========= 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 { parseConfigWithSchema, redactConfigWithSchema, secretStr, z, } from '@struktoai/mirage-core/resource/secrets';
+// Doubles as the himalaya CLI's configModel: parse applies the same
+// defaults buildEmailConfig fills in, and secretStr marks the password
+// for snapshot redaction.
+export const EmailConfigSchema = z.object({
+    imapHost: z.string(),
+    imapPort: z.number().default(993),
+    smtpHost: z.string(),
+    smtpPort: z.number().default(587),
+    username: z.string(),
+    password: secretStr(),
+    useSsl: z.boolean().default(true),
+    maxMessages: z.number().default(200),
+    /**
+     * Upstream himalaya's message.send.save-copy, whose default is true
+     * since pimalaya/himalaya#536.
+     */
+    saveCopy: z.boolean().default(true),
+    /** Its folder.alias.sent: null means ask the server for its \Sent mailbox. */
+    sentFolder: z.string().nullable().default(null),
+});
+export function redactEmailConfig(config) {
+    return redactConfigWithSchema(EmailConfigSchema, config);
+}
+export function buildEmailConfig(input) {
+    return {
+        imapHost: input.imapHost,
+        imapPort: input.imapPort ?? 993,
+        smtpHost: input.smtpHost,
+        smtpPort: input.smtpPort ?? 587,
+        username: input.username,
+        password: input.password,
+        useSsl: input.useSsl ?? true,
+        maxMessages: input.maxMessages ?? 200,
+        saveCopy: input.saveCopy ?? true,
+        sentFolder: input.sentFolder ?? null,
+    };
+}
+export function normalizeEmailConfig(input) {
+    return parseConfigWithSchema(EmailConfigSchema, input);
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/email/config.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,EACL,qBAAqB,EACrB,sBAAsB,EACtB,SAAS,EACT,CAAC,GACF,MAAM,yCAAyC,CAAA;AAGhD,oEAAoE;AACpE,uEAAuE;AACvE,0BAA0B;AAC1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,SAAS,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACpC;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAChD,CAAC,CAAA;AAMF,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,CAAmC,CAAA;AAC5F,CAAC;AAKD,MAAM,UAAU,gBAAgB,CAAC,KAAuB;IACtD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;KACrC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA8B;IACjE,OAAO,qBAAqB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;AACxD,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { EmailAccessor } from '../../accessor/email.ts';
+export declare function listFolders(accessor: EmailAccessor): Promise<string[]>;
+//# sourceMappingURL=folders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../../src/core/email/folders.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAG5D,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5E"}

package/dist/core/email/folders.js

@@ -0,0 +1,18 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { listFolders as clientListFolders } from "./client.js";
+export async function listFolders(accessor) {
+    return clientListFolders(accessor);
+}
+//# sourceMappingURL=folders.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../../src/core/email/folders.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,WAAW,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAuB;IACvD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAA;AACpC,CAAC"}

package/dist/core/email/read.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 { EmailAccessor } from '../../accessor/email.ts';
+export declare const read: (accessor: EmailAccessor, path: PathSpec, index?: IndexCacheStore, window?: import("@struktoai/mirage-core/core/hierarchy/read").ReadWindow) => Promise<Uint8Array>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/email/read.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAI/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAoC5D,eAAO,MAAM,IAAI,qKAGf,CAAA"}

package/dist/core/email/read.js

@@ -0,0 +1,41 @@
+// ========= 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 { resolveEntry } from '@struktoai/mirage-core/core/hierarchy/probe';
+import { makeRead } from '@struktoai/mirage-core/core/hierarchy/read';
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { fetchAttachment, fetchMessage } from "./client.js";
+import { readdir } from "./readdir.js";
+import { messageJsonBytes } from "./render.js";
+import { detectScope } from "./scope.js";
+async function readMessage(accessor, match, path, index) {
+    const entry = await resolveEntry(readdir, accessor, path, index);
+    if (entry === null)
+        throw enoent(path);
+    const msg = await fetchMessage(accessor, match.slots.folder ?? '', entry.id);
+    return messageJsonBytes(msg);
+}
+async function readAttachment(accessor, match, path, index) {
+    const entry = await resolveEntry(readdir, accessor, path, index);
+    if (entry === null)
+        throw enoent(path);
+    const data = await fetchAttachment(accessor, match.slots.folder ?? '', match.slots.uid ?? '', entry.vfsName);
+    if (data === null)
+        throw enoent(path);
+    return data;
+}
+export const read = makeRead(detectScope, {
+    message: readMessage,
+    attachment: readAttachment,
+});
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/email/read.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,YAAY,EAAE,MAAM,6CAA6C,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAA;AAGrE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,KAAK,UAAU,WAAW,CACxB,QAAuB,EACvB,KAAiB,EACjB,IAAc,EACd,KAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAChE,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAC5E,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,QAAuB,EACvB,KAAiB,EACjB,IAAc,EACd,KAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAChE,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM,eAAe,CAChC,QAAQ,EACR,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EACxB,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,EACrB,KAAK,CAAC,OAAO,CACd,CAAA;IACD,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAgB,WAAW,EAAE;IACvD,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAA"}

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

@@ -0,0 +1,16 @@
+import type { EmailAccessor } from '../../accessor/email.ts';
+import { type FetchedMessage } from './client.ts';
+export declare function msgFilename(subject: string, uid: string): string;
+/**
+ * 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 declare function dateBucket(message: FetchedMessage): string;
+export declare const readdir: import("@struktoai/mirage-core/core/hierarchy/probe").ReaddirFn<EmailAccessor>;
+//# sourceMappingURL=readdir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readdir.d.ts","sourceRoot":"","sources":["../../../src/core/email/readdir.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAuBhF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhE;AAmDD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE1D;AA+ID,eAAO,MAAM,OAAO,gFAOlB,CAAA"}