@odla-ai/chapter 0.40.2 → 0.41.0

package/README.md

@@ -116,7 +116,7 @@ Chapter-owned application, admin, CRM, payment, and scheduling behavior.
   boundary so you never pay for what you don't use:
   - `@odla-ai/chapter/ui/member` — **Preact-only**: `SlotPicker`, the date/timezone
     helpers, `JoinIsland` (form → payment → booking), `MembersArea`,
-    `Rescheduler`, `PaymentStep`, `<BrandStyle>`. It never imports
+    `GiftCodeRedeemer`, `Rescheduler`, `PaymentStep`, `<BrandStyle>`. It never imports
     `@odla-ai/auth-clerk` or `@odla-ai/crm`, so you can adopt a single
     presentational component without the Clerk browser SDK. (A bundle-graph test
     enforces this.)
@@ -546,9 +546,11 @@ builderLibrary: {
 
 Every resource has exactly one scope: `{ kind: "chapter", chapterId }`,
 `{ kind: "built_not_found" }`, or `{ kind: "global" }`. There are no groups or
-audience arrays. A Chapter can author only its own scope. Its admins and agents
-see its own published material plus global material, never a sibling Chapter or
-Built Not Found-only material. Built Not Found admins see every configured
+audience arrays. A Chapter can author only its own scope. Built Not Found can
+author material for itself, every Chapter, or exactly one Chapter from its
+configured source list. A Chapter's admins and agents see its own published
+material plus global material, never a sibling Chapter or Built Not Found-only
+material. Built Not Found admins see every configured
 Chapter source and can promote a Chapter resource to a global copy; the server
 records the source Chapter, source resource/document revisions, actor, and time.
 
@@ -556,7 +558,10 @@ Resources are bounded documents/notes, HTTPS links/inspiration, or canonical
 Brand `{ bookId, assetId }` references. Asset URLs, bytes, storage credentials,
 HTML, and executable content are not part of the contract. The standard admin
 adds a visibly private **Builder Library** tab separate from **Member content**.
-Saving a library item never creates or changes a member page.
+It is a compact CMS inventory with search and type/status filters, type-specific
+add/edit fields, previews, explicit Draft/Published/Archived state, and a
+visibility picker whose Chapter choices come only from checked-in network
+configuration. Saving a library item never creates or changes a member page.
 
 An authenticated admin or site-building agent reads the bounded, published-only
 manifest from `/api/admin/builder-library/manifest`. On Built Not Found, pass a
@@ -738,6 +743,15 @@ The host still decides which routes use managed theming and owns any legacy
 token aliases. Keep the marker after bootstrap declarations so the active
 `--ui-*` values win in the initial parsed document.
 
+`GiftCodeRedeemer` is the reusable member-side gift redemption control. It
+accepts the resolved `chapter.copy.member.gifts` copy contract, posts trimmed
+codes to `/api/gifts/redeem`, and keeps its input, action, loading lock, and
+reserved live status region aligned with the shared `@odla-ai/ui`
+inline-action-field contract. `MemberGifts` composes it automatically, while a
+custom member surface can import it directly from `@odla-ai/chapter/ui/member`.
+Code entry uses one-time-code autocomplete, disables automatic capitalization
+and correction, and retains the submitted code after an error.
+
 The hub owns a durable outbox: create/verify immutable Stripe Prices first,
 persist the desired revision, retry signed delivery, and mark it active only
 after the exact revision/digest receipt. Version history is for audit and