@wirecat/cli-core 0.476.0 → 0.478.0

package/dist/cli/messenger/message-writes.d.ts

@@ -77,6 +77,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                 error?: string | undefined;
             } | undefined;
             local_path?: string | undefined;
+            contact?: {
+                name: string;
+                first_name?: string | undefined;
+                last_name?: string | undefined;
+                phone?: string | undefined;
+                user_id?: string | undefined;
+            } | undefined;
             buttons?: {
                 kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                 text: string;
@@ -109,6 +116,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -144,6 +158,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -268,6 +289,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                 error?: string | undefined;
             } | undefined;
             local_path?: string | undefined;
+            contact?: {
+                name: string;
+                first_name?: string | undefined;
+                last_name?: string | undefined;
+                phone?: string | undefined;
+                user_id?: string | undefined;
+            } | undefined;
             buttons?: {
                 kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                 text: string;
@@ -300,6 +328,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -335,6 +370,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;

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

@@ -9,3 +9,5 @@ export declare const CONTACTS_QUERY: QueryRegistry;
 export declare const notesAllowed: (permissions: Parameters<typeof levelFor>[0], notes: Predicate | undefined) => void;
 /** The messenger keeps the voters of one answer; one answer id at a time. */
 export declare const VOTERS_QUERY: QueryRegistry;
+/** Telegram keeps the people who chose one reaction; one emoji at a time. */
+export declare const REACTORS_QUERY: QueryRegistry;

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/search-answers.js

@@ -1,4 +1,5 @@
 import { formatLocator, parseLocator } from "../../domain/locator.js";
+import { senderIsMe } from "../../domain/models.js";
 import { DEFAULT_TEXT_MODEL } from "../../embeddings/models.js";
 import { excerpt } from "../../services/excerpt.js";
 import { MAX_SEARCH_OFFSET } from "../../services/messages-archive-search.js";
@@ -28,6 +29,7 @@ export const messageHitItem = (hit, query = "") => {
         chat_title: hit.chatTitle ?? undefined,
         timestamp: hit.timestamp,
         sender_name: hit.senderName,
+        sender_is_me: senderIsMe(hit, at.account),
         excerpt: hit.excerpt ?? excerpt(hit.text, query),
         matched_in: hit.matchedIn,
         score: hit.score ?? undefined,
@@ -165,10 +167,11 @@ const pictureItems = (found) => {
     const shown = new Set(found.items.map(({ locator }) => locator));
     return (found.pictures ?? [])
         .filter(({ locator }) => !shown.has(locator))
-        .map(({ locator, timestamp, senderName, score }) => ({
+        .map(({ locator, timestamp, senderName, senderIsMe, score }) => ({
         ref: locator,
         timestamp,
         sender_name: senderName,
+        sender_is_me: senderIsMe,
         matched_in: "picture",
         score,
         untrusted: ["sender_name"],
@@ -226,6 +229,7 @@ export const allHitItem = (item) => item.kind === "meeting"
         url: item.url,
         excerpt: item.text,
         sender_name: item.from?.name,
+        sender_is_me: item.senderIsMe,
         sender_ref: item.from?.ref,
         found_by: item.foundBy,
         untrusted: ALL_HIT_UNTRUSTED[item.kind],

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;
@@ -347,6 +366,8 @@ export interface Message {
      */
     delivery?: Delivery;
 }
+/** MAX reports the owner's own messages with no sender id, so `outgoing` counts as well as the id. */
+export declare const senderIsMe: (message: Pick<Message, "outgoing" | "senderId">, account: string) => boolean;
 /** `delivered` reached the other person's phone; `read` they opened it (a voice note or view-once file played counts). */
 export type Delivery = "delivered" | "read";
 /**
@@ -741,7 +762,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 +815,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 +836,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/domain/models.js

@@ -9,5 +9,7 @@ export const FOLDER_KINDS = ["contacts", "non-contacts", "groups", "channels", "
 export const FOLDER_SKIPS = ["muted", "read", "archived"];
 /** What an admin may do, in max-cli's words; a messenger maps them onto its own. */
 export const ADMIN_RIGHTS = ["read", "members", "admins", "info", "pin", "link", "post", "edit", "delete"];
+/** MAX reports the owner's own messages with no sender id, so `outgoing` counts as well as the id. */
+export const senderIsMe = (message, account) => message.outgoing === true || (message.senderId !== null && String(message.senderId) === account);
 /** Kinds of attachment `chats media` filters by. */
 export const MEDIA_KINDS = ["photo", "video", "file", "audio", "link"];

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"]),
     })),
-});
+};