@wirecat/cli-core 0.263.0 → 0.265.0

package/dist/cli/messenger/chat-lists.d.ts

@@ -0,0 +1,161 @@
+import type { Services } from "../../services/index.js";
+/**
+ * The chat lists as the CLI and MCP both answer them: the query read against the list's fields, the source
+ * asked only what it answers, the rows as entities. `query` is the words typed after the arguments.
+ */
+export interface Paging {
+    limit: number;
+    page: number;
+    all?: boolean;
+}
+export declare const chatsList: (services: Services, query: string | readonly string[] | undefined, paging: Paging) => Promise<import("../envelope.js").ListBody<{
+    ref: string;
+    id: string;
+    provider?: string | undefined;
+    account?: string | undefined;
+    title: string | null;
+    kind: "channel" | "dialog" | "group" | "saved" | "unknown";
+    unread_count: number | null;
+    unread_mentions?: number | undefined;
+    last_message_at: string | null;
+    participants_count: number | null;
+    muted?: boolean | undefined;
+    archived?: boolean | undefined;
+    membership_state?: "archived" | "external" | "imported" | "joined" | "left" | "public" | undefined;
+    parent_chat_id?: string | undefined;
+    scope?: "personal" | "work" | undefined;
+    provider_metadata?: {
+        [x: string]: unknown;
+    } | undefined;
+    description?: string | null | undefined;
+    invite_link?: string | null | undefined;
+    settings?: {
+        all_can_pin?: boolean | null | undefined;
+        only_admins_add?: boolean | null | undefined;
+        only_admins_call?: boolean | null | undefined;
+        only_owner_edits_info?: boolean | null | undefined;
+        members_see_link?: boolean | null | undefined;
+        join_approval?: boolean | null | undefined;
+    } | undefined;
+    members?: {
+        id: string;
+        name: string | null;
+        username: string | null;
+        role?: "admin" | "member" | "owner" | undefined;
+        last_seen_at?: string | null | undefined;
+        registered_at?: string | null | undefined;
+        joined_at?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        is_bot?: boolean | undefined;
+        deleted?: boolean | undefined;
+        flagged?: "fake" | "scam" | undefined;
+        has_photo?: boolean | undefined;
+        score?: number | undefined;
+        reasons?: string[] | undefined;
+        check?: {
+            [x: string]: unknown;
+        } | undefined;
+    }[] | null | undefined;
+}>>;
+export declare const chatEvents: (services: Services, chat: string, query: string | readonly string[] | undefined) => Promise<import("../envelope.js").ListBody<{
+    chat_id: string;
+    time: string;
+    type: string;
+    message_id?: string | undefined;
+    by?: {
+        id: string | null;
+        name: string | null;
+        username?: string | null | undefined;
+    } | undefined;
+    people: {
+        id: string | null;
+        name: string | null;
+        username?: string | null | undefined;
+    }[];
+    title?: string | undefined;
+    before?: {
+        name: string | null;
+        username: string | null;
+    } | undefined;
+}>>;
+export declare const membersList: (services: Services, chat: string, paging: Paging) => Promise<import("../envelope.js").ListBody<{
+    id: string;
+    name: string | null;
+    username: string | null;
+    role?: "admin" | "member" | "owner" | undefined;
+    last_seen_at?: string | null | undefined;
+    registered_at?: string | null | undefined;
+    joined_at?: string | null | undefined;
+    invited_by?: string | null | undefined;
+    is_bot?: boolean | undefined;
+    deleted?: boolean | undefined;
+    flagged?: "fake" | "scam" | undefined;
+    has_photo?: boolean | undefined;
+    score?: number | undefined;
+    reasons?: string[] | undefined;
+    check?: {
+        [x: string]: unknown;
+    } | undefined;
+}>>;
+export declare const membersHistory: (services: Services, chat: string, query: string | readonly string[] | undefined) => Promise<import("../envelope.js").ListBody<{
+    chat_id: string;
+    time: string;
+    type: string;
+    message_id?: string | undefined;
+    by?: {
+        id: string | null;
+        name: string | null;
+        username?: string | null | undefined;
+    } | undefined;
+    people: {
+        id: string | null;
+        name: string | null;
+        username?: string | null | undefined;
+    }[];
+    title?: string | undefined;
+    before?: {
+        name: string | null;
+        username: string | null;
+    } | undefined;
+}>>;
+export declare const membersAudit: (services: Services, chat: string, query: string | readonly string[] | undefined, options: Omit<Parameters<Services["chats"]["audit"]>[1], "minScore">) => Promise<{
+    audit: import("../../services/members-audit.js").MembersAudit;
+    body: import("../envelope.js").ListBody<{
+        id: string;
+        name: string | null;
+        username: string | null;
+        role?: "admin" | "member" | "owner" | undefined;
+        last_seen_at?: string | null | undefined;
+        registered_at?: string | null | undefined;
+        joined_at?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        is_bot?: boolean | undefined;
+        deleted?: boolean | undefined;
+        flagged?: "fake" | "scam" | undefined;
+        has_photo?: boolean | undefined;
+        score?: number | undefined;
+        reasons?: string[] | undefined;
+        check?: {
+            [x: string]: unknown;
+        } | undefined;
+    }>;
+}>;
+/** The source takes a count but no offset, so page n reads n pages and shows the last. */
+export declare const inviteLinks: (services: Services, chat: string, query: string | readonly string[] | undefined, { limit, page }: Paging) => Promise<import("../envelope.js").ListBody<{
+    link: string;
+    approval: boolean;
+    expires_at: string | null;
+    max_uses: number | null;
+    primary?: boolean | undefined;
+    revoked?: boolean | undefined;
+    pending_count?: number | undefined;
+    joined_count?: number | undefined;
+}>>;
+export declare const joinRequests: (services: Services, chat: string, query: string | readonly string[] | undefined, { limit, page }: Paging) => Promise<import("../envelope.js").ListBody<{
+    person_id: string;
+    name: string | null;
+    username: string | null;
+    requested_at: string | null;
+    about?: string | undefined;
+}>>;
+//# sourceMappingURL=chat-lists.d.ts.map

package/dist/cli/messenger/chat-lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-lists.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chat-lists.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAkBvD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAOD,eAAO,MAAM,SAAS,aAAoB,QAAQ,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,UAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAShH,CAAA;AAED,eAAO,MAAM,UAAU,aAAoB,QAAQ,QAAQ,MAAM,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;GAS/G,CAAA;AAED,eAAO,MAAM,WAAW,aAAoB,QAAQ,QAAQ,MAAM,UAAU,MAAM;;;;;;;;;;;;;;;;;;GAQjF,CAAA;AAED,eAAO,MAAM,cAAc,aACf,QAAQ,QACZ,MAAM,SACL,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;GAY9C,CAAA;AAED,eAAO,MAAM,YAAY,aACb,QAAQ,QACZ,MAAM,SACL,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,WACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;EAKrE,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,WAAW,aACZ,QAAQ,QACZ,MAAM,SACL,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,mBAC5B,MAAM;;;;;;;;;GAYxB,CAAA;AAED,eAAO,MAAM,YAAY,aACb,QAAQ,QACZ,MAAM,SACL,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,mBAC5B,MAAM;;;;;;GAsBxB,CAAA"}

package/dist/cli/messenger/chat-lists.js

@@ -0,0 +1,82 @@
+import { queryError } from "@wirecat/cli-base/query";
+import { listOf } from "../envelope.js";
+import { LIST_QUERY_GUIDE, listQuery, nativeTerms, searchText, timeBounds } from "../list-query.js";
+import { nextStep } from "../steps.js";
+import { auditAnswer, chatAnswer, chatEventAnswer, inviteLinkAnswer, joinRequestAnswer, memberAnswer, memberEventAnswer, pageOf, scoreFloor, wholeList, } from "./chat-answers.js";
+import { AUDIT_QUERY, CHATS_QUERY, EVENTS_QUERY, HISTORY_QUERY, LINKS_QUERY, REQUESTS_QUERY } from "./chat-queries.js";
+const textOf = (query) => typeof query === "string" ? query : (query ?? []).join(" ");
+const typed = (query) => textOf(query).trim() || undefined;
+export const chatsList = async (services, query, paging) => {
+    listQuery(textOf(query), CHATS_QUERY, "chats list");
+    const { limit, page, all } = paging;
+    const found = await services.chats.list(all ? { offset: 0 } : { limit, offset: (page - 1) * limit });
+    const account = await services.chats.account();
+    return listOf("chats list", {
+        items: found.items.map((one) => chatAnswer(account, one)),
+        ...pageOf(paging, found),
+    });
+};
+export const chatEvents = async (services, chat, query) => {
+    const terms = nativeTerms(listQuery(textOf(query), EVENTS_QUERY, "chats events"), "chats events");
+    const { since } = timeBounds(terms.get("time"));
+    const found = await services.chats.events(chat, since === undefined ? {} : { since });
+    return wholeList("chats events", found.events.map((one) => chatEventAnswer(found.chatId, one)), found.more ? { meta: { truncated: true } } : {});
+};
+export const membersList = async (services, chat, paging) => {
+    const { limit, page, all } = paging;
+    const found = await services.chats.members(chat, all ? { offset: 0 } : { limit, offset: (page - 1) * limit });
+    return listOf("chats members list", {
+        items: found.items.map(memberAnswer),
+        ...pageOf(paging, found),
+        args: { chat },
+    });
+};
+export const membersHistory = async (services, chat, query) => {
+    const terms = nativeTerms(listQuery(textOf(query), HISTORY_QUERY, "chats members history"), "chats members history");
+    const { since } = timeBounds(terms.get("time"));
+    const found = await services.chats.memberHistory(chat, since === undefined ? {} : { since });
+    return wholeList("chats members history", found.events.map((one) => memberEventAnswer(found.chatId, one)), found.events.length === 0
+        ? { next: [nextStep("chats.members-fetch", { args: { chat: found.chatId, track: true } })] }
+        : {});
+};
+export const membersAudit = async (services, chat, query, options) => {
+    const minScore = scoreFloor(listQuery(textOf(query), AUDIT_QUERY, "chats members audit"));
+    const audit = await services.chats.audit(chat, { ...options, minScore });
+    return { audit, body: auditAnswer(audit) };
+};
+/** The source takes a count but no offset, so page n reads n pages and shows the last. */
+export const inviteLinks = async (services, chat, query, { limit, page }) => {
+    const terms = nativeTerms(listQuery(textOf(query), LINKS_QUERY, "chats link list"), "chats link list");
+    const revoked = terms.get("revoked")?.value.toLowerCase() === "true";
+    const found = await services.admin.links(chat, { limit: limit * page, revoked });
+    return listOf("chats link list", {
+        items: found.items.slice((page - 1) * limit).map(inviteLinkAnswer),
+        limit,
+        has_more: found.hasMore,
+        page,
+        args: { chat, query: typed(query) },
+    });
+};
+export const joinRequests = async (services, chat, query, { limit, page }) => {
+    const terms = nativeTerms(listQuery(textOf(query), REQUESTS_QUERY, "chats requests list"), "chats requests list");
+    if (terms.has("name") && terms.has("username"))
+        queryError("query.unsupported-placement", terms.get("username").span, "name or username, not both", {
+            command: "chats requests list",
+            guide: LIST_QUERY_GUIDE,
+        });
+    const search = searchText(terms.get("name") ?? terms.get("username"));
+    const link = terms.get("link")?.value;
+    const found = await services.admin.requests(chat, {
+        limit: limit * page,
+        ...(search === undefined ? {} : { search }),
+        ...(link === undefined ? {} : { link }),
+    });
+    return listOf("chats requests list", {
+        items: found.items.slice((page - 1) * limit).map(joinRequestAnswer),
+        limit,
+        has_more: found.hasMore,
+        page,
+        args: { chat, query: typed(query) },
+    });
+};
+//# sourceMappingURL=chat-lists.js.map

package/dist/cli/messenger/chat-lists.js.map

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

package/dist/cli/messenger/chat-queries.d.ts

@@ -0,0 +1,14 @@
+import type { QueryRegistry } from "@wirecat/cli-base/query";
+/** Neither the messenger nor the store filters the chat list, so every field is refused for now. */
+export declare const CHATS_QUERY: QueryRegistry;
+/** The messenger reads a chat's events back to a time; it cannot pick them by type. */
+export declare const EVENTS_QUERY: QueryRegistry;
+/** The store's member history is read back to a time. */
+export declare const HISTORY_QUERY: QueryRegistry;
+/** The audit scores every member it reads; the query sets the lowest score it shows. */
+export declare const AUDIT_QUERY: QueryRegistry;
+/** The messenger lists either the live links or the revoked ones. */
+export declare const LINKS_QUERY: QueryRegistry;
+/** The messenger searches requests by name or @username, or keeps one link's; never both at once. */
+export declare const REQUESTS_QUERY: QueryRegistry;
+//# sourceMappingURL=chat-queries.d.ts.map

package/dist/cli/messenger/chat-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-queries.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chat-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAK5D,oGAAoG;AACpG,eAAO,MAAM,WAAW,EAAE,aAIzB,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,YAAY,EAAE,aAI1B,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,aAAa,EAAE,aAI3B,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,WAAW,EAAE,aAKzB,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE,aAIzB,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,cAAc,EAAE,aAW5B,CAAA"}

package/dist/cli/messenger/chat-queries.js

@@ -0,0 +1,48 @@
+import { queryFieldsOf } from "@wirecat/cli-base/query";
+import { chat, chatEvent, inviteLink, joinRequest, member } from "../../entities/index.js";
+import { AUDIT_MIN_SCORE } from "../../services/members-audit.js";
+/** Neither the messenger nor the store filters the chat list, so every field is refused for now. */
+export const CHATS_QUERY = {
+    entity: "chat",
+    backend: "native",
+    fields: queryFieldsOf(chat, { exclude: ["provider_metadata"] }),
+};
+/** The messenger reads a chat's events back to a time; it cannot pick them by type. */
+export const EVENTS_QUERY = {
+    entity: "chat_event",
+    backend: "native",
+    fields: queryFieldsOf(chatEvent, { native: ["time"], examples: { time: "time>=2d" } }),
+};
+/** The store's member history is read back to a time. */
+export const HISTORY_QUERY = {
+    entity: "chat_event",
+    backend: "native",
+    fields: queryFieldsOf(chatEvent, { native: ["time"], examples: { time: "time>=7d" } }),
+};
+/** The audit scores every member it reads; the query sets the lowest score it shows. */
+export const AUDIT_QUERY = {
+    entity: "member",
+    backend: "native",
+    fields: queryFieldsOf(member, { exclude: ["check"], native: ["score"], examples: { score: "score>=3" } }),
+    defaults: [`score>=${AUDIT_MIN_SCORE}`],
+};
+/** The messenger lists either the live links or the revoked ones. */
+export const LINKS_QUERY = {
+    entity: "invite_link",
+    backend: "native",
+    fields: queryFieldsOf(inviteLink, { native: ["revoked"] }),
+};
+/** The messenger searches requests by name or @username, or keeps one link's; never both at once. */
+export const REQUESTS_QUERY = {
+    entity: "join_request",
+    backend: "native",
+    fields: queryFieldsOf(joinRequest, {
+        native: ["name", "username", "link"],
+        text: ["name", "username"],
+        relations: {
+            link: { type: "kw", example: 'link:"https://example.test/+abc"', relation: "the invite link they asked through" },
+        },
+        examples: { name: "name:ana", username: "username:ana" },
+    }),
+};
+//# sourceMappingURL=chat-queries.js.map

package/dist/cli/messenger/chat-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-queries.js","sourceRoot":"","sources":["../../../src/cli/messenger/chat-queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEjE,oGAAoG;AACpG,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;CAChE,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;CACvF,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;CACvF,CAAA;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;IACzG,QAAQ,EAAE,CAAC,UAAU,eAAe,EAAE,CAAC;CACxC,CAAA;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;CAC3D,CAAA;AAED,qGAAqG;AACrG,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa,CAAC,WAAW,EAAE;QACjC,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC;QACpC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;QAC1B,SAAS,EAAE;YACT,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,kCAAkC,EAAE,QAAQ,EAAE,oCAAoC,EAAE;SAClH;QACD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE;KACzD,CAAC;CACH,CAAA"}

package/dist/cli/messenger/chats-bots-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chats-bots-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-bots-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAE/D,4FAA4F;AAC5F,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,OAAO,EA2B7D,CAAA"}
+{"version":3,"file":"chats-bots-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-bots-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAE/D,4FAA4F;AAC5F,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,OAAO,EA0C7D,CAAA"}

package/dist/cli/messenger/chats-bots-command.js

@@ -1,6 +1,8 @@
 import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
 import { guardedApp, guardedStart } from "../../sends/buttons.js";
+import { itemOf, renderAnswer } from "../envelope.js";
+import { snakeKeys } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
 /** `chats start` and `chats app` — a bot in a one-to-one chat with the personal account. */
 export const botChatCommands = (messenger) => [
@@ -11,7 +13,7 @@ export const botChatCommands = (messenger) => [
         .action(async function (bot) {
         const context = messengerContext(this, messenger);
         const { payload } = this.opts();
-        context.renderer.result(await context.withMessenger((connection) => guardedStart(context.guard, connection, { chat: bot, ...(payload === undefined ? {} : { payload }) })));
+        renderAnswer(this, context, itemOf(snakeKeys(await context.withMessenger((connection) => guardedStart(context.guard, connection, { chat: bot, ...(payload === undefined ? {} : { payload }) })))));
     }),
     annotate(new Command("app"), { mutates: true })
         .description("the address that opens a bot's mini app, signed in as you — keep it to yourself")
@@ -20,7 +22,10 @@ export const botChatCommands = (messenger) => [
         .action(async function (bot) {
         const context = messengerContext(this, messenger);
         const { start } = this.opts();
-        context.renderer.result(await context.withMessenger((connection) => guardedApp(context.guard, connection, { chat: bot, ...(start === undefined ? {} : { startParam: start }) })));
+        renderAnswer(this, context, itemOf(snakeKeys(await context.withMessenger((connection) => guardedApp(context.guard, connection, {
+            chat: bot,
+            ...(start === undefined ? {} : { startParam: start }),
+        })))));
     }),
 ];
 //# sourceMappingURL=chats-bots-command.js.map

package/dist/cli/messenger/chats-bots-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"chats-bots-command.js","sourceRoot":"","sources":["../../../src/cli/messenger/chats-bots-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAkB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/D,4FAA4F;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAoB,EAAa,EAAE,CAAC;IAClE,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC9C,WAAW,CAAC,yEAAyE,CAAC;SACtF,QAAQ,CAAC,OAAO,EAAE,uFAAuF,CAAC;SAC1G,MAAM,CAAC,kBAAkB,EAAE,wEAAwE,CAAC;SACpG,MAAM,CAAC,KAAK,WAA0B,GAAW;QAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAwB,CAAA;QACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CACrB,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,UAAU,EAAE,EAAE,CACzC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CACtG,CACF,CAAA;IACH,CAAC,CAAC;IACJ,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC5C,WAAW,CAAC,iFAAiF,CAAC;SAC9F,QAAQ,CAAC,OAAO,EAAE,2CAA2C,CAAC;SAC9D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;SAC9D,MAAM,CAAC,KAAK,WAA0B,GAAW;QAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,EAAsB,CAAA;QACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CACrB,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,UAAU,EAAE,EAAE,CACzC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAC5G,CACF,CAAA;IACH,CAAC,CAAC;CACL,CAAA"}
+{"version":3,"file":"chats-bots-command.js","sourceRoot":"","sources":["../../../src/cli/messenger/chats-bots-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAkB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/D,4FAA4F;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAoB,EAAa,EAAE,CAAC;IAClE,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC9C,WAAW,CAAC,yEAAyE,CAAC;SACtF,QAAQ,CAAC,OAAO,EAAE,uFAAuF,CAAC;SAC1G,MAAM,CAAC,kBAAkB,EAAE,wEAAwE,CAAC;SACpG,MAAM,CAAC,KAAK,WAA0B,GAAW;QAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAwB,CAAA;QACrD,YAAY,CACV,IAAI,EACJ,OAAO,EACP,MAAM,CACJ,SAAS,CACP,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,UAAU,EAAE,EAAE,CACzC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CACtG,CACF,CACF,CACF,CAAA;IACH,CAAC,CAAC;IACJ,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC5C,WAAW,CAAC,iFAAiF,CAAC;SAC9F,QAAQ,CAAC,OAAO,EAAE,2CAA2C,CAAC;SAC9D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;SAC9D,MAAM,CAAC,KAAK,WAA0B,GAAW;QAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,EAAsB,CAAA;QACjD,YAAY,CACV,IAAI,EACJ,OAAO,EACP,MAAM,CACJ,SAAS,CACP,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,UAAU,EAAE,EAAE,CACzC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE;YACpC,IAAI,EAAE,GAAG;YACT,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;SACtD,CAAC,CACH,CACF,CACF,CACF,CAAA;IACH,CAAC,CAAC;CACL,CAAA"}

package/dist/cli/messenger/chats-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chats-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAYnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAG/D,eAAO,MAAM,YAAY,cAAe,SAAS,KAAG,OAoHnD,CAAA"}
+{"version":3,"file":"chats-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgBnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAG/D,eAAO,MAAM,YAAY,cAAe,SAAS,KAAG,OAoGnD,CAAA"}

package/dist/cli/messenger/chats-command.js

@@ -1,10 +1,15 @@
+import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
-import { CHAT_KINDS, checkedFilter, EVENTS_DAYS } from "../../services/chats.js";
-import { momentOf } from "../../services/moment.js";
-import { listed, renderPage, window, withPaging } from "../paging.js";
+import { EVENTS_DAYS } from "../../services/chats.js";
+import { itemOf, renderAnswer } from "../envelope.js";
+import { withQuery } from "../list-query.js";
+import { withPaging } from "../paging.js";
 import { groupCommands } from "./admin-commands.js";
 import { foldersCommand } from "./admin-folders-command.js";
 import { moderateCommand, rulesCommand } from "./admin-moderation-command.js";
+import { chatShown, lines, snakeKeys, wholeList } from "./chat-answers.js";
+import { chatEvents, chatsList } from "./chat-lists.js";
+import { CHATS_QUERY, EVENTS_QUERY } from "./chat-queries.js";
 import { botChatCommands } from "./chats-bots-command.js";
 import { documentsCommand } from "./chats-documents-command.js";
 import { membersCommand } from "./chats-members-command.js";
@@ -14,82 +19,42 @@ import { messengerContext } from "./context.js";
 import { chatDeletionCommands, mediaCommand, muteCommands } from "./records-command.js";
 export const chatsCommand = (messenger) => {
     const chats = new Command("chats").description("the account's chats");
-    chats.addCommand(withPaging(new Command("list").description("chats, newest first, archived ones included"))
-        .option("--search <text>", "only chats whose name contains this; at least 3 characters")
-        .option("--kind <kind>", `only chats of this kind: ${CHAT_KINDS.join(", ")}`)
-        .option("--unread", "only chats with unread messages")
-        .action(async function () {
+    chats.addCommand(withQuery(annotate(withPaging(new Command("list").description("chats, newest first, archived ones included")), {
+        output: { entity: "chat" },
+    }), CHATS_QUERY).action(async function (words) {
         const context = messengerContext(this, messenger);
-        const filter = checkedFilter(this.opts());
-        const wanted = window(context.settings);
-        const page = await context.withServices((services) => services.chats.list(filter, wanted));
-        if (page.partial) {
-            context.renderer.note("the messenger did not list every chat, and did not say how many it left out; one may match too");
-        }
-        renderPage(context, {
-            ...page,
-            items: context.format === "pretty"
-                ? page.items.map(({ id, title, kind, unreadCount, lastMessageAt }) => ({
-                    id,
-                    title,
-                    kind,
-                    unreadCount,
-                    lastMessageAt,
-                }))
-                : page.items,
-        });
+        const body = await context.withServices((services) => chatsList(services, words, context.settings));
+        renderAnswer(this, context, body, lines(({ id, title, kind, unread_count, last_message_at }) => [id, kind, title ?? "", unread_count ? `${unread_count} unread` : "", last_message_at ?? ""].join("  ")));
     }));
-    chats
-        .command("events")
-        .description("who joined, left, was added or removed, and by whom — from the chat's service messages")
-        .argument("<chat>", messenger.chatArgument)
-        .option("--since-time <time>", `ISO 8601, or 2h / 1d ago; ${EVENTS_DAYS} days ago if not given`)
-        .option("--type <names>", "only these, comma-separated: join, leave, add, remove, create, title, pin")
-        .action(async function (chat) {
+    chats.addCommand(withQuery(annotate(new Command("events")
+        .description("who joined, left, was added or removed, and by whom — from the chat's service messages; " +
+        `the last ${EVENTS_DAYS} days unless the query names time`)
+        .argument("<chat>", messenger.chatArgument), { output: { entity: "chat_event" } }), EVENTS_QUERY).action(async function (chat, words) {
         const context = messengerContext(this, messenger);
-        const { sinceTime: since, type } = this.opts();
-        const found = await context.withServices((services) => services.chats.events(chat, {
-            ...(since === undefined ? {} : { since: momentOf(since, "--since-time") }),
-            ...(type ? { only: type } : {}),
-        }));
-        if (context.format === "jsonl")
-            context.renderer.stream(found.events);
-        else if (context.format !== "pretty") {
-            const { events, more, ...rest } = found;
-            context.renderer.result({ ...listed(events), hasMore: more, ...rest });
-        }
-        else {
-            context.renderer.stream(found.events.map((one) => ({
-                time: one.timestamp,
-                event: one.event,
-                by: one.by.name ?? one.by.id,
-                people: one.people.map((person) => person.name ?? person.id).join(", "),
-            })));
-        }
-        if (found.more)
-            context.renderer.note("more history than one run reads — adjust --since-time to read more");
-    });
+        const body = await context.withServices((services) => chatEvents(services, chat, words));
+        renderAnswer(this, context, body, lines(({ time, type, by, people }) => [time, type, by?.name ?? by?.id ?? "", people.map((one) => one.name ?? one.id).join(", ")].join("  ")));
+        if (body.meta?.truncated)
+            context.renderer.note("more history than one run reads; a later time bound reads less");
+    }));
     chats
         .command("inspect")
         .description("what an invite or public link leads to, without joining it")
         .argument("<link>", "an invite link or a public one")
         .action(async function (link) {
         const context = messengerContext(this, messenger);
-        context.renderer.result(await context.withServices((services) => services.chats.inspect(link)));
+        const found = await context.withServices((services) => services.chats.inspect(link));
+        renderAnswer(this, context, itemOf(snakeKeys(found)));
     });
-    chats
-        .command("show")
+    chats.addCommand(annotate(new Command("show")
         .description("one chat: its kind, unread count, last message time and who is in it")
-        .argument("<chat>", messenger.chatArgument)
-        .action(async function (chat) {
+        .argument("<chat>", messenger.chatArgument), { output: { entity: "chat" } }).action(async function (chat) {
         const context = messengerContext(this, messenger);
-        const card = await context.withServices((services) => services.chats.show(chat));
-        context.renderer.result(card);
-        const { members, participantsCount } = card;
-        if (members && participantsCount !== null && members.length < participantsCount) {
-            context.renderer.note(`${members.length} listed members; the chat reports ${participantsCount} participants. The list may omit your account or be partial.`);
-        }
-    });
+        const { card, account } = await context.withServices(async (services) => ({
+            card: await services.chats.show(chat),
+            account: await services.chats.account(),
+        }));
+        renderAnswer(this, context, chatShown(account, card));
+    }));
     chats
         .command("send-as")
         .description("who this account may post as in a chat; changes no saved choice")
@@ -97,10 +62,7 @@ export const chatsCommand = (messenger) => {
         .action(async function (chat) {
         const context = messengerContext(this, messenger);
         const identities = await context.withServices((services) => services.chats.sendAs(chat));
-        if (context.format === "json")
-            context.renderer.result(listed(identities));
-        else
-            context.renderer.stream(identities);
+        renderAnswer(this, context, wholeList("chats send-as", identities.map(snakeKeys)));
     });
     chats.addCommand(documentsCommand(messenger));
     chats.addCommand(membersCommand(messenger));

package/dist/cli/messenger/chats-command.js.map

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

package/dist/cli/messenger/chats-documents-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chats-documents-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-documents-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAK/D,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,cAAe,SAAS,KAAG,OAuBvD,CAAA"}
+{"version":3,"file":"chats-documents-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-documents-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAE/D,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,cAAe,SAAS,KAAG,OA+BvD,CAAA"}

package/dist/cli/messenger/chats-documents-command.js

@@ -1,7 +1,9 @@
 import { Command } from "commander";
-import { positiveCount, renderPage, window } from "../paging.js";
+import { listOf, renderAnswer } from "../envelope.js";
+import { positiveCount, window } from "../paging.js";
+import { nextStep } from "../steps.js";
+import { documentLinkAnswer, lines, pageOf } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
-const line = ({ sentAt, sender, title, url, inStore }) => `${sentAt}  ${sender.name ?? sender.id ?? "?"}  ${title ?? url}  ${inStore ? "in store" : "not in store"}`;
 /** `chats documents …`: the Google documents linked in a chat's stored messages. */
 export const documentsCommand = (messenger) => {
     const documents = new Command("documents").description("the Google Docs and Drive documents linked in a chat's stored messages");
@@ -13,9 +15,12 @@ export const documentsCommand = (messenger) => {
         .action(async function (chat) {
         const context = messengerContext(this, messenger);
         const found = await context.withServices((services) => services.chatDocuments.list(chat, window(context.settings)));
-        if (found.empty)
-            context.renderer.note(`no stored messages in this chat — \`${messenger.app.command} messages sync ${found.chatId}\` fetches them`);
-        renderPage(context, found, (items) => items.map((item) => `${line(item)}\n`).join(""));
+        renderAnswer(this, context, listOf("chats documents list", {
+            items: found.items.map(documentLinkAnswer),
+            ...pageOf(context.settings, found),
+            args: { chat },
+            ...(found.empty ? { next: [nextStep("messages.sync", { args: { chat: found.chatId } })] } : {}),
+        }), lines(({ sent_at, sender, title, url, in_store }) => [sent_at, sender.name ?? sender.id ?? "?", title ?? url, in_store ? "in store" : "not in store"].join("  ")));
     }));
     return documents;
 };

package/dist/cli/messenger/chats-documents-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"chats-documents-command.js","sourceRoot":"","sources":["../../../src/cli/messenger/chats-documents-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAkB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/D,MAAM,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAgB,EAAE,EAAE,CACrE,GAAG,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,EAAE,CAAA;AAE5G,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAoB,EAAW,EAAE;IAChE,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CACpD,wEAAwE,CACzE,CAAA;IACD,SAAS,CAAC,UAAU,CAClB,IAAI,OAAO,CAAC,MAAM,CAAC;SAChB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;SACnE,MAAM,CAAC,YAAY,EAAE,2BAA2B,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;SAC1E,MAAM,CAAC,KAAK,WAA0B,IAAY;QACjD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,CACpD,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAC5D,CAAA;QACD,IAAI,KAAK,CAAC,KAAK;YACb,OAAO,CAAC,QAAQ,CAAC,IAAI,CACnB,uCAAuC,SAAS,CAAC,GAAG,CAAC,OAAO,kBAAkB,KAAK,CAAC,MAAM,iBAAiB,CAC5G,CAAA;QACH,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IACxF,CAAC,CAAC,CACL,CAAA;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}
+{"version":3,"file":"chats-documents-command.js","sourceRoot":"","sources":["../../../src/cli/messenger/chats-documents-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAkB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/D,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAoB,EAAW,EAAE;IAChE,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CACpD,wEAAwE,CACzE,CAAA;IACD,SAAS,CAAC,UAAU,CAClB,IAAI,OAAO,CAAC,MAAM,CAAC;SAChB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;SACnE,MAAM,CAAC,YAAY,EAAE,2BAA2B,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;SAC1E,MAAM,CAAC,KAAK,WAA0B,IAAY;QACjD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,CACpD,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAC5D,CAAA;QACD,YAAY,CACV,IAAI,EACJ,OAAO,EACP,MAAM,CAAC,sBAAsB,EAAE;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC1C,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;YAClC,IAAI,EAAE,EAAE,IAAI,EAAE;YACd,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChG,CAAC,EACF,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAClD,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,KAAK,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC5G,CACF,CAAA;IACH,CAAC,CAAC,CACL,CAAA;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}

package/dist/cli/messenger/chats-members-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chats-members-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-members-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAE/D,gFAAgF;AAChF,eAAO,MAAM,cAAc,cAAe,SAAS,KAAG,OAoMrD,CAAA"}
+{"version":3,"file":"chats-members-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/chats-members-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAE/D,gFAAgF;AAChF,eAAO,MAAM,cAAc,cAAe,SAAS,KAAG,OAkMrD,CAAA"}