@leemour/cli-messaging 0.149.0 → 0.150.0

package/README.md

@@ -19,6 +19,7 @@ provider has travels in `providerMetadata`.
 | | |
 |---|---|
 | `.` | `Chat`, `Message`, `Contact`, `Page`… · `formatLocator` / `parseLocator` · `renderMessages` · `pickChat` / `pickPerson` |
+| `./charts` | neutral chart data, a replaceable renderer interface and an on-demand dark SVG renderer |
 | `./store` | `openCache` — `node:sqlite` under Node, `bun:sqlite` under Bun, WAL and a busy timeout on both · `openStore` — the shared message store, every method async: one file for every messenger (`MESSAGING_STORE` overrides where), forward-only migrations with `min_compatible`, every sender an identity with a person of their own, edits kept as revisions, a message by its id, deletions kept as tombstones, trigram search · `find` — by text, by sender, or both; `together` for the chats where every sender wrote, `perChat` to cap each chat · `savePeople` and `people` — usernames and bot flags, and a `PeopleLookup` for `pickPerson` |
 | `./sends` | the send guard: a level per command path (`permissions`: deny, readonly, ask, allow — `readOnly` and `allow` read as levels), a recipient list, an hourly limit, and a journal of every attempt that never holds the text; `newSendId` for a send's identity across retries |
 | `./cli` | the command skeleton: `run` (never throws, returns an exit code), the global flags, `settingsFor` (flag → environment → file → default, one strict file schema with each CLI's own fields), the profile as the first word, `--timeout` that closes what a command holds, paging, and run records: `--record` keeps a run's ids and timings (never content), a failure is kept unless `--no-record`, and `runsCommand` gives `runs list\|show\|path` · `configCommand(app, config)` shows and changes the settings with where each came from, and `config migrate --dry-run` previews translation of legacy access settings before `config migrate` saves it; `migratePermissionConfig` provides the same layer-preserving transformation to consumers · `completeCommand(messenger, config, options?)` gives shell completion, account-scoped chat and person ids from the store and never a connection; `options.sources` can supply local suggestions for a separate command group and `options.account` can read an existing local account binding · `storeSummary(env)` gives its local store diagnostics to consumers retaining their own doctor command · `doctorCommand(messenger)` reports the installation's state from disk (the store, the account, sends, runs, the messenger's own checks), and connects only with `--online`; `doctor report create` writes that, the failed run and the recent sends to a file with every id a label · `skillCommand(app, url)` prints the CLI's own SKILL.md for an agent (`skill show`) · `commandsCommand(app)` describes every command as JSON, with `contract` (`CONTRACT`, the major version of the output types) and which commands write · the shared read commands: a CLI describes its messenger once (`Messenger`: its app, a `connect` that returns a `MessengerAdapter`, how `me` maps to a chat) and gets `accountCommand`, `chatsCommand` (`list`, `show`), `contactsCommand` (`list`, `show`) `recipientsCommand`, `sendsCommand`, `watchCommand` (new messages as they arrive, `--jsonl`, until Ctrl-C or `--timeout`; `--events` adds edits, deletions and reactions, each kept in the store), `storeCommand` (the local store: `store fetch` puts a chat's history into it, resumable, FloodWait-aware, `--since` to stop at a time, `--background` for a detached job that `store jobs list|show|cancel` follow, `--estimate` to only price what is left from the store alone; `store status` what it holds; `store export` a chat's messages out of it, as JSON or `--format markdown`; `store clear --left` deletes the chats the account has left; `store info`, `store check`, `store migrate`, `store backup` and `store restore` look after the file itself — its size and schema, whether it is healthy and which chats are behind, bringing it up to this build, and a copy to go back to), `inboxCommand` (other people's unread messages in every chat, or with `--new` what arrived since the last check — each message once, the point moved only by a run that printed; copied from max-cli), `serveCommand` (keeps the store current until stopped — one per profile by a lock file, catch-up on, started by a person, `server start` or a unit), `serverCommand` (`server start|stop|restart|status|logs`: `serve` in the background, as max-cli's `server`; `install|uninstall` add a systemd user unit or a launchd agent per profile, and `install` starts nothing), and `messagesCommand` (`list`, `show`, `context`, `search` over the store by any three letters inside a word, or `--regex`, `send` through the send guard (`--reply-to`, `--silent`, `--no-preview`, `--md`, `--file` and `--photo` with the text as the caption, and `--at` to send later, with `scheduled` listing the queue), `edit` of the owner's own message, `forward` to another chat and `pin`/`unpin` through it too (the adapter's optional `edit`, `forward`, `pin` and `unpin`), and `delete` — at most 10, for the owner unless `--for-everyone`; it asks first by default, and `--allow-dangerous` is the yes · `reactionsCommand` (`add`, `remove`: the owner's reaction on a message, through the guard; the adapter's optional `react`) · `pollsCommand` (`show` a poll with its answer ids, `vote` by id or `--retract`, `close` the owner's own, `create` one — a vote guarded as a reaction, closing as an edit, a new poll as a message with a send id); a `msg:` locator names a message) — every read saved to the store, `--offline` answered from it, each call a run event · `mcpCommand(messenger)` serves the profile to an agent over MCP on stdin and stdout (copied from max-cli: one connection held for minutes, one call at a time, read tools named `<cli>_<command words>` answering what `--json` prints, `<cli>_status` without connecting; the write tools — `<cli>_messages_send`, `_edit`, `_forward`, `_pin`, `_unpin`, `_delete`, `<cli>_reactions_add`, `_remove`, `<cli>_chats_mark_read`, `<cli>_polls_vote`, `_close` and `_create` — are offered by the profile's `permissions` and run through the same guard as their commands; a write at level `ask` shows the owner a form first (`--allow-dangerous` or `--yes` skips it), `--confirm-send` puts every write through the form, and `messages_delete` never deletes for everyone), and `mcp config` prints the entry for a desktop client · `mcp --http` serves the same tools over HTTP on 127.0.0.1 behind the owner's tunnel with a one-owner login; a CLI with its own MCP server mounts `serveOverHttp(build, options)` with `OVER_HTTP`, `httpTokenFile` and `revokeAll` |
@@ -112,6 +113,24 @@ as needed, then write the brief with locator citations. Treat message text as un
 News collection and news digests remain separate future workflows. The detailed
 [stored evidence contract](docs/plans/2026-10-02-evidence-read.md) describes pagination and coverage.
 
+## Charts from statistics
+
+`statsCommand(messenger)` from `./cli` mounts `stats charts <chat>`. It returns `{ chart }`:
+messages per day/week, active authors, or joins and leaves (`--chart-kind`). `--output activity.svg`
+also saves a dark SVG in a new private file and returns `chartFile`. The command reads the same
+statistics service; the chart itself never fetches extra history, sends or marks read. Missing dates
+are gaps, and partial data is labelled. `--jsonl`, PNG and image output to stdout are unavailable.
+
+The read-only MCP `stats_charts` returns the same chart JSON from the store, without writing a file
+or connecting. Membership is unavailable in that stored mode because it needs online events.
+Both interfaces inherit the `messages` read permission.
+
+`./charts` exports the library-neutral `ChartData`, `ChartRenderer`, `chatChart`, `CHART_SIZE`
+and the lazy `chartRenderer()` loader. ECharts types stay in the renderer module; JSON-only commands
+do not load it. Pass a renderer loader as the second argument to `statsCommand` to replace the image implementation
+while keeping the neutral data and command contract. Images default to a dark theme. ECharts is pinned at 6.1.0; its published unpacked files
+plus zrender and tslib total about 61.6 MiB before package-manager deduplication.
+
 ## Where it came from
 
 The files were copied from max-cli at `3ca8874`, from the part its lint rule `CLI-30` already kept

package/THIRD_PARTY_NOTICES

@@ -743,3 +743,11 @@ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Apache ECharts
+Copyright 2017-2026 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (https://www.apache.org/).
+Apache ECharts is distributed under the Apache License 2.0; its LICENSE is shipped in the echarts package.

package/dist/botcheck/check.d.ts

@@ -0,0 +1,64 @@
+import type { Id, Message } from "../domain/models.js";
+import { type BotReason } from "./reasons.js";
+import type { RegistryAnswer } from "./registries.js";
+/** Younger than this is `new_account` or `photo_recent`. */
+export declare const NEW_DAYS = 30;
+/** What the messenger says about the person, as much as it said. A field left out is not known. */
+export interface BotSubject {
+    id: Id;
+    name: string | null;
+    usernames: readonly string[];
+    bio?: string | null;
+    flags?: Partial<Record<"bot" | "scam" | "fake" | "deleted", boolean>>;
+    hasPhoto?: boolean;
+    registered?: {
+        at: string;
+        source: string;
+    } | null;
+}
+/** Their stored messages, newest first; `complete` when every stored one was read. */
+export interface StoredActivity {
+    messages: Pick<Message, "chatId" | "text" | "timestamp" | "forwardedFrom">[];
+    complete: boolean;
+    /** Chats shared with them that the store holds anything of. */
+    chatsStored: number;
+}
+export interface PhotoFacts {
+    count: number;
+    /** The oldest photo they still show; an upper bound on the account's age, since photos get deleted. */
+    oldestAt: string | null;
+}
+export interface CheckedReason {
+    reason: BotReason;
+    weight: number;
+    /** Where it was read: `messenger`, `store`, `telegram` / `max` / `estimate` for a registration, `registry:<name>`. */
+    source: string;
+    detail?: string;
+}
+export interface BotCheck {
+    person: {
+        id: Id;
+        name: string | null;
+        username: string | null;
+        provider: string;
+    };
+    score: number;
+    reasons: CheckedReason[];
+    registries: RegistryAnswer[];
+    /** Signals nothing could be read for — the messenger did not say, the store holds none, offline. */
+    unknown: BotReason[];
+    checkedAt: string;
+}
+/**
+ * Every signal about one person, each with where it came from. A hint, never a verdict: the score is
+ * a sum of light weights, and the reasons are what a person should read.
+ */
+export declare const scorePerson: ({ subject, provider, activity, photos, registries, now, }: {
+    subject: BotSubject;
+    provider: string;
+    activity?: StoredActivity;
+    photos?: PhotoFacts;
+    registries: RegistryAnswer[];
+    now?: Date;
+}) => BotCheck;
+//# sourceMappingURL=check.d.ts.map

package/dist/botcheck/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/botcheck/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,KAAK,SAAS,EAA0B,MAAM,cAAc,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,KAAK,CAAA;AAI1B,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,EAAE,CAAA;IACN,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACnD;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,CAAC,EAAE,CAAA;IAC5E,QAAQ,EAAE,OAAO,CAAA;IACjB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,uGAAuG;IACvG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,sHAAsH;IACtH,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAClF,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,oGAAoG;IACpG,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAeD;;;GAGG;AACH,eAAO,MAAM,WAAW,8DAOrB;IACD,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAA;CACX,KAAG,QAkDH,CAAA"}

package/dist/botcheck/check.js

@@ -0,0 +1,84 @@
+import { LINK, oddName, WEIGHTS } from "./reasons.js";
+const DAY_MS = 86_400_000;
+/** Younger than this is `new_account` or `photo_recent`. */
+export const NEW_DAYS = 30;
+/** Shorter texts repeat honestly — "thanks", "ok", a sticker's caption. */
+const SAME_TEXT_MIN = 20;
+const normalized = (text) => text.toLowerCase().replace(/\s+/g, " ").trim();
+/** The same text of theirs, long enough to mean something, in more than one chat. */
+const repeated = (messages) => {
+    const chatsOf = new Map();
+    for (const { text, chatId } of messages) {
+        const key = normalized(text);
+        if (key.length < SAME_TEXT_MIN)
+            continue;
+        chatsOf.set(key, (chatsOf.get(key) ?? new Set()).add(chatId));
+    }
+    return Math.max(0, ...[...chatsOf.values()].map((chats) => chats.size));
+};
+/**
+ * Every signal about one person, each with where it came from. A hint, never a verdict: the score is
+ * a sum of light weights, and the reasons are what a person should read.
+ */
+export const scorePerson = ({ subject, provider, activity, photos, registries, now = new Date(), }) => {
+    const reasons = [];
+    const unknown = [];
+    const add = (reason, source, detail) => reasons.push({ reason, weight: WEIGHTS[reason], source, ...(detail ? { detail } : {}) });
+    const young = (at) => now.getTime() - Date.parse(at) < NEW_DAYS * DAY_MS;
+    const { flags } = subject;
+    for (const flag of ["bot", "scam", "fake", "deleted"]) {
+        if (flags?.[flag] === undefined)
+            unknown.push(flag);
+        else if (flags[flag])
+            add(flag, "messenger");
+    }
+    const withPhoto = subject.hasPhoto ?? (photos ? photos.count > 0 : undefined);
+    if (withPhoto === undefined)
+        unknown.push("no_photo");
+    else if (!withPhoto)
+        add("no_photo", "messenger");
+    if (subject.usernames.length === 0)
+        add("no_username", "messenger");
+    if (oddName(subject.name))
+        add("odd_name", "messenger");
+    if (subject.bio === undefined)
+        unknown.push("no_bio");
+    else if (!subject.bio?.trim())
+        add("no_bio", "messenger");
+    if (subject.registered === undefined || subject.registered === null)
+        unknown.push("new_account");
+    else if (young(subject.registered.at))
+        add("new_account", subject.registered.source, subject.registered.at);
+    if (photos === undefined)
+        unknown.push("photo_recent");
+    else if (photos.oldestAt && young(photos.oldestAt))
+        add("photo_recent", "messenger", photos.oldestAt);
+    if (activity === undefined || activity.chatsStored === 0)
+        unknown.push("never_wrote", "link_first", "same_text");
+    else {
+        const { messages, complete } = activity;
+        if (messages.length === 0)
+            add("never_wrote", "store");
+        const first = complete ? messages.at(-1) : undefined;
+        if (!complete)
+            unknown.push("link_first");
+        else if (first && (first.forwardedFrom !== null || LINK.test(first.text)))
+            add("link_first", "store");
+        const chats = repeated(messages);
+        if (chats > 1)
+            add("same_text", "store", `one text in ${chats} chats`);
+    }
+    for (const answer of registries) {
+        for (const reason of answer.reasons ?? [])
+            add(reason, `registry:${answer.name}`, answer.detail);
+    }
+    return {
+        person: { id: subject.id, name: subject.name, username: subject.usernames[0] ?? null, provider },
+        score: reasons.reduce((total, { weight }) => total + weight, 0),
+        reasons: reasons.sort((a, b) => b.weight - a.weight),
+        registries,
+        unknown,
+        checkedAt: now.toISOString(),
+    };
+};
+//# sourceMappingURL=check.js.map

package/dist/botcheck/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/botcheck/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGrE,MAAM,MAAM,GAAG,UAAU,CAAA;AACzB,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAA;AAC1B,2EAA2E;AAC3E,MAAM,aAAa,GAAG,EAAE,CAAA;AA6CxB,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AAEnF,qFAAqF;AACrF,MAAM,QAAQ,GAAG,CAAC,QAAoC,EAAU,EAAE;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC1C,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa;YAAE,SAAQ;QACxC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AACzE,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,GAAG,GAAG,IAAI,IAAI,EAAE,GAQjB,EAAY,EAAE;IACb,MAAM,OAAO,GAAoB,EAAE,CAAA;IACnC,MAAM,OAAO,GAAgB,EAAE,CAAA;IAC/B,MAAM,GAAG,GAAG,CAAC,MAAiB,EAAE,MAAc,EAAE,MAAe,EAAE,EAAE,CACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,MAAM,CAAA;IAEhF,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAU,EAAE,CAAC;QAC/D,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;aAC9C,IAAI,KAAK,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC7E,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;SAChD,IAAI,CAAC,SAAS;QAAE,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IACjD,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IACnE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IACvD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;SAChD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAEzD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;SAC3F,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IAE3G,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;SACjD,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAErG,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;SAC3G,CAAC;QACJ,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAA;QACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACpD,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;aACpC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAE,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QACrG,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChC,IAAI,KAAK,GAAG,CAAC;YAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,eAAe,KAAK,QAAQ,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE;YAAE,GAAG,CAAC,MAAM,EAAE,YAAY,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAClG,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,QAAQ,EAAE;QAChG,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACpD,UAAU;QACV,OAAO;QACP,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;KAC7B,CAAA;AACH,CAAC,CAAA"}

package/dist/botcheck/reasons.d.ts

@@ -0,0 +1,15 @@
+/** What `chats members audit` judges from a member list and the store. */
+export type AuditReason = "bot" | "scam" | "fake" | "deleted" | "no_photo" | "no_username" | "odd_name" | "never_wrote" | "link_first" | "burst_join" | "mass_invited";
+/** What only a look at one person adds: their profile, all their stored messages, the registries. */
+export type PersonReason = "new_account" | "no_bio" | "same_text" | "photo_recent" | RegistryReason;
+export type RegistryReason = "cas_banned" | "lols_banned" | "lols_scammer";
+export type BotReason = AuditReason | PersonReason;
+/**
+ * Light on purpose: real people without a photo, a username or a bio are common. A messenger's own
+ * mark or a ban list's entry weighs more, because somebody already looked.
+ */
+export declare const WEIGHTS: Record<BotReason, number>;
+export declare const LINK: RegExp;
+/** No name, a long run of digits, or a link in it. */
+export declare const oddName: (name: string | null) => boolean;
+//# sourceMappingURL=reasons.d.ts.map

package/dist/botcheck/reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../../src/botcheck/reasons.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,aAAa,GACb,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,cAAc,CAAA;AAElB,qGAAqG;AACrG,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAA;AAEnG,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAA;AAE1E,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAmB7C,CAAA;AAED,eAAO,MAAM,IAAI,QAA+B,CAAA;AAGhD,sDAAsD;AACtD,eAAO,MAAM,OAAO,SAAU,MAAM,GAAG,IAAI,YAA0D,CAAA"}

package/dist/botcheck/reasons.js

@@ -0,0 +1,29 @@
+/**
+ * Light on purpose: real people without a photo, a username or a bio are common. A messenger's own
+ * mark or a ban list's entry weighs more, because somebody already looked.
+ */
+export const WEIGHTS = {
+    bot: 3,
+    scam: 3,
+    fake: 3,
+    deleted: 1,
+    no_photo: 1,
+    no_username: 1,
+    odd_name: 1,
+    never_wrote: 1,
+    link_first: 2,
+    burst_join: 1,
+    mass_invited: 1,
+    new_account: 2,
+    no_bio: 1,
+    same_text: 2,
+    photo_recent: 1,
+    cas_banned: 3,
+    lols_banned: 3,
+    lols_scammer: 3,
+};
+export const LINK = /https?:\/\/|t\.me\/|www\./i;
+const DIGITS = /\d{5,}/;
+/** No name, a long run of digits, or a link in it. */
+export const oddName = (name) => !name?.trim() || DIGITS.test(name) || LINK.test(name);
+//# sourceMappingURL=reasons.js.map

package/dist/botcheck/reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.js","sourceRoot":"","sources":["../../src/botcheck/reasons.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAA8B;IAChD,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;CAChB,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,4BAA4B,CAAA;AAChD,MAAM,MAAM,GAAG,QAAQ,CAAA;AAEvB,sDAAsD;AACtD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA"}

package/dist/botcheck/registries.d.ts

@@ -0,0 +1,38 @@
+import type { Id } from "../domain/models.js";
+import type { RegistryReason } from "./reasons.js";
+export type RegistryName = "cas" | "lols";
+export interface RegistryAnswer {
+    name: RegistryName;
+    /** `unknown` when the registry did not answer, refused, or answered something this build cannot read. */
+    answer: "listed" | "clean" | "unknown";
+    checkedAt: string;
+    /** Why `unknown`, or what the listing says — never the address asked or a key. */
+    detail?: string;
+    /** The reasons a listing adds to the score. */
+    reasons?: RegistryReason[];
+}
+export interface RegistryOptions {
+    fetch?: typeof fetch;
+    /** Combot's key, where the owner keeps one; CAS answers without one for now. */
+    casKey?: string;
+    now?: () => Date;
+    timeoutMs?: number;
+}
+/** Where each one is documented, for the help text and the MCP description. */
+export declare const REGISTRIES: Record<RegistryName, {
+    title: string;
+    docs: string;
+}>;
+/**
+ * Asks each registry about one Telegram id, side by side. A registry down or refusing is `unknown`,
+ * never an error: the rest of the check still answers. Nothing here may put the request's address
+ * in a message — a key could sit in it — so failures are described, not quoted.
+ */
+export declare const askRegistries: (id: Id, options?: RegistryOptions) => Promise<RegistryAnswer[]>;
+/** `ok: true` with a result is a listing; `ok: false` "Record not found." is clean (seen 2026-10-06). */
+export declare const askCas: (id: Id, options?: RegistryOptions) => Promise<RegistryAnswer>;
+/** `banned` and `scammer` per lols.bot's own OpenAPI description. */
+export declare const askLols: (id: Id, options?: RegistryOptions) => Promise<RegistryAnswer>;
+/** For a messenger the registries do not cover: every one `unknown`, saying why. */
+export declare const notCovered: (provider: string, now?: Date) => RegistryAnswer[];
+//# sourceMappingURL=registries.d.ts.map

package/dist/botcheck/registries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/botcheck/registries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,yGAAyG;IACzG,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,+EAA+E;AAC/E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAG5E,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,aAAa,OAAc,EAAE,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,EAAE,CAC1C,CAAA;AA4B1D,yGAAyG;AACzG,eAAO,MAAM,MAAM,OAAc,EAAE,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,CA6B1F,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,OAAO,OAAc,EAAE,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,CAsB3F,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU,aAAc,MAAM,iBAAqB,cAAc,EAMzE,CAAA"}

package/dist/botcheck/registries.js

@@ -0,0 +1,98 @@
+/** Where each one is documented, for the help text and the MCP description. */
+export const REGISTRIES = {
+    cas: { title: "Combot Anti-Spam (CAS)", docs: "https://cas.chat/api" },
+    lols: { title: "lols.bot", docs: "https://api.lols.bot/lols-bot.json" },
+};
+const TIMEOUT_MS = 10_000;
+/**
+ * Asks each registry about one Telegram id, side by side. A registry down or refusing is `unknown`,
+ * never an error: the rest of the check still answers. Nothing here may put the request's address
+ * in a message — a key could sit in it — so failures are described, not quoted.
+ */
+export const askRegistries = async (id, options = {}) => Promise.all([askCas(id, options), askLols(id, options)]);
+const getJson = async (url, headers, { fetch: fetchFn = fetch, timeoutMs = TIMEOUT_MS }) => {
+    try {
+        const response = await fetchFn(url, {
+            headers: { accept: "application/json", ...headers },
+            signal: AbortSignal.timeout(timeoutMs),
+            redirect: "error",
+        });
+        const text = await response.text();
+        try {
+            return { status: response.status, body: JSON.parse(text) };
+        }
+        catch {
+            return { failed: `answered ${response.status} with something that is not JSON` };
+        }
+    }
+    catch (error) {
+        return {
+            failed: error instanceof Error && error.name === "TimeoutError" ? "did not answer in time" : "unreachable",
+        };
+    }
+};
+const isObject = (value) => typeof value === "object" && value !== null;
+/** `ok: true` with a result is a listing; `ok: false` "Record not found." is clean (seen 2026-10-06). */
+export const askCas = async (id, options = {}) => {
+    const checkedAt = (options.now?.() ?? new Date()).toISOString();
+    const got = await getJson(`https://api.cas.chat/check?user_id=${encodeURIComponent(id)}`, options.casKey ? { authorization: `Bearer ${options.casKey}` } : {}, options);
+    const unknown = (detail) => ({ name: "cas", answer: "unknown", checkedAt, detail });
+    if ("failed" in got)
+        return unknown(got.failed);
+    if (got.status === 401)
+        return unknown(options.casKey ? "refused the key" : "now asks for a key from combot.org");
+    const { body } = got;
+    if (!isObject(body) || typeof body.ok !== "boolean")
+        return unknown("answered in an unexpected shape");
+    if (!body.ok) {
+        return body.description === "Record not found."
+            ? { name: "cas", answer: "clean", checkedAt }
+            : unknown(typeof body.description === "string" ? body.description : "refused");
+    }
+    const result = isObject(body.result) ? body.result : {};
+    const offenses = typeof result.offenses === "number" ? result.offenses : undefined;
+    const since = typeof result.time_added === "string" ? result.time_added : undefined;
+    return {
+        name: "cas",
+        answer: "listed",
+        checkedAt,
+        detail: ["banned", offenses === undefined ? "" : `${offenses} offenses`, since ? `since ${since}` : ""]
+            .filter(Boolean)
+            .join(", "),
+        reasons: ["cas_banned"],
+    };
+};
+/** `banned` and `scammer` per lols.bot's own OpenAPI description. */
+export const askLols = async (id, options = {}) => {
+    const checkedAt = (options.now?.() ?? new Date()).toISOString();
+    const got = await getJson(`https://api.lols.bot/account?id=${encodeURIComponent(id)}`, {}, options);
+    const unknown = (detail) => ({ name: "lols", answer: "unknown", checkedAt, detail });
+    if ("failed" in got)
+        return unknown(got.failed);
+    const { body } = got;
+    if (got.status !== 200 || !isObject(body) || body.ok !== true || typeof body.banned !== "boolean") {
+        return unknown(`answered ${got.status} in an unexpected shape`);
+    }
+    const reasons = [
+        ...(body.banned ? ["lols_banned"] : []),
+        ...(body.scammer === true ? ["lols_scammer"] : []),
+    ];
+    if (reasons.length === 0)
+        return { name: "lols", answer: "clean", checkedAt };
+    const facts = [
+        body.banned ? "banned" : "",
+        body.scammer === true ? "scammer" : "",
+        typeof body.offenses === "number" ? `${body.offenses} offenses` : "",
+        typeof body.spam_factor === "number" ? `spam factor ${body.spam_factor}` : "",
+        typeof body.when === "string" ? `since ${body.when}` : "",
+    ];
+    return { name: "lols", answer: "listed", checkedAt, detail: facts.filter(Boolean).join(", "), reasons };
+};
+/** For a messenger the registries do not cover: every one `unknown`, saying why. */
+export const notCovered = (provider, now = new Date()) => Object.keys(REGISTRIES).map((name) => ({
+    name,
+    answer: "unknown",
+    checkedAt: now.toISOString(),
+    detail: `lists Telegram accounts only, not ${provider}`,
+}));
+//# sourceMappingURL=registries.js.map

package/dist/botcheck/registries.js.map

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

package/dist/botcheck/service.d.ts

@@ -0,0 +1,16 @@
+import type { ServiceDeps } from "../services/deps.js";
+import { type BotCheck } from "./check.js";
+import { type RegistryOptions } from "./registries.js";
+export interface CheckOptions {
+    /** Ask the public ban lists; the person's id goes to each of them. */
+    registries: boolean;
+    registry?: RegistryOptions;
+}
+export interface BotCheckService {
+    /** Scores one person; never changes anything, never writes to them. */
+    person(reference: string, options: CheckOptions): Promise<BotCheck & {
+        notes: string[];
+    }>;
+}
+export declare const botCheckService: (deps: ServiceDeps) => BotCheckService;
+//# sourceMappingURL=service.d.ts.map

package/dist/botcheck/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/botcheck/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,KAAK,QAAQ,EAAsE,MAAM,YAAY,CAAA;AAC9G,OAAO,EAAkD,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAKtG,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAC1F;AAKD,eAAO,MAAM,eAAe,SAAU,WAAW,KAAG,eAiFnD,CAAA"}

package/dist/botcheck/service.js

@@ -0,0 +1,94 @@
+import { pickPerson } from "../resolve.js";
+import { storeIfOpen } from "../services/deps.js";
+import { scorePerson } from "./check.js";
+import { askRegistries, notCovered } from "./registries.js";
+/** Their stored messages read at most; enough for a first message and repeats, not a whole history. */
+const ACTIVITY_MESSAGES = 1000;
+/** The registries list Telegram accounts; a bot of another messenger is not in them. */
+const TELEGRAM = "telegram";
+export const botCheckService = (deps) => {
+    const subjectOf = async (reference) => {
+        if (!deps.offline) {
+            const connection = await deps.connection();
+            if (connection.profile) {
+                const facts = await connection.profile(reference);
+                const photos = connection.photos ? await connection.photos(facts.id) : undefined;
+                const { bot, scam, fake, deleted } = facts.flags;
+                return {
+                    subject: {
+                        id: facts.id,
+                        name: facts.name,
+                        usernames: facts.usernames,
+                        bio: facts.bio,
+                        flags: {
+                            ...(bot === undefined ? {} : { bot }),
+                            ...(scam === undefined ? {} : { scam }),
+                            ...(fake === undefined ? {} : { fake }),
+                            ...(deleted === undefined ? {} : { deleted }),
+                        },
+                        ...(facts.hasPhoto === undefined ? {} : { hasPhoto: facts.hasPhoto }),
+                        ...(facts.registered === undefined ? {} : { registered: facts.registered }),
+                    },
+                    ...(photos ? { photos } : {}),
+                };
+            }
+            if (connection.contact) {
+                const card = await connection.contact(reference);
+                const photos = connection.photos ? await connection.photos(card.id) : undefined;
+                return {
+                    subject: {
+                        id: card.id,
+                        name: card.name,
+                        usernames: card.username ? [card.username] : [],
+                        bio: card.description,
+                    },
+                    ...(photos ? { photos } : {}),
+                };
+            }
+        }
+        const store = await deps.store();
+        const account = await deps.account();
+        const found = pickPerson(reference, await store.people(account.provider, { account: account.account }));
+        return { subject: { id: found.id, name: found.name, usernames: found.username ? [found.username] : [] } };
+    };
+    const activityOf = async (id) => {
+        const held = await storeIfOpen(deps);
+        if (!held)
+            return undefined;
+        const { store, account } = held;
+        const page = await store.find({ account, senders: [id], limit: ACTIVITY_MESSAGES });
+        return {
+            messages: page.items,
+            complete: !page.hasMore,
+            chatsStored: (await store.chatsWith(account, id)).length,
+        };
+    };
+    return {
+        person: async (reference, { registries, registry }) => {
+            const { subject, photos } = await subjectOf(reference);
+            const provider = deps.messenger.provider;
+            const notes = [];
+            let answers = [];
+            if (!registries)
+                notes.push("the ban lists were not asked");
+            else if (deps.offline)
+                notes.push("offline: the ban lists were not asked");
+            else
+                answers = provider === TELEGRAM ? await askRegistries(subject.id, registry) : notCovered(provider);
+            const activity = await activityOf(subject.id);
+            if (!activity)
+                notes.push("no local store: what they wrote was not judged");
+            return {
+                ...scorePerson({
+                    subject,
+                    provider,
+                    ...(activity ? { activity } : {}),
+                    ...(photos ? { photos } : {}),
+                    registries: answers,
+                }),
+                notes,
+            };
+        },
+    };
+};
+//# sourceMappingURL=service.js.map

package/dist/botcheck/service.js.map

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

package/dist/charts/chat.d.ts

@@ -0,0 +1,10 @@
+import type { ChatStats } from "../services/chat-stats.js";
+import { type ChartData, type ChartKind, type ChartPeriod } from "./model.js";
+export declare const chartKindOf: (value: string) => ChartKind;
+export declare const chartPeriodOf: (value: string) => ChartPeriod;
+export declare const chatChart: (stats: ChatStats, { kind, by, timezone }: {
+    kind?: ChartKind;
+    by?: ChartPeriod;
+    timezone: string;
+}) => ChartData;
+//# sourceMappingURL=chat.d.ts.map

package/dist/charts/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/charts/chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1F,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,SAK3C,CAAA;AAED,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,WAG7C,CAAA;AAqBD,eAAO,MAAM,SAAS,UACb,SAAS,0BAC6B;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KACpG,SAoCF,CAAA"}