@wirecat/whatsapp-cli 0.0.0-stage → 0.2.0

package/dist/engine/go-engine.js

@@ -0,0 +1,227 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import * as v from "valibot";
+import { engineBinary, enginePackage } from "../engine-binary.js";
+import { goChannels } from "./channels.js";
+import { EngineError, engineError, engineEvent, hello, isWrite, keyFields, loginCode, PROTOCOL, waAccount, waChat, waChatCard, waDownloaded, waMessage, waOlder, } from "./contract.js";
+import { eventHub } from "./events.js";
+import { goGroups } from "./groups.js";
+import { goPrivacy } from "./privacy.js";
+import { goSettings } from "./settings.js";
+const HELLO_WAIT_MS = 15_000;
+const CLOSE_WAIT_MS = 5_000;
+const STOPPED = () => new EngineError("provider_unavailable", "the WhatsApp engine stopped unexpectedly", "engine.stopped");
+const CUT = () => new EngineError("outcome_unknown", "the WhatsApp engine stopped before WhatsApp confirmed the change; it may have gone through — check first", "engine.stopped-mid-write");
+const missing = () => new EngineError("provider_unavailable", `the WhatsApp engine is not installed — ${enginePackage()} is missing: reinstall @wirecat/whatsapp-cli ` +
+    "without --omit=optional, or set WA_ENGINE to the engine's path");
+/**
+ * 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 const startGoEngine = async (options) => {
+    const env = options.env ?? process.env;
+    const command = options.command ?? { file: engineBinary(env), args: [] };
+    const args = [
+        ...command.args,
+        "--store",
+        options.storePath,
+        "--holder",
+        options.holder,
+        ...(options.link ? ["--link"] : []),
+    ];
+    const child = spawn(command.file, args, { env, stdio: ["pipe", "pipe", "pipe"], windowsHide: true });
+    const hub = eventHub();
+    const pending = new Map();
+    let nextId = 1;
+    let self = null;
+    let closing = false;
+    let exited = false;
+    let onCode;
+    let greet;
+    // A binary that never started fires "error" and no "exit".
+    const exit = new Promise((resolve) => {
+        child.once("close", () => resolve());
+        child.once("error", () => resolve());
+    });
+    const failAll = (error) => {
+        greet?.reject(error());
+        for (const waiting of pending.values())
+            waiting.reject(isWrite(waiting.op) ? CUT() : error());
+        pending.clear();
+    };
+    child.once("error", (error) => {
+        exited = true;
+        failAll(error.code === "ENOENT" || error.code === "EACCES" ? missing : STOPPED);
+    });
+    // "close", not "exit": an answer the engine wrote just before it ended is still in the pipe at "exit".
+    child.once("close", () => {
+        exited = true;
+        failAll(STOPPED);
+        if (!closing)
+            hub.emit({ event: "connection", state: "stopped" });
+    });
+    child.stdin?.on("error", () => { });
+    createInterface({ input: child.stderr }).on("line", (line) => options.warn?.(line));
+    const onLine = (line) => {
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if ("hello" in value) {
+            const said = v.parse(hello, value.hello);
+            if (said.protocol !== PROTOCOL) {
+                greet?.reject(new EngineError("provider_unavailable", `the WhatsApp engine speaks protocol ${said.protocol}, this wa needs ${PROTOCOL} — reinstall wa`));
+                return;
+            }
+            self = said.self;
+            greet?.resolve();
+        }
+        else if ("refused" in value) {
+            const refused = v.parse(engineError, value.refused);
+            greet?.reject(new EngineError(refused.code, refused.message, refused.reason, refused.until));
+        }
+        else if ("login" in value) {
+            onCode?.(v.parse(loginCode, value));
+        }
+        else if ("event" in value) {
+            const event = v.safeParse(engineEvent, value);
+            if (event.success)
+                hub.emit(event.output);
+            else
+                options.warn?.("the WhatsApp engine sent an event this wa cannot read; it was skipped");
+        }
+        else if (typeof value.id === "number") {
+            const waiting = pending.get(value.id);
+            pending.delete(value.id);
+            if (!waiting)
+                return;
+            if ("error" in value) {
+                const refused = v.parse(engineError, value.error);
+                waiting.reject(new EngineError(refused.code, refused.message, refused.reason, refused.until));
+            }
+            else
+                waiting.resolve(value.ok);
+        }
+    };
+    createInterface({ input: child.stdout }).on("line", onLine);
+    const request = (op, fields, schema) => {
+        if (exited)
+            return Promise.reject(STOPPED());
+        const id = nextId++;
+        const answer = new Promise((resolve, reject) => pending.set(id, { op, resolve, reject }));
+        child.stdin?.write(`${JSON.stringify({ id, op, ...fields })}\n`);
+        return answer.then((value) => v.parse(schema, value));
+    };
+    const close = async () => {
+        if (closing)
+            return exit;
+        closing = true;
+        if (!exited) {
+            const asked = request("close", {}, v.unknown()).catch(() => { });
+            child.stdin?.end();
+            await Promise.race([asked.then(() => exit), delay(CLOSE_WAIT_MS)]);
+            if (!exited)
+                child.kill("SIGKILL");
+        }
+        await exit;
+    };
+    try {
+        await new Promise((resolve, reject) => {
+            greet = { resolve, reject };
+            setTimeout(() => reject(new EngineError("timeout", "the WhatsApp engine did not start in time")), HELLO_WAIT_MS).unref();
+        });
+    }
+    catch (error) {
+        await close();
+        throw error;
+    }
+    finally {
+        greet = undefined;
+    }
+    let connecting;
+    const nothing = v.nullable(v.unknown());
+    const jidAnswer = v.pipe(v.string(), v.includes("@"));
+    return {
+        self: () => self,
+        ready: async (signal) => {
+            connecting ??= request("connect", {}, nothing);
+            await Promise.race([connecting, aborted(signal)]);
+        },
+        me: () => request("me", {}, waAccount),
+        directory: () => request("directory", {}, v.array(waChat)),
+        chat: (jid) => request("chat", { jid }, waChatCard),
+        send: ({ chat, text, id, replyTo, quoted }) => request("send", { chat, text, sendId: id, ...replyFields(replyTo, quoted) }, waMessage),
+        edit: (key, text) => request("edit", { ...keyFields(key), text }, waMessage),
+        revoke: async (key) => {
+            await request("revoke", keyFields(key), nothing);
+        },
+        react: async (key, emoji) => {
+            await request("react", { ...keyFields(key), emoji }, nothing);
+        },
+        markRead: async (key) => {
+            await request("read", keyFields(key), nothing);
+        },
+        sendMedia: ({ chat, text, id, replyTo, quoted, file }) => request("sendMedia", { chat, text, sendId: id, file, ...replyFields(replyTo, quoted) }, waMessage),
+        sendAlbum: ({ chat, text, id, replyTo, quoted, files }) => request("sendAlbum", { chat, text, sendId: id, files, ...replyFields(replyTo, quoted) }, waMessage),
+        download: (attachment, path, key) => request("download", { attachment, path, ...keyFields(key) }, waDownloaded),
+        forward: ({ chat, id, text, attachment }) => request("forward", { chat, sendId: id, text, ...(attachment ? { attachment } : {}) }, waMessage),
+        older: (anchor, count) => request("older", { ...keyFields(anchor), timestamp: anchor.timestamp, count }, waOlder),
+        createPoll: ({ chat, id, question, answers, multiple }) => request("createPoll", { chat, sendId: id, question, answers, ...(multiple ? { multiple } : {}) }, waMessage),
+        vote: async (key, answers) => {
+            await request("vote", { ...keyFields(key), answers }, nothing);
+        },
+        pin: async (key, duration) => {
+            await request("pin", { ...keyFields(key), ...(duration === undefined ? {} : { duration }) }, nothing);
+        },
+        unpin: async (key) => {
+            await request("unpin", keyFields(key), nothing);
+        },
+        link: async (linking, show) => {
+            onCode = show;
+            try {
+                const account = await request("link", { ...linking }, waAccount);
+                self = account.jid;
+                return account;
+            }
+            finally {
+                onCode = undefined;
+            }
+        },
+        logout: async () => {
+            await request("logout", {}, nothing);
+            self = null;
+        },
+        storedChats: async (chats, recipients) => {
+            await request("storedChats", { chats, ...(recipients?.length ? { recipients } : {}) }, nothing);
+        },
+        canonicalChat: (jid) => request("canonicalChat", { jid }, jidAnswer),
+        listen: (kinds, onEvent) => hub.listen(kinds, onEvent),
+        close,
+        ...goGroups(request),
+        ...goPrivacy(request),
+        ...goSettings(request),
+        ...goChannels(request),
+    };
+};
+const replyFields = (replyTo, quoted) => ({
+    ...(replyTo === undefined ? {} : { replyTo }),
+    ...(quoted === undefined
+        ? {}
+        : {
+            quote: {
+                fromMe: quoted.fromMe,
+                text: quoted.text,
+                ...(quoted.sender === null ? {} : { sender: quoted.sender }),
+            },
+        }),
+});
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms).unref());
+const aborted = (signal) => new Promise((resolve) => {
+    if (signal.aborted)
+        resolve();
+    signal.addEventListener("abort", () => resolve(), { once: true });
+});
+//# sourceMappingURL=go-engine.js.map

package/dist/engine/go-engine.js.map

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

package/dist/engine/groups.d.ts

@@ -0,0 +1,171 @@
+import * as v from "valibot";
+import { type EngineOp, type WaContact } from "./contract.js";
+export declare const waMember: v.StrictObjectSchema<{
+    readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly role: v.PicklistSchema<["owner", "admin", "member"], undefined>;
+}, undefined>;
+/**
+ * A group in WhatsApp's own terms. `addMode` is who may add members; `announce`, only admins send; `locked`, only
+ * admins change the name and description; `ephemeral`, seconds until messages disappear, 0 for never. `link` is
+ * `null` unless it was asked for and the account may see it.
+ */
+export declare const waGroup: v.StrictObjectSchema<{
+    readonly chat: v.StrictObjectSchema<{
+        readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
+        readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+        readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+        readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
+    }, undefined>;
+    readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly link: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly addMode: v.PicklistSchema<["admin_add", "all_member_add", ""], undefined>;
+    readonly approval: v.BooleanSchema<undefined>;
+    readonly announce: v.BooleanSchema<undefined>;
+    readonly locked: v.BooleanSchema<undefined>;
+    readonly ephemeral: v.NumberSchema<undefined>;
+    readonly members: v.ArraySchema<v.StrictObjectSchema<{
+        readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly role: v.PicklistSchema<["owner", "admin", "member"], undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+/** `notAdded`: who could not be added, by their privacy or the group's limits, in the form they were named. */
+export declare const waCreated: v.StrictObjectSchema<{
+    readonly group: v.StrictObjectSchema<{
+        readonly chat: v.StrictObjectSchema<{
+            readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
+            readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+            readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+            readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
+        }, undefined>;
+        readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly link: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly addMode: v.PicklistSchema<["admin_add", "all_member_add", ""], undefined>;
+        readonly approval: v.BooleanSchema<undefined>;
+        readonly announce: v.BooleanSchema<undefined>;
+        readonly locked: v.BooleanSchema<undefined>;
+        readonly ephemeral: v.NumberSchema<undefined>;
+        readonly members: v.ArraySchema<v.StrictObjectSchema<{
+            readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly role: v.PicklistSchema<["owner", "admin", "member"], undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+    readonly notAdded: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>;
+}, undefined>;
+export declare const waJoined: v.StrictObjectSchema<{
+    readonly group: v.NullableSchema<v.StrictObjectSchema<{
+        readonly chat: v.StrictObjectSchema<{
+            readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
+            readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+            readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+            readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
+        }, undefined>;
+        readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly link: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly addMode: v.PicklistSchema<["admin_add", "all_member_add", ""], undefined>;
+        readonly approval: v.BooleanSchema<undefined>;
+        readonly announce: v.BooleanSchema<undefined>;
+        readonly locked: v.BooleanSchema<undefined>;
+        readonly ephemeral: v.NumberSchema<undefined>;
+        readonly members: v.ArraySchema<v.StrictObjectSchema<{
+            readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly role: v.PicklistSchema<["owner", "admin", "member"], undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly requested: v.BooleanSchema<undefined>;
+}, undefined>;
+export declare const waNotAdded: v.StrictObjectSchema<{
+    readonly notAdded: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>;
+}, undefined>;
+export declare const waJoinRequest: v.StrictObjectSchema<{
+    readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly requestedAt: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
+}, undefined>;
+/** `photo` is `null` when their privacy hides it; `verified` is WhatsApp's badge on an official business. */
+export declare const waProfile: v.StrictObjectSchema<{
+    readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly about: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly business: v.BooleanSchema<undefined>;
+    readonly verified: v.BooleanSchema<undefined>;
+    readonly contact: v.BooleanSchema<undefined>;
+    readonly photo: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type WaMember = v.InferOutput<typeof waMember>;
+export type WaGroup = v.InferOutput<typeof waGroup>;
+export type WaCreated = v.InferOutput<typeof waCreated>;
+export type WaJoined = v.InferOutput<typeof waJoined>;
+export type WaJoinRequest = v.InferOutput<typeof waJoinRequest>;
+export type WaProfile = v.InferOutput<typeof waProfile>;
+/** What `updateGroup` changes; a field left out stays. */
+export interface WaGroupChange {
+    title?: string;
+    description?: string;
+    addMode?: "admin_add" | "all_member_add";
+    approval?: boolean;
+    announce?: boolean;
+    locked?: boolean;
+    /** Seconds, one of WhatsApp's own timers; 0 turns it off. */
+    ephemeral?: number;
+}
+export type WaParticipantAction = "add" | "remove" | "promote" | "demote";
+/** The engine's group and people requests. Every write here is seen by other people. */
+export interface GroupEngine {
+    /** One group and its members; the invite link only with `withLink`, and only when the account may see it. */
+    group(jid: string, options?: {
+        withLink?: boolean;
+    }): Promise<WaGroup>;
+    /** The people are told they were added. */
+    createGroup(title: string, people: string[]): Promise<WaCreated>;
+    /** By an invite link; `requested` when the group's admins approve who joins. */
+    join(link: string): Promise<WaJoined>;
+    leave(jid: string): Promise<void>;
+    updateGroup(jid: string, change: WaGroupChange): Promise<WaGroup>;
+    /** The group's photo from a JPEG at `path`, an absolute path; the engine refuses one WhatsApp would not take. */
+    setGroupPhoto(jid: string, path: string): Promise<WaGroup>;
+    removeGroupPhoto(jid: string): Promise<WaGroup>;
+    /** A new invite link; the old one stops working. */
+    resetInviteLink(jid: string): Promise<WaGroup>;
+    /** Adds, removes, promotes to admin or demotes; only `add` may leave some out. */
+    participants(jid: string, action: WaParticipantAction, people: string[]): Promise<{
+        notAdded: string[];
+    }>;
+    joinRequests(jid: string): Promise<WaJoinRequest[]>;
+    answerJoinRequest(jid: string, person: string, accept: boolean): Promise<void>;
+    /** Reading it tells them nothing. */
+    profile(jid: string): Promise<WaProfile>;
+    block(jid: string, blocked: boolean): Promise<void>;
+    /** Whether one number has WhatsApp; nothing is sent to it. The engine takes one lookup every few seconds. */
+    lookup(phone: string): Promise<WaContact>;
+    /** The phone's address book, as the engine's store holds it. */
+    contacts(): Promise<WaContact[]>;
+}
+export type EngineRequest = <T>(op: EngineOp, fields: Record<string, unknown>, schema: v.GenericSchema<unknown, T>) => Promise<T>;
+/** The group and people requests over the Go engine's JSON lines. */
+export declare const goGroups: (request: EngineRequest) => GroupEngine;
+//# sourceMappingURL=groups.d.ts.map

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

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

package/dist/engine/groups.js

@@ -0,0 +1,66 @@
+import * as v from "valibot";
+import { waChat, waContact } from "./contract.js";
+const jid = v.pipe(v.string(), v.includes("@"));
+const time = v.pipe(v.string(), v.isoTimestamp());
+export const waMember = v.strictObject({
+    jid,
+    name: v.nullable(v.string()),
+    role: v.picklist(["owner", "admin", "member"]),
+});
+/**
+ * A group in WhatsApp's own terms. `addMode` is who may add members; `announce`, only admins send; `locked`, only
+ * admins change the name and description; `ephemeral`, seconds until messages disappear, 0 for never. `link` is
+ * `null` unless it was asked for and the account may see it.
+ */
+export const waGroup = v.strictObject({
+    chat: waChat,
+    description: v.nullable(v.string()),
+    link: v.nullable(v.string()),
+    addMode: v.picklist(["admin_add", "all_member_add", ""]),
+    approval: v.boolean(),
+    announce: v.boolean(),
+    locked: v.boolean(),
+    ephemeral: v.number(),
+    members: v.array(waMember),
+});
+/** `notAdded`: who could not be added, by their privacy or the group's limits, in the form they were named. */
+export const waCreated = v.strictObject({ group: waGroup, notAdded: v.array(jid) });
+export const waJoined = v.strictObject({ group: v.nullable(waGroup), requested: v.boolean() });
+export const waNotAdded = v.strictObject({ notAdded: v.array(jid) });
+export const waJoinRequest = v.strictObject({ jid, name: v.nullable(v.string()), requestedAt: v.nullable(time) });
+/** `photo` is `null` when their privacy hides it; `verified` is WhatsApp's badge on an official business. */
+export const waProfile = v.strictObject({
+    jid,
+    name: v.nullable(v.string()),
+    about: v.nullable(v.string()),
+    business: v.boolean(),
+    verified: v.boolean(),
+    contact: v.boolean(),
+    photo: v.nullable(v.boolean()),
+});
+const nothing = v.nullable(v.unknown());
+/** The group and people requests over the Go engine's JSON lines. */
+export const goGroups = (request) => ({
+    group: (jid, { withLink = false } = {}) => request("group", { jid, ...(withLink ? { withLink } : {}) }, waGroup),
+    createGroup: (title, people) => request("createGroup", { title, people }, waCreated),
+    join: (link) => request("join", { link }, waJoined),
+    leave: async (jid) => {
+        await request("leave", { jid }, nothing);
+    },
+    updateGroup: (jid, change) => request("updateGroup", { jid, ...change }, waGroup),
+    setGroupPhoto: (jid, path) => request("setGroupPhoto", { jid, path }, waGroup),
+    removeGroupPhoto: (jid) => request("setGroupPhoto", { jid, removePhoto: true }, waGroup),
+    resetInviteLink: (jid) => request("resetLink", { jid }, waGroup),
+    participants: (jid, action, people) => request("participants", { jid, action, people }, waNotAdded),
+    joinRequests: (jid) => request("requests", { jid }, v.array(waJoinRequest)),
+    answerJoinRequest: async (jid, person, accept) => {
+        await request("answerRequest", { jid, people: [person], accept }, nothing);
+    },
+    profile: (jid) => request("profile", { jid }, waProfile),
+    block: async (jid, blocked) => {
+        await request("block", { jid, blocked }, nothing);
+    },
+    lookup: (phone) => request("lookup", { phone }, waContact),
+    contacts: () => request("contacts", {}, v.array(waContact)),
+});
+//# sourceMappingURL=groups.js.map

package/dist/engine/groups.js.map

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

package/dist/engine/privacy.d.ts

@@ -0,0 +1,33 @@
+import * as v from "valibot";
+import type { EngineRequest } from "./groups.js";
+/**
+ * The account's privacy in WhatsApp's own names and values (whatsmeow's `types.PrivacySettings`): `groupadd` who may
+ * add the account to groups, `last` who sees last seen, `online` who sees it online (`match_last_seen`: those who see
+ * last seen), `calladd` whose calls ring (`known`: unknown callers are silenced), `profile` who sees the profile photo,
+ * `status` who sees the about text, `readreceipts` whether read receipts go (`all`) or not (`none`). An audience is
+ * `all`, `contacts`, `contact_blacklist` (contacts but those the phone excepts) or `none`. `""` is a setting WhatsApp
+ * did not send.
+ */
+export declare const waPrivacy: v.StrictObjectSchema<{
+    readonly groupadd: v.StringSchema<undefined>;
+    readonly last: v.StringSchema<undefined>;
+    readonly online: v.StringSchema<undefined>;
+    readonly calladd: v.StringSchema<undefined>;
+    readonly profile: v.StringSchema<undefined>;
+    readonly status: v.StringSchema<undefined>;
+    readonly readreceipts: v.StringSchema<undefined>;
+}, undefined>;
+export type WaPrivacy = v.InferOutput<typeof waPrivacy>;
+export interface WaPrivacyChange {
+    name: keyof WaPrivacy;
+    value: string;
+}
+/** The engine's privacy requests. A change is seen by everyone the setting is about. */
+export interface PrivacyEngine {
+    /** Asked of WhatsApp each time, never from a cache another device may have outdated. */
+    privacy(): Promise<WaPrivacy>;
+    /** In order, one request each; answers every setting as it now is. Nothing is sent unless every change is valid. */
+    setPrivacy(changes: WaPrivacyChange[]): Promise<WaPrivacy>;
+}
+export declare const goPrivacy: (request: EngineRequest) => PrivacyEngine;
+//# sourceMappingURL=privacy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../src/engine/privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;aAQpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,SAAS,CAAC,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,SAAS,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;IAC7B,oHAAoH;IACpH,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;CAC3D;AAED,eAAO,MAAM,SAAS,YAAa,aAAa,KAAG,aAGjD,CAAA"}

package/dist/engine/privacy.js

@@ -0,0 +1,23 @@
+import * as v from "valibot";
+/**
+ * The account's privacy in WhatsApp's own names and values (whatsmeow's `types.PrivacySettings`): `groupadd` who may
+ * add the account to groups, `last` who sees last seen, `online` who sees it online (`match_last_seen`: those who see
+ * last seen), `calladd` whose calls ring (`known`: unknown callers are silenced), `profile` who sees the profile photo,
+ * `status` who sees the about text, `readreceipts` whether read receipts go (`all`) or not (`none`). An audience is
+ * `all`, `contacts`, `contact_blacklist` (contacts but those the phone excepts) or `none`. `""` is a setting WhatsApp
+ * did not send.
+ */
+export const waPrivacy = v.strictObject({
+    groupadd: v.string(),
+    last: v.string(),
+    online: v.string(),
+    calladd: v.string(),
+    profile: v.string(),
+    status: v.string(),
+    readreceipts: v.string(),
+});
+export const goPrivacy = (request) => ({
+    privacy: () => request("privacy", {}, waPrivacy),
+    setPrivacy: (changes) => request("setPrivacy", { privacy: changes }, waPrivacy),
+});
+//# sourceMappingURL=privacy.js.map

package/dist/engine/privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.js","sourceRoot":"","sources":["../../src/engine/privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,YAAY,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAA;AAiBF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAsB,EAAiB,EAAE,CAAC,CAAC;IACnE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,CAAC;IAChD,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC;CAChF,CAAC,CAAA"}

package/dist/engine/settings.d.ts

@@ -0,0 +1,45 @@
+import { type WaAccount, type WaAnchor, type WaKey } from "./contract.js";
+import type { EngineRequest } from "./groups.js";
+/** The account's own name, "about" line and photo; a field left out stays. */
+export interface WaProfileChange {
+    pushName?: string;
+    about?: string;
+    /** The new photo's absolute path: a square JPEG of 190 to 720 pixels a side, checked before anything changes. */
+    path?: string;
+}
+/** The engine's writes to the account's synced settings, which WhatsApp syncs to the account's other devices. */
+export interface SettingsEngine {
+    /** `until`: `forever`, an ISO 8601 time, or `null` to unmute. Nobody in the chat is told. */
+    mute(jid: string, until: string | null): Promise<void>;
+    /**
+     * The name goes to the owner's devices as a setting, then the about and the photo to WhatsApp; answers the account
+     * as it now is.
+     */
+    updateProfile(change: WaProfileChange): Promise<WaAccount>;
+    /**
+     * Deletes `last`'s chat from the account's devices, up to `last`, the chat's newest stored message: WhatsApp needs
+     * it to know what the deletion covers. The photos and files the phone saved from it stay. Nobody else is told.
+     */
+    deleteChat(last: WaAnchor): Promise<void>;
+    /** Deletes every message of `last`'s chat up to `last`, starred ones too, and keeps the chat; as `deleteChat`. */
+    clearChat(last: WaAnchor): Promise<void>;
+    /**
+     * Deletes `message` from the account's devices alone; the others in the chat keep it. WhatsApp names the message by
+     * its key and the time it was sent, both from the store. The photos and files the phone saved from it stay.
+     */
+    deleteForMe(message: WaAnchor): Promise<void>;
+    /** Stars `message`, or takes the star off, on the account's devices alone; nobody in the chat is told. */
+    star(message: WaKey, starred: boolean): Promise<void>;
+    /** Moves `last`'s chat into the archive, which unpins it, or back out; bounded by `last` as `deleteChat` is. */
+    archiveChat(last: WaAnchor, archived: boolean): Promise<void>;
+    /** Pins the chat at the top of the account's chat list, or unpins it. Not a message pin. */
+    pinChat(jid: string, pinned: boolean): Promise<void>;
+    /**
+     * Marks `last`'s chat read on the account's devices up to `last`, which takes a mark-unread off; no receipt is sent.
+     */
+    markChatRead(last: WaAnchor): Promise<void>;
+    /** Marks `last`'s chat unread on the account's devices; no receipt is sent or taken back. */
+    markChatUnread(last: WaAnchor): Promise<void>;
+}
+export declare const goSettings: (request: EngineRequest) => SettingsEngine;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/engine/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAa,MAAM,eAAe,CAAA;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iHAAiH;IACjH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,iHAAiH;AACjH,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,kHAAkH;IAClH,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,0GAA0G;IAC1G,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,gHAAgH;IAChH,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,4FAA4F;IAC5F,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,6FAA6F;IAC7F,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C;AAID,eAAO,MAAM,UAAU,YAAa,aAAa,KAAG,cAiClD,CAAA"}