@wirecat/cli-core 0.476.0 → 0.477.0

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

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { queryError, queryFieldsOf } from "@wirecat/cli-base/query";
-import { contact, pollVote } from "../../entities/index.js";
+import { contact, pollVote, reaction } from "../../entities/index.js";
 import { levelFor } from "../../sends/permissions.js";
 const notesText = (node) => {
     if (/[*?]/.test(node.value.replace(/^\*+|\*+$/g, "")))
@@ -34,3 +34,9 @@ export const VOTERS_QUERY = {
     backend: "native",
     fields: queryFieldsOf(pollVote, { native: ["answers"], examples: { answers: "answers:0" } }),
 };
+/** Telegram keeps the people who chose one reaction; one emoji at a time. */
+export const REACTORS_QUERY = {
+    entity: "reaction",
+    backend: "native",
+    fields: queryFieldsOf(reaction, { native: ["reaction"], examples: { reaction: "reaction:🔥" } }),
+};

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

@@ -1,11 +1,47 @@
 import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
-import { REMOTE_WRITE } from "../effects.js";
-import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { capability } from "../../ports/messenger.js";
+import { REMOTE_READ, REMOTE_WRITE } from "../effects.js";
+import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { listQuery, nativeTerms, typedQuery, withQuery } from "../list-query.js";
+import { positiveCount } from "../paging.js";
+import { lines, reactorAnswer } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
+import { REACTORS_QUERY } from "./people-queries.js";
 /** `reactions add|remove`: the owner's own reaction on a message. */
 export const reactionsCommand = (messenger) => {
     const reactions = new Command("reactions").description("react to messages");
+    if (messenger.reactionsList)
+        reactions.addCommand(withQuery(annotate(annotate(new Command("list"), {
+            effects: REMOTE_READ,
+            examples: [`${messenger.app.command} personal reactions list "Book club" 101 reaction:🔥 --limit 20`],
+        })
+            .description("who reacted to a message, newest first; refused where the chat hides the list")
+            .argument("<chat>", messenger.chatArgument)
+            .argument("<message>", "the message id")
+            .option("--limit <n>", "how many to show", positiveCount("--limit"))
+            .option("--cursor <cursor>", "go on from where the last page stopped; page.next gives it"), { output: { entity: "reaction" } }), REACTORS_QUERY).action(async function (chat, message, words) {
+            const emoji = nativeTerms(listQuery(typedQuery(words), REACTORS_QUERY, "reactions list"), "reactions list").get("reaction")?.value;
+            const context = messengerContext(this, messenger);
+            const { cursor } = this.opts();
+            const { limit } = context.settings;
+            const found = await context.withMessenger(async (connection) => {
+                const list = capability(connection, "reactors", "list who reacted");
+                return list((await connection.resolve(chat)).id, message.trim(), {
+                    limit,
+                    ...(emoji === undefined ? {} : { emoji: emoji.trim() }),
+                    ...(cursor === undefined ? {} : { cursor }),
+                });
+            });
+            renderAnswer(this, context, listOf("reactions list", {
+                items: found.items.map(reactorAnswer),
+                limit,
+                has_more: found.hasMore,
+                paging: "cursor",
+                ...(found.cursor === undefined ? {} : { cursor: found.cursor }),
+                args: { chat, message, ...(words.length > 0 ? { query: words.join(" ") } : {}) },
+            }), lines(({ reacted_at, person, reaction: name }) => [reacted_at, person.name ?? person.id, name].join("  ")));
+        }));
     annotate(reactions.command("add"), {
         effects: REMOTE_WRITE,
         output: { entity: "reaction_change" },

package/dist/cli/messenger/serve-relay.d.ts

@@ -44,6 +44,7 @@ export declare const serveRelay: (command: Command, messenger: Messenger) => {
         groupSettings?: readonly import("../../domain/models.js").GroupSettingKey[];
         pollQuiz?: boolean;
         pollCloseSeconds?: readonly [min: number, max: number];
+        reactionsList?: boolean;
         pollVoters?: boolean;
         pollClose?: boolean;
         pollRevote?: boolean;

package/dist/domain/models.d.ts

@@ -189,6 +189,18 @@ export interface Attachment {
     buttons?: Button[][];
     /** The poll the message carries, as it stood when read; drawn for a person, not part of the JSON answer. */
     poll?: Poll;
+    /** The contact card shared in the message (`kind: "contact"`), the phone as the sender typed it. */
+    contact?: SharedContact;
+}
+/** A contact card sent in a message: who it is for, and the number the sender put on it. */
+export interface SharedContact {
+    /** First and last name as shown. */
+    name: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    /** The messenger's account for the card, when the number belongs to one. */
+    userId?: Id;
 }
 /**
  * What pressing a bot's button does: `callback` tells the bot, `link` opens `url`, `message` sends its
@@ -284,6 +296,13 @@ export interface PersonReaction {
     /** ISO 8601 — when the person reacted, as the messenger says, not when it arrived. */
     reactedAt: string;
 }
+/** One person's reaction to a message, as `reactions list` gives it. */
+export interface Reactor {
+    person: Member;
+    reaction: string;
+    /** ISO 8601. */
+    reactedAt: string;
+}
 /** The message a reply answers or a forward carries. */
 export interface QuotedMessage {
     id: Id;
@@ -741,7 +760,7 @@ export interface Registered {
     /** How fine `at` is: Telegram tells a month, an estimate a month at best. */
     precision: "day" | "month";
 }
-/** Everything the messenger itself says about one person, as `contacts info` reads it. */
+/** Everything the messenger itself says about one person, as `contacts show` reads it. */
 export interface ProfileFacts {
     id: Id;
     name: string | null;
@@ -794,7 +813,7 @@ export interface PersonAlias {
     lastSeenAt: string;
     source: "profile" | "messages";
 }
-/** `contacts info`: the person, and their activity in every chat shared with them. */
+/** `contacts show`: the person, and their activity in every chat shared with them. */
 export interface PersonProfile extends Omit<ProfileFacts, "chats"> {
     chats: SharedChatActivity[];
     /** Earlier names and usernames, oldest first; the current ones are not repeated. */
@@ -815,7 +834,7 @@ export interface Account {
     name: string | null;
     /** The public handle, without `@`, when there is one. */
     username: string | null;
-    /** The whole number, where the messenger tells it; printed as its last four digits unless asked. */
+    /** The whole number, where the messenger tells it; `--hide-phone` leaves it out. */
     phone?: string | null;
 }
 export interface Profile {

package/dist/entities/attachment.d.ts

@@ -24,6 +24,14 @@ export declare const attachment: v.StrictObjectSchema<{
         readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>, undefined>;
     readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** A shared contact card (`kind: "contact"`); the phone is the whole number as the sender put it. */
+    readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    }, undefined>, undefined>;
     /** A bot's keyboard under the message, row by row; `messages press` presses one. */
     readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
         readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;

package/dist/entities/attachment.js

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { count, reference, text } from "./fields.js";
+import { count, id, reference, text } from "./fields.js";
 export const attachment = v.strictObject({
     /** The message it came with, as a locator; absent inside that message. */
     message: v.optional(reference),
@@ -20,6 +20,14 @@ export const attachment = v.strictObject({
     text: v.optional(text),
     extraction: v.optional(v.strictObject({ origin: text, extractor: text, chars: count, error: v.optional(text) })),
     local_path: v.optional(text),
+    /** A shared contact card (`kind: "contact"`); the phone is the whole number as the sender put it. */
+    contact: v.optional(v.strictObject({
+        name: text,
+        first_name: v.optional(text),
+        last_name: v.optional(text),
+        phone: v.optional(text),
+        user_id: v.optional(id),
+    })),
     /** A bot's keyboard under the message, row by row; `messages press` presses one. */
     buttons: v.optional(v.array(v.array(v.strictObject({
         kind: v.picklist(["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"]),

package/dist/entities/contact-context.d.ts

@@ -180,6 +180,13 @@ export declare const contactMessages: v.StrictObjectSchema<{
                     readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 }, undefined>, undefined>;
                 readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly name: v.StringSchema<undefined>;
+                    readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+                }, undefined>, undefined>;
                 readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
                     readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
                     readonly text: v.StringSchema<undefined>;
@@ -212,6 +219,13 @@ export declare const contactMessages: v.StrictObjectSchema<{
                         readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     }, undefined>, undefined>;
                     readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+                        readonly name: v.StringSchema<undefined>;
+                        readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+                    }, undefined>, undefined>;
                     readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
                         readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
                         readonly text: v.StringSchema<undefined>;
@@ -247,6 +261,13 @@ export declare const contactMessages: v.StrictObjectSchema<{
                         readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     }, undefined>, undefined>;
                     readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+                        readonly name: v.StringSchema<undefined>;
+                        readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+                    }, undefined>, undefined>;
                     readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
                         readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
                         readonly text: v.StringSchema<undefined>;
@@ -931,6 +952,13 @@ export declare const contactContext: v.UnionSchema<[v.StrictObjectSchema<{
                     readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 }, undefined>, undefined>;
                 readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly name: v.StringSchema<undefined>;
+                    readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+                }, undefined>, undefined>;
                 readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
                     readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
                     readonly text: v.StringSchema<undefined>;
@@ -963,6 +991,13 @@ export declare const contactContext: v.UnionSchema<[v.StrictObjectSchema<{
                         readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     }, undefined>, undefined>;
                     readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+                        readonly name: v.StringSchema<undefined>;
+                        readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+                    }, undefined>, undefined>;
                     readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
                         readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
                         readonly text: v.StringSchema<undefined>;
@@ -998,6 +1033,13 @@ export declare const contactContext: v.UnionSchema<[v.StrictObjectSchema<{
                         readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     }, undefined>, undefined>;
                     readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly contact: v.OptionalSchema<v.StrictObjectSchema<{
+                        readonly name: v.StringSchema<undefined>;
+                        readonly first_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly last_name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly phone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly user_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+                    }, undefined>, undefined>;
                     readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
                         readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
                         readonly text: v.StringSchema<undefined>;

package/dist/entities/contact-read.d.ts

@@ -9,14 +9,12 @@ export declare const contactSync: v.StrictObjectSchema<{
     readonly changed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     readonly known: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
 }, undefined>;
-export declare const contactProfile: v.StrictObjectSchema<{
-    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly usernames: v.ArraySchema<v.StringSchema<undefined>, undefined>;
-    readonly bio: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly birthday: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
-    readonly phone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
-    readonly flags: Omit<v.StrictObjectSchema<{
+/** What the messenger says about a person; `contacts show` carries these beside the card's own fields. */
+export declare const profileFields: {
+    usernames: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    birthday: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    phone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    flags: Omit<v.StrictObjectSchema<{
         readonly bot: v.BooleanSchema<undefined>;
         readonly verified: v.BooleanSchema<undefined>;
         readonly premium: v.BooleanSchema<undefined>;
@@ -89,26 +87,18 @@ export declare const contactProfile: v.StrictObjectSchema<{
             readonly issue: v.BooleanIssue | v.StrictObjectIssue;
         } | undefined;
     };
-    readonly seen: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly mutual_contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly common_chats_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
-    readonly registered: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+    seen: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    mutual_contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    common_chats_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+    registered: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
         readonly at: v.StringSchema<undefined>;
         readonly source: v.PicklistSchema<["telegram", "max", "estimate"], undefined>;
         readonly precision: v.PicklistSchema<["day", "month"], undefined>;
     }, undefined>, undefined>, undefined>;
-    readonly has_photo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly chats: v.ArraySchema<v.StrictObjectSchema<{
-        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-        readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly kind: v.PicklistSchema<["dialog", "group", "channel", "saved", "unknown"], undefined>;
-        readonly their_messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
-        readonly first_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
-        readonly last_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
-        readonly complete: v.BooleanSchema<undefined>;
-    }, undefined>, undefined>;
-    readonly aliases: v.ArraySchema<v.StrictObjectSchema<{
+    has_photo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Earlier names and usernames, oldest first; the current ones are not repeated. */
+    aliases: v.ArraySchema<v.StrictObjectSchema<{
         readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly username: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly link: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -116,4 +106,4 @@ export declare const contactProfile: v.StrictObjectSchema<{
         readonly last_seen_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
         readonly source: v.PicklistSchema<["profile", "messages"], undefined>;
     }, undefined>, undefined>;
-}, undefined>;
+};

package/dist/entities/contact-read.js

@@ -1,13 +1,10 @@
 import * as v from "valibot";
-import { chat } from "./chat.js";
 import { count, id, text, time } from "./fields.js";
 export const contactLookup = v.strictObject({ id, name: v.nullable(text), username: v.nullable(text) });
 export const contactSync = v.strictObject({ added: count, changed: count, known: count });
-export const contactProfile = v.strictObject({
-    id,
-    name: v.nullable(text),
+/** What the messenger says about a person; `contacts show` carries these beside the card's own fields. */
+export const profileFields = {
     usernames: v.array(text),
-    bio: v.nullable(text),
     birthday: v.optional(v.nullable(text)),
     phone: v.optional(v.nullable(text)),
     flags: v.partial(v.strictObject({
@@ -30,15 +27,7 @@ export const contactProfile = v.strictObject({
         precision: v.picklist(["day", "month"]),
     }))),
     has_photo: v.optional(v.boolean()),
-    chats: v.array(v.strictObject({
-        id,
-        title: v.nullable(text),
-        kind: chat.entries.kind,
-        their_messages: count,
-        first_at: v.nullable(time),
-        last_at: v.nullable(time),
-        complete: v.boolean(),
-    })),
+    /** Earlier names and usernames, oldest first; the current ones are not repeated. */
     aliases: v.array(v.strictObject({
         name: v.optional(text),
         username: v.optional(text),
@@ -47,4 +36,4 @@ export const contactProfile = v.strictObject({
         last_seen_at: time,
         source: v.picklist(["profile", "messages"]),
     })),
-});
+};