@openclaw/whatsapp 2026.5.1-beta.1

package/doctor-contract-api.ts

@@ -0,0 +1,8 @@
+import type { ChannelDoctorLegacyConfigRule } from "openclaw/plugin-sdk/channel-contract";
+
+export { normalizeCompatibilityConfig } from "./src/doctor-contract.js";
+
+// WhatsApp currently exposes doctor compatibility fixes without extra legacy
+// rule scans. Keep that empty answer on a lightweight contract surface so
+// config validation stays off the broad contract-api import path.
+export const legacyConfigRules: ChannelDoctorLegacyConfigRule[] = [];

package/index.test.ts

@@ -0,0 +1,13 @@
+import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
+import { describe } from "vitest";
+import entry from "./index.js";
+import setupEntry from "./setup-entry.js";
+
+describe("whatsapp bundled entries", () => {
+  assertBundledChannelEntries({
+    entry,
+    expectedId: "whatsapp",
+    expectedName: "WhatsApp",
+    setupEntry,
+  });
+});

package/index.ts

@@ -0,0 +1,16 @@
+import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelEntry({
+  id: "whatsapp",
+  name: "WhatsApp",
+  description: "WhatsApp channel plugin",
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./channel-plugin-api.js",
+    exportName: "whatsappPlugin",
+  },
+  runtime: {
+    specifier: "./runtime-api.js",
+    exportName: "setWhatsAppRuntime",
+  },
+});

package/legacy-session-surface-api.ts

@@ -0,0 +1,6 @@
+import { canonicalizeLegacySessionKey, isLegacyGroupSessionKey } from "./src/session-contract.js";
+
+export const whatsappLegacySessionSurface = {
+  isLegacyGroupSessionKey,
+  canonicalizeLegacySessionKey,
+};

package/legacy-state-migrations-api.ts

@@ -0,0 +1 @@
+export { detectWhatsAppLegacyStateMigrations } from "./src/state-migrations.js";

package/light-runtime-api.ts

@@ -0,0 +1,12 @@
+export { getActiveWebListener } from "./src/active-listener.js";
+export {
+  getWebAuthAgeMs,
+  logWebSelfId,
+  logoutWeb,
+  pickWebChannel,
+  readWebSelfId,
+  WA_WEB_AUTH_DIR,
+  webAuthExists,
+} from "./src/auth-store.js";
+export { createWhatsAppLoginTool } from "./src/agent-tools-login.js";
+export { formatError, getStatusCode } from "./src/session-errors.js";

package/login-qr-api.ts

@@ -0,0 +1 @@
+export { startWebLoginWithQr, waitForWebLogin } from "./login-qr-runtime.js";

package/login-qr-runtime.ts

@@ -0,0 +1,23 @@
+type StartWebLoginWithQr = typeof import("./src/login-qr.js").startWebLoginWithQr;
+type WaitForWebLogin = typeof import("./src/login-qr.js").waitForWebLogin;
+
+let loginQrModulePromise: Promise<typeof import("./src/login-qr.js")> | null = null;
+
+function loadLoginQrModule() {
+  loginQrModulePromise ??= import("./src/login-qr.js");
+  return loginQrModulePromise;
+}
+
+export async function startWebLoginWithQr(
+  ...args: Parameters<StartWebLoginWithQr>
+): ReturnType<StartWebLoginWithQr> {
+  const { startWebLoginWithQr } = await loadLoginQrModule();
+  return await startWebLoginWithQr(...args);
+}
+
+export async function waitForWebLogin(
+  ...args: Parameters<WaitForWebLogin>
+): ReturnType<WaitForWebLogin> {
+  const { waitForWebLogin } = await loadLoginQrModule();
+  return await waitForWebLogin(...args);
+}