riverbankcms 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -166,3 +166,30 @@ If local content includes unrelated differences, see `workflows/agent-safe-sync.
166
166
  1. Read `cli-reference.md` for detailed command documentation
167
167
  2. Review `schema.md` to understand this site's content model
168
168
  3. Check `workflows/` for step-by-step guides
169
+
170
+
171
+ ## Customer portal routes
172
+
173
+ When portal auth is enabled, `riverbankcms init` generates these reserved routes:
174
+
175
+ | Route | SDK helper | Scaffold template |
176
+ | --- | --- | --- |
177
+ | `/portal` | `createPortalPage` from `@riverbankcms/sdk/next` | `portalPageTemplates` |
178
+ | `/portal/tickets/[registrationId]` | `createPortalTicketPage` | `portalPageTemplates` |
179
+ | `/portal/digital-products/[entitlementId]` | `createPortalDigitalProductPage` | `portalPageTemplates` |
180
+ | `/portal/digital-products/[entitlementId]/files/[assetId]` | `createPortalDigitalProductFilePage` | `portalPageTemplates` |
181
+ | `/api/portal/callback` (GET) | `handlePortalCallback` from `@riverbankcms/sdk/portal` | `portalCallbackRouteTemplate` |
182
+ | `/api/portal/logout` (POST) | `handlePortalLogout` | `portalLogoutRouteTemplate` |
183
+
184
+ Existing sites should add these files after upgrading the SDK. Import
185
+ `@riverbankcms/sdk/styles.css` globally. The page helpers provide the site theme
186
+ scope automatically; sites with `themeSource: 'local'` pass the same `theme`,
187
+ `themes`/`themeSwitch`, or `getTheme` options used by their catch-all. A custom
188
+ resolver receives `content.type === 'portal'` and `content.site` on these routes. The callback and logout routes own the HTTP-only cookie.
189
+ The file route authenticates before redirecting to a signed download URL.
190
+
191
+ For a custom host, `CustomerPortal` from `@riverbankcms/sdk/portal/client` takes
192
+ `siteId`, `apiBaseUrl`, `portalToken` (nullable), `demoEmailSuppressed`, plus optional `callbackPath`, `logoutPath` and `bookPath`
193
+ (defaults `/api/portal/callback`, `/api/portal/logout`, `/book`). Wrap it in the
194
+ site's `ThemeScope`. This is a reserved route component, not a CMS block.
195
+ `@riverbankcms/sdk/portal` remains the server helper entry.