@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/services/evidence-read.js

@@ -0,0 +1,23 @@
+import { CliError } from "@wirecat/cli-base";
+import { prepareEvidencePacket } from "./evidence.js";
+import { storedChatId } from "./messages.js";
+/** Reads only the authorised account's store, retaining the newest whole-message prefix. */
+export const readEvidencePacket = async (store, account, { chat, limit, before }, messenger = {}) => {
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+        throw new CliError("validation_error", "evidence message limit must be an integer from 1 to 100");
+    if (before !== undefined && !before.trim())
+        throw new CliError("validation_error", "evidence before id must not be empty");
+    const chatId = await storedChatId(messenger, chat, store, account);
+    const page = await store.messages(account, chatId, { limit, ...(before === undefined ? {} : { before }) });
+    const items = page.items.toReversed();
+    const packet = prepareEvidencePacket({
+        kind: "chats",
+        source: { ...account, chat: chatId },
+        page: { ...page, items },
+        limits: { messages: limit },
+    });
+    const older = page.hasMore || packet.coverage.omitted > 0;
+    const last = items[packet.items.length - 1];
+    return { ...packet, nextBeforeId: older && last ? last.id : null };
+};
+//# sourceMappingURL=evidence-read.js.map

package/dist/services/evidence-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-read.js","sourceRoot":"","sources":["../../src/services/evidence-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAuB,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAY5C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,KAAmB,EACnB,OAAmB,EACnB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAqB,EAC1C,SAAS,GAA4C,EAAE,EACxB,EAAE;IACjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG;QAC1D,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,yDAAyD,CAAC,CAAA;IACnG,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QACxC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,sCAAsC,CAAC,CAAA;IAEhF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAClE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1G,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAA;IACrC,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACnC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;QACpC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE;QACxB,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;KAC5B,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAA;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC3C,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACpE,CAAC,CAAA"}

package/dist/services/evidence.d.ts

@@ -0,0 +1,53 @@
+import { type MessageLocator } from "../domain/locator.js";
+import type { Message, Page } from "../domain/models.js";
+export type EvidenceKind = "chats" | "news" | "person";
+export type EvidenceSource = Omit<MessageLocator, "message">;
+export interface EvidenceMessage {
+    locator: string;
+    fingerprint: string;
+    timestamp: string;
+    editedAt: string | null;
+    senderId: string | null;
+    senderName: string | null;
+    senderIsChat: boolean;
+    outgoing: boolean | null;
+    text: string;
+    replyTo: string | null;
+    threadId: string | null;
+    attachmentKinds: string[];
+}
+export interface EvidencePacket {
+    schemaVersion: 1;
+    id: string;
+    kind: EvidenceKind;
+    source: EvidenceSource;
+    fingerprint: string;
+    limits: {
+        messages: number;
+        bytes: number;
+    };
+    /** UTF-8 bytes of the JSON items array, including brackets and separators. */
+    contentBytes: number;
+    coverage: {
+        provided: number;
+        included: number;
+        omitted: number;
+        hasMore: boolean;
+        /** A page alone cannot establish how complete the archive is. */
+        history: "unknown";
+        truncatedBy: "messages" | "bytes" | null;
+    };
+    items: EvidenceMessage[];
+}
+export interface EvidencePacketInput {
+    kind: EvidenceKind;
+    source: EvidenceSource;
+    page: Pick<Page<Message>, "items" | "hasMore">;
+    limits?: {
+        messages?: number;
+        bytes?: number;
+    };
+}
+/** Builds from an already authorised page; preserves its order and never fetches or marks anything read. */
+export declare const prepareEvidencePacket: ({ kind, source, page, limits: requested, }: EvidencePacketInput) => EvidencePacket;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/services/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/services/evidence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAExD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AACtD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;AAE5D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,CAAC,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,OAAO,CAAA;QAChB,iEAAiE;QACjE,OAAO,EAAE,SAAS,CAAA;QAClB,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI,CAAA;KACzC,CAAA;IACD,KAAK,EAAE,eAAe,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;IACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,CAAA;IAC9C,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAUD,4GAA4G;AAC5G,eAAO,MAAM,qBAAqB,+CAK/B,mBAAmB,KAAG,cAkExB,CAAA"}

package/dist/services/evidence.js

@@ -0,0 +1,76 @@
+import { createHash, randomUUID } from "node:crypto";
+import { CliError } from "@wirecat/cli-base";
+import { formatLocator } from "../domain/locator.js";
+const hash = (value) => createHash("sha256").update(JSON.stringify(value)).digest("hex");
+const positive = (value, name, minimum = 1) => {
+    if (!Number.isSafeInteger(value) || value < minimum)
+        throw new CliError("validation_error", `${name} must be a safe integer of at least ${minimum}`);
+    return value;
+};
+/** Builds from an already authorised page; preserves its order and never fetches or marks anything read. */
+export const prepareEvidencePacket = ({ kind, source, page, limits: requested, }) => {
+    if (!["chats", "news", "person"].includes(kind))
+        throw new CliError("validation_error", "evidence kind must be chats, news or person");
+    if ([source.provider, source.account, source.chat].some((part) => !part.trim()))
+        throw new CliError("validation_error", "evidence source must name a provider, account and chat");
+    if (page.items.some((message) => message.chatId !== source.chat))
+        throw new CliError("validation_error", "every evidence message must belong to the named chat");
+    if (page.items.some((message) => !message.id.trim()))
+        throw new CliError("validation_error", "every evidence message must have an id");
+    if (new Set(page.items.map(({ id }) => id)).size !== page.items.length)
+        throw new CliError("validation_error", "an evidence page must not repeat a message id");
+    const limits = {
+        messages: positive(requested?.messages ?? 100, "evidence message limit"),
+        bytes: positive(requested?.bytes ?? 64 * 1024, "evidence byte limit", 2),
+    };
+    const scope = { provider: source.provider, account: source.account, chat: source.chat };
+    const items = [];
+    let contentBytes = 2;
+    let truncatedBy = null;
+    for (const message of page.items) {
+        if (items.length === limits.messages) {
+            truncatedBy = "messages";
+            break;
+        }
+        const parent = message.replyToId ?? message.replyTo?.id;
+        const content = {
+            locator: formatLocator({ ...scope, message: message.id }),
+            timestamp: message.timestamp,
+            editedAt: message.editedAt,
+            senderId: message.senderId,
+            senderName: message.senderName,
+            senderIsChat: message.senderIsChat ?? false,
+            outgoing: message.outgoing,
+            text: message.text,
+            replyTo: parent === undefined ? null : formatLocator({ ...scope, message: parent }),
+            threadId: message.threadId ?? null,
+            attachmentKinds: message.attachments.map(({ kind: attachmentKind }) => attachmentKind),
+        };
+        const item = { ...content, fingerprint: hash(content) };
+        const bytes = Buffer.byteLength(JSON.stringify(item), "utf8") + (items.length > 0 ? 1 : 0);
+        if (bytes > limits.bytes - contentBytes) {
+            truncatedBy = "bytes";
+            break;
+        }
+        items.push(item);
+        contentBytes += bytes;
+    }
+    const content = {
+        schemaVersion: 1,
+        kind,
+        source: scope,
+        limits,
+        contentBytes,
+        coverage: {
+            provided: page.items.length,
+            included: items.length,
+            omitted: page.items.length - items.length,
+            hasMore: page.hasMore,
+            history: "unknown",
+            truncatedBy,
+        },
+        items,
+    };
+    return { ...content, id: randomUUID(), fingerprint: hash(content) };
+};
+//# sourceMappingURL=evidence.js.map

package/dist/services/evidence.js.map

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

package/dist/services/excerpt.d.ts

@@ -0,0 +1,15 @@
+/** Words of a query worth finding in a text: no operators, no field names, nothing shorter than three letters. */
+export declare const queryWords: (query: string) => string[];
+/**
+ * About `size` characters of `text` on one line, around the first word of `query` it holds, or its start when it
+ * holds none: enough to tell a hit apart, a fraction of a whole email.
+ */
+export declare const excerpt: (text: string, query: string, size?: number) => string;
+/** A hit with its excerpt, taken from where the words were found; the text of that place is not passed on. */
+export declare const withExcerpt: <T extends {
+    text: string;
+    matchedText?: string;
+}>({ matchedText, ...hit }: T, query: string) => Omit<T, "matchedText"> & {
+    excerpt: string;
+};
+//# sourceMappingURL=excerpt.d.ts.map

package/dist/services/excerpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.d.ts","sourceRoot":"","sources":["../../src/services/excerpt.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,MAAM,EAK6B,CAAA;AAE9E;;;GAGG;AACH,eAAO,MAAM,OAAO,SAAU,MAAM,SAAS,MAAM,oBAAe,MAWjE,CAAA;AAED,8GAA8G;AAC9G,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,2BACjD,CAAC,SACnB,MAAM,KACZ,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAoE,CAAA"}

package/dist/services/excerpt.js

@@ -0,0 +1,26 @@
+/** Words of a query worth finding in a text: no operators, no field names, nothing shorter than three letters. */
+export const queryWords = (query) => query
+    .toLowerCase()
+    .split(/\s+/)
+    .map((word) => word.replace(/^[\p{L}_]+:/u, "").replace(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, ""))
+    .filter((word) => word.length > 2 && !["and", "or", "not"].includes(word));
+/**
+ * About `size` characters of `text` on one line, around the first word of `query` it holds, or its start when it
+ * holds none: enough to tell a hit apart, a fraction of a whole email.
+ */
+export const excerpt = (text, query, size = 240) => {
+    const flat = text.replace(/\s+/g, " ").trim();
+    if (flat.length <= size)
+        return flat;
+    const lower = flat.toLowerCase();
+    const found = queryWords(query)
+        .map((word) => lower.indexOf(word))
+        .filter((index) => index >= 0);
+    const at = found.length ? Math.min(...found) : 0;
+    const start = Math.max(0, Math.min(at - Math.floor(size / 3), flat.length - size));
+    const end = start + size;
+    return `${start > 0 ? "…" : ""}${flat.slice(start, end).trim()}${end < flat.length ? "…" : ""}`;
+};
+/** A hit with its excerpt, taken from where the words were found; the text of that place is not passed on. */
+export const withExcerpt = ({ matchedText, ...hit }, query) => ({ ...hit, excerpt: excerpt(matchedText ?? hit.text, query) });
+//# sourceMappingURL=excerpt.js.map

package/dist/services/excerpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.js","sourceRoot":"","sources":["../../src/services/excerpt.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAY,EAAE,CACpD,KAAK;KACF,WAAW,EAAE;KACb,KAAK,CAAC,KAAK,CAAC;KACZ,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;KAChG,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,IAAI,GAAG,GAAG,EAAU,EAAE;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7C,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAChC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;SAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;IAChC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IAClF,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAA;IACxB,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AACjG,CAAC,CAAA;AAED,8GAA8G;AAC9G,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,EAAE,WAAW,EAAE,GAAG,GAAG,EAAK,EAC1B,KAAa,EACiC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA"}

package/dist/services/file-download.d.ts

@@ -0,0 +1,55 @@
+import type { RemoteFile } from "../cli/messenger/port.js";
+import type { Id } from "../domain/models.js";
+import { batchProgress } from "./batch.js";
+import type { MessagesService } from "./messages.js";
+export interface Saved {
+    kind: string;
+    path: string;
+    bytes: number;
+    /** Only with `--all`: the file was already there from an earlier run, and was left as it was. */
+    existing?: true;
+}
+/**
+ * The files are saved whatever happens here: a store that cannot take the paths costs only the later
+ * `attachments extract`, so it warns and never fails the download.
+ */
+export declare const recordPaths: (messages: Pick<MessagesService, "keepDownloaded">, chat: string, message: Id, files: readonly RemoteFile[], saved: readonly Saved[], warn: (message: string) => void, onFailure?: (error: unknown) => void) => Promise<number>;
+/**
+ * Every file of one message, as `--all` saves them — a taken name gets the message's prefix, never
+ * overwrites — and where they went recorded in the store. For `attachments extract --download`.
+ */
+export declare const downloadMessage: (messages: Pick<MessagesService, "download" | "keepDownloaded">, chat: string, message: Id, output: string, warn: (message: string) => void) => Promise<Saved[]>;
+export declare const saveFiles: (messages: Pick<MessagesService, "keepDownloaded">, chat: string, message: Id, files: readonly RemoteFile[], output: string, { unique, warn, onSaved, batch, }: {
+    unique?: boolean;
+    warn: (message: string) => void;
+    onSaved?: (saved: Saved) => void;
+    batch?: ReturnType<typeof batchProgress>;
+}) => Promise<{
+    saved: Saved[];
+    batch: {
+        attempted: number;
+        succeeded: number;
+        failed: number;
+        errorRate: number;
+        failures: import("./batch.js").BatchFailure[];
+        stopReason?: "authentication" | "cancelled" | "error_rate" | "rate_limited" | undefined;
+        maxErrorPercent: number;
+    };
+}>;
+/**
+ * A name another person chose cannot climb out of the folder, cannot be a dot file we would then
+ * hide, and carries no control or direction character to rewrite the terminal or disguise its extension.
+ */
+export declare const safeName: (name: string | undefined, platform?: NodeJS.Platform) => string | undefined;
+/**
+ * The bytes go to a temporary name first and are then hard-linked to the real one, which fails if the
+ * name is taken — so an existing file survives, and an interrupted download leaves no half file under
+ * the name somebody will open.
+ *
+ * `unique` is for a whole chat, where two messages often carry the same file name: a taken name gets the
+ * message's own prefix, and when that is taken too the file was saved by an earlier run and is `existing`.
+ */
+export declare const save: (file: RemoteFile, directory: string, fallbackName: string, { unique }?: {
+    unique?: boolean;
+}) => Promise<Saved>;
+//# sourceMappingURL=file-download.d.ts.map

package/dist/services/file-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-download.d.ts","sourceRoot":"","sources":["../../src/services/file-download.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,QAAQ,CAAC,EAAE,IAAI,CAAA;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,aACZ,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,QAC3C,MAAM,WACH,EAAE,SACJ,SAAS,UAAU,EAAE,SACrB,SAAS,KAAK,EAAE,QACjB,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,cACnB,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KACnC,OAAO,CAAC,MAAM,CAchB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,aAChB,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,gBAAgB,CAAC,QACxD,MAAM,WACH,EAAE,UACH,MAAM,QACR,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAC9B,OAAO,CAAC,KAAK,EAAE,CAUjB,CAAA;AAED,eAAO,MAAM,SAAS,aACV,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,QAC3C,MAAM,WACH,EAAE,SACJ,SAAS,UAAU,EAAE,UACpB,MAAM,qCAMX;IACD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;CACzC;;;;;;;;;;;EAuBF,CAAA;AAkBD;;;GAGG;AACH,eAAO,MAAM,QAAQ,SAAU,MAAM,GAAG,SAAS,iCAAgC,MAAM,GAAG,SAYzF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,SACT,UAAU,aACL,MAAM,gBACH,MAAM,eACA;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KACvC,OAAO,CAAC,KAAK,CAoCf,CAAA"}

package/dist/services/file-download.js

@@ -0,0 +1,141 @@
+import { createWriteStream, mkdirSync } from "node:fs";
+import { link, rm } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { CliError } from "@wirecat/cli-base";
+import { batchProgress } from "./batch.js";
+/**
+ * The files are saved whatever happens here: a store that cannot take the paths costs only the later
+ * `attachments extract`, so it warns and never fails the download.
+ */
+export const recordPaths = async (messages, chat, message, files, saved, warn, onFailure) => {
+    const downloaded = saved.map((one, index) => ({
+        kind: one.kind,
+        path: one.path,
+        ...(files[index]?.name === undefined ? {} : { name: files[index]?.name }),
+        ...(files[index]?.position === undefined ? {} : { position: files[index]?.position }),
+    }));
+    try {
+        return await messages.keepDownloaded(chat, message, downloaded);
+    }
+    catch (error) {
+        onFailure?.(error);
+        warn(`not recorded in the local store where message ${message}'s files went: ${error.message}`);
+        return 0;
+    }
+};
+/**
+ * Every file of one message, as `--all` saves them — a taken name gets the message's prefix, never
+ * overwrites — and where they went recorded in the store. For `attachments extract --download`.
+ */
+export const downloadMessage = async (messages, chat, message, output, warn) => {
+    const { files } = await messages.download(chat, message);
+    mkdirSync(output, { recursive: true });
+    const result = await saveFiles(messages, chat, message, files, output, { unique: true, warn });
+    if (result.batch.failed > 0)
+        throw new CliError("provider_error", "some attachments failed; completed downloads are retained", {
+            batch: result.batch,
+            saved: result.saved,
+        });
+    return result.saved;
+};
+export const saveFiles = async (messages, chat, message, files, output, { unique = false, warn, onSaved, batch = batchProgress(), }) => {
+    const saved = [];
+    const successful = [];
+    for (const [index, file] of files.entries()) {
+        if (batch.stopped)
+            break;
+        try {
+            const one = await save(file, output, `${message}-${index + 1}`, { unique });
+            saved.push(one);
+            successful.push(file);
+            batch.ok();
+            onSaved?.(one);
+        }
+        catch (error) {
+            const issue = batch.fail(message, "download", error, (file.position ?? index) + 1);
+            warn(`message ${message}, attachment ${(file.position ?? index) + 1}: ${issue.code} — ${issue.actions.map((action) => action.message).join(" ")}`);
+        }
+    }
+    await recordPaths(messages, chat, message, successful, saved, warn, (error) => batch.fail(message, "record_downloads", error));
+    return { saved, batch: batch.result() };
+};
+const EXTENSIONS = {
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/webp": "webp",
+    "image/gif": "gif",
+    "video/mp4": "mp4",
+    "video/webm": "webm",
+    "audio/mpeg": "mp3",
+    "audio/ogg": "ogg",
+    "audio/mp4": "m4a",
+    "application/pdf": "pdf",
+};
+/** Telegram sends a photo with no name and no type; it is always a JPEG. */
+const BY_KIND = { photo: "jpg" };
+/**
+ * A name another person chose cannot climb out of the folder, cannot be a dot file we would then
+ * hide, and carries no control or direction character to rewrite the terminal or disguise its extension.
+ */
+export const safeName = (name, platform = process.platform) => {
+    let plain = name === undefined
+        ? ""
+        : basename(name.replaceAll("\\", "/"))
+            .replace(/[\p{Cc}​-‏‪-‮⁦-⁩]/gu, "")
+            .replace(/^\.+/, "");
+    if (platform === "win32") {
+        plain = plain.replace(/[<>:"|?*]/g, "_").replace(/[. ]+$/, "");
+        if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(plain))
+            return undefined;
+    }
+    return plain === "" ? undefined : plain;
+};
+/**
+ * The bytes go to a temporary name first and are then hard-linked to the real one, which fails if the
+ * name is taken — so an existing file survives, and an interrupted download leaves no half file under
+ * the name somebody will open.
+ *
+ * `unique` is for a whole chat, where two messages often carry the same file name: a taken name gets the
+ * message's own prefix, and when that is taken too the file was saved by an earlier run and is `existing`.
+ */
+export const save = async (file, directory, fallbackName, { unique = false } = {}) => {
+    const own = safeName(file.name);
+    const fileName = () => {
+        const extension = EXTENSIONS[file.mime ?? ""] ?? BY_KIND[file.kind];
+        return own ?? (extension ? `${fallbackName}.${extension}` : fallbackName);
+    };
+    const partial = join(directory, `.${fileName()}.${process.pid}.part`);
+    let bytes = 0;
+    const counting = new Transform({
+        transform(chunk, _encoding, done) {
+            bytes += chunk.length;
+            done(null, chunk);
+        },
+    });
+    try {
+        await pipeline(Readable.from(file.bytes()), counting, createWriteStream(partial, { flags: "wx", mode: 0o600 }));
+        // Lazy HTTP downloads learn MIME while reading bytes.
+        const name = fileName();
+        const names = unique && own ? [name, `${fallbackName}-${own}`] : [name];
+        for (const candidate of names) {
+            const path = resolve(join(directory, candidate));
+            const taken = await link(partial, path).then(() => false, (error) => {
+                if (error.code === "EEXIST")
+                    return true;
+                throw error;
+            });
+            if (!taken)
+                return { kind: file.kind, path, bytes };
+        }
+        const path = resolve(join(directory, names.at(-1) ?? name));
+        if (unique)
+            return { kind: file.kind, path, bytes, existing: true };
+        throw new CliError("validation_error", `${path} already exists — nothing was overwritten; choose --output-dir`);
+    }
+    finally {
+        await rm(partial, { force: true });
+    }
+};
+//# sourceMappingURL=file-download.js.map

package/dist/services/file-download.js.map

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

package/dist/services/folders.d.ts

@@ -0,0 +1,52 @@
+import type { Chat, Folder, FolderKind, FolderSkip, Id } from "../domain/models.js";
+import { type Operated } from "../sends/guarded.js";
+import { type ServiceDeps } from "./deps.js";
+/** Chats as typed; `include` and `skip` replace what the folder had. */
+export interface FolderRulesEdit {
+    emoji?: string;
+    include?: FolderKind[];
+    skip?: FolderSkip[];
+    exclude?: string[];
+    pin?: string[];
+}
+export interface FolderChat {
+    id: Id;
+    title: string | null;
+    kind: Chat["kind"] | null;
+}
+export type FolderShown = Omit<Folder, "chatIds" | "excludedChatIds" | "pinnedChatIds"> & {
+    chats: FolderChat[];
+    pinned: FolderChat[];
+    excluded: FolderChat[];
+};
+export interface FolderEdit extends FolderRulesEdit {
+    title?: string;
+    add?: string[];
+    remove?: string[];
+}
+/** The owner's chat folders. Nobody else sees them, but they change the owner's own app, so each change is guarded. */
+export interface FoldersService {
+    list(): Promise<Folder[]>;
+    /** `folder` is its id, or its title exactly; its chats by name. */
+    show(folder: string): Promise<FolderShown>;
+    create(title: string, chats: string[], rules?: FolderRulesEdit): Promise<Operated<{
+        folder: Folder;
+    }>>;
+    /** `folder` is its id, or its title exactly. */
+    update(folder: string, edit: FolderEdit): Promise<Operated<{
+        folder: Folder;
+    }>>;
+    delete(folder: string): Promise<Operated<{
+        folderId: string;
+    }>>;
+    /** The folders named go first, in this order; the others keep theirs after them. */
+    order(folders: string[]): Promise<Operated<{
+        folders: Pick<Folder, "id" | "title">[];
+    }>>;
+    /** A folder shared by a link: every chat in it is joined. */
+    join(link: string): Promise<Operated<{
+        folder: Folder;
+    }>>;
+}
+export declare const foldersService: (deps: ServiceDeps) => FoldersService;
+//# sourceMappingURL=folders.d.ts.map

package/dist/services/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/services/folders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAe,UAAU,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAChG,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEjE,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,WAAW,CAAA;AAEzD,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,EAAE,CAAA;IACN,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,eAAe,CAAC,GAAG;IACxF,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,QAAQ,EAAE,UAAU,EAAE,CAAA;CACvB,CAAA;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,uHAAuH;AACvH,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACzB,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC1C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACtG,gDAAgD;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC/E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC/D,oFAAoF;IACpF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IACxF,6DAA6D;IAC7D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAC1D;AAED,eAAO,MAAM,cAAc,SAAU,WAAW,KAAG,cAkKlD,CAAA"}