feat(platform)!: rename builder to chat, client and webhooks

[amitbardos]

What

client.builder follows the AI chat, so it's renamed to client.chat:

Before	After
client.builder	client.chat
BuilderModule	ChatModule
BuilderSession	ChatSession
BuilderInitOptions	ChatInitOptions
BuilderSocket (internal)	ChatSocket
modules/builder*.ts	modules/chat*.ts
reference page interfaces/builder	interfaces/chat

Base44's terminology keeps "builder" for the Builder plan, the Base44 Builder GitHub App and people who build apps. The chat is "the AI chat" and the AI is "the AI". chat also matches useBase44Chat, Base44ChatProvider and the Apps API's chat/* endpoints. v0's platform API uses the same name (chats).

Breaking, on purpose

The SDK has no users yet, so this is a clean rename with no aliases: client.builder and the Builder* types are gone. A type test pins that client.builder no longer exists. The CHANGELOG's Unreleased entry marks it Breaking.

Webhooks

The server types follow base44-dev/apper#32412: chat.turn_started.v1 and chat.turn_ended.v1 (ChatTurnStartedV1Data, ChatTurnEndedV1Data) replace builder.turn_*. Base44 renames them in place (its only consumer, gameix, is handled in wix-private/gameix#334), so the old names are gone.

Also

• TSDoc, README, the package description and the error text say "chat session", "the AI" and "app editor".
• The sync-asyncapi workflow points at the renamed chat.events.generated.ts. Without that fix the hourly sync would stop committing.
• The Mintlify post-processing config (types-to-expose, appended-articles, page-sections) and examples/client.ts.

Merge after apper deploys

The webhook types were generated from that PR's schema files. On main, the hourly sync-webhook-events job fetches https://base44.com/webhooks/schemas/chat.turn_*.json, which returns 404 until apper deploys. The same deploy updates the "the builder" descriptions still inside chat.events.generated.ts through sync-asyncapi.

Heads-up

base44/javascript-sdk#338 also edits appended-articles.json and types-to-expose.json. Whichever merges second needs a small rebase.

Checks

npm test -w @base44/platform (types, 155 unit, docs, 9 package tests), npm run check:events, npm run lint, and npm run create-docs, which produces interfaces/chat.mdx with no Builder* pages.

🤖 Generated with Claude Code

[github-actions]

🚀 Package Preview Available! (@base44/platform)

---

Install this PR's preview build with npm:

npm i @base44-preview/platform@0.3.0-pr.340.4cdf434

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/platform:

npm i "@base44/platform@npm:@base44-preview/platform@0.3.0-pr.340.4cdf434"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/platform": "npm:@base44-preview/platform@0.3.0-pr.340.4cdf434"
  }
}

• 📦 Preview Package: @base44-preview/platform@0.3.0-pr.340.4cdf434
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.54-pr.340.4cdf434

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.54-pr.340.4cdf434"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.54-pr.340.4cdf434"
  }
}

• 📦 Preview Package: @base44-preview/sdk@0.8.54-pr.340.4cdf434
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}