@mindot/will 0.3.0 → 0.5.0

package/dist/channels/whatsapp.js

@@ -0,0 +1,252 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+
+// src/channels/roster.ts
+var FLUSH_MS = 2e3;
+var ChannelRoster = class {
+  constructor(path) {
+    this.path = path;
+    if (existsSync(path)) {
+      try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        for (const e of Array.isArray(raw) ? raw : []) this.entries.set(e.entityId, e);
+      } catch {
+      }
+    }
+  }
+  path;
+  entries = /* @__PURE__ */ new Map();
+  dirty = false;
+  timer = null;
+  /** Upsert what we just learned about an entity; schedules a throttled flush. */
+  record(update) {
+    const prev = this.entries.get(update.entityId);
+    const next = {
+      lastSeenAt: Date.now(),
+      ...prev,
+      ...Object.fromEntries(Object.entries(update).filter(([, v]) => v !== void 0))
+    };
+    this.entries.set(next.entityId, next);
+    this.dirty = true;
+    if (!this.timer) {
+      this.timer = setTimeout(() => {
+        this.timer = null;
+        this.flush();
+      }, FLUSH_MS);
+      this.timer.unref?.();
+    }
+    return next;
+  }
+  resolve(entityId) {
+    return this.entries.get(entityId);
+  }
+  all() {
+    return [...this.entries.values()];
+  }
+  /** Write to disk now (no-op when clean). Called by bridges on close. */
+  flush() {
+    if (!this.dirty) return;
+    try {
+      mkdirSync(dirname(this.path), { recursive: true });
+      writeFileSync(this.path, JSON.stringify(this.all(), null, 2));
+      this.dirty = false;
+    } catch {
+    }
+  }
+};
+
+// src/channels/types.ts
+function chunkText(text, max) {
+  if (text.length <= max) return [text];
+  const chunks = [];
+  let rest = text;
+  while (rest.length > max) {
+    const window = rest.slice(0, max);
+    const cut = Math.max(window.lastIndexOf("\n\n"), window.lastIndexOf("\n"), window.lastIndexOf(" "));
+    const at = cut > max * 0.5 ? cut : max;
+    chunks.push(rest.slice(0, at).trimEnd());
+    rest = rest.slice(at).trimStart();
+  }
+  if (rest) chunks.push(rest);
+  return chunks;
+}
+
+// src/channels/whatsapp.ts
+var WHATSAPP_MESSAGE_LIMIT = 65536;
+var isGroupJid = (jid) => jid.endsWith("@g.us");
+var bareId = (jid) => jid.split("@")[0].split(":")[0];
+var dmJidFor = (userId) => `${userId}@s.whatsapp.net`;
+function textOf(m) {
+  const msg = m.message;
+  return msg?.conversation ?? msg?.extendedTextMessage?.text ?? msg?.imageMessage?.caption ?? msg?.videoMessage?.caption ?? "";
+}
+async function connectWhatsApp(will, opts = {}) {
+  const log = opts.log ?? ((m) => console.error(`[will:whatsapp] ${m}`));
+  const roster = new ChannelRoster(opts.rosterPath ?? `.will/${will.id}.whatsapp.json`);
+  const allowed = opts.chats?.length ? new Set(opts.chats) : null;
+  let closed = false;
+  const socket = opts.socket ?? await createWhatsAppSocket({
+    authPath: opts.authPath ?? `.will/${will.id}.wa-auth`,
+    log,
+    stillOpen: () => !closed
+  });
+  let lastActiveChatId = opts.homeChatId ?? null;
+  socket.ev.on("messages.upsert", ({ messages, type }) => {
+    if (type && type !== "notify") return;
+    for (const m of messages) void onMessage(m);
+  });
+  async function onMessage(m) {
+    const jid = m.key.remoteJid;
+    if (!jid || m.key.fromMe || !m.message || m.messageStubType) return;
+    if (jid.endsWith("@broadcast") || jid.endsWith("@newsletter")) return;
+    if (allowed && !allowed.has(jid)) return;
+    const isGroup = isGroupJid(jid);
+    const senderJid = isGroup ? m.key.participant : jid;
+    if (!senderJid) return;
+    const selfId = socket.user ? bareId(socket.user.id) : null;
+    const mentioned = m.message.extendedTextMessage?.contextInfo?.mentionedJid ?? [];
+    const addressed = !isGroup || selfId != null && mentioned.some((j) => bareId(j) === selfId);
+    if (opts.mentionOnly && !addressed) return;
+    const userId = bareId(senderJid);
+    const entityId = `whatsapp:${userId}`;
+    const speaker = m.pushName ?? void 0;
+    roster.record({
+      entityId,
+      userId,
+      ...speaker ? { displayName: speaker } : {},
+      ...isGroup ? { lastChannelId: jid } : { dmChannelId: jid }
+    });
+    if (isGroup) lastActiveChatId = jid;
+    if (addressed) await socket.sendPresenceUpdate?.("composing", jid).catch(() => {
+    });
+    const text = textOf(m);
+    if (!text.trim()) return;
+    await will.perceive({
+      text,
+      from: entityId,
+      thread: `whatsapp:${jid}`,
+      ...speaker ? { speaker } : {}
+    });
+  }
+  will.on("message", (m) => {
+    if (!closed) void deliver(m);
+  });
+  async function deliver(m) {
+    const peer = m.to ? roster.resolve(m.to) : void 0;
+    const chunks = chunkText(m.content, WHATSAPP_MESSAGE_LIMIT);
+    const derivedDm = m.to?.startsWith("whatsapp:") ? dmJidFor(m.to.slice("whatsapp:".length)) : void 0;
+    const targets = [peer?.lastChannelId, peer?.dmChannelId, derivedDm, opts.homeChatId ?? void 0, lastActiveChatId ?? void 0];
+    for (const jid of targets) {
+      if (!jid) continue;
+      try {
+        for (const chunk of chunks) await socket.sendMessage(jid, { text: chunk });
+        return;
+      } catch {
+      }
+    }
+    log(`no route for utterance to '${m.to}' \u2014 dropped (${m.content.length} chars)`);
+  }
+  return {
+    kind: "whatsapp",
+    async start() {
+      log(`${will.name} is present on WhatsApp${socket.user ? ` as ${bareId(socket.user.id)}` : ""}`);
+    },
+    async close() {
+      if (closed) return;
+      closed = true;
+      roster.flush();
+      try {
+        socket.end?.();
+      } catch {
+      }
+    }
+  };
+}
+async function createWhatsAppSocket(o) {
+  let baileys;
+  try {
+    baileys = await import('baileys');
+  } catch {
+    throw new Error("baileys is not installed (it is an optionalDependency) \u2014 run `bun add baileys` / `npm i baileys` and retry.");
+  }
+  const { default: makeWASocket, useMultiFileAuthState, DisconnectReason } = baileys;
+  const noop = () => {
+  };
+  const logger = {
+    level: "silent",
+    child() {
+      return logger;
+    },
+    trace: noop,
+    debug: noop,
+    info: noop,
+    warn: noop,
+    error: noop,
+    fatal: noop
+  };
+  const subscribers = [];
+  let inner = null;
+  const facade = {
+    get user() {
+      return inner?.user ? { id: inner.user.id, name: inner.user.name ?? void 0 } : null;
+    },
+    ev: { on: (_e, fn) => {
+      subscribers.push(fn);
+    } },
+    sendMessage: (jid, content) => {
+      if (!inner) return Promise.reject(new Error("whatsapp socket not connected"));
+      return inner.sendMessage(jid, content);
+    },
+    sendPresenceUpdate: (state2, jid) => inner?.sendPresenceUpdate(state2, jid) ?? Promise.resolve(),
+    end: () => inner?.end(void 0)
+  };
+  const { state, saveCreds } = await useMultiFileAuthState(o.authPath);
+  await new Promise((resolveOpen, rejectOpen) => {
+    let opened = false;
+    function connect() {
+      const sock = makeWASocket({ auth: state, logger });
+      inner = sock;
+      sock.ev.on("creds.update", saveCreds);
+      sock.ev.on("messages.upsert", (u) => {
+        for (const fn of subscribers) fn(u);
+      });
+      sock.ev.on("connection.update", (update) => {
+        const { connection, lastDisconnect, qr } = update;
+        if (qr) void printQr(qr, o.log);
+        if (connection === "open" && !opened) {
+          opened = true;
+          resolveOpen();
+        }
+        if (connection === "close") {
+          const code = lastDisconnect?.error?.output?.statusCode;
+          if (code === DisconnectReason.loggedOut) {
+            const err = new Error("WhatsApp unlinked this device (logged out) \u2014 delete the auth dir and pair again.");
+            o.log(err.message);
+            if (!opened) rejectOpen(err);
+            return;
+          }
+          if (o.stillOpen()) {
+            o.log(`connection closed (status ${code ?? "?"}) \u2014 reconnecting\u2026`);
+            setTimeout(connect, 3e3);
+          }
+        }
+      });
+    }
+    connect();
+  });
+  return facade;
+}
+async function printQr(qr, log) {
+  log("pair this device: WhatsApp \u2192 Settings \u2192 Linked devices \u2192 Link a device");
+  try {
+    const qrt = await import('qrcode-terminal');
+    (qrt.default ?? qrt).generate(qr, { small: true });
+  } catch {
+    log(`qrcode-terminal not installed \u2014 raw pairing code:
+${qr}`);
+  }
+}
+
+export { connectWhatsApp };
+//# sourceMappingURL=whatsapp.js.map
+//# sourceMappingURL=whatsapp.js.map

package/dist/channels/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/channels/roster.ts","../../src/channels/types.ts","../../src/channels/whatsapp.ts"],"names":["state"],"mappings":"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","file":"whatsapp.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// src/channels/roster.ts — who the Will knows on a platform, and where\n// ─────────────────────────────────────────────────────────────\n//\n// The mind knows *entities*; a platform knows user ids and channels. The roster\n// is the durable seam between them: for each entity the Will has met on a\n// channel it records how to reach them again — so a *proactive* utterance\n// (`message.to` from the mind's own initiative) can find its person after a\n// restart, not just within one session.\n//\n// It persists as a small JSON file next to the PMA artifact. Writes are\n// throttled (the file is advisory routing state, not cognition — losing the\n// last few seconds costs a fallback delivery, never memory).\n// ─────────────────────────────────────────────────────────────\n\nimport { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname } from 'node:path'\n\n/** How to reach one entity on the platform. */\nexport interface RosterEntry {\n  /** The mind-side entity id, e.g. 'discord:80351110224678912'. */\n  entityId: string\n  /** The platform-side user id. */\n  userId: string\n  /** Last display name seen (advisory — the *learned* name lives in the mind). */\n  displayName?: string\n  /** DM channel id, once one is known. */\n  dmChannelId?: string\n  /** Last shared (guild) channel this entity spoke in. */\n  lastChannelId?: string\n  /** Epoch ms of the last message seen from them. */\n  lastSeenAt: number\n}\n\nconst FLUSH_MS = 2_000\n\nexport class ChannelRoster {\n  private entries = new Map<string, RosterEntry>()\n  private dirty = false\n  private timer: ReturnType<typeof setTimeout> | null = null\n\n  constructor( private readonly path: string ) {\n    if( existsSync( path ) ){\n      try {\n        const raw = JSON.parse( readFileSync( path, 'utf8' ) ) as RosterEntry[]\n        for( const e of Array.isArray( raw ) ? raw : [] ) this.entries.set( e.entityId, e )\n      }\n      catch { /* a corrupt roster is not worth failing a boot over — start fresh */ }\n    }\n  }\n\n  /** Upsert what we just learned about an entity; schedules a throttled flush. */\n  record( update: { entityId: string; userId: string } & Partial<Omit<RosterEntry, 'entityId' | 'userId'>> ): RosterEntry {\n    const prev = this.entries.get( update.entityId )\n    const next: RosterEntry = {\n      lastSeenAt: Date.now(),\n      ...prev,\n      ...Object.fromEntries( Object.entries( update ).filter( ( [ , v ] ) => v !== undefined ) ) as typeof update,\n    }\n    this.entries.set( next.entityId, next )\n    this.dirty = true\n    if( !this.timer ){\n      this.timer = setTimeout( () => { this.timer = null; this.flush() }, FLUSH_MS )\n      this.timer.unref?.()\n    }\n    return next\n  }\n\n  resolve( entityId: string ): RosterEntry | undefined {\n    return this.entries.get( entityId )\n  }\n\n  all(): RosterEntry[] {\n    return [ ...this.entries.values() ]\n  }\n\n  /** Write to disk now (no-op when clean). Called by bridges on close. */\n  flush(): void {\n    if( !this.dirty ) return\n    try {\n      mkdirSync( dirname( this.path ), { recursive: true } )\n      writeFileSync( this.path, JSON.stringify( this.all(), null, 2 ) )\n      this.dirty = false\n    }\n    catch { /* advisory state — never take the mind down over it */ }\n  }\n}\n","// ─────────────────────────────────────────────────────────────\n// src/channels/types.ts — the channel-bridge contract\n// ─────────────────────────────────────────────────────────────\n//\n// A channel bridge puts a Will *in a place where people already are* (Discord,\n// Telegram, Slack, …). It is a host surface, not a cognition surface: it turns\n// platform messages into `perceive` stimuli and delivers the Will's projected\n// utterances back — nothing more. The paradigm survives the crossing:\n//\n//   • every platform user is an entity the Will comes to know (`from`),\n//     with a *learned* name (`speaker`) — never a placeholder;\n//   • every platform channel/DM is a conversation thread (`thread`);\n//   • the Will decides when to speak. Silence is a valid outcome, so a\n//     bridge never fabricates a reply and never times a message out into\n//     an error.\n//\n// Bridges live at the same altitude as the MCP/HTTP hosts (src/mcp, src/serve):\n// they wrap the SDK facade, not the stem.\n// ─────────────────────────────────────────────────────────────\n\n/** A running connection between one Will and one platform. */\nexport interface ChannelBridge {\n  /** Platform kind, e.g. 'discord'. */\n  readonly kind: string\n  /** Connect and start relaying. Resolves once the bridge is live. */\n  start(): Promise<void>\n  /** Disconnect and release resources. Idempotent. */\n  close(): Promise<void>\n}\n\n/** Split a message into platform-sized chunks on natural boundaries. */\nexport function chunkText( text: string, max: number ): string[] {\n  if( text.length <= max ) return [ text ]\n  const chunks: string[] = []\n  let rest = text\n  while( rest.length > max ){\n    // Prefer a paragraph break, then a line break, then a space — else hard-cut.\n    const window = rest.slice( 0, max )\n    const cut = Math.max( window.lastIndexOf( '\\n\\n' ), window.lastIndexOf( '\\n' ), window.lastIndexOf( ' ' ) )\n    const at = cut > max * 0.5 ? cut : max\n    chunks.push( rest.slice( 0, at ).trimEnd() )\n    rest = rest.slice( at ).trimStart()\n  }\n  if( rest ) chunks.push( rest )\n  return chunks\n}\n","// ─────────────────────────────────────────────────────────────\n// src/channels/whatsapp.ts — a Will present on WhatsApp\n// ─────────────────────────────────────────────────────────────\n//\n// Same paradigm as the Discord bridge, different room:\n//\n//   inbound   DM / group message → will.perceive({ from, speaker, text, thread })\n//             — every author is `whatsapp:<number>` (stable across chats), the\n//             push name is *learned* by the mind, and each chat (DM or group)\n//             is its own conversation thread.\n//   outbound  will.on('message') → the addressee's last shared group, else\n//             their DM (a WhatsApp DM jid is derivable from the number — no\n//             roster miss is fatal), else the home chat.\n//\n// TRANSPORT — read before deploying. This bridge speaks the *linked-device*\n// protocol via Baileys: the Will pairs to a WhatsApp account by QR scan, like\n// WhatsApp Web. That is not a sanctioned bot API — WhatsApp's terms don't\n// allow automation on personal accounts, and accounts doing it can be banned.\n// Meta's sanctioned path (the Business Cloud API) needs a business account,\n// webhook hosting, and app review — no 2-minute pairing. Operator's choice;\n// docs/channels/whatsapp.md is explicit about the trade. Use a spare number.\n//\n// Baileys is imported lazily inside `createWhatsAppSocket` — tests (and hosts\n// that bring their own transport) inject `socket`, and the structural\n// `WaLikeSocket` type keeps the dependency out of the type graph.\n// ─────────────────────────────────────────────────────────────\n\nimport type { Will, WillMessage } from '#sdk/will'\nimport { ChannelRoster } from '#channels/roster'\nimport { chunkText, type ChannelBridge } from '#channels/types'\n\n/** WhatsApp's hard per-message cap. */\nconst WHATSAPP_MESSAGE_LIMIT = 65_536\n\n// ── The slice of a Baileys socket the bridge actually uses (structural) ──────\n\nexport interface WaLikeMessage {\n  key: {\n    remoteJid?: string | null\n    fromMe?: boolean | null\n    /** Sender jid inside a group (absent in DMs). */\n    participant?: string | null\n  }\n  /** Sender's display (\"push\") name. */\n  pushName?: string | null\n  messageStubType?: number | null\n  message?: {\n    conversation?: string | null\n    extendedTextMessage?: { text?: string | null; contextInfo?: { mentionedJid?: string[] | null } | null } | null\n    imageMessage?: { caption?: string | null } | null\n    videoMessage?: { caption?: string | null } | null\n  } | null\n}\n\nexport interface WaLikeSocket {\n  /** The paired account, once connected. id like '4915…:12@s.whatsapp.net'. */\n  user?: { id: string; name?: string } | null\n  ev: { on( event: 'messages.upsert', fn: ( u: { messages: WaLikeMessage[]; type?: string } ) => void ): unknown }\n  sendMessage( jid: string, content: { text: string } ): Promise<unknown>\n  sendPresenceUpdate?( state: 'composing' | 'paused', jid?: string ): Promise<unknown>\n  /** Tear the connection down (does not unlink the device). */\n  end?( err?: Error ): void\n}\n\n// ── Options ──────────────────────────────────────────────────────────────────\n\nexport interface WhatsAppBridgeOptions {\n  /** Chat jids the Will inhabits (groups `…@g.us`, DMs `…@s.whatsapp.net`). Unset = every chat. */\n  chats?: string[]\n  /** Perceive group messages only when the Will is @mentioned (DMs always perceived). */\n  mentionOnly?: boolean\n  /** Fallback chat jid for utterances with no reachable addressee. */\n  homeChatId?: string\n  /** Linked-device credentials dir (default: ./.will/<willId>.wa-auth). QR pairs on first run. */\n  authPath?: string\n  /** Roster path (default: ./.will/<willId>.whatsapp.json). */\n  rosterPath?: string\n  /** Test / power-user seam: bring your own socket; Baileys is never imported. */\n  socket?: WaLikeSocket\n  log?: ( msg: string ) => void\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nconst isGroupJid = ( jid: string ): boolean => jid.endsWith( '@g.us' )\n\n/** '4915123:7@s.whatsapp.net' → '4915123' (device + server stripped). */\nconst bareId = ( jid: string ): string => jid.split( '@' )[0]!.split( ':' )[0]!\n\n/** A DM jid is derivable from the bare number — WhatsApp's gift to proactivity. */\nconst dmJidFor = ( userId: string ): string => `${ userId }@s.whatsapp.net`\n\nfunction textOf( m: WaLikeMessage ): string {\n  const msg = m.message\n  return msg?.conversation\n      ?? msg?.extendedTextMessage?.text\n      ?? msg?.imageMessage?.caption\n      ?? msg?.videoMessage?.caption\n      ?? ''\n}\n\n// ── The bridge ───────────────────────────────────────────────────────────────\n\n/**\n * Connect a Will to WhatsApp over the linked-device protocol. First run prints\n * a QR to pair (Settings → Linked devices → Link a device); credentials persist\n * in `authPath` so later runs reconnect silently. Close via the returned\n * `ChannelBridge.close()` — the Will keeps ticking; it only loses this surface.\n */\nexport async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions = {} ): Promise<ChannelBridge> {\n  const log     = opts.log ?? ( ( m: string ) => console.error( `[will:whatsapp] ${ m }` ) )\n  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.whatsapp.json` )\n  const allowed = opts.chats?.length ? new Set( opts.chats ) : null\n\n  let closed = false\n  const socket = opts.socket ?? await createWhatsAppSocket( {\n    authPath: opts.authPath ?? `.will/${ will.id }.wa-auth`,\n    log,\n    stillOpen: () => !closed,\n  } )\n\n  /** The most recently active allowed chat — last-resort proactive target. */\n  let lastActiveChatId: string | null = opts.homeChatId ?? null\n\n  // ── inbound: platform message → stimulus ──────────────────────────────────\n  socket.ev.on( 'messages.upsert', ( { messages, type } ) => {\n    if( type && type !== 'notify' ) return   // history sync/corrections are not new percepts\n    for( const m of messages ) void onMessage( m )\n  } )\n\n  async function onMessage( m: WaLikeMessage ): Promise<void> {\n    const jid = m.key.remoteJid\n    if( !jid || m.key.fromMe || !m.message || m.messageStubType ) return\n    if( jid.endsWith( '@broadcast' ) || jid.endsWith( '@newsletter' ) ) return   // stories/broadcasts aren't a room the Will is in\n    if( allowed && !allowed.has( jid ) ) return\n\n    const isGroup   = isGroupJid( jid )\n    const senderJid = isGroup ? m.key.participant : jid\n    if( !senderJid ) return\n\n    const selfId    = socket.user ? bareId( socket.user.id ) : null\n    const mentioned = m.message.extendedTextMessage?.contextInfo?.mentionedJid ?? []\n    const addressed = !isGroup || ( selfId != null && mentioned.some( j => bareId( j ) === selfId ) )\n    if( opts.mentionOnly && !addressed ) return\n\n    const userId   = bareId( senderJid )\n    const entityId = `whatsapp:${ userId }`\n    const speaker  = m.pushName ?? undefined\n\n    roster.record( {\n      entityId,\n      userId,\n      ...( speaker ? { displayName: speaker } : {} ),\n      ...( isGroup ? { lastChannelId: jid } : { dmChannelId: jid } ),\n    } )\n    if( isGroup ) lastActiveChatId = jid\n\n    // Same rule as Discord: a presence cue only when addressed — the mind may\n    // still choose silence, and 'composing' expires on its own.\n    if( addressed ) await socket.sendPresenceUpdate?.( 'composing', jid ).catch( () => {} )\n\n    const text = textOf( m )\n    if( !text.trim() ) return\n\n    await will.perceive( {\n      text,\n      from:   entityId,\n      thread: `whatsapp:${ jid }`,\n      ...( speaker ? { speaker } : {} ),\n    } )\n  }\n\n  // ── outbound: projected utterance → the addressee ─────────────────────────\n  will.on( 'message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )\n\n  async function deliver( m: WillMessage ): Promise<void> {\n    const peer   = m.to ? roster.resolve( m.to ) : undefined\n    const chunks = chunkText( m.content, WHATSAPP_MESSAGE_LIMIT )\n\n    // Last shared group → known DM → DM derived from the entity id itself →\n    // home chat → last active chat. Unlike Discord, an unmet-but-addressed\n    // entity is still reachable: `whatsapp:<number>` implies its DM jid.\n    const derivedDm = m.to?.startsWith( 'whatsapp:' ) ? dmJidFor( m.to.slice( 'whatsapp:'.length ) ) : undefined\n    const targets = [ peer?.lastChannelId, peer?.dmChannelId, derivedDm, opts.homeChatId ?? undefined, lastActiveChatId ?? undefined ]\n    for( const jid of targets ){\n      if( !jid ) continue\n      try {\n        for( const chunk of chunks ) await socket.sendMessage( jid, { text: chunk } )\n        return\n      }\n      catch { /* try the next route */ }\n    }\n    log( `no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)` )\n  }\n\n  // ── lifecycle ──────────────────────────────────────────────────────────────\n  return {\n    kind: 'whatsapp',\n    async start(): Promise<void> {\n      // createWhatsAppSocket resolves already-open; an injected socket is the\n      // caller's to have readied.\n      log( `${ will.name } is present on WhatsApp${ socket.user ? ` as ${ bareId( socket.user.id ) }` : '' }` )\n    },\n    async close(): Promise<void> {\n      if( closed ) return\n      closed = true\n      roster.flush()\n      try { socket.end?.() } catch { /* already down */ }\n    },\n  }\n}\n\n// ── The real transport (Baileys, lazily imported) ────────────────────────────\n\ninterface SocketFactoryOpts {\n  authPath:  string\n  log:       ( msg: string ) => void\n  /** Reconnect only while the bridge is open. */\n  stillOpen: () => boolean\n}\n\n/**\n * A reconnect-stable facade over Baileys. Baileys' own pattern replaces the\n * socket object on every reconnect; the facade keeps one stable identity the\n * bridge can hold, re-attaching its subscribers to each inner incarnation.\n * Resolves once the first connection is open (after QR pairing on first run).\n */\nasync function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocket> {\n  let baileys: typeof import( 'baileys' )\n  try { baileys = await import( 'baileys' ) }\n  catch {\n    throw new Error( 'baileys is not installed (it is an optionalDependency) — run `bun add baileys` / `npm i baileys` and retry.' )\n  }\n  const { default: makeWASocket, useMultiFileAuthState, DisconnectReason } = baileys\n\n  // Baileys logs through pino at info by default — JSON noise all over the\n  // host's stderr. A minimal pino-shaped silent logger (child() returns\n  // itself, every level a no-op) is what it actually needs; hand-rolling it\n  // beats importing a transitive dep that may not resolve from dist/.\n  const noop = (): void => {}\n  const logger = {\n    level: 'silent',\n    child(){ return logger },\n    trace: noop, debug: noop, info: noop, warn: noop, error: noop, fatal: noop,\n  }\n\n  type Handler = ( u: { messages: WaLikeMessage[]; type?: string } ) => void\n  const subscribers: Handler[] = []\n  let inner: ReturnType<typeof makeWASocket> | null = null\n\n  const facade: WaLikeSocket = {\n    get user(){ return inner?.user ? { id: inner.user.id, name: inner.user.name ?? undefined } : null },\n    ev: { on: ( _e, fn ) => { subscribers.push( fn ) } },\n    sendMessage: ( jid, content ) => {\n      if( !inner ) return Promise.reject( new Error( 'whatsapp socket not connected' ) )\n      return inner.sendMessage( jid, content )\n    },\n    sendPresenceUpdate: ( state, jid ) => inner?.sendPresenceUpdate( state, jid ) ?? Promise.resolve(),\n    end: () => inner?.end( undefined ),\n  }\n\n  const { state, saveCreds } = await useMultiFileAuthState( o.authPath )\n\n  await new Promise<void>( ( resolveOpen, rejectOpen ) => {\n    let opened = false\n\n    function connect(): void {\n      const sock = makeWASocket( { auth: state, logger: logger as never } )\n      inner = sock\n\n      sock.ev.on( 'creds.update', saveCreds )\n      sock.ev.on( 'messages.upsert', u => { for( const fn of subscribers ) fn( u as never ) } )\n\n      sock.ev.on( 'connection.update', update => {\n        const { connection, lastDisconnect, qr } = update as {\n          connection?: string; lastDisconnect?: { error?: unknown }; qr?: string\n        }\n\n        if( qr ) void printQr( qr, o.log )\n\n        if( connection === 'open' && !opened ){\n          opened = true\n          resolveOpen()\n        }\n        if( connection === 'close' ){\n          const code = ( lastDisconnect?.error as { output?: { statusCode?: number } } | undefined )?.output?.statusCode\n          if( code === DisconnectReason.loggedOut ){\n            const err = new Error( 'WhatsApp unlinked this device (logged out) — delete the auth dir and pair again.' )\n            o.log( err.message )\n            if( !opened ) rejectOpen( err )\n            return\n          }\n          if( o.stillOpen() ){\n            o.log( `connection closed (status ${ code ?? '?' }) — reconnecting…` )\n            setTimeout( connect, 3_000 )\n          }\n        }\n      } )\n    }\n\n    connect()\n  } )\n\n  return facade\n}\n\n/** QR to the terminal; falls back to the raw pairing string if the tiny renderer is absent. */\nasync function printQr( qr: string, log: ( m: string ) => void ): Promise<void> {\n  log( 'pair this device: WhatsApp → Settings → Linked devices → Link a device' )\n  try {\n    type QrModule = { generate( s: string, o: { small: boolean } ): void }\n    const qrt = ( await import( 'qrcode-terminal' as string ) ) as QrModule & { default?: QrModule }\n    ;( qrt.default ?? qrt ).generate( qr, { small: true } )\n  }\n  catch {\n    log( `qrcode-terminal not installed — raw pairing code:\\n${ qr }` )\n  }\n}\n"]}