Skip to content

@open-wa v5.0.0-alpha.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@smashah smashah released this 07 Jun 14:34
v5.0.0-alpha.0
f9f3272

@open-wa v5.0.0-alpha.0

This is the first v5 alpha prerelease for testers and contributors. It introduces the new monorepo package line, the v5 runtime shape, updated transport pieces, and the first pass of the new documentation.

Alpha warning: use v4.76.0 for production systems unless you are deliberately testing v5 in a disposable environment.

Highlights

  • Monorepo package line: v5 is split into focused packages for the runtime, API, client, schema, drivers, plugins, integrations, and tooling.
  • New runtime shape: the public v5 path centers on createClient, schema-driven method metadata, and clearer runtime boundaries.
  • HTTP and SSE transport: Easy API commands move through HTTP while runtime events stream through Server-Sent Events.
  • Browser driver options: Puppeteer, Playwright, and Lightpanda-backed driver packages are available for early testing.
  • MCP support: the Easy API can expose WhatsApp methods as MCP tools for AI agents.
  • Integration packages: early v5 packages cover Chatwoot, webhook delivery, S3 media handling, Cloudflare session proxying, and Node-RED.
  • Documentation refresh: the docs now focus on practical v5 paths: Easy API, SocketClient, embedded runtime, integrations, MCP, and generated reference pages.

Test The Alpha

Use an explicit version while the alpha line is moving:

npx @open-wa/wa-automate@5.0.0-alpha.0 --port 8080

For production systems, stay on the latest stable v4 release:

npx @open-wa/wa-automate@4.76.0

Migration Guidance

  • Start with Easy API before embedding the runtime directly.
  • Test named sessions, authentication, webhooks, generated schemas, and event streams in a separate environment.
  • Prefer SocketClient for remote consumers when you do not need to own the browser runtime.
  • Treat v5 as a new runtime surface, not a drop-in v4 replacement yet.

Package Areas

  • @open-wa/wa-automate for the CLI and public package entry.
  • @open-wa/core, @open-wa/api, and @open-wa/schema for the runtime, Easy API, and method metadata.
  • @open-wa/driver-puppeteer, @open-wa/driver-playwright, and @open-wa/driver-lightpanda for browser runtime experiments.
  • @open-wa/plugin-sdk plus integration packages for webhook, Chatwoot, S3, Cloudflare, and Node-RED paths.

Full changelog: 4.76.0...v5.0.0-alpha.0

Contributors

open-wa
Assets 2
Loading