@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/_dts/sdk/src/cli/output.d.ts

@@ -2,12 +2,100 @@
  * CLI Output Formatting
  *
  * Provides consistent output formatting for CLI commands.
+ *
+ * ## Single JSON envelope contract (Phase 7.1)
+ *
+ * Under `--json`, EVERY command emits EXACTLY ONE JSON document on stdout:
+ *
+ *   { ok: boolean, command: string, result: <command-specific>, warnings: [...], errors: [...] }
+ *
+ * This is enforced structurally: in JSON mode the terminal output methods
+ * (`success`/`result`/`json`/`table`) do NOT print — they buffer their payload
+ * into the invocation's {@link InvocationEnvelope}. `warn` appends to `warnings`,
+ * `error`/`fail` append to `errors`. A single writer (`InvocationEnvelope.flush`)
+ * emits the one envelope: on success via the program's `postAction` hook, on
+ * failure via `error()` (which throws `CliExit` so `runCli` owns the exit code),
+ * and for parse/help/version via `runCli` itself. Commands can therefore never
+ * double-print a JSON document, no matter how many output calls they make.
+ *
+ * Human (non-`--json`) output is unchanged.
+ */
+/** A structured warning or error entry inside the JSON envelope. */
+export interface EnvelopeMessage {
+    message: string;
+    code?: string;
+    details?: unknown;
+    suggestion?: unknown;
+}
+/**
+ * The single machine-readable document emitted per invocation under `--json`.
+ *
+ * Closed discriminated final state: an `ok: false` envelope ALWAYS carries at
+ * least one typed error (`errors` is a non-empty tuple), and an `ok: true`
+ * envelope never carries errors. The invariant is enforced by
+ * {@link InvocationEnvelope.flush}, so `{ ok: false, errors: [] }` is
+ * unrepresentable in the emitted output.
  */
+export type JsonEnvelope = {
+    ok: true;
+    command: string;
+    result: unknown;
+    warnings: EnvelopeMessage[];
+    errors: [];
+} | {
+    ok: false;
+    command: string;
+    result: unknown;
+    warnings: EnvelopeMessage[];
+    errors: [EnvelopeMessage, ...EnvelopeMessage[]];
+};
+/**
+ * Raised by `output.error` (and mapped by `runCli`) to terminate a command with a
+ * non-zero exit code WITHOUT calling `process.exit` inside command code — so the
+ * single envelope is always flushed first and the exit code is owned in one place.
+ */
+export declare class CliExit extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+/**
+ * Accumulates the single JSON envelope for ONE CLI invocation. Created once per
+ * invocation (owned by the fresh root program) and threaded to every command's
+ * output, so all output — success, warnings, errors, and even parse/help/version
+ * handled by `runCli` — funnels into one document. `flush()` is idempotent and is
+ * the ONLY writer of the stdout JSON.
+ */
+export declare class InvocationEnvelope {
+    private resultValue;
+    private failed;
+    private readonly warnings;
+    private readonly errors;
+    private flushed;
+    setResult(value: unknown): void;
+    addWarning(warning: EnvelopeMessage): void;
+    addError(error: EnvelopeMessage): void;
+    markFailed(): void;
+    hasFlushed(): boolean;
+    /** True once at least one error has been recorded or a failure marked. */
+    isFailed(): boolean;
+    private finalState;
+    /** Emit the single envelope. Idempotent: subsequent calls are no-ops. */
+    flush(command: string): void;
+}
 export interface OutputOptions {
     /** Output in JSON format for machine parsing */
     json?: boolean;
     /** Minimal output (suppress non-essential messages) */
     quiet?: boolean;
+    /**
+     * In JSON mode, the invocation-scoped envelope all terminal output funnels into
+     * so exactly one document is emitted. Always supplied by `createOutputForCommand`
+     * in JSON mode; if absent, JSON-mode terminal writes are dropped (never a stray
+     * second document).
+     */
+    envelope?: InvocationEnvelope;
+    /** Full command path (e.g. "entry upsert") for the envelope's `command` field. */
+    command?: string;
 }
 export interface OutputContext {
     success(message: string, data?: unknown): void;

package/dist/_dts/sdk/src/cli/program.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Riverbank CMS SDK CLI — program construction and invocation.
+ *
+ * `createProgram()` builds the full Commander command tree; `runCli()` drives it
+ * so that under `--json` EXACTLY ONE envelope reaches stdout for EVERY outcome,
+ * including the paths Commander itself owns — parse errors, `--help`, and
+ * `--version` (which would otherwise bypass command actions entirely).
+ *
+ * `runCli`:
+ *  - runs `parseAsync` inside an AsyncLocalStorage invocation scope so all output
+ *    (actions, and the parse/help/version handling below) funnels into ONE
+ *    envelope, isolated per concurrent invocation;
+ *  - installs `exitOverride` + `configureOutput` on every command so Commander's
+ *    exits and its help/version/error text are intercepted rather than written
+ *    raw or exiting the process; and
+ *  - owns the process exit code (commands never call `process.exit`).
+ */
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+/**
+ * Parse and run the CLI. Returns the process exit code (the caller sets
+ * `process.exitCode`); it never calls `process.exit` itself, so it is safe to
+ * drive from tests. Under `--json`, exactly one envelope is written to stdout for
+ * every outcome — success, non-fatal failure, thrown error, parse error, `--help`,
+ * and `--version`.
+ */
+export declare function runCli(argv: string[], options?: {
+    program?: Command;
+}): Promise<number>;

package/dist/_dts/sdk/src/cli/push-config.d.ts

@@ -45,5 +45,5 @@ export declare function pushConfigAction(output: OutputContext, options: PushCon
 /**
  * push-config command definition
  */
-export declare const pushConfigCommand: Command;
+export declare const createPushConfigCommand: () => Command;
 export {};

package/dist/_dts/sdk/src/client/management/blocks.d.ts

@@ -1,6 +1,19 @@
 /**
  * Block Operations for Management Client
  */
-import { type HttpClient } from './http';
+import { ManagementApiError, type HttpClient } from './http';
 import type { BlockOperations } from './types';
+/**
+ * Discriminated stale-conflict error for `blocks.patch`: the block's draft
+ * changed since the caller's read. `currentHash` is the server's current
+ * draft content hash — retry the patch with it as `baseContentHash`.
+ * Extracted from the typed `SdkPatchPageBlockStaleContentFieldError` wire
+ * contract, so callers never parse prose.
+ */
+export declare class BlockPatchStaleContentError extends ManagementApiError {
+    readonly kind = "stale-content";
+    readonly currentHash: string;
+    constructor(source: ManagementApiError, currentHash: string);
+}
+export declare function isBlockPatchStaleContentError(error: unknown): error is BlockPatchStaleContentError;
 export declare function createBlockOperations(http: HttpClient): BlockOperations;

package/dist/_dts/sdk/src/client/management/catalog.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Catalog (discovery surface) operations for the Management Client.
+ *
+ * Read-only catalogs an agent enumerates to act without reading repo source.
+ */
+import type { HttpClient } from './http';
+import type { Capabilities, CatalogOperations, DemoContent } from './types';
+export declare function createCatalogOperations(http: HttpClient): CatalogOperations;
+export declare function createCapabilitiesOperation(http: HttpClient): () => Promise<Capabilities>;
+export declare function createDemoContentOperation(http: HttpClient): () => Promise<DemoContent>;

package/dist/_dts/sdk/src/client/management/http.d.ts

@@ -25,7 +25,13 @@ export declare class ManagementApiError extends Error {
     readonly details?: unknown;
     readonly statusCode?: number;
     readonly request?: ManagementApiErrorRequest;
-    constructor(message: string, code: string, details?: unknown, statusCode?: number, request?: ManagementApiErrorRequest);
+    /**
+     * Precise failure tag from the server's `DomainServiceError` (e.g. `STALE_BASE`,
+     * `PALETTE_CAP_REACHED`). Branch on this when the coarse `code`/`statusCode`
+     * collapses several failures into one.
+     */
+    readonly tag?: string;
+    constructor(message: string, code: string, details?: unknown, statusCode?: number, request?: ManagementApiErrorRequest, tag?: string);
 }
 /**
  * Type guard to check if an error is a 404 Not Found response.

package/dist/_dts/sdk/src/client/management/index.d.ts

@@ -36,7 +36,8 @@ import { CourseSessionConflictError } from './courses';
  * @returns ManagementClient instance
  */
 export declare function createManagementClient(config: ManagementClientConfig): ManagementClient;
-export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, EntryPublishUpsertResult, UpsertedManagementEntry, PageUpsertInput, PagePublishUpsertResult, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInitializeInput, ThemeUpsertInput, ThemeUpsertResult, ThemeUpsertUpdateInput, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledDrafts, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
+export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, EntryPublishUpsertResult, UpsertedManagementEntry, PageUpsertInput, PagePublishUpsertResult, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInitializeInput, ThemeUpsertInput, ThemeUpsertResult, ThemeUpsertUpdateInput, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledDrafts, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, CatalogOperations, PulledCatalogTheme, PulledCatalogBlocks, PulledCatalogContentTypes, Capabilities, DemoContent, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
 export { ManagementApiError, type ManagementApiErrorRequest } from './http';
+export { BlockPatchStaleContentError, isBlockPatchStaleContentError, } from './blocks';
 export { applySiteStyleSelectionBodyFromCommand, buildApplySiteStyleSelectionCommand, } from './theme';
 export { CourseSessionConflictError };

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -11,11 +11,14 @@ import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../.
 import type { SdkEventUpsertBody } from '../../../../api/src/sdk-event-upsert';
 import type { SdkManagementEventSeries } from '../../../../api/src/sdkContracts';
 import type { SdkPullTruncationMeta } from '../../../../api/src/sdkContracts';
+import type { SdkCapabilitiesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCatalogThemeResponse, SdkDemoContentResponse } from '../../../../api/src/sdkContracts';
 import type { SdkEntryPublishErrorCode, SdkPagePublishErrorCode, SdkPublicationOutcome } from '../../../../api/src/sdkContracts';
 import type { PaletteSelection } from '../../../../theme-core/src/palette/index';
 import type { Theme } from '../../contracts';
 export type SdkDeletePageResponse = NonNullable<APIEndpoints['sdkDeletePage']['response']>;
 export type SdkGetPageBlockResponse = NonNullable<APIEndpoints['sdkGetPageBlock']['response']>;
+export type SdkPatchPageBlockBody = NonNullable<APIEndpoints['sdkPatchPageBlock']['body']>;
+export type SdkPatchPageBlockResponse = NonNullable<APIEndpoints['sdkPatchPageBlock']['response']>;
 export type SdkPullEntriesAllResponse = NonNullable<APIEndpoints['sdkPullEntriesAll']['response']>;
 export type SdkUpsertEntryResponse = NonNullable<APIEndpoints['sdkUpsertEntry']['response']>;
 export type SdkUpsertPageResponse = NonNullable<APIEndpoints['sdkUpsertPage']['response']>;
@@ -150,6 +153,7 @@ export interface ManagementNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: ManagementNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -189,6 +193,7 @@ export interface PulledNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: PulledNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -198,6 +203,7 @@ export interface NavigationMenuUpsertInput {
     name: string;
     isPrimary?: boolean;
     isFooter?: boolean;
+    footerRole?: 'main' | 'legal-policy' | null;
     items: NavigationItemInput[];
 }
 export interface NavigationItemInput {
@@ -554,28 +560,18 @@ export interface ThemeUpsertResult {
 export type SiteStyleSelectionApplyCommand = SiteCommandOf<'applySiteStyleSelection'>;
 export type SiteStyleSelectionApplyCommandInput = SiteStyleSelectionApplyCommand['input'];
 /**
- * Public SDK input for style-selection apply, derived from the shared command
- * IR so SDK, CLI, and AI proposal flows stay aligned. The IR permits the
- * minimal request ({siteStyleId, baseSelectionVersion}); omitted choices
- * default from the curated style server-side. Wire IDs are strings at this
- * boundary; the server schema brands and validates them. The canonical header
- * pair is atomic at the type level: both omitted (site-style default), both
- * null (legacy default), or both supplied.
+ * Public SDK delta contract. `siteStyleRef` is command orchestration identity;
+ * semantic style changes live only in the `changes` batch.
  */
-export type ThemeStyleSelectionApplyInput = Omit<SiteStyleSelectionApplyCommandInput, 'siteStyleId' | 'headerLayoutId' | 'headerStyleId'> & Readonly<{
-    siteStyleId: string;
+export type ThemeStyleSelectionApplyInput = Omit<SiteStyleSelectionApplyCommandInput, 'changes'> & Readonly<{
+    siteStyleRef: string;
     baseSelectionVersion: number;
     selectionId?: string | null;
-}> & (Readonly<{
-    headerLayoutId?: undefined;
-    headerStyleId?: undefined;
-}> | Readonly<{
-    headerLayoutId: null;
-    headerStyleId: null;
-}> | Readonly<{
-    headerLayoutId: string;
-    headerStyleId: string;
-}>);
+    changes: readonly [
+        SiteStyleSelectionApplyCommandInput['changes'][number],
+        ...SiteStyleSelectionApplyCommandInput['changes'][number][]
+    ];
+}>;
 export interface ThemeStyleSelectionApplyResult {
     success: boolean;
     themeId: string;
@@ -595,7 +591,8 @@ export interface ThemeStyleSelectionApplyResult {
 }
 /**
  * Footer content for SDK management operations.
- * Matches the structure stored in site_settings.footer_content_json (bottomText only).
+ * A narrow legal-text command. The CMS maps this onto the V1 footer composition's
+ * legal module without exposing or replacing the aggregate.
  */
 export interface FooterContent {
     /** Rich text content in ProseMirror JSON format */
@@ -905,6 +902,12 @@ export interface ApiErrorResponse {
             code: string;
             message: string;
         }>;
+        /**
+         * Precise failure tag from the originating server `DomainServiceError`
+         * (e.g. `STALE_BASE`, `PALETTE_CAP_REACHED`). Optional; the coarse `code`
+         * collapses several tags into one HTTP status.
+         */
+        tag?: string;
     };
 }
 export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
@@ -944,10 +947,18 @@ export interface PageOperations {
     delete(identifier: string): Promise<void>;
 }
 export type ManagementPageBlock = SdkGetPageBlockResponse['block'];
+/**
+ * Input for `blocks.patch` — derived from the API contract.
+ * `baseContentHash` must be the `contentHash` from a prior `blocks.get`;
+ * a stale hash rejects with a 409 whose `fieldErrors[0].message` carries the
+ * current hash (field `baseContentHash`, code `STALE_CONTENT`).
+ */
+export type BlockPatchInput = SdkPatchPageBlockBody;
 export interface BlockOperations {
     list(pageIdentifier: string): Promise<ManagementBlock[]>;
     get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementPageBlock | null>;
     upsert(pageIdentifier: string, input: BlockUpsertInput): Promise<ManagementBlock>;
+    patch(pageIdentifier: string, blockIdentifier: string, input: BlockPatchInput): Promise<ManagementPageBlock>;
     reorder(pageIdentifier: string, blockIdentifiers: string[]): Promise<void>;
     delete(pageIdentifier: string, blockIdentifier: string): Promise<void>;
 }
@@ -1034,6 +1045,20 @@ export interface PullOperations {
      */
     contentTypes(): Promise<PulledContentTypes>;
 }
+export type PulledCatalogTheme = SdkCatalogThemeResponse;
+export type PulledCatalogBlocks = SdkCatalogBlocksResponse;
+export type PulledCatalogContentTypes = SdkCatalogContentTypesResponse;
+export type Capabilities = SdkCapabilitiesResponse;
+/** Demo-seed provenance listing (plan 8.2). */
+export type DemoContent = SdkDemoContentResponse;
+export interface CatalogOperations {
+    /** Theme discovery catalog: styles, personalities, palettes, looks + current selection. */
+    theme(): Promise<PulledCatalogTheme>;
+    /** Block discovery catalog: manifest fields, content-source, theme-aware variant availability. */
+    blocks(): Promise<PulledCatalogBlocks>;
+    /** Content-type discovery catalog: normalized field DSL per content type. */
+    contentTypes(): Promise<PulledCatalogContentTypes>;
+}
 export interface BackfillPageResult {
     pagesUpdated: number;
     identifiersAssigned: Record<string, string>;
@@ -1120,6 +1145,19 @@ export interface ManagementClient {
     events: EventOperations;
     courses: CourseOperations;
     pull: PullOperations;
+    /** Discovery catalogs (theme / blocks / content-types). */
+    catalog: CatalogOperations;
     identifiers: IdentifiersOperations;
     media: MediaOperations;
+    /**
+     * Thin capabilities index: API version, catalog links, and per-catalog content
+     * hashes so agents can cache catalogs and detect drift.
+     */
+    capabilities(): Promise<Capabilities>;
+    /**
+     * Demo-seed provenance ledger: the resources demo recipe runs created on this
+     * site (plan 8.2), so an agent can distinguish placeholder demo content from
+     * authored content and drive cleanup.
+     */
+    demoContent(): Promise<DemoContent>;
 }

package/dist/_dts/sdk/src/config/content-types.d.ts

@@ -300,6 +300,8 @@ export interface NavigationMenuConfig {
     isPrimary?: boolean;
     /** Is this the footer menu? */
     isFooter?: boolean;
+    /** Named footer destination. Prefer this for new configurations. */
+    footerRole?: 'main' | 'legal-policy' | null;
     /** Menu items */
     items: NavigationItemConfig[];
 }

package/dist/_dts/sdk/src/config/content-validation.d.ts

@@ -97,6 +97,10 @@ export declare const navigationMenuConfigSchema: z.ZodObject<{
     name: z.ZodString;
     isPrimary: z.ZodOptional<z.ZodBoolean>;
     isFooter: z.ZodOptional<z.ZodBoolean>;
+    footerRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        main: "main";
+        "legal-policy": "legal-policy";
+    }>>>;
     items: z.ZodArray<z.ZodType<Readonly<{
         label: string;
         link: import("../../../api/src/index").NavigationAuthoringLinkInput;

package/dist/_dts/sdk/src/date-time/index.d.ts

@@ -0,0 +1,68 @@
+export type ScheduledDateTimeInput = Readonly<{
+    startsAt: string;
+    timeZone: string;
+    locale?: string;
+}>;
+export type ScheduledDateTimeRangeInput = Readonly<{
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+    locale?: string;
+}>;
+export type ScheduledIntlDateTimeFormatOptions = Readonly<Omit<Intl.DateTimeFormatOptions, 'timeZone'>>;
+export type ScheduledDateFormatOptions = Readonly<{
+    format?: ScheduledIntlDateTimeFormatOptions;
+}>;
+export type ScheduledCompactTimeFormatOptions = Readonly<{
+    timePresentation?: 'compact';
+    format?: never;
+}>;
+export type ScheduledStandardTimeFormatOptions = Readonly<{
+    timePresentation: 'standard';
+    format?: ScheduledIntlDateTimeFormatOptions;
+}>;
+export type ScheduledTimeFormatOptions = ScheduledCompactTimeFormatOptions | ScheduledStandardTimeFormatOptions;
+export type ScheduledDateTimeFormatOptions = Readonly<{
+    dateFormat?: ScheduledIntlDateTimeFormatOptions;
+    time?: ScheduledTimeFormatOptions;
+}>;
+export type RiverbankDateTimeFormatErrorDetails = Readonly<{
+    code: 'invalid_starts_at';
+    field: 'startsAt';
+    value: string;
+}> | Readonly<{
+    code: 'invalid_ends_at';
+    field: 'endsAt';
+    value: string;
+}> | Readonly<{
+    code: 'missing_ends_at';
+    field: 'endsAt';
+    value: string;
+}> | Readonly<{
+    code: 'invalid_time_zone';
+    field: 'timeZone';
+    value: string;
+}> | Readonly<{
+    code: 'invalid_locale';
+    field: 'locale';
+    value: string;
+}> | Readonly<{
+    code: 'end_before_start';
+    field: 'endsAt';
+    value: string;
+}>;
+export type RiverbankDateTimeFormatErrorCode = RiverbankDateTimeFormatErrorDetails['code'];
+export type RiverbankDateTimeFormatErrorField = RiverbankDateTimeFormatErrorDetails['field'];
+export declare class RiverbankDateTimeFormatError extends Error {
+    readonly name = "RiverbankDateTimeFormatError";
+    readonly code: RiverbankDateTimeFormatErrorCode;
+    readonly field: RiverbankDateTimeFormatErrorField;
+    readonly value: string;
+    constructor(details: RiverbankDateTimeFormatErrorDetails);
+}
+export declare function formatScheduledDate(input: ScheduledDateTimeInput, options?: ScheduledDateFormatOptions): string;
+export declare function formatScheduledTime(input: ScheduledDateTimeInput, options?: ScheduledTimeFormatOptions): string;
+export declare function formatScheduledDateTime(input: ScheduledDateTimeInput, options?: ScheduledDateTimeFormatOptions): string;
+export declare function formatScheduledDateRange(input: ScheduledDateTimeRangeInput, options?: ScheduledDateFormatOptions): string;
+export declare function formatScheduledTimeRange(input: ScheduledDateTimeRangeInput, options?: ScheduledTimeFormatOptions): string;
+export declare function formatScheduledDateTimeRange(input: ScheduledDateTimeRangeInput, options?: ScheduledDateTimeFormatOptions): string;

package/dist/_dts/sdk/src/navigation/index.d.ts

@@ -280,6 +280,7 @@ export declare function getPrimaryNavigation(navigation: NavigationMenuWithItems
  * ```
  */
 export declare function getFooterNavigation(navigation: NavigationMenuWithItems[] | null | undefined): NavigationMenuWithItems | null;
+export declare function getFooterNavigationByRole(navigation: NavigationMenuWithItems[] | null | undefined, role: 'main' | 'legal-policy'): NavigationMenuWithItems | null;
 /**
  * Get a navigation menu by name/slug.
  *
@@ -417,6 +418,7 @@ export declare function buildMenu(navigation: NavigationMenuWithItems[], routes:
  * ```
  */
 export declare function buildFooterMenu(navigation: NavigationMenuWithItems[], routes: RouteMap, options?: NavigationRenderOptions): FooterMenu;
+export declare function buildFooterMenuForRole(navigation: NavigationMenuWithItems[], routes: RouteMap, role: 'main' | 'legal-policy', options?: NavigationRenderOptions): FooterMenu;
 export declare function resolveNavigationLinkHref(link: LinkPayload | null, routes: RouteMap, options?: NavigationRenderOptions): string | null;
 /**
  * Build a Logo from site layout data.

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -58,6 +58,8 @@ export interface ApiError {
         timestamp: string;
         status: number;
         fieldErrors?: FieldError[];
+        /** Precise failure tag from the originating server `DomainServiceError` (optional). */
+        tag?: string;
     };
 }
 export type ApiResult<TData> = ApiResponse<TData> | ApiError;
@@ -184,6 +186,7 @@ export interface NavigationMenuRecord {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     createdAt?: string | null;
     updatedAt?: string | null;
 }
@@ -315,7 +318,7 @@ export type SiteResponse = {
      * Persisted design selections. Optional so legacy
      * payloads without these columns still satisfy the type — consumers fall
      * back to the site style's defaults when null.
-    */
+     */
     selectionButtonPersonalityId?: string | null;
     runtimePaletteState?: RuntimePaletteState | null;
     selectionHeaderLayoutId?: string | null;
@@ -424,7 +427,7 @@ export type SdkRuntimePageSurfaceContentSource = Readonly<{
 export type SdkRuntimePageSurface = {
     id: string;
     routeId: string;
-    readinessState: 'shippable';
+    readinessState: 'internal_pilot' | 'shippable';
     subject: SdkRuntimePageSurfaceSubject;
     title: string;
     slug: string | null;

package/dist/_dts/sdk/src/rendering/components/Layout.d.ts

@@ -3,7 +3,7 @@
  *
  * Renders site header and footer around content. Fetches site data if not provided.
  */
-import { buildMenu, buildFooterMenu, buildLogo } from '../../navigation';
+import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import { type SdkThemeRuntime } from '../themeRuntime';
 export type HeaderData = {
@@ -16,6 +16,7 @@ export type HeaderData = {
 export type FooterData = {
     menu: ReturnType<typeof buildMenu>;
     footerMenu: ReturnType<typeof buildFooterMenu>;
+    legalFooterMenu: ReturnType<typeof buildFooterMenuForRole>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
     theme: SiteResponse['theme'];

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -182,7 +182,7 @@ export type EntryContentResult = {
 export type PageSurfaceContentData = {
     id: string;
     routeId: string;
-    readinessState: 'shippable';
+    readinessState: 'internal_pilot' | 'shippable';
     subject: SdkRuntimePageSurfaceSubject;
     title: string;
     slug: string | null;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.107.0";
+export declare const SDK_VERSION = "0.109.0";