@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/sends/recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipients.d.ts","sourceRoot":"","sources":["../../src/sends/recipients.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAE7C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,EAAE,CAAA;IACN,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAS,WAAW,WAAW,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MAKzG,CAAA;AAEH;;;GAGG;AACH,qBAAa,aAAa;;IAGtB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM;IAH1B,uEAAuE;IACvE,YACW,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACtB;IAEJ,mGAAmG;IACnG,IAAI,IAAI,SAAS,EAAE,GAAG,SAAS,CAa9B;IAED,iGAAiG;IACjG,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAWjC;IAED,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQ/C;IAED,4CAA4C;IAC5C,GAAG,IAAI,OAAO,CAIb;CAKF"}

package/dist/sends/recipients.js

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@wirecat/cli-base";
+/**
+ * A state file, not a setting: the configuration schema has deliberately no place for a chat id,
+ * and this list is data about a profile rather than a preference.
+ */
+export const recipientsPathFor = (app, profile, env = process.env) => join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state, "profiles", `${profile}.recipients.json`);
+/**
+ * The chats a profile may send to. **No file means the check is off**; a file with no chats in it
+ * means nowhere.
+ */
+export class RecipientList {
+    path;
+    command;
+    /** `command` names the program in the hint that turns the list off. */
+    constructor(path, command) {
+        this.path = path;
+        this.command = command;
+    }
+    /** `undefined` when the list is off. A file that cannot be read refuses rather than opening up. */
+    read() {
+        if (!existsSync(this.path))
+            return undefined;
+        try {
+            const parsed = JSON.parse(readFileSync(this.path, "utf8"));
+            if (!Array.isArray(parsed.chats))
+                throw new Error("no `chats` array");
+            return parsed.chats;
+        }
+        catch (error) {
+            throw new CliError("configuration_error", `the recipient list ${this.path} cannot be read (${error instanceof Error ? error.message : String(error)}) — ` +
+                `fix the file or turn the list off with \`${this.command} recipients clear\``);
+        }
+    }
+    /** Whether it was new. Adding one again fills in a partner an older entry was stored without. */
+    add(recipient) {
+        const chats = this.read() ?? [];
+        const known = chats.find((chat) => chat.id === recipient.id);
+        if (known) {
+            if (recipient.partnerId && !known.partnerId) {
+                this.#write(chats.map((chat) => (chat === known ? { ...known, partnerId: recipient.partnerId } : chat)));
+            }
+            return false;
+        }
+        this.#write([...chats, recipient]);
+        return true;
+    }
+    /** The id or the title as it was stored; `undefined` when neither matched. */
+    remove(reference) {
+        const chats = this.read() ?? [];
+        const wanted = reference.trim();
+        const gone = chats.find((chat) => chat.id === wanted) ??
+            chats.find((chat) => chat.title?.toLocaleLowerCase() === wanted.toLocaleLowerCase());
+        if (gone)
+            this.#write(chats.filter((chat) => chat !== gone));
+        return gone;
+    }
+    /** Whether there was a list to turn off. */
+    off() {
+        if (!existsSync(this.path))
+            return false;
+        rmSync(this.path);
+        return true;
+    }
+    #write(chats) {
+        writeSecurely(this.path, `${JSON.stringify({ chats }, null, 2)}\n`, 0o600);
+    }
+}
+//# sourceMappingURL=recipients.js.map

package/dist/sends/recipients.js.map

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

package/dist/sends/send-as.d.ts

@@ -0,0 +1,12 @@
+import { type MessengerAdapter } from "../cli/messenger/port.js";
+import type { Id } from "../domain/models.js";
+/**
+ * Found before the chat is resolved, so a messenger without identities refuses before any lookup;
+ * the returned check runs once the chat id is known, in the same connection. With no identity named,
+ * a chat whose saved sender is not the account is refused: the messenger would post as that sender,
+ * and nothing the owner typed said so (owner, NEED-796 C).
+ */
+export declare const sendAsCheck: (connection: MessengerAdapter, sendAs: Id | undefined) => (chatId: Id) => Promise<void>;
+/** `--send-as` as typed; blank is refused rather than read as "no identity". */
+export declare const typedSendAs: (typed: string | undefined) => Id | undefined;
+//# sourceMappingURL=send-as.d.ts.map

package/dist/sends/send-as.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-as.d.ts","sourceRoot":"","sources":["../../src/sends/send-as.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,eAAgB,gBAAgB,UAAU,EAAE,GAAG,SAAS,cAGtD,EAAE,kBAqB3B,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,UAAW,MAAM,GAAG,SAAS,KAAG,EAAE,GAAG,SAI5D,CAAA"}

package/dist/sends/send-as.js

@@ -0,0 +1,34 @@
+import { CliError } from "@wirecat/cli-base";
+import { capability } from "../cli/messenger/port.js";
+/**
+ * Found before the chat is resolved, so a messenger without identities refuses before any lookup;
+ * the returned check runs once the chat id is known, in the same connection. With no identity named,
+ * a chat whose saved sender is not the account is refused: the messenger would post as that sender,
+ * and nothing the owner typed said so (owner, NEED-796 C).
+ */
+export const sendAsCheck = (connection, sendAs) => {
+    if (sendAs === undefined) {
+        const saved = connection.savedSender?.bind(connection);
+        return async (chatId) => {
+            const sender = await saved?.(chatId);
+            if (sender) {
+                throw new CliError("validation_error", `this chat posts as ${sender} unless told otherwise — add --send-as ${connection.self() ?? "<your id>"} ` +
+                    `to post as yourself, or --send-as ${sender} to post as it; \`chats send-as\` lists who you can be`, { savedSender: sender });
+            }
+        };
+    }
+    const identities = capability(connection, "sendAsIdentities", "send as another identity");
+    return async (chatId) => {
+        if (!(await identities(chatId)).some((one) => one.id === sendAs)) {
+            throw new CliError("validation_error", `${sendAs} is not an identity this account may post as in this chat — see \`chats send-as\``);
+        }
+    };
+};
+/** `--send-as` as typed; blank is refused rather than read as "no identity". */
+export const typedSendAs = (typed) => {
+    const sendAs = typed?.trim();
+    if (sendAs === "")
+        throw new CliError("validation_error", "--send-as needs an id from `chats send-as`");
+    return sendAs;
+};
+//# sourceMappingURL=send-as.js.map

package/dist/sends/send-as.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-as.js","sourceRoot":"","sources":["../../src/sends/send-as.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAyB,MAAM,0BAA0B,CAAA;AAG5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAA4B,EAAE,MAAsB,EAAE,EAAE;IAClF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QACtD,OAAO,KAAK,EAAE,MAAU,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC,CAAA;YACpC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,sBAAsB,MAAM,0CAA0C,UAAU,CAAC,IAAI,EAAE,IAAI,WAAW,GAAG;oBACvG,qCAAqC,MAAM,wDAAwD,EACrG,EAAE,WAAW,EAAE,MAAM,EAAE,CACxB,CAAA;YACH,CAAC;QACH,CAAC,CAAA;IACH,CAAC;IACD,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,EAAE,kBAAkB,EAAE,0BAA0B,CAAC,CAAA;IACzF,OAAO,KAAK,EAAE,MAAU,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,MAAM,mFAAmF,CAC7F,CAAA;QACH,CAAC;IACH,CAAC,CAAA;AACH,CAAC,CAAA;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAyB,EAAkB,EAAE;IACvE,MAAM,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;IAC5B,IAAI,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,4CAA4C,CAAC,CAAA;IACvG,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/sends/send-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * One logical send's identity, made before the request and kept through every retry: a signed
+ * 64-bit integer as a string, which is what Telegram's `random_id` takes and what fits MAX's `cid`.
+ */
+export declare const newSendId: () => string;
+/** One write's identity, for every write the guard sees. A send's is its send id, so a retry keeps it. */
+export declare const newOperationId: typeof newSendId;
+//# sourceMappingURL=send-id.d.ts.map

package/dist/sends/send-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-id.d.ts","sourceRoot":"","sources":["../../src/sends/send-id.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAO,MAAoD,CAAA;AAEjF,0GAA0G;AAC1G,eAAO,MAAM,cAAc,kBAAY,CAAA"}

package/dist/sends/send-id.js

@@ -0,0 +1,9 @@
+import { randomBytes } from "node:crypto";
+/**
+ * One logical send's identity, made before the request and kept through every retry: a signed
+ * 64-bit integer as a string, which is what Telegram's `random_id` takes and what fits MAX's `cid`.
+ */
+export const newSendId = () => randomBytes(8).readBigInt64BE().toString();
+/** One write's identity, for every write the guard sees. A send's is its send id, so a retry keeps it. */
+export const newOperationId = newSendId;
+//# sourceMappingURL=send-id.js.map

package/dist/sends/send-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-id.js","sourceRoot":"","sources":["../../src/sends/send-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAA;AAEjF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAA"}

package/dist/sends/upload.d.ts

@@ -0,0 +1,30 @@
+import type { AppIdentity } from "../cli/app.js";
+export type UploadKind = "photo" | "file" | "voice";
+/** A file read for sending. Its name goes to the messenger and never to the journal. */
+export interface Upload {
+    kind: UploadKind;
+    name: string;
+    bytes: Uint8Array;
+    /** A `file` that goes as a file to download even where the messenger would play it — a video. */
+    asFile?: true;
+}
+/** Protect known credential/state paths without refusing ordinary hidden developer folders. */
+export declare const refusedPlace: (path: string, app: AppIdentity, env: NodeJS.ProcessEnv) => boolean;
+export declare const readUpload: (kind: UploadKind, path: string, { app, env, anyFile }: {
+    app: AppIdentity;
+    env?: NodeJS.ProcessEnv;
+    anyFile?: boolean;
+}) => Promise<Upload>;
+export declare const readAttachments: ({ photo, file, voice, asFile, filename, text, }: {
+    photo?: string;
+    file?: string;
+    voice?: string;
+    asFile?: boolean;
+    filename?: string;
+    text?: string;
+}, read: {
+    app: AppIdentity;
+    env?: NodeJS.ProcessEnv;
+    anyFile?: boolean;
+}) => Promise<Upload[]>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/sends/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/sends/upload.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AAEnD,wFAAwF;AACxF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,CAAA;IACjB,iGAAiG;IACjG,MAAM,CAAC,EAAE,IAAI,CAAA;CACd;AAKD,+FAA+F;AAC/F,eAAO,MAAM,YAAY,SAAU,MAAM,OAAO,WAAW,OAAO,MAAM,CAAC,UAAU,KAAG,OAiCrF,CAAA;AAOD,eAAO,MAAM,UAAU,SACf,UAAU,QACV,MAAM,yBACiC;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAC5G,OAAO,CAAC,MAAM,CAqBhB,CAAA;AAYD,eAAO,MAAM,eAAe,oDAQvB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,QAClG;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KACrE,OAAO,CAAC,MAAM,EAAE,CAmBlB,CAAA"}

package/dist/sends/upload.js

@@ -0,0 +1,95 @@
+import { realpathSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { basename, dirname, extname, isAbsolute, relative, resolve, sep } from "node:path";
+import { CliError, resolvePaths } from "@wirecat/cli-base";
+import { storePath } from "../store/path.js";
+const PHOTO = new Set([".jpg", ".jpeg", ".png", ".webp"]);
+const VOICE = new Set([".ogg", ".oga", ".opus"]);
+/** Protect known credential/state paths without refusing ordinary hidden developer folders. */
+export const refusedPlace = (path, app, env) => {
+    const own = Object.values(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }));
+    // The store file and its -wal and -shm, not its folder: MESSAGING_STORE may sit in the home folder.
+    const store = resolve(storePath(env));
+    let ancestor = resolve(path);
+    let real = ancestor;
+    // Downloads may create missing descendants of a symlinked directory.
+    for (;;) {
+        try {
+            real = resolve(realpathSync(ancestor), relative(ancestor, resolve(path)));
+            break;
+        }
+        catch {
+            const parent = dirname(ancestor);
+            if (parent === ancestor)
+                break;
+            ancestor = parent;
+        }
+    }
+    const credentialFolders = new Set([".ssh", ".gnupg", ".aws", ".secrets", "secrets"]);
+    const credentialFiles = new Set([".env", ".npmrc", ".pypirc", "credentials.yml.enc", "master.key"]);
+    return [resolve(path), real].some((candidate) => candidate
+        .split(sep)
+        .some((part, index, parts) => credentialFolders.has(part) ||
+        credentialFiles.has(part) ||
+        /^\.env\./.test(part) ||
+        (part === ".config" && parts[index + 1] === "autostart")) ||
+        own.some((dir) => inside(candidate, dir)) ||
+        [store, `${store}-wal`, `${store}-shm`].includes(candidate));
+};
+const inside = (path, dir) => {
+    const way = relative(resolve(dir), path);
+    return way === "" || (!way.startsWith("..") && !isAbsolute(way));
+};
+export const readUpload = async (kind, path, { app, env = process.env, anyFile = false }) => {
+    if (kind === "photo" && !PHOTO.has(extname(path).toLowerCase())) {
+        throw new CliError("validation_error", `a photo is a .jpg, .png or .webp — send ${path} as a file instead`);
+    }
+    if (kind === "voice" && !VOICE.has(extname(path).toLowerCase())) {
+        throw new CliError("validation_error", `a voice message is Ogg Opus: .ogg, .oga or .opus — send ${path} as a file`);
+    }
+    if (!anyFile && refusedPlace(path, app, env)) {
+        throw new CliError("validation_error", `cannot send ${path}: known credential files, ${app.command}'s own folders and the message store ` +
+            `are not sent — the owner adds --allow-any-file to \`${app.command} messages send\` if this file is meant to go`);
+    }
+    try {
+        return { kind, name: basename(path), bytes: await readFile(path) };
+    }
+    catch (error) {
+        const code = error.code;
+        const reason = code === "ENOENT" ? "no such file" : code === "EISDIR" ? "it is a folder" : "it cannot be read";
+        throw new CliError("validation_error", `cannot send ${path}: ${reason}`);
+    }
+};
+/**
+ * What a send attaches, as `messages send` and its tool take it. A voice message goes alone, as the
+ * messengers' own apps send one.
+ */
+const checkFilename = (filename, file) => {
+    if (file === undefined)
+        throw new CliError("validation_error", "--filename names a --file; give one");
+    if (filename.trim() === "" || /[/\\\0]/.test(filename) || filename.length > 255)
+        throw new CliError("validation_error", "--filename is a name, not a path: no / or \\, at most 255 characters");
+};
+export const readAttachments = async ({ photo, file, voice, asFile, filename, text, }, read) => {
+    if (voice !== undefined && (photo !== undefined || file !== undefined || (text ?? "").trim() !== "")) {
+        throw new CliError("validation_error", "a voice message goes alone — no text, no file, no photo beside it");
+    }
+    if (asFile && file === undefined)
+        throw new CliError("validation_error", "--as-file is about a --file; give one");
+    if (filename !== undefined)
+        checkFilename(filename, file);
+    return [
+        ...(photo === undefined ? [] : [await readUpload("photo", photo, read)]),
+        ...(file === undefined
+            ? []
+            : [
+                {
+                    ...(await readUpload("file", file, read)),
+                    ...(filename === undefined ? {} : { name: filename }),
+                    ...(asFile ? { asFile: true } : {}),
+                },
+            ]),
+        ...(voice === undefined ? [] : [await readUpload("voice", voice, read)]),
+    ];
+};
+//# sourceMappingURL=upload.js.map

package/dist/sends/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/sends/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAC1F,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAa5C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AACzD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEhD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,GAAgB,EAAE,GAAsB,EAAW,EAAE;IAC9F,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;IAC7F,oGAAoG;IACpG,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IACrC,IAAI,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,IAAI,GAAG,QAAQ,CAAA;IACnB,qEAAqE;IACrE,SAAS,CAAC;QACR,IAAI,CAAC;YACH,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACzE,MAAK;QACP,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;YAChC,IAAI,MAAM,KAAK,QAAQ;gBAAE,MAAK;YAC9B,QAAQ,GAAG,MAAM,CAAA;QACnB,CAAC;IACH,CAAC;IACD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAA;IACpF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,qBAAqB,EAAE,YAAY,CAAC,CAAC,CAAA;IACnG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAC/B,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS;SACN,KAAK,CAAC,GAAG,CAAC;SACV,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACrB,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;QAC3B,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QACrB,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,WAAW,CAAC,CAC3D;QACH,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC9D,CAAA;AACH,CAAC,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,GAAW,EAAW,EAAE;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;IACxC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AAClE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,IAAgB,EAChB,IAAY,EACZ,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,EAAoE,EAC5F,EAAE;IACnB,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,2CAA2C,IAAI,oBAAoB,CAAC,CAAA;IAC7G,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,2DAA2D,IAAI,YAAY,CAAC,CAAA;IACrH,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,eAAe,IAAI,6BAA6B,GAAG,CAAC,OAAO,uCAAuC;YAChG,uDAAuD,GAAG,CAAC,OAAO,8CAA8C,CACnH,CAAA;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAA;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;QAClD,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAA;QAC9G,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,eAAe,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;IAC1E,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,IAAwB,EAAQ,EAAE;IACzE,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,CAAC,CAAA;IACrG,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;QAC7E,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,sEAAsE,CAAC,CAAA;AAClH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,EACE,KAAK,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,EACR,IAAI,GACkG,EACxG,IAAsE,EACnD,EAAE;IACrB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACrG,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,mEAAmE,CAAC,CAAA;IAC7G,CAAC;IACD,IAAI,MAAM,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,uCAAuC,CAAC,CAAA;IACjH,IAAI,QAAQ,KAAK,SAAS;QAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACzD,OAAO;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACxE,GAAG,CAAC,IAAI,KAAK,SAAS;YACpB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE;oBACE,GAAG,CAAC,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;oBACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;oBACrD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7C;aACF,CAAC;QACN,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;KACzE,CAAA;AACH,CAAC,CAAA"}

package/dist/services/account.d.ts

@@ -0,0 +1,25 @@
+import { type ProfileChange } from "../cli/messenger/port.js";
+import type { Account, AccountSession, Id, PrivacySettings } from "../domain/models.js";
+import { type Operated } from "../sends/guarded.js";
+import type { ServiceDeps } from "./deps.js";
+/** The owner's own profile and logins. */
+export interface AccountService {
+    /** The account as it now stands, its phone masked as `account show` masks it. */
+    update(change: ProfileChange): Promise<Operated<{
+        account: Account;
+    }>>;
+    /** Logs the owner out of every other device, the phone included. */
+    endOtherSessions(): Promise<Operated<{
+        sessions: AccountSession[];
+    }>>;
+    /** `until`: `forever`, an ISO 8601 time, or null to hear the chat again. */
+    mute(chat: string, until: string | null): Promise<Operated<{
+        chatId: Id;
+        mutedUntil: string | null;
+    }>>;
+    updatePrivacy(change: PrivacySettings): Promise<Operated<{
+        privacy: PrivacySettings;
+    }>>;
+}
+export declare const accountService: (deps: ServiceDeps) => AccountService;
+//# sourceMappingURL=account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/services/account.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACvF,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG5C,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAA;IACtE,oEAAoE;IACpE,gBAAgB,IAAI,OAAO,CAAC,QAAQ,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IACrE,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAA;IACtG,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC,CAAA;CACxF;AAED,eAAO,MAAM,cAAc,SAAU,WAAW,KAAG,cA2DlD,CAAA"}

package/dist/services/account.js

@@ -0,0 +1,50 @@
+import { CliError } from "@wirecat/cli-base";
+import { capability } from "../cli/messenger/port.js";
+import { guardedWrite } from "../sends/guarded.js";
+import { newOperationId } from "../sends/send-id.js";
+import { maskedAccount } from "./people.js";
+export const accountService = (deps) => {
+    const online = async (command) => {
+        if (deps.offline)
+            throw new CliError("validation_error", `\`${command}\` changes the account; not with --offline`);
+        return deps.connection();
+    };
+    return {
+        update: async (change) => {
+            if (Object.values(change).every((value) => value === undefined)) {
+                throw new CliError("validation_error", "nothing to change — give a name, a description or a photo");
+            }
+            if (change.firstName !== undefined && change.firstName.trim() === "") {
+                throw new CliError("validation_error", "a first name cannot be empty");
+            }
+            const update = capability(await online("account update"), "updateProfile", "change the profile");
+            const operationId = newOperationId();
+            const account = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "account", action: "profile" }, () => update(change));
+            return { operationId, account: maskedAccount(account) };
+        },
+        endOtherSessions: async () => {
+            const end = capability(await online("account sessions end"), "endOtherSessions", "end other sessions");
+            const operationId = newOperationId();
+            const sessions = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "account", action: "sessions-end" }, () => end());
+            return { operationId, sessions };
+        },
+        mute: async (chat, until) => {
+            const connection = await online(until === null ? "chats unmute" : "chats mute");
+            const mute = capability(connection, "mute", "mute a chat");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "account", action: "chat-mute" }, () => mute(chatId, until));
+            return { operationId, chatId, mutedUntil: until };
+        },
+        updatePrivacy: async (change) => {
+            if (Object.values(change).every((value) => value === undefined)) {
+                throw new CliError("validation_error", "nothing to change — name a setting");
+            }
+            const update = capability(await online("account privacy set"), "updatePrivacy", "change privacy settings");
+            const operationId = newOperationId();
+            const privacy = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "account", action: "privacy" }, () => update(change));
+            return { operationId, privacy };
+        },
+    };
+};
+//# sourceMappingURL=account.js.map

package/dist/services/account.js.map

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

package/dist/services/admin-statistics.d.ts

@@ -0,0 +1,70 @@
+import type { AdminOptions, AdminReport } from "../domain/admin-statistics.js";
+import type { AdminStoreResult, MessageStore } from "../store/store.js";
+import type { ServiceDeps } from "./deps.js";
+import type { SearchQuery } from "./messages.js";
+import { type RankingSelection } from "./rankings-selection.js";
+export type AdminQuery = SearchQuery & {
+    answerers?: string[];
+    olderThan?: string;
+    within?: string;
+    sinceTime?: string;
+    untilTime?: string;
+    minViews?: number;
+    maxReplies?: number;
+    saved?: string;
+};
+export interface AdminSelection {
+    kind: "admin-statistics";
+    version: 1;
+    base: RankingSelection;
+    options: AdminOptions;
+    entity: {
+        account: {
+            provider: string;
+            account: string;
+        };
+        id: string;
+    };
+}
+export interface AdminFound extends AdminStoreResult {
+    report: AdminReport;
+    detectorVersion: 1;
+    items: (AdminStoreResult["items"][number] & {
+        drilldown: {
+            command: string;
+            arguments: {
+                person?: string;
+                message?: string;
+                component: "report";
+                selection: AdminSelection;
+            };
+        };
+    })[];
+}
+export interface AdminEvidenceFound extends Omit<AdminStoreResult, "items" | "evidence"> {
+    items: NonNullable<AdminStoreResult["evidence"]>;
+    component: "report";
+}
+export interface AdminStatisticsService {
+    report(report: AdminReport, query: AdminQuery): Promise<AdminFound>;
+    evidence(target: "messages" | "contacts", reference: string, selection: unknown, options: {
+        component: string;
+        limit: number;
+        cursor?: string;
+        signal?: AbortSignal;
+    }): Promise<AdminEvidenceFound>;
+}
+export declare const isAdminSelection: (selection: unknown) => boolean;
+export declare const readAdminSelection: (store: MessageStore, input: unknown) => Promise<{
+    base: RankingSelection;
+    options: AdminOptions;
+    entity: {
+        account: {
+            provider: string;
+            account: string;
+        };
+        id: string;
+    };
+}>;
+export declare const adminStatisticsService: (deps: ServiceDeps) => AdminStatisticsService;
+//# sourceMappingURL=admin-statistics.d.ts.map

package/dist/services/admin-statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-statistics.d.ts","sourceRoot":"","sources":["../../src/services/admin-statistics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAY,MAAM,+BAA+B,CAAA;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,OAAO,EAAE,KAAK,gBAAgB,EAA0C,MAAM,yBAAyB,CAAA;AAGvG,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IACrC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AACD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE;QAAE,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CACvE;AACD,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD,MAAM,EAAE,WAAW,CAAA;IACnB,eAAe,EAAE,CAAC,CAAA;IAClB,KAAK,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG;QAC1C,SAAS,EAAE;YACT,OAAO,EAAE,MAAM,CAAA;YACf,SAAS,EAAE;gBAAE,MAAM,CAAC,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,QAAQ,CAAC;gBAAC,SAAS,EAAE,cAAc,CAAA;aAAE,CAAA;SACjG,CAAA;KACF,CAAC,EAAE,CAAA;CACL;AACD,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,CAAC;IACtF,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAA;IAChD,SAAS,EAAE,QAAQ,CAAA;CACpB;AACD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACnE,QAAQ,CACN,MAAM,EAAE,UAAU,GAAG,UAAU,EAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnF,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC/B;AAgGD,eAAO,MAAM,gBAAgB,cAAe,OAAO,KAAG,OAUrD,CAAA;AACD,eAAO,MAAM,kBAAkB,UAAiB,YAAY,SAAS,OAAO;;;;iBAnIvD;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;YAAM,MAAM;;EAsLrE,CAAA;AAED,eAAO,MAAM,sBAAsB,SAAU,WAAW,KAAG,sBA6MzD,CAAA"}