@wirecat/max-cli 0.0.0-stage → 0.42.0

package/dist/domain/models.d.ts

@@ -0,0 +1,238 @@
+/**
+ * What this CLI promises. **Raw MAX objects never reach output** (REQUIREMENTS §16, §25): the wire
+ * shape is undocumented, changes without notice, and carries fields whose meaning nobody knows.
+ * Everything above the adapter speaks these types.
+ */
+import type { Button, Chat, Contact, Id, Member, Reactions, ChatCard as SharedChatCard } from "@wirecat/cli-messaging";
+/**
+ * The shared model where MAX says the same thing; below, only what MAX says differently or alone.
+ * What MAX does with the shared ones, measured:
+ *
+ * - `Id` — MAX ids are 64-bit, so a string, never a number.
+ * - `AttachmentLink` — no token and no cookie needed to fetch it (2026-09-23).
+ * - `ChatEvent.event` — `new`, `add`, `remove`, `pin` seen; anything else passes through.
+ * - `Contact.lastMessagedAt` — MAX does not send it on a contact: it comes from the chat.
+ * - `AccountSession` — MAX gives a session no id, so none can be ended alone.
+ */
+export type { AccountSession, AttachmentLink, Audience, Button, ButtonKind, CallRecord, Chat, ChatEvent, ChatEvents, ChatKind, Contact, Deletion, Id, JoinRequest, MediaKind, Member, Page, PersonCard, Pin, PrivacySettings, Profile, ProfileFacts, Reactions, ReadMark, Sticker, StickerSet, } from "@wirecat/cli-messaging";
+export interface Attachment {
+    /** Lower-cased MAX type: `photo`, `video`, `file`, `share`, `call`, `control`, `sticker`… */
+    kind: string;
+    /**
+     * A photo's image or a shared page. ⚠ Measured 2026-09-22: a photo link opens with no cookie and
+     * no token, so whoever holds it sees the picture.
+     */
+    url?: string;
+    width?: number;
+    height?: number;
+    /** A shared page's title. */
+    title?: string;
+    /** A file's name and size, measured 2026-09-23. */
+    name?: string;
+    size?: number;
+    /** A file or a video carries no link, only these; `messages download` asks MAX for the link. */
+    fileId?: Id;
+    videoId?: Id;
+    /** A service message (`control`): what happened, as MAX names it — `new`, `add`, `remove`, `pin`… */
+    event?: string;
+    /** A service message: the people it happened to. Who did it is the message's sender. */
+    userIds?: Id[];
+    /** Absent on a `poll` newer than the version measured (`version` above 2). */
+    poll?: Poll;
+    /** A bot's keyboard, row by row (`inline_keyboard`). */
+    buttons?: Button[][];
+}
+/** A poll as the owner sees it. The settings bits are unpacked here and nowhere else. */
+export interface Poll {
+    id: Id;
+    question: string;
+    answers: PollAnswer[];
+    /** How many people voted, not how many votes: one person may pick several answers. */
+    total: number;
+    multiple: boolean;
+    anonymous: boolean;
+    revote: boolean;
+    closed: boolean;
+    quiz: boolean;
+}
+export interface PollAnswer {
+    /** What `max polls vote` takes — MAX's own answer id, not a position in the list. */
+    id: Id;
+    text: string;
+    votes: number;
+    /** The owner voted for this one. */
+    mine: boolean;
+}
+/** A poll and the message that carries it — what `max polls` answers with. */
+export interface PollMessage {
+    chatId: Id;
+    messageId: Id;
+    poll: Poll;
+}
+/** The message a reply answers or a forward carries — MAX sends it whole, inside the one that links to it. */
+export interface QuotedMessage {
+    id: Id;
+    senderId: Id | null;
+    senderName: string | null;
+    /** ISO 8601, or `null` when the quote did not say. */
+    timestamp: string | null;
+    text: string;
+    attachments: Attachment[];
+    /** Whether this account wrote it. `null` when we do not know who we are. */
+    outgoing: boolean | null;
+}
+export interface Message {
+    id: Id;
+    chatId: Id;
+    senderId: Id | null;
+    senderName: string | null;
+    /** ISO 8601. */
+    timestamp: string;
+    /**
+     * When MAX last recorded an edit, or `null` for a message nobody has changed.
+     *
+     * Measured 2026-09-20: an edited message comes back carrying `status: "EDITED"` and an
+     * `updateTime` later than its `time`. Surfaced rather than hidden because a reader has no other
+     * way to tell an edited message from the original, and because it is what the cache compares to
+     * decide whether the copy it holds is still current.
+     */
+    editedAt: string | null;
+    text: string;
+    /** Whether this account sent it. `null` when we do not know who we are. */
+    outgoing: boolean | null;
+    attachments: Attachment[];
+    replyTo: QuotedMessage | null;
+    forwardedFrom: QuotedMessage | null;
+    /**
+     * `null` when nobody asked — `--offline`, or the request failed. ~~History does not carry
+     * reactions~~ **Correction 2026-10-06:** a channel's history carries `reactionInfo` with counts (measured
+     * with `pnpm probe:channel-posts`); elsewhere it is `{}` and they come from a request of their own.
+     */
+    reactions: Reactions | null;
+    /** ISO 8601 — when MAX will send it. Present only on a message still waiting in the queue. */
+    scheduledFor?: string;
+    /** A channel post's `stats.views`, where MAX sends it (measured 2026-10-05, `pnpm probe:channel-posts`). */
+    providerMetadata?: {
+        views?: number;
+        graph?: {
+            version: 1;
+            reply?: {
+                chatId: Id;
+                messageId: Id;
+            } | null;
+        };
+    };
+}
+/**
+ * A message found by searching, carrying the chat's name as well as its id.
+ *
+ * A search spans every chat, so an answer that named only the id would make the reader look each
+ * one up to understand their own results. The title is what the store already holds; it is `null`
+ * for a chat MAX never titled.
+ */
+export interface MessageHit extends Message {
+    chatTitle: string | null;
+}
+/**
+ * What happened to a message after it arrived, as `max watch --events` prints it (`MAX-34`). MAX
+ * pushes an edit and a deletion as the same message again with `status` `EDITED` or `REMOVED`, and
+ * a reaction as opcode 155 (tab recording 2026-09-25).
+ */
+export type MessageChange = {
+    event: "edit";
+    message: MessageHit;
+} | {
+    event: "delete";
+    chatId: Id;
+    chatTitle: string | null;
+    messageId: Id;
+} | {
+    event: "reaction";
+    chatId: Id;
+    chatTitle: string | null;
+    messageId: Id;
+    reactions: Reactions;
+}
+/**
+ * Somebody read a chat up to a message — the owner on another device too. MAX names the message by
+ * its time, not its id (opcode 130, measured 2026-10-08).
+ */
+ | {
+    event: "read";
+    chatId: Id;
+    chatTitle: string | null;
+    userId: Id;
+    upToTime: string | null;
+    unreadCount: number | null;
+}
+/** A chat's title, members or the owner's membership changed; MAX sends the chat whole (135, or a 128 with it). */
+ | {
+    event: "chat";
+    chat: Chat;
+};
+/** A group's member as MAX lists them (`max chats members list`). */
+export interface GroupMember extends Member {
+    /** ISO 8601, when the MAX account was created — a days-old account is worth a look. */
+    registeredAt: string | null;
+    /** ISO 8601, when MAX last saw them; `null` when their privacy hides it. */
+    lastSeenAt: string | null;
+    /** Absent where the login did not say who runs the group. */
+    role?: "owner" | "admin" | "member";
+}
+export interface GroupMembers {
+    chatId: Id;
+    members: GroupMember[];
+    /** Every page was read. */
+    complete: boolean;
+    /** Whether `role` is filled in: the login names a group's owner and admins only for chats that changed lately. */
+    rolesKnown: boolean;
+}
+/** The shared card, plus what MAX tells about a group. */
+export interface ChatCard extends SharedChatCard {
+    description: string | null;
+    access: string | null;
+    /** `null` for a dialog, offline, or a group the login did not carry. */
+    settings: GroupSettings | null;
+}
+/** The settings MAX lets a group's owner change, under our names. */
+export interface GroupSettings {
+    allCanPin: boolean | null;
+    onlyAdminsAdd: boolean | null;
+    onlyAdminsCall: boolean | null;
+    onlyOwnerEditsInfo: boolean | null;
+    membersSeeLink: boolean | null;
+}
+/** A group or channel as the group commands answer it. */
+export interface GroupCard extends Chat {
+    description: string | null;
+    /** `public`, `private` or `secret`, as MAX says it. */
+    access: string | null;
+    /** The invite link. Only a member who may see it gets one. */
+    link: string | null;
+    settings: GroupSettings;
+}
+/** A chat folder. MAX's own filters and options are kept inside the client and sent back untouched. */
+export interface Folder {
+    id: string;
+    title: string;
+    /** Chats added to it by hand. A folder that selects by filter lists none. */
+    chatIds: Id[];
+}
+export interface ContactImport {
+    /** How many numbers went to MAX. */
+    sent: number;
+    /** The numbers MAX answered for — measured once, on the owner's own number, which it recognised. */
+    recognised: string[];
+    contacts: Contact[];
+}
+/** One message of a window around another, which carries `anchor: true`. */
+export type WindowedMessage = Message & {
+    anchor?: true;
+};
+/**
+ * When a message was sent, read from its id: **`id >> 16` is the send time in milliseconds**, the
+ * low 16 bits a counter. Measured 2026-09-22 on three messages across two days, exact every time.
+ * `undefined` for anything that is not a message id.
+ */
+export declare const timeOfMessageId: (id: Id) => number | undefined;
+//# sourceMappingURL=models.d.ts.map

package/dist/domain/models.d.ts.map

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

package/dist/domain/models.js

@@ -0,0 +1,17 @@
+/**
+ * What this CLI promises. **Raw MAX objects never reach output** (REQUIREMENTS §16, §25): the wire
+ * shape is undocumented, changes without notice, and carries fields whose meaning nobody knows.
+ * Everything above the adapter speaks these types.
+ */
+/**
+ * When a message was sent, read from its id: **`id >> 16` is the send time in milliseconds**, the
+ * low 16 bits a counter. Measured 2026-09-22 on three messages across two days, exact every time.
+ * `undefined` for anything that is not a message id.
+ */
+export const timeOfMessageId = (id) => {
+    if (!/^\d{10,20}$/.test(id))
+        return undefined;
+    const time = Number(BigInt(id) >> 16n);
+    return Number.isSafeInteger(time) && time > 0 ? time : undefined;
+};
+//# sourceMappingURL=models.js.map

package/dist/domain/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/domain/models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwPH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAM,EAAsB,EAAE;IAC5D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAA;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAA;IACtC,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AAClE,CAAC,CAAA"}

package/dist/download.d.ts

@@ -0,0 +1,38 @@
+import type { AttachmentLink } from "./domain/models.js";
+export interface Saved {
+    kind: string;
+    path: string;
+    bytes: number;
+}
+/** Where a download may go; throws for a link it must not follow. */
+export type Reach = (url: URL) => Promise<void>;
+/**
+ * **Out to the internet only, over https** (`NEED-278`). A link comes from MAX, and one pointing at
+ * this machine or its network would make `max` a way to read what only this machine can reach.
+ * Checked again after every redirect.
+ */
+export declare const publicOnly: Reach;
+/** A voice message is read into memory whole; minutes of Opus are a few megabytes. */
+export declare const LARGEST_VOICE: number;
+/** No byte for this long and the download is given up — however large the file, it is moving or not. */
+export declare const STALL_MS = 60000;
+export interface Watchdog {
+    readonly signal: AbortSignal;
+    poke(): void;
+    stop(): void;
+}
+/** An abort signal that fires when `poke` has not been called for `ms`. */
+export declare const watchdog: (ms: number) => Watchdog;
+/** General attachments stream with a file budget; voice transcription keeps its smaller memory budget. */
+export declare const streamBytes: (attachment: AttachmentLink, reach?: Reach, limit?: number, onMime?: (mime: string | undefined) => void, signal?: AbortSignal) => AsyncGenerator<Uint8Array>;
+/** Into memory rather than a file: a voice message is a few hundred kilobytes, and transcription reads it once. */
+export declare const fetchBytes: (attachment: AttachmentLink, reach?: Reach, limit?: number) => Promise<Uint8Array>;
+/**
+ * Downloads one attachment into `directory` and **never replaces a file that is there**.
+ *
+ * The bytes go to a temporary name first and are then hard-linked to the real one, which fails if
+ * the name is taken — so an existing file survives, and an interrupted download leaves no half
+ * file under the name somebody will open.
+ */
+export declare const save: (attachment: AttachmentLink, directory: string, fallbackName: string, reach?: Reach) => Promise<Saved>;
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AA2BD,qEAAqE;AACrE,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,KAaxB,CAAA;AA0BD,sFAAsF;AACtF,eAAO,MAAM,aAAa,QAAmB,CAAA;AAE7C,wGAAwG;AACxG,eAAO,MAAM,QAAQ,QAAS,CAAA;AAE9B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,IAAI,IAAI,IAAI,CAAA;IACZ,IAAI,IAAI,IAAI,CAAA;CACb;AAED,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,OAAQ,MAAM,KAAG,QAWrC,CAAA;AAsED,0GAA0G;AAC1G,eAAO,MAAM,WAAW,eACV,cAAc,UACnB,KAAK,2BAEH,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,WAClC,WAAW,KACnB,cAAc,CAAC,UAAU,CAiB3B,CAAA;AAED,mHAAmH;AACnH,eAAO,MAAM,UAAU,eACT,cAAc,UACnB,KAAK,qBAEX,OAAO,CAAC,UAAU,CAYpB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,eACH,cAAc,aACf,MAAM,gBACH,MAAM,UACb,KAAK,KACX,OAAO,CAAC,KAAK,CAoBf,CAAA"}

package/dist/download.js

@@ -0,0 +1,199 @@
+import { lookup } from "node:dns/promises";
+import { createWriteStream } from "node:fs";
+import { link, rm } from "node:fs/promises";
+import { BlockList, isIP } from "node:net";
+import { basename, join } from "node:path";
+import { PassThrough, Readable, Transform, Writable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { CliError } from "@wirecat/cli-core";
+import { WEB_USER_AGENT } from "./spec/identity.js";
+const EXTENSIONS = {
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/webp": "webp",
+    "image/gif": "gif",
+    "video/mp4": "mp4",
+    "audio/mpeg": "mp3",
+    "audio/ogg": "ogg",
+    "audio/mp4": "m4a",
+};
+/**
+ * A name MAX gave cannot climb out of the directory, cannot be a dot file we would then hide, and
+ * carries no control or direction character to rewrite the terminal or disguise its extension.
+ */
+const safeName = (name) => {
+    const plain = name === undefined
+        ? ""
+        : basename(name.replaceAll("\\", "/"))
+            .replace(/[\p{Cc}\u200b-\u200f\u202a-\u202e\u2066-\u2069]/gu, "")
+            .replace(/^\.+/, "");
+    return plain === "" ? undefined : plain;
+};
+/**
+ * **Out to the internet only, over https** (`NEED-278`). A link comes from MAX, and one pointing at
+ * this machine or its network would make `max` a way to read what only this machine can reach.
+ * Checked again after every redirect.
+ */
+export const publicOnly = async (url) => {
+    if (url.protocol !== "https:") {
+        throw new CliError("validation_error", `a ${url.protocol} link is not downloaded — only https`);
+    }
+    const host = url.hostname.replace(/^\[|\]$/g, "");
+    const family = isIP(host);
+    const addresses = family ? [{ address: host, family }] : await lookup(host, { all: true, verbatim: true });
+    if (addresses.some(({ address, family }) => PRIVATE.check(address, family === 6 ? "ipv6" : "ipv4"))) {
+        throw new CliError("validation_error", `the link points into this machine or its network (${url.hostname}) — not downloaded`);
+    }
+};
+const PRIVATE = new BlockList();
+for (const [network, prefix] of [
+    ["0.0.0.0", 8],
+    ["10.0.0.0", 8],
+    ["100.64.0.0", 10],
+    ["127.0.0.0", 8],
+    ["169.254.0.0", 16],
+    ["172.16.0.0", 12],
+    ["192.168.0.0", 16],
+    ["224.0.0.0", 3],
+])
+    PRIVATE.addSubnet(network, prefix, "ipv4");
+// `::ffff:127.0.0.1` is matched against the IPv4 rules by BlockList itself, under Node and Bun alike.
+for (const [network, prefix] of [
+    ["::", 127],
+    ["fc00::", 7],
+    ["fe80::", 10],
+    ["ff00::", 8],
+])
+    PRIVATE.addSubnet(network, prefix, "ipv6");
+/** MAX takes attachments up to 4 GB (help.max.ru, "Как отправить в чат фото и другие файлы"). */
+const LARGEST_ATTACHMENT = 4 * 1024 ** 3;
+/** A voice message is read into memory whole; minutes of Opus are a few megabytes. */
+export const LARGEST_VOICE = 32 * 1024 * 1024;
+/** No byte for this long and the download is given up — however large the file, it is moving or not. */
+export const STALL_MS = 60_000;
+/** An abort signal that fires when `poke` has not been called for `ms`. */
+export const watchdog = (ms) => {
+    const controller = new AbortController();
+    let timer = setTimeout(() => controller.abort(), ms);
+    return {
+        signal: controller.signal,
+        poke: () => {
+            clearTimeout(timer);
+            timer = setTimeout(() => controller.abort(), ms);
+        },
+        stop: () => clearTimeout(timer),
+    };
+};
+const REDIRECTS = 5;
+const HEADERS = { "User-Agent": WEB_USER_AGENT.headerUserAgent, Referer: "https://web.max.ru/" };
+/** The body of the link, at most `limit` bytes, with redirects followed by hand so each is checked. */
+const open = async (attachment, reach, limit, parentSignal) => {
+    const stalled = watchdog(STALL_MS);
+    const signal = parentSignal ? AbortSignal.any([stalled.signal, parentSignal]) : stalled.signal;
+    const failed = (error) => {
+        stalled.stop();
+        if (stalled.signal.aborted) {
+            throw new CliError("timeout", `the ${attachment.kind} download stopped moving for ${STALL_MS / 1000} s`);
+        }
+        throw error;
+    };
+    let target = new URL(attachment.url);
+    for (let hop = 0;; hop += 1) {
+        const response = await reach(target)
+            .then(() => fetch(target, { headers: HEADERS, redirect: "manual", signal }))
+            .catch(failed);
+        const location = response.headers.get("location");
+        if (response.status >= 300 && response.status < 400 && location) {
+            await response.body?.cancel();
+            if (hop >= REDIRECTS)
+                failed(new CliError("network_error", `the ${attachment.kind} link redirects too many times`));
+            target = new URL(location, target);
+            continue;
+        }
+        if (!response.ok || !response.body) {
+            await response.body?.cancel();
+            failed(new CliError("network_error", `the ${attachment.kind} could not be downloaded: HTTP ${response.status}`));
+        }
+        const declared = Number(response.headers.get("content-length") ?? Number.NaN);
+        if (declared > limit) {
+            await response.body?.cancel();
+            failed(tooLarge(attachment, limit));
+        }
+        let bytes = 0;
+        const counting = new Transform({
+            transform(chunk, _encoding, done) {
+                stalled.poke();
+                bytes += chunk.length;
+                done(bytes > limit ? tooLarge(attachment, limit) : null, chunk);
+            },
+        });
+        const source = Readable.fromWeb(response.body);
+        const pump = (destination) => pipeline(source, counting, destination).then(() => {
+            stalled.stop();
+            return bytes;
+        }, failed);
+        return { response, pump };
+    }
+};
+const tooLarge = (attachment, limit) => new CliError("validation_error", `the ${attachment.kind} is larger than ${limit >= 1024 ** 2 ? `${Math.round(limit / 1024 ** 2)} MiB` : `${Math.round(limit / 1024)} KiB`} — not downloaded`);
+/** General attachments stream with a file budget; voice transcription keeps its smaller memory budget. */
+export const streamBytes = async function* (attachment, reach = publicOnly, limit = LARGEST_ATTACHMENT, onMime, signal) {
+    const { pump, response } = await open(attachment, reach, limit, signal);
+    const body = new PassThrough();
+    const finished = pump(body).catch((error) => {
+        body.destroy(error instanceof Error ? error : new Error("attachment download failed"));
+        throw error;
+    });
+    // The stream reports failures to its reader; observe the pump immediately as well.
+    void finished.catch(() => { });
+    try {
+        onMime?.(response.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase());
+        for await (const chunk of body)
+            yield chunk;
+        await finished;
+    }
+    finally {
+        body.destroy();
+        await finished.catch(() => { });
+    }
+};
+/** Into memory rather than a file: a voice message is a few hundred kilobytes, and transcription reads it once. */
+export const fetchBytes = async (attachment, reach = publicOnly, limit = LARGEST_VOICE) => {
+    const { pump } = await open(attachment, reach, limit);
+    const chunks = [];
+    await pump(new Writable({
+        write(chunk, _encoding, done) {
+            chunks.push(chunk);
+            done();
+        },
+    }));
+    return new Uint8Array(Buffer.concat(chunks));
+};
+/**
+ * Downloads one attachment into `directory` and **never replaces a file that is there**.
+ *
+ * The bytes go to a temporary name first and are then hard-linked to the real one, which fails if
+ * the name is taken — so an existing file survives, and an interrupted download leaves no half
+ * file under the name somebody will open.
+ */
+export const save = async (attachment, directory, fallbackName, reach = publicOnly) => {
+    const { response, pump } = await open(attachment, reach, LARGEST_ATTACHMENT);
+    const extension = EXTENSIONS[response.headers.get("content-type")?.split(";")[0]?.trim() ?? ""];
+    const name = safeName(attachment.name) ?? (extension ? `${fallbackName}.${extension}` : fallbackName);
+    const path = join(directory, name);
+    const partial = join(directory, `.${name}.${process.pid}.part`);
+    try {
+        const bytes = await pump(createWriteStream(partial, { flags: "wx", mode: 0o600 }));
+        await link(partial, path).catch((error) => {
+            if (error.code === "EEXIST") {
+                throw new CliError("validation_error", `${path} already exists — nothing was overwritten; choose --output`);
+            }
+            throw error;
+        });
+        return { kind: attachment.kind, path, bytes };
+    }
+    finally {
+        await rm(partial, { force: true });
+    }
+};
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

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

package/dist/format-markdown.d.ts

@@ -0,0 +1,13 @@
+import { type FormattedText, type TextSpan } from "@wirecat/cli-messaging";
+export declare const formatMarkdown: (input: string) => FormattedText;
+/** Personal elements: legacy types measured locally; UNDERLINE/LINK documented in external traffic observations. */
+export declare const toNativeMarkup: (span: TextSpan) => {
+    type: string;
+    from: number;
+    length: number;
+    attributes?: {
+        url: string;
+    };
+};
+export declare const toHtml: (text: string, spans: readonly TextSpan[]) => string;
+//# sourceMappingURL=format-markdown.d.ts.map

package/dist/format-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-markdown.d.ts","sourceRoot":"","sources":["../src/format-markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAyB,MAAM,wBAAwB,CAAA;AAmJjG,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,aAY9C,CAAA;AAED,oHAAoH;AACpH,eAAO,MAAM,cAAc,SACnB,QAAQ,KACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAoB5E,CAAA;AAKD,eAAO,MAAM,MAAM,SAAU,MAAM,SAAS,SAAS,QAAQ,EAAE,KAAG,MA2DjE,CAAA"}