@riverbankcms/sdk 0.136.0 → 0.137.0

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -15968,6 +15968,7 @@ export type Database = {
                     created_at: string;
                     footer_look_id: string | null;
                     header_layout_id: string;
+                    header_preferences: Json | null;
                     header_style_id: string;
                     id: string;
                     is_current: boolean;
@@ -15984,6 +15985,7 @@ export type Database = {
                     created_at?: string;
                     footer_look_id?: string | null;
                     header_layout_id: string;
+                    header_preferences?: Json | null;
                     header_style_id: string;
                     id?: string;
                     is_current?: boolean;
@@ -16000,6 +16002,7 @@ export type Database = {
                     created_at?: string;
                     footer_look_id?: string | null;
                     header_layout_id?: string;
+                    header_preferences?: Json | null;
                     header_style_id?: string;
                     id?: string;
                     is_current?: boolean;
@@ -18422,6 +18425,7 @@ export type Database = {
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
                     p_header_layout_id: string;
+                    p_header_preferences?: Json;
                     p_header_style_id: string;
                     p_selection_id?: string;
                     p_site_id: string;
@@ -20282,6 +20286,7 @@ export type Database = {
                     p_button_style_options: Json;
                     p_footer_look_id?: string;
                     p_header_layout_id: string;
+                    p_header_preferences?: Json;
                     p_header_style_id: string;
                     p_site_id: string;
                     p_theme: Json;
@@ -20293,34 +20298,10 @@ export type Database = {
                     theme_id: string;
                 }[];
             };
-            publish_authoritative_page_surface_content_guarded: {
+            publish_authoritative_page_surface_v2: {
                 Args: {
-                    p_expected_draft_version_id: string;
-                    p_expected_published_version_id: string;
-                    p_expected_source_data: Json;
-                    p_expected_source_updated_at: string;
-                    p_expected_source_version_id: string;
-                    p_owner_id: string;
-                    p_owner_kind: Database["public"]["Enums"]["content_owner_kind"];
-                    p_published_data: Json;
-                    p_site_id: string;
-                    p_source_kind: string;
-                    p_user_id: string;
-                };
-                Returns: Json;
-            };
-            publish_authoritative_surface_slot_snapshot_guarded: {
-                Args: {
-                    p_blocks: Json;
-                    p_expected_draft_version_id: string;
-                    p_expected_published_version_id: string;
-                    p_expected_source_data: Json;
-                    p_expected_source_updated_at: string;
-                    p_expected_source_version_id: string;
                     p_page_surface_id: string;
                     p_site_id: string;
-                    p_source_kind: string;
-                    p_surface_slot_id: string;
                     p_user_id: string;
                 };
                 Returns: Json;
@@ -20661,6 +20642,7 @@ export type Database = {
                     p_expected_selection_version: number;
                     p_footer_look_id?: string;
                     p_header_layout_id: string;
+                    p_header_preferences?: Json;
                     p_header_style_id: string;
                     p_selection_id?: string;
                     p_selection_overrides: Json;
@@ -21033,21 +21015,7 @@ export type Database = {
                     transition_outcome: string;
                 }[];
             };
-            transition_managed_event_availability_v1: {
-                Args: {
-                    p_event_offering_id: string;
-                    p_event_series_id?: string;
-                    p_expected_archived_at: string;
-                    p_expected_series_status?: string;
-                    p_first_live_at?: string;
-                    p_next_archived_at: string;
-                    p_next_series_status?: string;
-                    p_site_id: string;
-                    p_update_archive?: boolean;
-                };
-                Returns: boolean;
-            };
-            transition_managed_event_availability_v2: {
+            transition_managed_event_availability_v3: {
                 Args: {
                     p_command: Json;
                     p_event_offering_id: string;

package/dist/_dts/db/src/index.d.ts

@@ -6,3 +6,4 @@ export type { CamelizeKeys, CamelToSnake, DecamelizeKeys, DeepCamelizeKeys, Deep
 export { createPatchApplier } from './utils/patch';
 export * from './schemas/forms';
 export * from './schemas/standard-contact';
+export { escapePostgrestFilterValue } from './utils/postgrestFilter';

package/dist/_dts/db/src/utils/postgrestFilter.d.ts

@@ -0,0 +1,2 @@
+/** Escape literal search text embedded in a PostgREST ilike expression. */
+export declare function escapePostgrestFilterValue(value: string): string;

package/dist/_dts/media-core/src/bulkDeletePlanning.d.ts

@@ -7,6 +7,7 @@ export type MediaUsageCheckResponseWithCounts = Readonly<{
 export type BulkDeleteResultLike = Readonly<{
     deleted: number;
     failed: number;
+    warnings?: readonly unknown[];
 }>;
 export type BulkDeleteOptions = Readonly<{
     deleteObjects?: boolean;
@@ -16,6 +17,9 @@ export declare const BULK_DELETE_IN_PROGRESS_MESSAGE = "Delete already in progre
 export type BulkDeleteCompletionToast = Readonly<{
     kind: 'success';
     message: string;
+}> | Readonly<{
+    kind: 'warning';
+    message: string;
 }> | Readonly<{
     kind: 'error';
     message: string;

package/dist/_dts/media-core/src/fileDomain.d.ts

@@ -426,6 +426,8 @@ export declare const FILE_SIZE_LIMITS: {
     readonly instagramZip: PositiveByteCount;
     readonly bookingEvidence: PositiveByteCount;
 };
+/** Shared admission ceiling for SDK-management media uploads before intent-specific finalization. */
+export declare const MAX_MANAGEMENT_MEDIA_UPLOAD_BYTES: PositiveByteCount;
 export declare const DEFAULT_PRIVATE_FILE_SIGNED_URL_EXPIRY_SECONDS: PositiveSeconds;
 export declare const MAX_SAFE_DOWNLOAD_FILENAME_LENGTH = 180;
 export declare function asPositiveByteCount(value: number): Result<PositiveByteCount, 'not-positive-byte-count'>;
@@ -438,6 +440,7 @@ export declare function asSafeDownloadFilename(value: string): Result<SafeDownlo
 export declare const parseSafeDownloadFilename: typeof asSafeDownloadFilename;
 export declare function deriveUploadPolicy(actor: FileActor, intent: UploadIntent): Result<UploadPolicy, UploadPolicyError>;
 export declare function classifyKnownMimeType(mimeType: string | DeclaredMimeType | DetectedMimeType | undefined | null): Result<FileKind, MimeTypeClassificationError>;
+export declare function managementMediaLibraryUploadLimitForMimeType(mimeType: string | DeclaredMimeType | DetectedMimeType | undefined | null): Result<PositiveByteCount, MimeTypeClassificationError>;
 export declare function isMimeTypeAllowedForPolicy(mimeType: string | DeclaredMimeType | DetectedMimeType | undefined | null, policy: UploadPolicy): boolean;
 export declare function isFileKindAllowed(kind: FileKind, policy: UploadPolicy): boolean;
 export declare function isFileUseAllowed(requestedUse: FileUse, allowedUses: NonEmptyArray<FileUse>): boolean;

package/dist/_dts/preview-next/src/client/preview/PreviewShell.d.ts

@@ -52,6 +52,7 @@ type PreviewShellCommonProps = {
      */
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
+    themeSelectionHeaderPreferences?: import('../../../../theme-core/src/site-styles/index').HeaderPreferences | null;
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

package/dist/_dts/preview-next/src/client/preview/PreviewShellLayout.d.ts

@@ -28,6 +28,7 @@ type PreviewShellLayoutCommonProps = {
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonStyleSelection?: ButtonStyleSelection | null;
     themeSelectionButtonStyleRepairs?: readonly ButtonStyleSelectionRepair[];
+    themeSelectionHeaderPreferences?: import('../../../../theme-core/src/site-styles/index').HeaderPreferences | null;
     themeSelectionHeaderSelection?: HeaderLayoutStyleSelection | null;
     themeSelectionFooterLookId?: FooterLookId | null;
     themeSelectionHeaderLogo?: HeaderLogoContext;

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeContext.d.ts

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderLogoContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderPreferences, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderLogoContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
@@ -63,6 +63,7 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     siteId: string;
     apiClient: ApiClient;
     theme?: Theme | null;
+    headerPreferences?: HeaderPreferences | null;
     themeId?: string | null;
     selectionId?: string | null;
     selectionVersion?: number | null;
@@ -72,5 +73,5 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     siteStyleAccess?: SiteStyleAccess;
     canOpenDesignEditor?: boolean;
 }>;
-export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, headerPreferences, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerLogoContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;

package/dist/_dts/preview-next/src/client/preview/siteChromeBrandPreferences.d.ts

@@ -1,5 +1,6 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { BrandDisplayMode, HeaderBrandPreferences, HeaderLogoContext, LogoSizePolicy } from '../../../../theme-core/src/site-styles/index';
+export { withHeaderBrandThemePreferences } from '../../../../theme-core/src/site-styles/index';
 export type { HeaderBrandPreferences } from '../../../../theme-core/src/site-styles/index';
 export type HeaderBrandDisplayOption = Readonly<{
     value: BrandDisplayMode;
@@ -36,6 +37,5 @@ export declare function createHeaderBrandControlStateFromPreferences({ preferenc
 }): HeaderBrandControlState;
 export declare function readHeaderBrandPreferences(theme: Theme | null): HeaderBrandPreferences;
 export declare function normalizeHeaderBrandPreferences(preferences: HeaderBrandPreferences, hasLogo: boolean): HeaderBrandPreferences;
-export declare function withHeaderBrandThemePreferences(theme: Theme, preferences: HeaderBrandPreferences): Theme;
 export declare function withHeaderBrandPreferences(context: HeaderLogoContext | undefined, preferences: HeaderBrandPreferences): HeaderLogoContext | undefined;
 export declare function hasLogoInHeaderLogoContext(context: HeaderLogoContext | undefined): boolean;

package/dist/_dts/preview-next/src/client/preview/siteChromeQuickControlHistoryState.d.ts

@@ -70,6 +70,8 @@ export type SiteChromeQuickControlReplayPlan = Readonly<{
     preferences: HeaderNavPreferences;
 }> | Readonly<{
     kind: 'background-preferences';
+    /** Which surface's background this replays — the save needs it (#1318 Phase 4d). */
+    surface: 'header' | 'footer';
     preferences: SiteChromeBackgroundPreferences;
 }>;
 export type SiteChromeQuickControlHistoryMutation = Readonly<{

package/dist/_dts/preview-next/src/client/preview/siteChromeQuickControlSaveRequest.d.ts

@@ -0,0 +1,51 @@
+import type { HeaderNavPreferences, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SelectionSnapshot } from './StyleConfigurator.state';
+import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
+import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
+import { type SiteChromeQuickControlBackgroundTarget, type SiteChromeQuickControlBrandTarget, type SiteChromeQuickControlHistoryMutation, type SiteChromeQuickControlNavTarget, type SiteChromeQuickControlReplayPlan, type SiteChromeQuickControlSelectionTarget } from './siteChromeQuickControlHistoryState';
+export type SiteChromeQuickControlPendingMutation = Extract<SiteChromeQuickControlHistoryMutation, {
+    kind: 'undoing' | 'redoing';
+}>;
+type ConfirmMutation = Readonly<{
+    kind: 'confirm-mutation';
+    mutation: SiteChromeQuickControlPendingMutation;
+}>;
+type History<TTarget> = ConfirmMutation | Readonly<{
+    kind: 'record';
+    target: TTarget;
+}>;
+/**
+ * What one quick-control save is asking for.
+ *
+ * `surface` travels with the requests that can name one. It has to, from
+ * #1318 Phase 4d: a header save carries no theme any more, so a footer
+ * background change sent under the header surface would have nowhere to be
+ * written.
+ */
+export type SiteChromeQuickControlSaveRequest = Readonly<{
+    kind: 'selection';
+    surface: SiteChromeEditableSurfaceKind;
+    selection: SelectionSnapshot;
+    history: History<SiteChromeQuickControlSelectionTarget>;
+}> | Readonly<{
+    kind: 'brand-preferences';
+    preferences: HeaderBrandPreferences;
+    history: History<SiteChromeQuickControlBrandTarget>;
+}> | Readonly<{
+    kind: 'background-preferences';
+    surface: SiteChromeEditableSurfaceKind;
+    preferences: SiteChromeBackgroundPreferences;
+    history: History<SiteChromeQuickControlBackgroundTarget>;
+}> | Readonly<{
+    kind: 'nav-preferences';
+    preferences: HeaderNavPreferences;
+    history: History<SiteChromeQuickControlNavTarget>;
+}>;
+/**
+ * Which surface a save is for. Selection and background changes name their own;
+ * the brand and nav controls only ever edit the header.
+ */
+export declare function saveRequestSurface(request: SiteChromeQuickControlSaveRequest): SiteChromeEditableSurfaceKind;
+/** Replaying an undo or redo is the same save, with a confirmation attached. */
+export declare function saveRequestFromQuickControlReplayPlan(plan: SiteChromeQuickControlReplayPlan, mutation: SiteChromeQuickControlPendingMutation): SiteChromeQuickControlSaveRequest;
+export {};

package/dist/_dts/preview-next/src/client/preview/siteChromeSavePlan.d.ts

@@ -1,6 +1,6 @@
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { HeaderNavPreferences, HeaderLogoContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderNavPreferences, HeaderLogoContext, HeaderPreferences, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import { type SiteStylePreviewPlan } from './siteStylePreviewPlanner';
@@ -25,8 +25,30 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     themeId: string | null;
     selectionId: string | null;
     baseSelectionUpdatedAt: string | null;
+    /** Persisted intent, including the structural fields quick controls cannot edit. */
+    persistedHeaderPreferences: HeaderPreferences;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerLogoContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerLogoContext, headerBrandPreferences, headerNavPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, persistedHeaderPreferences, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+/**
+ * The nav half of the record the server persisted, read back rather than
+ * re-derived from the saved bytes. The theme is compiled output from 4b
+ * onward; the record is the intent, so it is the better answer to "what is the
+ * control set to". Falls back to the bytes while the column is still absent on
+ * a row the Phase 4c backfill has not reached.
+ */
+export declare function headerNavPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse): HeaderNavPreferences;
+/**
+ * The header half comes from the persisted record; the footer half has no
+ * entry in `HeaderPreferences` and stays derived from the saved theme.
+ */
+export declare function backgroundPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse): SiteChromeBackgroundPreferences;
+/**
+ * The brand half of the record the server persisted. Same rule as the nav and
+ * background halves: the record is the intent, the saved theme is compiled
+ * output, so the controls read the record when there is one and fall back to
+ * the bytes while the Phase 4c backfill is outstanding.
+ */
+export declare function headerBrandPreferencesFromSiteChromeSaveResponse(saved: SaveSiteChromeSelectionResponse, headerLogoContext: HeaderLogoContext | undefined): HeaderBrandPreferences;
 export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeSelectionBody;
 export declare function selectionSnapshotFromSiteChromeSaveResponse({ saved, fallback, savePlan, }: Readonly<{
     saved: SaveSiteChromeSelectionResponse;

package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts

@@ -1,6 +1,6 @@
 import type { Theme } from '../../../../blocks/src/index';
 import { type ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderBrandPresentationPreference, FooterLookId, HeaderLayoutId, HeaderLogoContext, HeaderStyleId, SiteChromeSurface } from '../../../../theme-core/src/site-styles/index';
 import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteThemeSelectionsResult, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
@@ -20,6 +20,16 @@ type SiteStylePreviewPlanCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     selection: SiteStylePreviewSelection;
     headerLogoContext?: HeaderLogoContext;
+    /**
+     * The row's brand-presentation mode, which the preview must honour or it
+     * renders a treatment the save will not persist (#1318 D24).
+     *
+     * Required, with no default, so a caller that does not hold the record has to
+     * say `'recommended'` in its own source rather than inherit it invisibly.
+     * That is the difference between a stated assumption and a silent one, and
+     * the assumption is wrong for exactly the rows D24 exists for.
+     */
+    headerBrandPresentation: HeaderBrandPresentationPreference;
 }>;
 export type SiteStylePreviewPlanInput = SiteStylePreviewPlanCommonInput & (Readonly<{
     compilation: Readonly<{
@@ -42,4 +52,16 @@ export declare function deriveSiteStylePreviewUpdate(baseTheme: Theme | null | u
     kind: 'derive-update';
 }>;
 export declare function planSiteStylePreviewChange(input: SiteStylePreviewPlanInput): SiteStylePreviewPlan;
+/**
+ * The configurator's previews, with the one assumption they make written down
+ * once instead of four times.
+ *
+ * `planSiteStylePreviewChange` requires the brand-presentation mode (#1318 D24)
+ * so that no caller inherits it invisibly. Nothing hands the site-style
+ * configurator the row's persisted record yet, so it states `'recommended'` —
+ * correct for every row except a `'plain'` one, where the preview is a round
+ * trip behind until the first save teaches it otherwise. The plan's closing
+ * checklist has what closing that costs.
+ */
+export declare function planConfiguratorPreview(input: SiteStylePreviewPlanInput extends infer TInput ? TInput extends unknown ? Omit<TInput, 'headerBrandPresentation'> : never : never): SiteStylePreviewPlan;
 export {};

package/dist/_dts/preview-next/src/client/preview/usePersistedHeaderPreferences.d.ts

@@ -0,0 +1,8 @@
+import { type RefObject } from 'react';
+import type { Theme } from '../../../../blocks/src/index';
+import { type HeaderLogoContext, type HeaderPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SelectionSnapshot } from './StyleConfigurator.state';
+import type { SiteChromeCustomizeProviderProps } from './SiteChromeCustomizeContext';
+/** Keep the row-owned intent across optimistic edits and server responses. */
+export declare function usePersistedHeaderPreferences(stored: HeaderPreferences | null, theme: Theme | null | undefined, selection: SelectionSnapshot | null, logo: HeaderLogoContext | undefined): RefObject<HeaderPreferences>;
+export declare function useSiteChromeInitialSnapshot({ theme, initialSelections, selectionVersion, selectionUpdatedAt, headerLogoContext, }: Pick<SiteChromeCustomizeProviderProps, 'theme' | 'initialSelections' | 'selectionVersion' | 'selectionUpdatedAt' | 'headerLogoContext'>): SelectionSnapshot | null;

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

@@ -270,7 +270,8 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'selectionId' | 'selectionVersion' | 'selectionUpdatedAt' | 'selectionButtonStyleSelection' | 'selectionButtonStyleRepairs' | 'selectionHeaderSelection' | 'selectionFooterLookId'>;
+/** Keep the SDK's selection metadata aligned with the runtime response. */
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
 export type SiteResponse = SiteSelectionResponse & {
     site: {
         id: string;

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.136.0";
+export declare const SDK_VERSION = "0.137.0";