@wirecat/whatsapp-cli 0.0.0-stage → 0.2.0

package/dist/engine/contract.d.ts.map

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

package/dist/engine/contract.js

@@ -0,0 +1,353 @@
+import * as v from "valibot";
+/**
+ * What the engine and the adapter say to each other, in WhatsApp's own terms. The Go engine speaks it as JSON
+ * lines; `FakeEngine` speaks it in memory. Bump `PROTOCOL` on any change an older peer would misread — the
+ * adapter refuses an engine whose hello names another version.
+ *
+ * Ids are JIDs as strings. A one-to-one chat is always in its LID form (`…@lid`) when WhatsApp has one for the
+ * user, never in phone form: cli-core cannot merge two stored chats, so the engine picks the one id before it
+ * emits a chat (cli-private plans/2026-10-16-whatsapp-foundation.md, decision 3). Names are what the address book or the
+ * person set; a phone number is never a name.
+ */
+export const PROTOCOL = 41;
+/**
+ * Every request the engine answers. A write changes something on WhatsApp or sends something: cut by a dropped
+ * connection or the engine's end, it may have gone through, so it answers `outcome_unknown`, never a retryable error
+ * (WC-LIFE-9). The engine's `writes` (engine/cmd/wa-engine/errors.go) must name the same writes; its tests check
+ * that and that it dispatches exactly these ops.
+ */
+export const ENGINE_OPS = {
+    send: "write",
+    sendMedia: "write",
+    sendAlbum: "write",
+    forward: "write",
+    edit: "write",
+    revoke: "write",
+    react: "write",
+    read: "write",
+    createPoll: "write",
+    vote: "write",
+    pin: "write",
+    unpin: "write",
+    createGroup: "write",
+    join: "write",
+    leave: "write",
+    updateGroup: "write",
+    setGroupPhoto: "write",
+    resetLink: "write",
+    participants: "write",
+    answerRequest: "write",
+    block: "write",
+    setPrivacy: "write",
+    mute: "write",
+    updateProfile: "write",
+    deleteChat: "write",
+    clearChat: "write",
+    deleteForMe: "write",
+    star: "write",
+    archiveChat: "write",
+    unarchiveChat: "write",
+    pinChat: "write",
+    unpinChat: "write",
+    markChatRead: "write",
+    markChatUnread: "write",
+    followChannel: "write",
+    unfollowChannel: "write",
+    logout: "write",
+    connect: "read",
+    close: "read",
+    // A cut pairing is abandoned: a retry asks WhatsApp for a new code, and nobody else sees either.
+    link: "read",
+    me: "read",
+    directory: "read",
+    chat: "read",
+    download: "read",
+    // Asks the owner's own phone for older messages; asking twice only sends the same history again.
+    older: "read",
+    group: "read",
+    requests: "read",
+    profile: "read",
+    lookup: "read",
+    contacts: "read",
+    privacy: "read",
+    channel: "read",
+    channelMessages: "read",
+    // Records the store's phone-form chats in the engine's own table; nothing reaches WhatsApp.
+    storedChats: "read",
+    // Reads whatsmeow's LID map for a typed phone-form chat; nothing reaches WhatsApp.
+    canonicalChat: "read",
+};
+export const isWrite = (op) => ENGINE_OPS[op] === "write";
+const jid = v.pipe(v.string(), v.includes("@"));
+const time = v.pipe(v.string(), v.isoTimestamp());
+export const waChat = v.strictObject({
+    jid,
+    /**
+     * `unread` and `lastMessageAt` are absent when the source does not say. Only a notice, such as a group leaving its
+     * community, leaves out `name` and `participants`: a pushed chat keeps the stored value of whatever is absent.
+     */
+    name: v.optional(v.nullable(v.string())),
+    kind: v.picklist(["dm", "self", "group", "newsletter", "broadcast"]),
+    unread: v.optional(v.nullable(v.number())),
+    lastMessageAt: v.optional(v.nullable(time)),
+    participants: v.optional(v.nullable(v.number())),
+    archived: v.optional(v.boolean()),
+    muted: v.optional(v.boolean()),
+    /** The community a group is linked to; `null` when a live read says it is in none, absent when nothing said. */
+    parent: v.optional(v.nullable(jid)),
+    /** A community itself: a group that holds other groups. */
+    community: v.optional(v.literal(true)),
+    /**
+     * `left` when WhatsApp said the owner left the group or was removed, `member` when it said the owner was added back;
+     * never `null`, which clears `archived` too.
+     */
+    membershipState: v.optional(v.picklist(["left", "member"])),
+});
+export const waContact = v.strictObject({ jid, name: v.nullable(v.string()) });
+/**
+ * What whatsmeow needs to fetch and decrypt a file again, base64 where it is bytes. Stored as the attachment's opaque
+ * `providerRef`, so a download or a forward needs only the store. A channel's files are not encrypted and have no keys.
+ */
+export const waMediaRef = v.strictObject({
+    media: v.picklist(["image", "video", "audio", "document", "sticker"]),
+    directPath: v.pipe(v.string(), v.nonEmpty()),
+    mediaKey: v.optional(v.string()),
+    fileSha256: v.optional(v.string()),
+    fileEncSha256: v.optional(v.string()),
+    /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+    url: v.optional(v.string()),
+    mediaKeyTimestamp: v.optional(v.number()),
+});
+/**
+ * A download's answer: the new path when the phone had to upload the file again, `null` when WhatsApp still kept it.
+ * The key stays that of the stored ref; the checksums come too when the phone encrypted the file again.
+ */
+export const waDownloaded = v.nullable(v.strictObject({
+    directPath: v.pipe(v.string(), v.nonEmpty()),
+    fileSha256: v.optional(v.string()),
+    fileEncSha256: v.optional(v.string()),
+}));
+/** A place as its message carried it, kept so a forward sends it again; `geo:` in `url` rounds the coordinates. */
+export const waPlaceRef = v.strictObject({
+    place: v.strictObject({
+        latitude: v.number(),
+        longitude: v.number(),
+        name: v.optional(v.string()),
+        address: v.optional(v.string()),
+        url: v.optional(v.string()),
+    }),
+});
+/**
+ * A contact card as its message carried it, kept so a forward sends it again. The vCard holds a phone number: it
+ * stays in the opaque `providerRef`, which cli-core never prints, and never reaches a log or an error.
+ */
+export const waCardRef = v.strictObject({ card: v.strictObject({ name: v.string(), vcard: v.string() }) });
+/**
+ * cli-core's Attachment in WhatsApp's terms: `photo`, `video`, `voice`, `audio`, `document`, `sticker`, `location`
+ * (`url` is a `geo:` link), `contact` (its name; the card itself only in `ref`). `ref` is a file's keys, or what a
+ * place or a contact card needs to be sent again; a live location has none.
+ */
+export const waAttachment = v.strictObject({
+    kind: v.picklist(["photo", "video", "voice", "audio", "document", "sticker", "location", "contact"]),
+    url: v.optional(v.string()),
+    width: v.optional(v.number()),
+    height: v.optional(v.number()),
+    title: v.optional(v.string()),
+    name: v.optional(v.string()),
+    size: v.optional(v.number()),
+    mime: v.optional(v.string()),
+    duration: v.optional(v.number()),
+    ref: v.optional(v.union([waMediaRef, waPlaceRef, waCardRef])),
+});
+/**
+ * A poll as its message carries it. An answer's `id` is the start of the SHA-256 of its text, which is what a vote
+ * names on the wire. Votes arrive later, live as `vote` events or in a history push's `votes`; cli-core's store
+ * counts them.
+ */
+export const waPoll = v.strictObject({
+    question: v.string(),
+    answers: v.array(v.strictObject({ id: v.pipe(v.string(), v.nonEmpty()), text: v.string() })),
+    multiple: v.boolean(),
+});
+export const waMessage = v.strictObject({
+    id: v.pipe(v.string(), v.nonEmpty()),
+    chat: jid,
+    sender: v.nullable(jid),
+    senderName: v.nullable(v.string()),
+    fromMe: v.boolean(),
+    timestamp: time,
+    editedAt: v.nullable(time),
+    text: v.string(),
+    replyTo: v.nullable(v.string()),
+    attachments: v.optional(v.array(waAttachment)),
+    poll: v.optional(waPoll),
+    /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+    starred: v.optional(v.literal(true)),
+    /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+    serverId: v.optional(v.number()),
+});
+/**
+ * One person's newest choice in a poll: `selected` is the full SHA-256 of each chosen answer's text, and none takes
+ * the vote back. `voter` is in LID form like a sender, and the account's own vote is under `self()`. A vote in a
+ * history push carries its `poll`, since the push may not hold that poll; a live `vote` event has none. `votedAt` is
+ * when the voter cast it, by WhatsApp's clock: the store keeps a voter's newest vote by it.
+ */
+export const waVote = v.strictObject({
+    chat: jid,
+    message: v.pipe(v.string(), v.nonEmpty()),
+    voter: jid,
+    voterName: v.nullable(v.string()),
+    selected: v.array(v.string()),
+    votedAt: time,
+    poll: v.optional(waPoll),
+});
+/**
+ * A one-to-one chat the engine emitted before in phone form (`from`), now named by its person's LID (`to`). The store
+ * moves the old chat to the new id before anything under the new id lands. The engine repeats a re-key for a while,
+ * since the CLI may not have been listening; a repeat changes nothing.
+ */
+export const waRekey = v.strictObject({ from: jid, to: jid });
+/**
+ * Who joined, left, was added, removed, promoted or demoted in a group, or its new title, live or from the group's
+ * service message in a history push. WhatsApp gives a live change no id, so `id` is derived from the chat, the time in
+ * seconds, the action and the sorted people: both paths give one change the same id, and the store keeps it once.
+ * `by` and `people` are in LID form like a sender; `by` is `null` where WhatsApp did not say who.
+ */
+export const waChatEvent = v.strictObject({
+    chat: jid,
+    id: v.pipe(v.string(), v.nonEmpty()),
+    timestamp: time,
+    event: v.picklist(["join", "leave", "add", "remove", "promote", "demote", "title"]),
+    by: v.nullable(jid),
+    byName: v.nullable(v.string()),
+    people: v.array(waContact),
+    title: v.optional(v.string()),
+});
+/**
+ * One push from the phone. `kind` follows whatsmeow's sync types; the adapter treats them all alike. `votes` are the
+ * votes in the pushed polls, which the store saves with the push, not as `vote` events. `events` are the groups'
+ * service messages in the push, which come as no message. `rekeys` apply first.
+ */
+export const waHistory = v.strictObject({
+    kind: v.picklist(["bootstrap", "recent", "full", "on_demand", "push_name", "other"]),
+    chats: v.array(waChat),
+    contacts: v.array(waContact),
+    messages: v.array(waMessage),
+    votes: v.array(waVote),
+    rekeys: v.optional(v.array(waRekey)),
+    events: v.optional(v.array(waChatEvent)),
+});
+/**
+ * The phone's answer to `older`: the chat's messages sent before the anchor, as many as were asked or fewer. No
+ * messages and `more: false` is the chat's start. The engine never answers no messages with `more: true`: a batch of
+ * only messages the contract skips is asked past, since cli-core reads any empty page as the start.
+ */
+export const waOlder = v.strictObject({ messages: v.array(waMessage), more: v.boolean() });
+/** `outdated`: WhatsApp refuses this engine's version. `stopped`: the engine process ended without being asked. */
+export const connectionState = v.picklist([
+    "connected",
+    "disconnected",
+    "logged_out",
+    "replaced",
+    "banned",
+    "outdated",
+    "stopped",
+]);
+export const engineEvent = v.variant("event", [
+    v.strictObject({ event: v.literal("history"), history: waHistory }),
+    v.strictObject({ event: v.literal("message"), message: waMessage }),
+    v.strictObject({ event: v.literal("edit"), message: waMessage }),
+    v.strictObject({ event: v.literal("delete"), chat: jid, id: v.string() }),
+    v.strictObject({ event: v.literal("vote"), vote: waVote }),
+    v.strictObject({ event: v.literal("chat_event"), change: waChatEvent }),
+    /** The owner starred a message or took the star off on another device. */
+    v.strictObject({ event: v.literal("star"), chat: jid, id: v.pipe(v.string(), v.nonEmpty()), starred: v.boolean() }),
+    /** A re-key outside a history push, sent before the first message under the new id. */
+    v.strictObject({ event: v.literal("rekey"), ...waRekey.entries }),
+    /** `until`: when a temporary ban ends, if WhatsApp said. */
+    v.strictObject({ event: v.literal("connection"), state: connectionState, until: v.optional(time) }),
+]);
+export const engineErrorCode = v.picklist([
+    "validation_error",
+    "authentication_error",
+    "permission_error",
+    "not_found",
+    "rate_limited",
+    "timeout",
+    "network_error",
+    "provider_error",
+    "provider_unavailable",
+    "outcome_unknown",
+]);
+/**
+ * Why, for the refusals an agent recovers from differently than their code says: another process holds the device
+ * (`device.in-use`), WhatsApp handed the login to another connection (`device.replaced`), logged the device out, refuses
+ * this version (`client.outdated`), banned the account, or asked it to slow down (`account.rate-limited`, never the
+ * engine's own lookup pace), or has not yet sent the keys a settings change is sealed with (`settings.keys-missing`).
+ * A download WhatsApp no longer keeps the file for says how asking the phone to upload it again ended (`media.*`), or
+ * that the engine stopped while it waited (`engine.stopped`). The CLI registers each one (`src/reasons.ts`).
+ */
+export const engineReason = v.picklist([
+    "device.in-use",
+    "device.replaced",
+    "device.logged-out",
+    "client.outdated",
+    "account.banned",
+    "account.rate-limited",
+    "settings.keys-missing",
+    "media.not-on-phone",
+    "media.phone-cannot-decrypt",
+    "media.phone-answer-unreadable",
+    "media.phone-failed",
+    "media.phone-timeout",
+    "media.retry-failed",
+    "engine.stopped",
+]);
+export const engineError = v.strictObject({
+    code: engineErrorCode,
+    message: v.string(),
+    reason: v.optional(engineReason),
+    /** When a temporary ban ends, if WhatsApp said. */
+    until: v.optional(time),
+});
+/** The engine's first line: its protocol and the linked account (`self()`), or `null` before a login. */
+export const hello = v.strictObject({
+    protocol: v.number(),
+    engine: v.string(),
+    version: v.string(),
+    self: v.nullable(jid),
+});
+export const waAccount = v.strictObject({ jid, name: v.nullable(v.string()) });
+export const waChatCard = v.strictObject({ chat: waChat, members: v.nullable(v.array(waContact)) });
+/**
+ * A code to show while linking: `qr` is the text of a QR code to draw, `pair` the eight characters to type on the
+ * phone. Either one links the account for as long as it is valid, so it is shown and never stored or logged.
+ */
+export const loginCode = v.strictObject({ login: v.picklist(["qr", "pair"]), code: v.pipe(v.string(), v.nonEmpty()) });
+/** A message key as the engine reads it from a request. */
+export const keyFields = ({ chat, id, fromMe, sender }) => ({
+    chat,
+    message: id,
+    fromMe,
+    ...(sender === null ? {} : { sender }),
+});
+/** The most messages one `older` request asks the phone for, as WhatsApp's own clients ask. */
+export const OLDER_MAX = 50;
+/**
+ * A refusal from the engine, already in the closed list of codes. Its message is fixed wording: it never repeats a
+ * chat name, a JID or anything typed, since errors reach logs and run records.
+ */
+export class EngineError extends Error {
+    code;
+    reason;
+    until;
+    constructor(code, message, reason, 
+    /** When a temporary ban ends, if WhatsApp said. */
+    until) {
+        super(message);
+        this.code = code;
+        this.reason = reason;
+        this.until = until;
+    }
+}
+//# sourceMappingURL=contract.js.map

package/dist/engine/contract.js.map

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

package/dist/engine/events.d.ts

@@ -0,0 +1,9 @@
+import type { EngineEvent } from "./contract.js";
+type Kind = EngineEvent["event"];
+/** Fans events out by kind, and keeps each one nobody listens for until a listener of its kind arrives. */
+export declare const eventHub: () => {
+    emit: (event: EngineEvent) => void;
+    listen: (kinds: readonly Kind[], onEvent: (event: EngineEvent) => void) => (() => void);
+};
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/engine/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/engine/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,KAAK,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAOhC,2GAA2G;AAC3G,eAAO,MAAM,QAAQ;kBAIE,WAAW,KAAG,IAAI;oBAMhB,SAAS,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAU7F,CAAA"}

package/dist/engine/events.js

@@ -0,0 +1,23 @@
+/** Fans events out by kind, and keeps each one nobody listens for until a listener of its kind arrives. */
+export const eventHub = () => {
+    const listeners = new Set();
+    let kept = [];
+    const emit = (event) => {
+        const takers = [...listeners].filter((listener) => listener.kinds.has(event.event));
+        if (takers.length === 0)
+            kept.push(event);
+        for (const listener of takers)
+            listener.onEvent(event);
+    };
+    const listen = (kinds, onEvent) => {
+        const listener = { kinds: new Set(kinds), onEvent };
+        listeners.add(listener);
+        const mine = kept.filter((event) => listener.kinds.has(event.event));
+        kept = kept.filter((event) => !listener.kinds.has(event.event));
+        for (const event of mine)
+            onEvent(event);
+        return () => listeners.delete(listener);
+    };
+    return { emit, listen };
+};
+//# sourceMappingURL=events.js.map

package/dist/engine/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/engine/events.ts"],"names":[],"mappings":"AASA,2GAA2G;AAC3G,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;IACrC,IAAI,IAAI,GAAkB,EAAE,CAAA;IAE5B,MAAM,IAAI,GAAG,CAAC,KAAkB,EAAQ,EAAE;QACxC,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QACnF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzC,KAAK,MAAM,QAAQ,IAAI,MAAM;YAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACxD,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,OAAqC,EAAgB,EAAE;QAC7F,MAAM,QAAQ,GAAa,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;QAC7D,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QACpE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QAC/D,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QACxC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC,CAAA;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACzB,CAAC,CAAA"}

package/dist/engine/go-engine.d.ts

@@ -0,0 +1,23 @@
+import { type WhatsAppEngine } from "./contract.js";
+export interface GoEngineOptions {
+    /** The profile's `private.db`. */
+    storePath: string;
+    /** Who holds the connection — `serve`, `messages send` — named to anyone the lock refuses. */
+    holder: string;
+    /** Allows an empty store: this run links a new device. */
+    link?: boolean;
+    env?: NodeJS.ProcessEnv;
+    /** The engine's own diagnostics, fixed wording only. */
+    warn?: (line: string) => void;
+    /** Tests run a stand-in: the program, and the arguments before the engine's own. */
+    command?: {
+        file: string;
+        args: string[];
+    };
+}
+/**
+ * Runs the Go engine as a child process and speaks JSON lines with it. It starts the engine and waits for its hello;
+ * a refusal there (the lock is held, the profile is not linked) rejects with the engine's own code and wording.
+ */
+export declare const startGoEngine: (options: GoEngineOptions) => Promise<WhatsAppEngine>;
+//# sourceMappingURL=go-engine.d.ts.map

package/dist/engine/go-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-engine.d.ts","sourceRoot":"","sources":["../../src/engine/go-engine.ts"],"names":[],"mappings":"AAKA,OAAO,EAaL,KAAK,cAAc,EAOpB,MAAM,eAAe,CAAA;AAMtB,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,wDAAwD;IACxD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,oFAAoF;IACpF,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAC3C;AA4BD;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAmB,eAAe,KAAG,OAAO,CAAC,cAAc,CAkMpF,CAAA"}