@wirecat/cli-core 0.543.0 → 0.545.0

package/dist/store/sqlite/history-skips.js

@@ -0,0 +1,95 @@
+/**
+ * The history limits' record of a chat, kept in the chat row's `metadata` under this key so no store version is
+ * needed; `Chat.providerMetadata` leaves it out.
+ */
+export const HISTORY_KEY = "$history";
+const objectOf = (text) => {
+    if (typeof text !== "string")
+        return {};
+    try {
+        const value = JSON.parse(text);
+        return value !== null && typeof value === "object" && !Array.isArray(value)
+            ? value
+            : {};
+    }
+    catch {
+        return {};
+    }
+};
+const recordOf = (metadata) => {
+    const value = objectOf(metadata)[HISTORY_KEY];
+    return value !== null && typeof value === "object" ? value : {};
+};
+const rowOf = ({ database }, accountKey, chatId) => database
+    .prepare("SELECT id, kind, participants_count, metadata FROM chats WHERE account_id = ? AND external_id = ?")
+    .get(accountKey, chatId);
+const update = (context, id, metadata, change) => {
+    const all = objectOf(metadata);
+    const next = change(recordOf(metadata));
+    if (next.skipped === undefined && !next.included)
+        delete all[HISTORY_KEY];
+    else
+        all[HISTORY_KEY] = next;
+    const text = Object.keys(all).length === 0 ? null : JSON.stringify(all);
+    context.database.prepare("UPDATE chats SET metadata = ?, updated_at = ? WHERE id = ?").run(text, context.now(), id);
+};
+export const historyShapes = (context, accountKey, chatIds) => {
+    const shapes = new Map();
+    for (const chatId of new Set(chatIds)) {
+        const row = rowOf(context, accountKey, chatId);
+        if (!row)
+            continue;
+        shapes.set(chatId, {
+            kind: String(row.kind),
+            participantsCount: row.participants_count == null ? null : Number(row.participants_count),
+            included: recordOf(row.metadata).included === true,
+        });
+    }
+    return shapes;
+};
+/** Adds what one push left out to what the chat's record already holds. A chat the store lacks is left as it is. */
+export const recordHistorySkips = (context, accountKey, skips) => {
+    for (const [chatId, skip] of skips) {
+        const row = rowOf(context, accountKey, chatId);
+        if (!row)
+            continue;
+        update(context, Number(row.id), row.metadata, (held) => {
+            const before = held.skipped;
+            const skipped = before
+                ? {
+                    ...skip,
+                    messages: before.messages + skip.messages,
+                    oldestAt: before.oldestAt < skip.oldestAt ? before.oldestAt : skip.oldestAt,
+                    newestAt: before.newestAt > skip.newestAt ? before.newestAt : skip.newestAt,
+                }
+                : skip;
+            return { ...held, skipped };
+        });
+    }
+};
+/** Lifts the limits for one chat from now on, or puts them back. Answers `false` for a chat the store lacks. */
+export const setHistoryIncluded = (context, accountKey, chatId, included) => {
+    const row = rowOf(context, accountKey, chatId);
+    if (!row)
+        return false;
+    update(context, Number(row.id), row.metadata, (held) => ({ ...held, included }));
+    return true;
+};
+/** Every chat of the account whose pushed history the limits left out, most messages first. */
+export const historySkips = ({ database }, accountKey) => database
+    .prepare(`SELECT external_id, title, metadata FROM chats WHERE account_id = ? AND metadata LIKE '%"${HISTORY_KEY}"%'`)
+    .all(accountKey)
+    .flatMap((row) => {
+    const { skipped } = recordOf(row.metadata);
+    return skipped
+        ? [{ chatId: String(row.external_id), title: row.title == null ? null : String(row.title), ...skipped }]
+        : [];
+})
+    .sort((a, b) => b.messages - a.messages);
+/** `metadata` as the messenger gave it: the history record is the store's own. */
+export const withoutHistory = (metadata) => {
+    if (metadata === undefined || !(HISTORY_KEY in metadata))
+        return metadata;
+    const { [HISTORY_KEY]: _, ...rest } = metadata;
+    return rest;
+};

package/dist/store/store.d.ts

@@ -106,6 +106,7 @@ export interface MessageStore {
     forAccount(key: AccountKey): AccountStore;
     close(): Promise<void>;
 }
+export type { ChatHistoryShape, StoredHistorySkip } from "./sqlite/history-skips.js";
 export { BACKFILL_ON_OPEN, type StoreOptions } from "./sqlite/open-store.js";
 export { fileFacts, readStoreTables, type TableKind } from "./sqlite/store-tables.js";
 export declare const openStore: (options?: StoreOptions) => Promise<MessageStore>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.543.0",
+  "version": "0.545.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",

package/parity.json

@@ -438,6 +438,9 @@
     "--full": {
       "meaning": "found messages with their whole text and every provider field"
     },
+    "--full-history": {
+      "meaning": "keep this chat's pushed history in full from now on, past the history limits"
+    },
     "--hidden": {
       "value": "<on|off>",
       "meaning": "on hides a forum's General topic from the topic list, off shows it"
@@ -3509,6 +3512,7 @@
         "--catch-up-messages": "all",
         "--catch-up-time": "all",
         "--dry-run": "all",
+        "--full-history": "all",
         "--last": "all",
         "--limit": "all",
         "--no-catch-up": "all",