chaipro v0.4.2

Released 2026-10-09. Upgrading from v0.4.1.

A feature release. Block settings get a new form with collapsible groups, blocks can say how deep they may be placed, an AI session can take over a page someone has open, and agents can write blog posts and legal pages in Payload. Hosts that already own an apps table can rename ChaiBuilder's tables in code.

Breaking

  • ChaiBuilder branding is off by default. The "Learn more" docs link in the Add page dialog and the console banner are hidden unless you set features: { chaiBranding: true }. See Configuration.
  • Custom table names are set in code only. Build the schema with chaipro/db/schema-factory and pass it to the adapter's tables option, drizzle-kit and the Payload hook. Hosts on the default names need no change. See Database Setup.
  • tableMapping takes more. Entries can map column keys, and null declares a column absent. Hosts with a custom tableMapping should re-check their keys.
  • New columns on ai_page_edits: baseRevision, lastEditAt, endedAt and endedBy. Reads fall back when they are missing; add them to get the full AI handover. Generate a migration after upgrading.

Added

  • A new block settings form. Grouped, collapsible object fields, plus rich text, link, icon and visibility controls. Settings groups can nest one level, and groupProps takes defaultOpen. The Image and Button blocks have grouped settings. See Custom Blocks.
  • maxDepth on blocks. 0 keeps a block at the top level, so a Footer no longer nests into the current selection. The libraryGroupMaxDepth editor prop sets limits per library group.
  • AI page handover. The person editing a page can hand it to an AI session, or be asked to. The page saves first and turns read-only for everyone, and a lock badge shows in the pages list. See MCP Server Setup.
  • MCP tools for Payload content. payloadContentMcpPlugin lets agents list, read, draft, edit and publish documents in a drafts-enabled collection, with payloadBlogMcpPlugin and payloadLegalMcpPlugin presets. Writes only save drafts, and publishing needs confirmed: true. See MCP Server Setup.
  • Libraries panel: an Add button on block cards, and the selected group is remembered.
  • "Publish with translation pages" is back, and the publish warning lists untranslated blocks.
  • CHAI_UNTRANSLATED_LINK_FALLBACK decides where links to untranslated pages go: home for the language home, none to leave them unresolved. The default is unchanged. See Multilingual.

Changed

  • Smaller page payloads to the browser, and block pageData no longer carries global.
  • Streaming fallbacks receive the block's props.
  • Theme font preloading covers up to four weights.

Security

  • Payload content collections that are not scoped to a site are refused rather than served.
  • Uploading to storage needs assets:create, and deleting from storage is permission gated.

Fixed

  • The site is resolved from the requested hostname on every request.
  • NEXT_PUBLIC_* values reach the browser at runtime.
  • A failed save stays unsaved and skips after-save hooks.
  • A Button with a link renders as a single <a>, and default link text no longer leaks into aria-label.
  • Backspace in a canvas input no longer deletes the block.
  • *-screen and viewport height classes scale with the fit-to-width canvas.
  • The font selector no longer rewrites a theme font that is not registered.
  • Creating a page with a {{...}} slug is refused, and page style compile errors no longer return 500.
  • Publishing waits for the page's own global blocks.
  • Asset files are deleted when the trash is emptied.

Upgrade notes

  1. Upgrade the package with pnpm up chaipro@^0.4.2, then generate and apply a migration for the new ai_page_edits columns.
  2. Want the ChaiBuilder links back? Set features: { chaiBranding: true }.
  3. Using a custom tableMapping or table names? Move them to the schema factory and re-check the mapping keys.

© ChaiBuilder. All rights reserved.

ChaiBuilderMade withChaiBuilder