@wirecat/cli-memo 0.0.0 → 0.5.1

package/dist/mail/import.js

@@ -0,0 +1,170 @@
+import { extractText, importEngine } from "@wirecat/cli-messaging/documents";
+import { embedChanged } from "../notes/embed.js";
+import { dropMissing } from "../store/gone.js";
+import { listAllMail, listImapMail } from "./gmail.js";
+import { parseMail } from "./parse.js";
+const DAY = 86_400_000;
+/** IMAP's SINCE counts whole days in the server's zone, so the window's first days are not trusted. */
+const EDGE = 2 * DAY;
+const ANY = /[\s\S]?/;
+const titleOf = (subject) => subject?.replace(/^\s*((re|fwd?|aw|wg)\s*:\s*)+/i, "").trim() || null;
+export const importMail = async ({ store, run, account, since, max = 200, now = Date.now, env, embed = false, loadEngine = importEngine, retryAttachments = false, indexThreads = embedChanged, }) => {
+    const startedAt = now();
+    const key = { provider: "email", account: account.address.toLowerCase() };
+    await store.saveAccount(key, { name: account.address });
+    const folders = account.folders ?? [account.mode === "imap" ? "INBOX" : "[Gmail]/All Mail"];
+    if (folders.length < 1 || folders.length > 50)
+        throw new Error("select 1–50 mail folders");
+    const collected = [];
+    for (const folder of folders)
+        collected.push(...(account.mode === "imap"
+            ? await listImapMail(run, account.name, since, folder)
+            : (await listAllMail(run, account.name, since, folder)).map((item) => ({
+                ...item,
+                folder: folder === "[Gmail]/All Mail" ? "archive" : folder,
+                scopeFolder: folder,
+            }))));
+    const listed = [...new Map(collected.map((item) => [item.messageId, item])).values()].sort((a, b) => b.receivedAt.localeCompare(a.receivedAt));
+    const changed = new Set();
+    const attachments = [];
+    const present = new Set(listed.map(({ messageId }) => messageId));
+    const foundFolders = new Map();
+    for (const item of collected) {
+        const current = foundFolders.get(item.messageId) ?? new Set();
+        current.add(item.scopeFolder ?? item.folder ?? folders[0]);
+        foundFolders.set(item.messageId, current);
+    }
+    for (const [id, found] of foundFolders) {
+        const earlier = await store.syncState(key, `mail_message_folders:${id}`);
+        const kept = earlier === undefined ? [] : JSON.parse(earlier.value).filter((folder) => !folders.includes(folder));
+        await store.setSyncState(key, `mail_message_folders:${id}`, JSON.stringify([...new Set([...kept, ...found])]));
+    }
+    let saved = 0;
+    let alreadyStored = 0;
+    let read = 0;
+    for (const item of listed) {
+        if (!retryAttachments && (await store.message(key, item.messageId, { chatId: item.threadId })) !== undefined) {
+            const children = await store.syncState(key, `mail_attachments:${item.messageId}`);
+            for (const id of children === undefined ? [] : JSON.parse(children.value))
+                present.add(id);
+            alreadyStored++;
+            continue;
+        }
+        if (read >= max)
+            break;
+        read++;
+        const mail = parseMail(await run(["--json", "message", "read", "-a", account.name, "-m", item.folder ?? "archive", item.uid]));
+        const people = [mail.from, ...mail.to, ...mail.bcc].filter((person) => person !== null);
+        const known = (await store.members(key, item.threadId)).map(({ id }) => id);
+        const members = [...new Set([...known, ...people.map(({ email }) => email)])];
+        const newest = (await store.find({ account: key, chatId: item.threadId, pattern: ANY, limit: 1 })).items[0]
+            ?.timestamp;
+        // Saving a chat replaces its fields, so an older message read later must not move the time back.
+        const lastMessageAt = newest !== undefined && newest > item.receivedAt ? newest : item.receivedAt;
+        await store.applyDelta(key, {
+            chats: [
+                {
+                    id: item.threadId,
+                    title: titleOf(mail.subject),
+                    kind: members.length > 2 ? "group" : "dialog",
+                    unreadCount: null,
+                    lastMessageAt,
+                    participantsCount: members.length,
+                },
+            ],
+            people: people.map(({ email, name }) => ({ id: email, name })),
+            members: new Map([[item.threadId, members]]),
+        });
+        const message = {
+            id: item.messageId,
+            chatId: item.threadId,
+            senderId: mail.from?.email ?? null,
+            senderName: mail.from?.name ?? null,
+            timestamp: item.receivedAt,
+            editedAt: null,
+            text: [mail.subject, mail.text].filter(Boolean).join("\n\n"),
+            outgoing: mail.from === null ? null : mail.from.email === key.account,
+            attachments: mail.attachments.map((part) => ({
+                kind: "file",
+                name: part.name,
+                ...(part.mime === null ? {} : { mime: part.mime }),
+                ...(part.bytes === null ? {} : { size: part.bytes.byteLength }),
+                providerRef: { message: item.messageId, part: part.id },
+            })),
+            providerMetadata: {
+                emailHeaders: { cc: mail.cc.map((address) => address.email), bcc: mail.bcc.map((address) => address.email) },
+            },
+            replyTo: null,
+            forwardedFrom: null,
+            reactions: null,
+        };
+        await store.saveMessages(key, item.threadId, [message], { via: "himalaya", seenAt: startedAt });
+        const children = [];
+        for (const part of mail.attachments) {
+            const extraction = part.bytes === null
+                ? { status: "unavailable" }
+                : await extractText(part.bytes, { kind: "file", name: part.name, mime: part.mime, path: part.name }, loadEngine);
+            if (extraction.status !== "extracted") {
+                attachments.push({ message: item.messageId, part: part.id, status: extraction.status });
+                continue;
+            }
+            const id = `${item.messageId}:attachment:${part.id}`;
+            await store.saveMessages(key, item.threadId, [
+                {
+                    ...message,
+                    id,
+                    text: `${part.name}\n\n${extraction.text}`.slice(0, 200_000),
+                    attachments: [],
+                    providerMetadata: {
+                        emailAttachment: { message: item.messageId, part: part.id, extractor: extraction.extractor },
+                    },
+                },
+            ], { via: "himalaya", seenAt: startedAt });
+            children.push(id);
+            present.add(id);
+            attachments.push({ message: item.messageId, part: part.id, status: "extracted", locatorId: id });
+        }
+        await store.setSyncState(key, `mail_attachments:${item.messageId}`, JSON.stringify(children));
+        saved++;
+        changed.add(item.threadId);
+    }
+    const complete = listed.length - alreadyStored - saved === 0;
+    const scope = JSON.stringify({ mode: account.mode ?? "gmail", folders: [...folders].sort() });
+    const previousScope = await store.syncState(key, "mail_folder_scope");
+    const { deleted, skipped } = previousScope !== undefined && previousScope.value !== scope
+        ? { deleted: 0, skipped: "folder scope changed; missing mail is not proven deleted" }
+        : await dropMissing(store, key, present, new Date(since.getTime() + EDGE).toISOString(), async ({ id }) => {
+            const parent = id.replace(/:attachment:\d+$/, "");
+            const membership = await store.syncState(key, `mail_message_folders:${parent}`);
+            if (membership === undefined)
+                return account.mode !== "imap" && folders.length === 1 && folders[0] === "[Gmail]/All Mail";
+            return JSON.parse(membership.value).every((folder) => folders.includes(folder));
+        });
+    await store.setSyncState(key, "mail_folder_scope", scope);
+    const indexed = await indexThreads(store, key, [...changed], {
+        embed: embed && account.embed !== false,
+        ...(env === undefined ? {} : { env }),
+    });
+    const coverage = {
+        folders,
+        since: since.toISOString(),
+        until: new Date(startedAt).toISOString(),
+        state: complete ? "window" : "partial",
+        identity: account.mode === "imap" ? "message-id-or-uidvalidity-folder-uid" : "gmail-message-id",
+    };
+    await store.setSyncState(key, "mail_coverage", JSON.stringify(coverage));
+    return {
+        account: key.account,
+        since: since.toISOString(),
+        listed: listed.length,
+        saved,
+        alreadyStored,
+        deleted,
+        complete,
+        indexed,
+        coverage,
+        ...(attachments.length ? { attachments } : {}),
+        ...(skipped === undefined ? {} : { deletionsSkipped: skipped }),
+    };
+};
+//# sourceMappingURL=import.js.map

package/dist/mail/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/mail/import.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAmB,MAAM,kCAAkC,CAAA;AAE7F,OAAO,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,EAAgB,SAAS,EAAE,MAAM,YAAY,CAAA;AA4BpD,MAAM,GAAG,GAAG,UAAU,CAAA;AACtB,uGAAuG;AACvG,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAA;AACpB,MAAM,GAAG,GAAG,SAAS,CAAA;AAErB,MAAM,OAAO,GAAG,CAAC,OAAsB,EAAiB,EAAE,CACxD,OAAO,EAAE,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAA;AAEvE,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,EAC/B,KAAK,EACL,GAAG,EACH,OAAO,EACP,KAAK,EACL,GAAG,GAAG,GAAG,EACT,GAAG,GAAG,IAAI,CAAC,GAAG,EACd,GAAG,EACH,KAAK,GAAG,KAAK,EACb,UAAU,GAAG,YAAY,EACzB,gBAAgB,GAAG,KAAK,EACxB,YAAY,GAAG,YAAY,GAa5B,EAAyB,EAAE;IAC1B,MAAM,SAAS,GAAG,GAAG,EAAE,CAAA;IACvB,MAAM,GAAG,GAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;IACrF,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAEvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAA;IAC3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC1F,MAAM,SAAS,GAAG,EAAE,CAAA;IACpB,KAAK,MAAM,MAAM,IAAI,OAAO;QAC1B,SAAS,CAAC,IAAI,CACZ,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;YACzB,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;YACtD,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACnE,GAAG,IAAI;gBACP,MAAM,EAAE,MAAM,KAAK,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;gBAC1D,WAAW,EAAE,MAAM;aACpB,CAAC,CAAC,CAAC,CACT,CAAA;IACH,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAClG,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CACzC,CAAA;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,MAAM,WAAW,GAA6C,EAAE,CAAA;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IACjE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAA;IACnD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAU,CAAA;QACrE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,IAAK,OAAO,CAAC,CAAC,CAAY,CAAC,CAAA;QACtE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAA;QACxE,MAAM,IAAI,GACR,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAc,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QACpH,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,wBAAwB,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAChH,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,gBAAgB,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7G,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,oBAAoB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;YACjF,KAAK,MAAM,EAAE,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACxG,aAAa,EAAE,CAAA;YACf,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,IAAI,GAAG;YAAE,MAAK;QACtB,IAAI,EAAE,CAAA;QACN,MAAM,IAAI,GAAG,SAAS,CACpB,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CACvG,CAAA;QACD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAqB,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAA;QAC1G,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAA;QAC3E,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7E,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACzG,EAAE,SAAS,CAAA;QACb,iGAAiG;QACjG,MAAM,aAAa,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAA;QACjG,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,IAAI,CAAC,QAAQ;oBACjB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;oBAC5B,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;oBAC7C,WAAW,EAAE,IAAI;oBACjB,aAAa;oBACb,iBAAiB,EAAE,OAAO,CAAC,MAAM;iBAClC;aACF;YACD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;SAC7C,CAAC,CAAA;QACF,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,IAAI,CAAC,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,QAAQ;YACrB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI;YAClC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI;YACnC,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5D,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO;YACrE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBAC/D,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;aACxD,CAAC,CAAC;YACH,gBAAgB,EAAE;gBAChB,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;aAC7G;YACD,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,SAAS,EAAE,IAAI;SAChB,CAAA;QACD,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QAC/F,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,KAAK,IAAI;gBACjB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAsB,EAAE;gBACpC,CAAC,CAAC,MAAM,WAAW,CACf,IAAI,CAAC,KAAK,EACV,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EACnE,UAAU,CACX,CAAA;YACP,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACtC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;gBACvF,SAAQ;YACV,CAAC;YACD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC,EAAE,EAAE,CAAA;YACpD,MAAM,KAAK,CAAC,YAAY,CACtB,GAAG,EACH,IAAI,CAAC,QAAQ,EACb;gBACE;oBACE,GAAG,OAAO;oBACV,EAAE;oBACF,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;oBAC5D,WAAW,EAAE,EAAE;oBACf,gBAAgB,EAAE;wBAChB,eAAe,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE;qBAC7F;iBACF;aACF,EACD,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CACvC,CAAA;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACjB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACf,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;QAClG,CAAC;QACD,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,oBAAoB,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7F,KAAK,EAAE,CAAA;QACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,aAAa,GAAG,KAAK,KAAK,CAAC,CAAA;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC7F,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAA;IACrE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GACxB,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,KAAK,KAAK;QAC1D,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,0DAA0D,EAAE;QACrF,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;YACtG,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;YACjD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,wBAAwB,MAAM,EAAE,CAAC,CAAA;YAC/E,IAAI,UAAU,KAAK,SAAS;gBAC1B,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,kBAAkB,CAAA;YAC7F,OAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAc,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QAC/F,CAAC,CAAC,CAAA;IACR,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE;QAC3D,KAAK,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;QACvC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;KACtC,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG;QACf,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE;QAC1B,KAAK,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;QACxC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAE,QAAkB,CAAC,CAAC,CAAE,SAAmB;QAC5D,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,kBAAkB;KAChG,CAAA;IACD,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxE,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK;QACL,aAAa;QACb,OAAO;QACP,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;KAChE,CAAA;AACH,CAAC,CAAA"}

package/dist/mail/parse.d.ts

@@ -0,0 +1,21 @@
+export interface Address {
+    email: string;
+    name: string | null;
+}
+export interface ParsedMail {
+    subject: string | null;
+    from: Address | null;
+    to: Address[];
+    cc: Address[];
+    bcc: Address[];
+    attachments: {
+        id: number;
+        name: string;
+        mime: string | null;
+        bytes: Uint8Array | null;
+    }[];
+    text: string;
+}
+/** `himalaya --json message read`: the `mail-parser` crate's message, serialised as it is. */
+export declare const parseMail: (json: string) => ParsedMail;
+//# sourceMappingURL=parse.d.ts.map

package/dist/mail/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/mail/parse.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,EAAE,EAAE,OAAO,EAAE,CAAA;IACb,EAAE,EAAE,OAAO,EAAE,CAAA;IACb,GAAG,EAAE,OAAO,EAAE,CAAA;IACd,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,EAAE,CAAA;IAC1F,IAAI,EAAE,MAAM,CAAA;CACb;AAkDD,8FAA8F;AAC9F,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,UA2ExC,CAAA"}

package/dist/mail/parse.js

@@ -0,0 +1,86 @@
+import { CliError } from "@wirecat/cli-core";
+const MAX_TEXT = 20_000;
+const addresses = (value) => {
+    const address = value?.Address;
+    const list = address !== undefined && "List" in address
+        ? (address.List ?? [])
+        : address !== undefined && "Group" in address
+            ? (address.Group ?? []).flatMap((group) => group.addresses ?? [])
+            : [];
+    return list.flatMap(({ address: email, name }) => (email ? [{ email: email.toLowerCase(), name: name ?? null }] : []));
+};
+const bodyText = (part, kind) => {
+    const body = part?.body;
+    return typeof body === "object" && body !== null && typeof body[kind] === "string" ? body[kind] : "";
+};
+const htmlToText = (html) => html
+    .replace(/<(script|style)[\s\S]*?<\/\1>/gi, "")
+    .replace(/<br\s*\/?>|<\/(p|div|li|tr|h\d)>/gi, "\n")
+    .replace(/<[^>]+>/g, "")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/[ \t]+\n/g, "\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+/** `himalaya --json message read`: the `mail-parser` crate's message, serialised as it is. */
+export const parseMail = (json) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new CliError("invalid_response", "himalaya message read did not answer JSON");
+    }
+    if (!parsed || !Array.isArray(parsed.parts) || !Array.isArray(parsed.text_body) || !Array.isArray(parsed.html_body))
+        throw new CliError("invalid_response", "himalaya returned an incomplete parsed message");
+    if (parsed.attachments !== undefined && !Array.isArray(parsed.attachments))
+        throw new CliError("invalid_response", "himalaya returned invalid attachment metadata");
+    const headers = parsed.parts[0]?.headers ?? [];
+    const header = (name) => headers.find((item) => item.name === name)?.value;
+    const subject = header("subject")?.Text ?? null;
+    const plain = parsed.text_body
+        .map((index) => bodyText(parsed.parts[index], "Text"))
+        .join("\n\n")
+        .trim();
+    const text = plain || htmlToText(parsed.html_body.map((index) => bodyText(parsed.parts[index], "Html")).join("\n"));
+    return {
+        subject,
+        from: addresses(header("from"))[0] ?? null,
+        to: [...addresses(header("to")), ...addresses(header("cc"))],
+        cc: addresses(header("cc")),
+        bcc: addresses(header("bcc")),
+        attachments: (parsed.attachments ?? []).slice(0, 50).map((id) => {
+            const part = parsed.parts[id];
+            const value = (name) => part?.headers.find((item) => typeof item.name === "string" && item.name.replaceAll("_", "-") === name)?.value;
+            const type = value("content-type")?.ContentType;
+            const disposition = value("content-disposition")?.ContentType;
+            const attrs = [...(disposition?.attributes ?? []), ...(type?.attributes ?? [])];
+            const name = attrs.find((attr) => ["filename", "name"].includes(attr.name ?? attr.attribute ?? ""))?.value ??
+                `attachment-${id}`;
+            const raw = typeof part?.body === "object" && part.body !== null ? (part.body.Binary ?? part.body.InlineBinary) : undefined;
+            let bytes = null;
+            if (Array.isArray(raw) &&
+                raw.length <= 50 * 1024 * 1024 &&
+                raw.every((byte) => Number.isInteger(byte) && byte >= 0 && byte <= 255))
+                bytes = Uint8Array.from(raw);
+            else if (typeof raw === "string" && raw.length <= 70_000_000 && /^[A-Za-z0-9+/]*={0,2}$/.test(raw))
+                bytes = Buffer.from(raw, "base64");
+            else if (typeof part?.body === "object" && part.body !== null && typeof part.body.Text === "string")
+                bytes = new TextEncoder().encode(part.body.Text);
+            else if (typeof part?.body === "object" && part.body !== null && typeof part.body.Html === "string")
+                bytes = new TextEncoder().encode(htmlToText(part.body.Html));
+            return {
+                id,
+                name: name.slice(0, 200),
+                mime: type?.c_type ? `${type.c_type}/${type.c_subtype ?? "octet-stream"}` : null,
+                bytes,
+            };
+        }),
+        text: text.replace(/\r\n?/g, "\n").slice(0, MAX_TEXT),
+    };
+};
+//# sourceMappingURL=parse.js.map

package/dist/mail/parse.js.map

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

package/dist/notes/about.d.ts

@@ -0,0 +1,31 @@
+import type { MessageStore, Note } from "@wirecat/cli-messaging/store";
+import type { Subject } from "../people/subject.js";
+export interface NoteRef {
+    ref: string;
+    source: Note["source"];
+    folderId: string | null;
+    path: string | null;
+    title: string | null;
+    modifiedAt: string;
+    /** The heading or block the link points at. */
+    anchor?: string;
+}
+export interface NotesAbout {
+    subject: string;
+    name: string | null;
+    /** Notes that say they are about the subject. */
+    about: NoteRef[];
+    /** Notes that link the subject directly. */
+    linking: NoteRef[];
+    /** Notes that link one of the notes about the subject. */
+    throughNotes: NoteRef[];
+    /** Links written with one of the person's names that the store could not resolve: two people share it. */
+    waiting: (NoteRef & {
+        text: string;
+    })[];
+    hasMore: boolean;
+}
+/** What notes say about a subject, through the links the store holds — never a name found in plain text. */
+export declare const notesAbout: (store: MessageStore, subject: Subject, limit?: number) => Promise<NotesAbout>;
+export declare const aboutText: (answer: NotesAbout) => string;
+//# sourceMappingURL=about.d.ts.map

package/dist/notes/about.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../src/notes/about.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAQ,YAAY,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,EAAE,CAAA;IACvB,0GAA0G;IAC1G,OAAO,EAAE,CAAC,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IACvC,OAAO,EAAE,OAAO,CAAA;CACjB;AAcD,4GAA4G;AAC5G,eAAO,MAAM,UAAU,UAAiB,YAAY,WAAW,OAAO,qBAAe,OAAO,CAAC,UAAU,CAmDtG,CAAA;AAED,eAAO,MAAM,SAAS,WAAY,UAAU,KAAG,MAa9C,CAAA"}

package/dist/notes/about.js

@@ -0,0 +1,69 @@
+import { formatReference } from "@wirecat/cli-messaging";
+const fold = (value) => value.normalize("NFC").toLocaleLowerCase("en").trim().replace(/^@/, "");
+const refOf = (note, anchor = null) => ({
+    ref: `note:${note.id}`,
+    source: note.source,
+    folderId: note.folderId,
+    path: note.path,
+    title: note.title,
+    modifiedAt: note.updatedAt,
+    ...(anchor === null ? {} : { anchor }),
+});
+/** What notes say about a subject, through the links the store holds — never a name found in plain text. */
+export const notesAbout = async (store, subject, limit = 20) => {
+    const refs = [
+        subject.ref,
+        ...(subject.person?.identities.map((identity) => formatReference({ type: "contact", provider: identity.provider, id: identity.id })) ?? []),
+    ];
+    const live = async (links) => {
+        const found = [];
+        for (const link of links) {
+            if (!link.from.startsWith("note:"))
+                continue;
+            const note = await store.notes.note(link.from.slice("note:".length)).catch(() => undefined);
+            if (note && note.deletedAt === null)
+                found.push({ note, link });
+        }
+        return found;
+    };
+    const pointing = await live((await Promise.all(refs.map((to) => store.notes.links({ to })))).flat());
+    const about = pointing.filter(({ link }) => link.kind === "about");
+    const linking = pointing.filter(({ link }) => link.kind === "links-to");
+    const through = await live((await Promise.all(about.map(({ note }) => store.notes.links({ to: `note:${note.id}` }))))
+        .flat()
+        .filter((link) => link.kind === "links-to"));
+    const names = new Set([subject.person?.name, ...(subject.person?.identities.map(({ name }) => name) ?? [])]
+        .filter((name) => !!name?.trim())
+        .map(fold));
+    const waiting = names.size === 0
+        ? []
+        : await live((await store.notes.links({ unresolved: true })).filter((link) => names.has(fold(link.targetText ?? ""))));
+    const unique = (items) => [...new Map(items.map((item) => [`${item.note.id}#${item.link.anchor ?? ""}`, item])).values()].sort((a, b) => b.note.updatedAt.localeCompare(a.note.updatedAt));
+    const lists = [about, linking, through, waiting].map(unique);
+    return {
+        subject: subject.ref,
+        name: subject.person?.name ?? null,
+        about: (lists[0] ?? []).slice(0, limit).map(({ note }) => refOf(note)),
+        linking: (lists[1] ?? []).slice(0, limit).map(({ note, link }) => refOf(note, link.anchor)),
+        throughNotes: (lists[2] ?? []).slice(0, limit).map(({ note, link }) => refOf(note, link.anchor)),
+        waiting: (lists[3] ?? [])
+            .slice(0, limit)
+            .map(({ note, link }) => ({ ...refOf(note), text: link.targetText ?? "" })),
+        hasMore: lists.some((list) => list.length > limit),
+    };
+};
+export const aboutText = (answer) => {
+    const line = (note) => `  ${note.path ?? note.ref}${note.anchor ? ` ${note.anchor}` : ""}`;
+    const section = (title, notes) => (notes.length ? [title, ...notes.map(line), ""] : []);
+    const who = answer.name ?? answer.subject;
+    return [
+        ...(answer.about.length ? section("About", answer.about) : [`No note about ${who}.`, ""]),
+        ...section("Linking them", answer.linking),
+        ...section("Linking a note about them", answer.throughNotes),
+        ...section("Written with their name, but two people share it — link one with tg contacts link", answer.waiting),
+        ...(answer.hasMore ? ["More were found; raise --limit to see them."] : []),
+    ]
+        .join("\n")
+        .trimEnd();
+};
+//# sourceMappingURL=about.js.map

package/dist/notes/about.js.map

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

package/dist/notes/bound.d.ts

@@ -0,0 +1,24 @@
+import type { MessageStore } from "@wirecat/cli-messaging/store";
+import { type NoteFolder } from "./folders.js";
+export type BoundFolder = NoteFolder & {
+    id: string;
+};
+/**
+ * A folder imported before store version 25 has an id but its path still waits in the store, which hands
+ * it over once. It goes straight into this computer's config, so it is never lost between claim and save.
+ */
+export declare const claimPendingFolders: (store: MessageStore, env: NodeJS.ProcessEnv) => Promise<void>;
+/**
+ * The configured folders the store knows, after claiming pending paths; `only` narrows them by path or id.
+ * `strict` refuses a folder with no id — an import must not invent one — while a read just leaves it out.
+ */
+export declare const boundFolders: (store: MessageStore, env: NodeJS.ProcessEnv, { only, strict }?: {
+    only?: string[];
+    strict?: boolean;
+}) => Promise<BoundFolder[]>;
+/** The folder a file lies in, and its path inside it. */
+export declare const folderOfFile: (folders: BoundFolder[], file: string) => {
+    folder: BoundFolder;
+    path: string;
+};
+//# sourceMappingURL=bound.d.ts.map

package/dist/notes/bound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound.d.ts","sourceRoot":"","sources":["../../src/notes/bound.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAEhE,OAAO,EAAc,KAAK,UAAU,EAAe,MAAM,cAAc,CAAA;AAEvE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAAiB,YAAY,OAAO,MAAM,CAAC,UAAU,KAAG,OAAO,CAAC,IAAI,CAWnG,CAAA;AAQD;;;GAGG;AACH,eAAO,MAAM,YAAY,UAChB,YAAY,OACd,MAAM,CAAC,UAAU,qBACG;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAC7D,OAAO,CAAC,WAAW,EAAE,CAiBvB,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,YAAY,YAAa,WAAW,EAAE,QAAQ,MAAM,KAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAKtG,CAAA"}

package/dist/notes/bound.js

@@ -0,0 +1,57 @@
+import { resolve } from "node:path";
+import { CliError } from "@wirecat/cli-core";
+import { loadConfig, updateConfig } from "../config.js";
+import { bindFolder, noteFolders } from "./folders.js";
+/**
+ * A folder imported before store version 25 has an id but its path still waits in the store, which hands
+ * it over once. It goes straight into this computer's config, so it is never lost between claim and save.
+ */
+export const claimPendingFolders = async (store, env) => {
+    for (const folder of await store.notes.folders()) {
+        if (folder.pendingPath === null)
+            continue;
+        const { path } = await store.notes.claimFolderPath(folder.id);
+        if (path === null)
+            continue;
+        updateConfig((config) => {
+            const here = noteFolders(config.notes).find((entry) => entry.path === resolve(path));
+            if (here?.id && here.id !== folder.id)
+                return config;
+            return bindFolder(config, { id: folder.id, path, format: here?.format ?? folder.format });
+        }, env);
+    }
+};
+const unbound = (path) => new CliError("configuration_error", `${path} has no folder id — memo folders add ${path}, or memo folders attach <id> ${path} if another computer made one`);
+/**
+ * The configured folders the store knows, after claiming pending paths; `only` narrows them by path or id.
+ * `strict` refuses a folder with no id — an import must not invent one — while a read just leaves it out.
+ */
+export const boundFolders = async (store, env, { only, strict = true } = {}) => {
+    await claimPendingFolders(store, env);
+    const known = new Set((await store.notes.folders()).map(({ id }) => id));
+    const configured = noteFolders(loadConfig(env).notes);
+    const wanted = only === undefined
+        ? configured
+        : only.map((name) => {
+            const found = configured.find((folder) => folder.id === name || folder.path === resolve(name));
+            if (!found)
+                throw unbound(resolve(name));
+            return found;
+        });
+    return wanted.flatMap((folder) => {
+        if (folder.id !== null && known.has(folder.id))
+            return [folder];
+        if (strict)
+            throw unbound(folder.path);
+        return [];
+    });
+};
+/** The folder a file lies in, and its path inside it. */
+export const folderOfFile = (folders, file) => {
+    const at = resolve(file);
+    const folder = folders.find((candidate) => at.startsWith(`${candidate.path}/`));
+    if (!folder)
+        throw new CliError("not_found", `${at} is in no configured folder of notes`);
+    return { folder, path: at.slice(folder.path.length + 1) };
+};
+//# sourceMappingURL=bound.js.map

package/dist/notes/bound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound.js","sourceRoot":"","sources":["../../src/notes/bound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,UAAU,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAA;AAIvE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAAmB,EAAE,GAAsB,EAAiB,EAAE;IACtG,KAAK,MAAM,MAAM,IAAI,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI;YAAE,SAAQ;QACzC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC7D,IAAI,IAAI,KAAK,IAAI;YAAE,SAAQ;QAC3B,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YACpF,IAAI,IAAI,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE;gBAAE,OAAO,MAAM,CAAA;YACpD,OAAO,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3F,CAAC,EAAE,GAAG,CAAC,CAAA;IACT,CAAC;AACH,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAC/B,IAAI,QAAQ,CACV,qBAAqB,EACrB,GAAG,IAAI,wCAAwC,IAAI,iCAAiC,IAAI,+BAA+B,CACxH,CAAA;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,KAAmB,EACnB,GAAsB,EACtB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAA0C,EAAE,EAC3C,EAAE;IAC1B,MAAM,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACxE,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,MAAM,GACV,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YAC9F,IAAI,CAAC,KAAK;gBAAE,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YACxC,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAA;IACR,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/B,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,MAAqB,CAAC,CAAA;QAC9E,IAAI,MAAM;YAAE,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACtC,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAE,IAAY,EAAyC,EAAE;IAC1G,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IAC/E,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,sCAAsC,CAAC,CAAA;IACzF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAA;AAC3D,CAAC,CAAA"}

package/dist/notes/command.d.ts

@@ -0,0 +1,4 @@
+import { type Streams } from "@wirecat/cli-core";
+import { type Command } from "commander";
+export declare const notesCommand: (program: Command, streams: Streams, env: NodeJS.ProcessEnv) => void;
+//# sourceMappingURL=command.d.ts.map

package/dist/notes/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/notes/command.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE1E,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,WAAW,CAAA;AAiD9D,eAAO,MAAM,YAAY,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IAoOzF,CAAA"}