@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/services/admin.js

@@ -0,0 +1,229 @@
+import { CliError } from "@wirecat/cli-base";
+import { capability } from "../cli/messenger/port.js";
+import { sendTime } from "../domain/send-time.js";
+import { guardedWrite } from "../sends/guarded.js";
+import { newOperationId } from "../sends/send-id.js";
+export const adminService = (deps) => {
+    const online = async (command) => {
+        if (deps.offline)
+            throw new CliError("validation_error", `\`${command}\` changes a chat; not with --offline`);
+        return deps.connection();
+    };
+    return {
+        create: async ({ title, people, channel }) => {
+            if (title.trim() === "")
+                throw new CliError("validation_error", "a group needs a title");
+            const connection = await online("chats create");
+            const create = capability(connection, "createGroup", "create a group");
+            const personIds = people.length === 0 ? [] : await capability(connection, "people", "find people")(people);
+            const operationId = newOperationId();
+            const chat = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "chat", action: "create", personIds, people: personIds.length }, () => create(title.trim(), personIds, { channel }), (made) => ({ chatId: made.id }));
+            return { operationId, chat };
+        },
+        join: async (link) => {
+            const connection = await online("chats join");
+            const join = capability(connection, "join", "join a chat by its link");
+            const operationId = newOperationId();
+            const joined = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "chat", action: "join" }, () => join(link.trim()), (answer) => ("requested" in answer ? {} : { chatId: answer.id }));
+            return "requested" in joined ? { operationId, requested: true } : { operationId, chat: joined };
+        },
+        leave: async (chat) => {
+            const connection = await online("chats leave");
+            const leave = capability(connection, "leave", "leave a chat");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "leave" }, () => leave(chatId));
+            return { operationId, chatId };
+        },
+        deleteChat: async (chat) => {
+            const connection = await online("chats delete");
+            const remove = capability(connection, "deleteChat", "delete a chat");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "delete" }, () => remove(chatId));
+            return { operationId, chatId };
+        },
+        clearHistory: async (chat) => {
+            const connection = await online("chats clear");
+            const clear = capability(connection, "clearHistory", "clear a chat's history");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "clear" }, () => clear(chatId));
+            return { operationId, chatId };
+        },
+        update: async (chat, change) => {
+            const settings = Object.keys(change.settings ?? {}).length;
+            const profile = change.title !== undefined || change.description !== undefined || change.photo !== undefined;
+            if (!profile && settings === 0) {
+                throw new CliError("validation_error", "nothing to change — give a title, a description, a photo or a setting");
+            }
+            if (change.title !== undefined && change.title.trim() === "") {
+                throw new CliError("validation_error", "a group needs a title");
+            }
+            const connection = await online("chats update");
+            const update = capability(connection, "updateGroup", "change a group");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            const action = profile ? "update" : "settings";
+            const card = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action }, () => update(chatId, change));
+            return { operationId, chat: card };
+        },
+        link: async (chat) => {
+            const group = await capability(await online("chats link show"), "group", "read a group")(chat);
+            if (group.link === null) {
+                throw new CliError("not_found", `${group.title ?? group.id} shows you no invite link — only admins, or members when the group allows it`);
+            }
+            return { chatId: group.id, title: group.title, link: group.link };
+        },
+        resetLink: async (chat) => {
+            const connection = await online("chats link reset");
+            const reset = capability(connection, "resetInviteLink", "replace an invite link");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            const card = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "link.reset" }, () => reset(chatId));
+            return { operationId, chat: card };
+        },
+        createLink: async (chat, { approval, expires, maxUses }) => {
+            const expiresAt = linkLimits({ approval, expires, maxUses });
+            const connection = await online("chats link create");
+            const create = capability(connection, "createInviteLink", "make another invite link");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            const made = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "link.create" }, () => create(chatId, {
+                approval,
+                ...(expiresAt === undefined ? {} : { expiresAt }),
+                ...(maxUses === undefined ? {} : { maxUses }),
+            }));
+            return { operationId, chatId, ...made };
+        },
+        requests: async (chat, window) => {
+            if (deps.offline)
+                throw new CliError("validation_error", "join requests are read from the messenger; not with --offline");
+            // Telegram searches the whole pending list or one link's, never both (mtcute getInviteLinkMembers).
+            if (window.search !== undefined && window.link !== undefined)
+                throw new CliError("validation_error", "--search and --link narrow the list two ways; use one");
+            if (window.search?.trim() === "" || window.link?.trim() === "")
+                throw new CliError("validation_error", "--search and --link need a value");
+            const connection = await deps.connection();
+            const list = capability(connection, "joinRequests", "read join requests");
+            const { id: chatId } = await connection.resolve(chat);
+            return { chatId, ...(await list(chatId, window)) };
+        },
+        answerRequest: async (chat, person, accept) => {
+            const connection = await online(`chats requests ${accept ? "accept" : "decline"}`);
+            const answer = capability(connection, "answerJoinRequest", "answer join requests");
+            const [personId] = await capability(connection, "people", "find people")([person]);
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            // The recipient list names the group only: whoever asked to join cannot be on it in advance.
+            const { already } = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: accept ? "requests.accept" : "requests.decline", people: 1 }, () => answer(chatId, personId, accept));
+            return { operationId, chatId, personId: personId, accepted: accept, already };
+        },
+        answerAllRequests: async (chat, accept, { link }) => {
+            const connection = await online(`chats requests ${accept ? "accept" : "decline"} --all`);
+            const list = capability(connection, "joinRequests", "read join requests");
+            const answerAll = capability(connection, "answerAllJoinRequests", "answer every join request at once");
+            const { id: chatId } = await connection.resolve(chat);
+            const page = await list(chatId, { limit: 100, ...(link === undefined ? {} : { link }) });
+            const counted = page.total ?? page.items.length;
+            if (page.total === undefined && page.hasMore)
+                throw new CliError("validation_error", "too many requests to count; answer them by person, or by --link");
+            if (counted === 0)
+                return { chatId, accepted: accept, counted };
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, {
+                operationId,
+                chatId,
+                kind: "chat",
+                action: accept ? "requests.accept" : "requests.decline",
+                count: counted,
+                people: counted,
+            }, () => answerAll(chatId, accept, link));
+            return { operationId, chatId, accepted: accept, counted };
+        },
+        links: async (chat, window) => {
+            if (deps.offline)
+                throw new CliError("validation_error", "invite links are read from the messenger; not with --offline");
+            const connection = await deps.connection();
+            const list = capability(connection, "inviteLinks", "list invite links");
+            const { id: chatId } = await connection.resolve(chat);
+            return { chatId, ...(await list(chatId, window)) };
+        },
+        revokeLink: async (chat, link) => {
+            if (link.trim() === "")
+                throw new CliError("validation_error", "which link? give it as `chats link list` shows it");
+            const connection = await online("chats link revoke");
+            const revoke = capability(connection, "revokeInviteLink", "revoke an invite link");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            const answer = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "link.revoke" }, () => revoke(chatId, link.trim()));
+            return { operationId, chatId, ...answer };
+        },
+        updateLink: async (chat, link, { approval, expires, maxUses }) => {
+            if (link.trim() === "")
+                throw new CliError("validation_error", "which link? give it as `chats link list` shows it");
+            if (approval === undefined && expires === undefined && maxUses === undefined)
+                throw new CliError("validation_error", "nothing to change: give --approval, --no-approval, --expire-time or --max-uses");
+            const limited = linkLimits({ approval, expires: expires === "never" ? undefined : expires, maxUses });
+            const expiresAt = expires === "never" ? null : limited;
+            const connection = await online("chats link update");
+            const update = capability(connection, "updateInviteLink", "change an invite link");
+            const { id: chatId } = await connection.resolve(chat);
+            const change = {
+                ...(approval === undefined ? {} : { approval }),
+                ...(expiresAt === undefined ? {} : { expiresAt }),
+                ...(maxUses === undefined ? {} : { maxUses }),
+            };
+            const operationId = newOperationId();
+            const answer = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "link.update" }, () => update(chatId, link.trim(), change));
+            return { operationId, chatId, ...answer };
+        },
+        addMembers: async (chat, people, options) => {
+            const connection = await online("chats members add");
+            const add = capability(connection, "addMembers", "add people to a group");
+            const personIds = await capability(connection, "people", "find people")(people);
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            const { notAdded } = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "members.add", personIds, people: personIds.length }, () => add(chatId, personIds, options));
+            return { operationId, chatId, added: personIds.filter((id) => !notAdded.includes(id)), notAdded };
+        },
+        removeMembers: async (chat, people) => {
+            const connection = await online("chats members remove");
+            const remove = capability(connection, "removeMembers", "remove people from a group");
+            const personIds = await capability(connection, "people", "find people")(people);
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "members.remove", people: personIds.length }, () => remove(chatId, personIds));
+            return { operationId, chatId, removed: personIds };
+        },
+        addAdmin: async (chat, person, rights) => {
+            if (rights.length === 0)
+                throw new CliError("validation_error", "an admin needs at least one right");
+            const connection = await online("chats admins add");
+            const add = capability(connection, "addAdmin", "make someone an admin");
+            const [personId] = await capability(connection, "people", "find people")([person]);
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "admins.add" }, () => add(chatId, personId, rights));
+            return { operationId, chatId, personId: personId, rights };
+        },
+        removeAdmin: async (chat, person) => {
+            const connection = await online("chats admins remove");
+            const remove = capability(connection, "removeAdmin", "take admin rights back");
+            const [personId] = await capability(connection, "people", "find people")([person]);
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "admins.remove" }, () => remove(chatId, personId));
+            return { operationId, chatId, personId: personId };
+        },
+    };
+};
+const linkLimits = ({ approval, expires, maxUses, }) => {
+    if (maxUses !== undefined && (!Number.isInteger(maxUses) || maxUses < 1 || maxUses > 99_999))
+        throw new CliError("validation_error", "--max-uses takes a whole number from 1 to 99999");
+    // Measured on Telegram 2026-10-08: turning approval on drops the limit, and says nothing.
+    if (approval === true && maxUses !== undefined)
+        throw new CliError("validation_error", "a link that asks first takes no use limit; give --approval or --max-uses");
+    return expires === undefined ? undefined : sendTime(expires, Date.now(), "--expire-time");
+};
+//# sourceMappingURL=admin.js.map

package/dist/services/admin.js.map

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

package/dist/services/agenda.d.ts

@@ -0,0 +1,51 @@
+import type { ChatKind } from "../domain/models.js";
+import { type ChatActivity, type TaskDetails } from "../store/store.js";
+import type { ServiceDeps } from "./deps.js";
+export interface AgendaOptions {
+    /** ms: a task due within this is listed. */
+    dueWithin?: number;
+    /** ms: a chat where the owner wrote last and nobody answered for this long is listed. */
+    waiting?: number;
+    /** ms: a chat where someone else wrote last and the owner did not answer for this long is listed. */
+    unanswered?: number;
+    /** ms: chats silent for longer than this are not looked at: they ended, they did not go quiet. */
+    within?: number;
+    kinds?: readonly ChatKind[];
+}
+/** Why a task is on the agenda; a task planned for later and not due soon is not on it. */
+export type AgendaReason = "overdue" | "due" | "check" | "unplanned";
+export interface AgendaTask extends Pick<TaskDetails, "id" | "key" | "title" | "type" | "source" | "dueAt" | "nextCheckAt" | "createdAt"> {
+    reasons: AgendaReason[];
+}
+export interface AgendaChat extends Omit<ChatActivity, "lastMessageId"> {
+    /** The newest message, as a locator to read around; never its text. `null` while it is not stored. */
+    lastMessage: string | null;
+    /** Open tasks whose source is in this chat. */
+    openTasks: string[];
+}
+/**
+ * What needs a look today, from the local store alone and without one message's text: the agent
+ * reads only what this names. `stale` says the store saved nothing for a day — a chat may look quiet
+ * only because nothing was synced; `unsynced` names the chats the store is behind on.
+ */
+export interface Agenda {
+    at: string;
+    account: string;
+    storedAt: string | null;
+    stale: boolean;
+    tasks: AgendaTask[];
+    /** Someone else wrote last, and the owner has not answered. */
+    owed: AgendaChat[];
+    /** The owner wrote last, and nobody answered. */
+    waiting: AgendaChat[];
+    /**
+     * The chat list says these moved, and their newest message is not stored: who wrote last is unknown
+     * until they are read. Never dropped, or a chat nobody synced would never come up.
+     */
+    unsynced: AgendaChat[];
+}
+export interface AgendaService {
+    show(options?: AgendaOptions): Promise<Agenda>;
+}
+export declare const agendaService: (deps: ServiceDeps, now?: () => number) => AgendaService;
+//# sourceMappingURL=agenda.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agenda.d.ts","sourceRoot":"","sources":["../../src/services/agenda.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,KAAK,YAAY,EAAY,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAK5C,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CAC5B;AAED,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAA;AAEpE,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,CAAC;IAC7G,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC;IACrE,sGAAsG;IACtG,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,+DAA+D;IAC/D,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,iDAAiD;IACjD,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB;;;OAGG;IACH,QAAQ,EAAE,UAAU,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/C;AAED,eAAO,MAAM,aAAa,SAAU,WAAW,QAAO,MAAM,MAAM,KAAc,aAwD9E,CAAA"}

package/dist/services/agenda.js

@@ -0,0 +1,82 @@
+import { formatLocator, isLocator, parseLocator } from "../domain/locator.js";
+import { inboxKey } from "../store/store.js";
+import { taskAccount } from "./task-rules.js";
+const DAY = 86_400_000;
+export const agendaService = (deps, now = Date.now) => ({
+    show: async ({ dueWithin = DAY, waiting = 7 * DAY, unanswered = DAY, within = 30 * DAY, kinds } = {}) => {
+        const [store, account] = [await deps.store(), await deps.account()];
+        const at = now();
+        const open = await store.tasks
+            .find({ project: inboxKey(taskAccount(account)), status: "open", limit: 500 })
+            .catch((error) => {
+            // An account that never had a task has no inbox project yet.
+            if (error instanceof Error && "code" in error && error.code === "not_found")
+                return [];
+            throw error;
+        });
+        const tasks = open
+            .map((task) => ({ task, reasons: reasonsOf(task, at, dueWithin) }))
+            .filter(({ reasons }) => reasons.length > 0)
+            .sort((a, b) => urgency(a.task) - urgency(b.task))
+            .map(({ task, reasons }) => ({
+            id: task.id,
+            key: task.key,
+            title: task.title,
+            type: task.type,
+            source: task.source,
+            dueAt: task.dueAt,
+            nextCheckAt: task.nextCheckAt,
+            createdAt: task.createdAt,
+            reasons,
+        }));
+        const activity = await store.chatActivity(account, at - within);
+        const wanted = new Set(kinds ?? ["dialog", "group"]);
+        const chats = activity.chats
+            .filter((chat) => wanted.has(chat.kind))
+            .map(({ lastMessageId, ...chat }) => ({
+            ...chat,
+            lastMessage: lastMessageId === null
+                ? null
+                : formatLocator({
+                    provider: account.provider,
+                    account: account.account,
+                    chat: chat.chatId,
+                    message: lastMessageId,
+                }),
+            openTasks: open.filter((task) => chatOf(task.source) === chat.chatId).map((task) => task.id),
+        }));
+        const silentFor = (chat) => at - Date.parse(chat.lastMessageAt);
+        return {
+            at: new Date(at).toISOString(),
+            account: taskAccount(account),
+            storedAt: activity.storedAt,
+            stale: activity.storedAt === null || at - Date.parse(activity.storedAt) > DAY,
+            tasks,
+            owed: chats.filter((chat) => chat.lastFromOwner === false && silentFor(chat) >= unanswered),
+            waiting: chats.filter((chat) => chat.lastFromOwner === true && silentFor(chat) >= waiting),
+            unsynced: chats.filter((chat) => chat.lastMessage === null),
+        };
+    },
+});
+const reasonsOf = (task, at, dueWithin) => {
+    const due = task.dueAt === null ? undefined : Date.parse(task.dueAt);
+    const check = task.nextCheckAt === null ? undefined : Date.parse(task.nextCheckAt);
+    const reasons = [];
+    if (due !== undefined && due <= at)
+        reasons.push("overdue");
+    else if (due !== undefined && due <= at + dueWithin)
+        reasons.push("due");
+    if (check !== undefined && check <= at)
+        reasons.push("check");
+    if (due === undefined && check === undefined)
+        reasons.push("unplanned");
+    return reasons;
+};
+/** The earliest date a task names; one with none waits since it was opened. */
+const urgency = (task) => {
+    const dates = [task.dueAt, task.nextCheckAt].filter((one) => one !== null).map(Date.parse);
+    return dates.length > 0 ? Math.min(...dates) : Date.parse(task.createdAt);
+};
+/** The chat a message locator names; a note or document source belongs to no chat. */
+const chatOf = (source) => source !== null && isLocator(source) ? parseLocator(source).chat : undefined;
+//# sourceMappingURL=agenda.js.map

package/dist/services/agenda.js.map

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

package/dist/services/archive-gaps.d.ts

@@ -0,0 +1,64 @@
+import type { Id } from "../domain/models.js";
+import { type AccountKey, type Range } from "../store/store.js";
+import type { ServiceDeps } from "./deps.js";
+import { type CatchUpOptions, type CatchUpResult } from "./search-catchup.js";
+export declare const GAP_BOUNDS: {
+    maxGaps: number;
+    limit: number;
+    timeMs: number;
+};
+export interface GapPlan {
+    version: 1;
+    scope: "interior";
+    account: AccountKey;
+    chat: Id;
+    ordering: "id" | "time";
+    held: Range[];
+    gaps: Range[];
+    unknown: {
+        older: boolean;
+        newer: true;
+    };
+    fingerprint: string;
+    limits: {
+        maxGaps: number;
+        limit: number;
+        timeMs: number;
+        pageSize: number;
+    };
+}
+export interface RepairOptions {
+    catchUp?: CatchUpOptions | false;
+    maxGaps?: number;
+    limit?: number;
+    timeMs?: number;
+    pageSize?: number;
+    pauseMs?: number;
+    fingerprint?: string;
+    signal?: AbortSignal;
+    note?: (line: string) => void;
+    onPage?: (progress: {
+        fetched: number;
+        chatId: string;
+        oldest: number;
+    }) => void;
+}
+export interface GapRepair {
+    version: 1;
+    scope: "interior";
+    chat: Id;
+    before: GapPlan;
+    after: GapPlan;
+    repaired: Range[];
+    fetched: number;
+    requests: number;
+    complete: boolean;
+    prepared?: CatchUpResult;
+    stopped?: "bound" | "partial_or_inaccessible" | "fetch_failed";
+}
+export declare const validateRepair: (messenger: ServiceDeps["messenger"], options: RepairOptions) => void;
+export declare const gapsService: (deps: ServiceDeps) => {
+    plan: (chat: string) => Promise<GapPlan>;
+    repair: (chat: string, options?: RepairOptions) => Promise<GapRepair>;
+};
+//# sourceMappingURL=archive-gaps.d.ts.map

package/dist/services/archive-gaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-gaps.d.ts","sourceRoot":"","sources":["../../src/services/archive-gaps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,KAAK,UAAU,EAAmB,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAkC,MAAM,qBAAqB,CAAA;AAE7G,eAAO,MAAM,UAAU;IAAK,OAAO;IAAK,KAAK;IAAO,MAAM;CAAU,CAAA;AACpE,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,UAAU,CAAA;IACjB,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,EAAE,EAAE,CAAA;IACR,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;IACvB,IAAI,EAAE,KAAK,EAAE,CAAA;IACb,IAAI,EAAE,KAAK,EAAE,CAAA;IACb,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAA;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7E;AACD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACjF;AACD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,UAAU,CAAA;IACjB,IAAI,EAAE,EAAE,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,KAAK,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,yBAAyB,GAAG,cAAc,CAAA;CAC/D;AACD,eAAO,MAAM,cAAc,cAAe,WAAW,CAAC,WAAW,CAAC,WAAW,aAAa,SAgBzF,CAAA;AAED,eAAO,MAAM,WAAW,SAAU,WAAW;iBACjB,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;mBAwBvB,MAAM,YAAW,aAAa,KAAQ,OAAO,CAAC,SAAS,CAAC;CAoGrF,CAAA"}

package/dist/services/archive-gaps.js

@@ -0,0 +1,146 @@
+import { createHash, randomUUID } from "node:crypto";
+import { CliError } from "@wirecat/cli-base";
+import { historyStartKey } from "../store/store.js";
+import { abortable, archiveService, FETCHING } from "./archive.js";
+import { storedChatId } from "./messages.js";
+import { catchUpSearch, validateCatchUp } from "./search-catchup.js";
+export const GAP_BOUNDS = { maxGaps: 5, limit: 500, timeMs: 30_000 };
+export const validateRepair = (messenger, options) => {
+    const maxGaps = options.maxGaps ?? GAP_BOUNDS.maxGaps;
+    const limit = options.limit ?? GAP_BOUNDS.limit;
+    const timeMs = options.timeMs ?? GAP_BOUNDS.timeMs;
+    const fetching = messenger.fetching ?? FETCHING;
+    const pageSize = options.pageSize ?? fetching.page;
+    for (const [name, value, maximum] of [
+        ["max-gaps", maxGaps, 100],
+        ["limit", limit, 10_000],
+        ["repair-time", timeMs, 300_000],
+        ["page-size", pageSize, fetching.maxPageSize ?? fetching.page],
+    ])
+        if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
+            throw new CliError("validation_error", `${name} must be between 1 and ${maximum}`);
+    if (!Number.isSafeInteger(options.pauseMs ?? 0) || (options.pauseMs ?? 0) < 0)
+        throw new CliError("validation_error", "pause must not be negative");
+};
+export const gapsService = (deps) => {
+    const plan = async (chat) => {
+        const store = await deps.store();
+        const account = await deps.account();
+        const chatId = await storedChatId(deps.messenger, chat, store, account);
+        const ordering = (deps.messenger.fetching ?? FETCHING).orderBy ?? "id";
+        const held = await store.ranges(account, chatId);
+        const gaps = held.slice(1).flatMap((range, index) => {
+            const prior = held[index];
+            return prior && prior.to + 1 < range.from ? [{ from: prior.to + 1, to: range.from - 1 }] : [];
+        });
+        const knownStart = await store.syncState(account, historyStartKey(chatId));
+        const start = knownStart === null ? NaN : Number(knownStart?.value);
+        const unknown = { older: !Number.isSafeInteger(start) || !held[0] || held[0].from > start, newer: true };
+        const identity = { account, chat: chatId, ordering, held };
+        return {
+            version: 1,
+            scope: "interior",
+            ...identity,
+            limits: { ...GAP_BOUNDS, pageSize: (deps.messenger.fetching ?? FETCHING).page },
+            gaps,
+            unknown,
+            fingerprint: createHash("sha256").update(JSON.stringify(identity)).digest("hex"),
+        };
+    };
+    const repair = async (chat, options = {}) => {
+        const maxGaps = options.maxGaps ?? GAP_BOUNDS.maxGaps;
+        const limit = options.limit ?? GAP_BOUNDS.limit;
+        const timeMs = options.timeMs ?? GAP_BOUNDS.timeMs;
+        const fetching = deps.messenger.fetching ?? FETCHING;
+        const pageSize = options.pageSize ?? fetching.page;
+        validateRepair(deps.messenger, options);
+        const prepare = options.catchUp ?? (deps.searchCatchUp ? {} : false);
+        if (prepare)
+            validateCatchUp(deps, prepare);
+        deps.guard.check({ chatId: null, key: "store.gaps.repair" }, { reserve: false });
+        const before = await plan(chat);
+        if (options.fingerprint !== undefined && options.fingerprint !== before.fingerprint)
+            throw new CliError("validation_error", "the gap plan changed; inspect it again before repairing");
+        const store = await deps.store();
+        const holder = randomUUID();
+        if (!(await store.claim(before.account, before.chat, "gaps", holder, timeMs + 5000)))
+            throw new CliError("validation_error", "another gap repair holds this chat; retry after it finishes");
+        const started = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeMs);
+        const signal = options.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
+        let fetched = 0;
+        let requests = 0;
+        const repaired = [];
+        let stopped;
+        try {
+            for (let round = 0; round < maxGaps; round += 1) {
+                const current = await plan(before.chat);
+                const gap = current.gaps.at(-1);
+                if (!gap)
+                    break;
+                if (signal.aborted || fetched >= limit) {
+                    stopped = "bound";
+                    break;
+                }
+                let result;
+                let windowFetched = 0;
+                try {
+                    result = await abortable(() => archiveService(deps).fetch(before.chat, {
+                        window: gap,
+                        onRequest: () => {
+                            requests += 1;
+                        },
+                        limit: limit - fetched,
+                        pageSize,
+                        pauseMs: options.pauseMs ?? 1000,
+                        catchUp: false,
+                        stop: signal,
+                        note: options.note ?? (() => { }),
+                        onPage: (progress) => {
+                            windowFetched = progress.fetched;
+                            options.onPage?.({ ...progress, fetched: fetched + windowFetched });
+                        },
+                    }), signal);
+                }
+                catch {
+                    fetched += windowFetched;
+                    stopped = signal.aborted ? "bound" : "fetch_failed";
+                    break;
+                }
+                fetched += result.fetched;
+                if (!result.windowComplete) {
+                    stopped = signal.aborted || fetched >= limit ? "bound" : "partial_or_inaccessible";
+                    break;
+                }
+                repaired.push(gap);
+            }
+            const after = await plan(before.chat);
+            const remainingMs = timeMs - (Date.now() - started);
+            const prepared = !prepare
+                ? undefined
+                : remainingMs <= 0 || signal.aborted
+                    ? { complete: false, reason: "time_or_abort_bound" }
+                    : await catchUpSearch(deps, before.chat, { ...prepare, timeMs: Math.min(prepare.timeMs ?? 30_000, remainingMs) }, signal);
+            return {
+                version: 1,
+                scope: "interior",
+                chat: before.chat,
+                before,
+                after,
+                repaired,
+                fetched,
+                requests,
+                complete: after.gaps.length === 0,
+                ...(prepared === undefined ? {} : { prepared }),
+                ...(stopped ? { stopped } : after.gaps.length ? { stopped: "bound" } : {}),
+            };
+        }
+        finally {
+            clearTimeout(timer);
+            await store.release(before.account, before.chat, "gaps", holder);
+        }
+    };
+    return { plan, repair };
+};
+//# sourceMappingURL=archive-gaps.js.map