@molecule/app-react 1.5.0 → 1.5.1

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-09-08T06:08:06.749Z
+Generated: 2026-09-15T13:40:28.802Z
 -->
 
 # @molecule/app-react
@@ -951,8 +951,22 @@ interface UseChatResult {
    */
   noteRemoteStreamEvent: () => void
   error: string | null
-  /** Metadata about a limit-related error (for contextual upgrade CTAs). */
-  errorMeta: { limitType?: string; requiresSignup?: boolean } | null
+  /**
+   * Metadata about a limit-related error, for a contextual call-to-action.
+   * `limitType` names the RULE the backend enforced; `billingAction` names the
+   * REMEDY it resolved (e.g. `add_funds`, `add_payment_method`,
+   * `raise_spend_cap`, `upgrade`, `none`) and is what the button should be
+   * built from — the same limit needs a different button per account.
+   * `upgradeTier` is the plan an upgrade would move to, explicitly `null` when
+   * there is no higher tier. The backend owns these vocabularies, so the
+   * action/tier are plain strings here.
+   */
+  errorMeta: {
+    limitType?: string
+    requiresSignup?: boolean
+    billingAction?: string
+    upgradeTier?: string | null
+  } | null
   /** Current agent mode — plan (read-only research) or execute (full access). */
   mode: 'plan' | 'execute'
   /**
@@ -2807,6 +2821,13 @@ Peer dependencies:
   top-level navigation with NO credentials: it answers 401 and the paid plan is never
   granted. The shipped confirmation pages (`@molecule/app-plan-updated-page-react`,
   `@molecule/app-legal-pages-react`) already call it.
+- **A limit error from `useChat` carries the backend's remedy, not just its name.**
+  `errorMeta` exposes `limitType` (the rule that fired), `requiresSignup`,
+  `billingAction` (what the user must DO — e.g. `add_funds`,
+  `add_payment_method`, `raise_spend_cap`, `upgrade`, `none`) and `upgradeTier`
+  (`null` = no higher plan). Build the call-to-action from `billingAction`;
+  deriving it from `limitType` alone offers "Upgrade" to someone who just needs
+  to add funds. Whatever your API omits arrives `undefined`.
 - `RouterProvider` carries a molecule `Router` (e.g. `createReactRouter()` from
   `@molecule/app-routing-react-router`). react-router's own `<BrowserRouter>` context is
   separate — components that render react-router `<Link>` (several in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-react",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "React framework bindings for molecule.dev",
   "type": "module",
   "main": "dist/index.js",
@@ -58,8 +58,8 @@
     }
   },
   "devDependencies": {
-    "@molecule/app-ai-models": "1.3.0",
-    "@molecule/app-i18n": "1.0.1",
+    "@molecule/app-ai-models": "1.3.1",
+    "@molecule/app-i18n": "1.0.2",
     "@testing-library/dom": "10.4.1",
     "@testing-library/react": "16.3.2",
     "@types/node": "26.1.2",
@@ -74,7 +74,7 @@
     "url": "https://github.com/molecule-dev/molecule.git",
     "directory": "packages/app/frameworks/react"
   },
-  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/app/frameworks/react",
+  "homepage": "https://www.molecule.dev/packages/app-react",
   "bugs": "https://github.com/molecule-dev/molecule/issues",
   "publishConfig": {
     "access": "public"