@riverbankcms/sdk 0.70.0 → 0.70.3

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

@@ -486,6 +486,190 @@ export type Database = {
                     }
                 ];
             };
+            appointment_availability_schedule_services: {
+                Row: {
+                    created_at: string;
+                    resource_id: string;
+                    schedule_id: string;
+                    service_id: string;
+                    site_id: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    resource_id: string;
+                    schedule_id: string;
+                    service_id: string;
+                    site_id: string;
+                };
+                Update: {
+                    created_at?: string;
+                    resource_id?: string;
+                    schedule_id?: string;
+                    service_id?: string;
+                    site_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "appointment_availability_schedule_services_schedule_fk";
+                        columns: ["schedule_id", "site_id", "resource_id"];
+                        isOneToOne: false;
+                        referencedRelation: "appointment_availability_schedules";
+                        referencedColumns: ["id", "site_id", "resource_id"];
+                    },
+                    {
+                        foreignKeyName: "appointment_availability_schedule_services_service_fk";
+                        columns: ["service_id", "site_id"];
+                        isOneToOne: false;
+                        referencedRelation: "appointment_services";
+                        referencedColumns: ["id", "site_id"];
+                    }
+                ];
+            };
+            appointment_availability_schedule_starts: {
+                Row: {
+                    created_at: string;
+                    display_order: number;
+                    id: string;
+                    resource_id: string;
+                    schedule_id: string;
+                    site_id: string;
+                    start_time: string;
+                    updated_at: string;
+                    weekday: number;
+                };
+                Insert: {
+                    created_at?: string;
+                    display_order?: number;
+                    id?: string;
+                    resource_id: string;
+                    schedule_id: string;
+                    site_id: string;
+                    start_time: string;
+                    updated_at?: string;
+                    weekday: number;
+                };
+                Update: {
+                    created_at?: string;
+                    display_order?: number;
+                    id?: string;
+                    resource_id?: string;
+                    schedule_id?: string;
+                    site_id?: string;
+                    start_time?: string;
+                    updated_at?: string;
+                    weekday?: number;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "appointment_availability_schedule_starts_schedule_fk";
+                        columns: ["schedule_id", "site_id", "resource_id"];
+                        isOneToOne: false;
+                        referencedRelation: "appointment_availability_schedules";
+                        referencedColumns: ["id", "site_id", "resource_id"];
+                    }
+                ];
+            };
+            appointment_availability_schedule_windows: {
+                Row: {
+                    created_at: string;
+                    display_order: number;
+                    end_time: string;
+                    id: string;
+                    resource_id: string;
+                    schedule_id: string;
+                    site_id: string;
+                    start_time: string;
+                    updated_at: string;
+                    weekday: number;
+                };
+                Insert: {
+                    created_at?: string;
+                    display_order?: number;
+                    end_time: string;
+                    id?: string;
+                    resource_id: string;
+                    schedule_id: string;
+                    site_id: string;
+                    start_time: string;
+                    updated_at?: string;
+                    weekday: number;
+                };
+                Update: {
+                    created_at?: string;
+                    display_order?: number;
+                    end_time?: string;
+                    id?: string;
+                    resource_id?: string;
+                    schedule_id?: string;
+                    site_id?: string;
+                    start_time?: string;
+                    updated_at?: string;
+                    weekday?: number;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "appointment_availability_schedule_windows_schedule_fk";
+                        columns: ["schedule_id", "site_id", "resource_id"];
+                        isOneToOne: false;
+                        referencedRelation: "appointment_availability_schedules";
+                        referencedColumns: ["id", "site_id", "resource_id"];
+                    }
+                ];
+            };
+            appointment_availability_schedules: {
+                Row: {
+                    created_at: string;
+                    display_order: number;
+                    id: string;
+                    interval_minutes: number | null;
+                    name: string;
+                    resource_id: string;
+                    role_kind: string;
+                    site_id: string;
+                    start_policy_kind: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    display_order?: number;
+                    id?: string;
+                    interval_minutes?: number | null;
+                    name?: string;
+                    resource_id: string;
+                    role_kind: string;
+                    site_id: string;
+                    start_policy_kind: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    display_order?: number;
+                    id?: string;
+                    interval_minutes?: number | null;
+                    name?: string;
+                    resource_id?: string;
+                    role_kind?: string;
+                    site_id?: string;
+                    start_policy_kind?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "appointment_availability_schedules_resource_id_fkey";
+                        columns: ["resource_id"];
+                        isOneToOne: false;
+                        referencedRelation: "staff_members";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "appointment_availability_schedules_site_id_fkey";
+                        columns: ["site_id"];
+                        isOneToOne: false;
+                        referencedRelation: "sites";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             appointment_blackouts: {
                 Row: {
                     created_at: string;
@@ -13140,6 +13324,7 @@ export type Database = {
                     palette_overrides: Json | null;
                     palette_variant_id: string | null;
                     site_id: string;
+                    style_selection_version: number;
                     theme_id: string;
                     updated_at: string;
                     user_id: string;
@@ -13155,6 +13340,7 @@ export type Database = {
                     palette_overrides?: Json | null;
                     palette_variant_id?: string | null;
                     site_id: string;
+                    style_selection_version?: number;
                     theme_id: string;
                     updated_at?: string;
                     user_id: string;
@@ -13170,6 +13356,7 @@ export type Database = {
                     palette_overrides?: Json | null;
                     palette_variant_id?: string | null;
                     site_id?: string;
+                    style_selection_version?: number;
                     theme_id?: string;
                     updated_at?: string;
                     user_id?: string;
@@ -14802,6 +14989,26 @@ export type Database = {
                 };
                 Returns: number;
             };
+            apply_site_style_selection_atomic: {
+                Args: {
+                    p_base_selection_version: number;
+                    p_button_personality_id: string | null;
+                    p_footer_look_id: string | null;
+                    p_header_look_id: string | null;
+                    p_palette_overrides: Json | null;
+                    p_palette_variant_id: string | null;
+                    p_selection_id?: string | null;
+                    p_site_id: string;
+                    p_theme: Json;
+                };
+                Returns: {
+                    outcome: string;
+                    selection_id: string | null;
+                    selection_updated_at: string | null;
+                    style_selection_version: number | null;
+                    theme_id: string | null;
+                }[];
+            };
             apply_customer_profile_rectification: {
                 Args: {
                     audit_actor_user_id: string;
@@ -15397,6 +15604,12 @@ export type Database = {
                 };
                 Returns: string;
             };
+            ensure_default_appointment_availability_schedule: {
+                Args: {
+                    p_resource_id: string;
+                };
+                Returns: string;
+            };
             ensure_event_pricing_profile: {
                 Args: {
                     p_event_series_id: string;
@@ -15894,6 +16107,12 @@ export type Database = {
                 };
                 Returns: undefined;
             };
+            sync_default_appointment_availability_schedule_windows: {
+                Args: {
+                    p_resource_id: string;
+                };
+                Returns: undefined;
+            };
             transactional_email_claim_jobs: {
                 Args: {
                     p_limit: number;

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

@@ -33,6 +33,7 @@ export type PreviewEditorSidebarProps = {
     theme?: Theme | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     /** Persisted Style configurator selections (Phase C / E). */
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
@@ -64,4 +65,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, designRowRequest, apiClient, bearerToken, supabaseUrl, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -34,6 +34,7 @@ export type PreviewShellProps = {
     theme: Theme;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     /**
      * Persisted Style configurator selections. Forwarded into StyleConfigurator
@@ -68,7 +69,7 @@ export type PreviewShellProps = {
     designEditorEligibility?: PreviewDesignEditorEligibility;
     baseFetch?: BaseFetch;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, supabaseUrl, useThemeScope, designEditorEligibility, baseFetch, }: PreviewShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, supabaseUrl, useThemeScope, designEditorEligibility, baseFetch, }: PreviewShellProps): import("react/jsx-runtime").JSX.Element;
 export declare function defaultDesignEditorEligibility(input: Readonly<{
     pageId: string | null;
     entryData?: PreviewContentEntryData | null;

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

@@ -25,6 +25,7 @@ export type PreviewShellLayoutProps = {
     bearerToken?: string | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionVersion?: number | null;
     themeSelectionUpdatedAt?: string | null;
     themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
     themeSelectionPaletteVariantId?: PaletteVariantId | null;
@@ -43,4 +44,4 @@ export type PreviewShellLayoutProps = {
     useThemeScope?: boolean;
     siteStyleAccess?: SiteStyleAccess;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, themeSelectionFooterContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;

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

@@ -31,8 +31,10 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     theme?: Theme | null;
     themeId?: string | null;
     selectionId?: string | null;
+    selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
     initialSelections: Readonly<{
+        selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
         paletteVariantId: PaletteVariantId | null;
@@ -44,6 +46,6 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     footerSelectionContext?: Partial<FooterSelectionContext>;
     siteStyleAccess?: SiteStyleAccess;
 }>;
-export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, siteStyleAccess, }: SiteChromeCustomizeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, siteStyleAccess, }: SiteChromeCustomizeProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;
 export {};

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

@@ -11,9 +11,11 @@ export type StyleConfiguratorProps = Readonly<{
     theme?: Theme | null;
     themeId?: string | null;
     selectionId?: string | null;
+    selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
     /** Server-persisted design selections. */
     initialSelections: Readonly<{
+        selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
         paletteVariantId: PaletteVariantId | null;
@@ -30,4 +32,4 @@ export type StyleConfiguratorProps = Readonly<{
     }> | null;
     siteStyleAccess: VisibleSiteStyleAccess;
 }>;
-export declare function StyleConfigurator({ siteId, apiClient, theme, themeId, selectionId, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -38,6 +38,7 @@ export type StyleConfiguratorNotice = Readonly<{
 }>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
+    selectionVersion: number;
     selectionUpdatedAt?: string | null;
     headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId | null;

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

@@ -0,0 +1,8 @@
+import type { APIEndpoints } from '../../../../api/src/index';
+import type { SelectionSnapshot } from './StyleConfigurator.state';
+export type ApplySiteStyleSelectionBody = NonNullable<APIEndpoints['applySiteStyleSelection']['body']>;
+export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
+    base: SelectionSnapshot;
+    previewed: SelectionSnapshot;
+    selectionId?: string | null;
+}>): ApplySiteStyleSelectionBody;

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

@@ -6,6 +6,7 @@ import type { SelectionSnapshot } from './StyleConfigurator.state';
 export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<{
     theme?: Theme | null;
     initialSelections: Readonly<{
+        selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
         paletteVariantId: PaletteVariantId | null;

package/dist/_dts/sdk/src/cli/commands/delete.d.ts

@@ -6,6 +6,9 @@
  * Usage:
  *   riverbankcms delete entry <type> <identifier>
  *   riverbankcms delete block <page-identifier> <block-identifier>
+ *
+ * These destructive one-off commands intentionally remain direct for #931 so
+ * their confirmation and remote --yes safety semantics stay unchanged.
  */
 import { Command } from 'commander';
 export declare const deleteCommand: Command;

package/dist/_dts/sdk/src/cli/commands/style.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Style Command
+ *
+ * Apply bounded site-style selections via the command-backed theme API.
+ */
+import { Command } from 'commander';
+import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/index';
+import type { ThemeStyleSelectionApplyInput } from '../../client/management';
+export type StyleApplyOptions = Readonly<{
+    siteStyleId: string;
+    baseSelectionVersion: string;
+    selectionId?: string;
+    buttonPersonalityId?: string;
+    paletteVariantId?: string;
+    paletteOverrides?: string;
+    headerLookId?: string;
+    footerLookId?: string;
+}>;
+export type StyleCatalogListOptions = Readonly<{
+    siteStyleId?: string;
+}>;
+export type StyleCatalogChoice = Readonly<{
+    id: string;
+    label: string;
+}>;
+export type StyleCatalogListRow = Readonly<{
+    siteStyleId: string;
+    name: string;
+    palettes: readonly StyleCatalogChoice[];
+    buttonPersonalities: readonly StyleCatalogChoice[];
+    headerLooks: readonly StyleCatalogChoice[];
+    footerLooks: readonly StyleCatalogChoice[];
+}>;
+export declare function buildStyleSelectionApplyInputFromOptions(options: StyleApplyOptions): ThemeStyleSelectionApplyInput;
+export declare function buildStyleCatalogListRows(styles?: readonly CuratedSiteStyle[], options?: StyleCatalogListOptions): readonly StyleCatalogListRow[];
+export declare function formatStyleCatalogListRow(row: StyleCatalogListRow): string[];
+export declare const styleCommand: Command;

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

@@ -5,6 +5,7 @@
  * Reduces duplication and ensures consistent behavior.
  */
 import { Command } from 'commander';
+import type { SiteId } from '../../../core/src/index';
 import type { ManagementClient } from '../client/management/types';
 import { type OutputContext } from './output';
 import { type CliErrorContext } from './errors';
@@ -52,6 +53,8 @@ export interface CommandContext {
     client: ManagementClient;
     isRemote: boolean;
     isJsonOutput: boolean;
+    targetEnv: EnvTarget;
+    siteId: SiteId;
     /** Environment targets for this operation */
     envTargets: EnvTarget[];
 }
@@ -271,6 +274,11 @@ export declare function handleCommandError(error: unknown, output: OutputContext
  * }))
  */
 export declare function withErrorHandling<TArgs extends unknown[]>(action: (...args: [...TArgs, Command]) => Promise<void>): (...args: [...TArgs, Command]) => Promise<void>;
+/**
+ * Wrap a command action so handlers receive a resolved command context instead
+ * of the raw Commander instance.
+ */
+export declare function withCommandContext<TArgs extends unknown[], TOptions = unknown>(action: (ctx: CommandContext, ...args: [...TArgs, TOptions]) => Promise<void>): (...args: [...TArgs, TOptions, Command]) => Promise<void>;
 /**
  * Wrap a destructive command action with confirmation prompt and error handling.
  *
@@ -289,39 +297,6 @@ export declare function withErrorHandling<TArgs extends unknown[]>(action: (...a
  * ))
  */
 export declare function withConfirmation<TArgs extends unknown[]>(getMessage: (...args: TArgs) => string, action: (ctx: CommandContext, ...args: TArgs) => Promise<void>): (...args: [...TArgs, ConfirmOptions, Command]) => Promise<void>;
-/**
- * Configuration for publish/unpublish command factories.
- */
-export interface PublishCommandConfig {
-    /** Resource name for display (e.g., 'entry', 'page') */
-    resourceName: string;
-    /** Argument names (e.g., ['type', 'identifier'] or ['identifier']) */
-    args: readonly string[];
-    /** Function to call the appropriate client method */
-    action: (client: ManagementClient, ...args: string[]) => Promise<void>;
-}
-/**
- * Create a publish command for a resource.
- *
- * @example
- * const publishCommand = createPublishCommand({
- *   resourceName: 'entry',
- *   args: ['type', 'identifier'],
- *   action: (client, type, id) => client.entries.publish(type, id),
- * });
- */
-export declare function createPublishCommand(config: PublishCommandConfig): Command;
-/**
- * Create an unpublish command for a resource.
- *
- * @example
- * const unpublishCommand = createUnpublishCommand({
- *   resourceName: 'entry',
- *   args: ['type', 'identifier'],
- *   action: (client, type, id) => client.entries.unpublish(type, id),
- * });
- */
-export declare function createUnpublishCommand(config: PublishCommandConfig): Command;
 /**
  * Configuration for get command factory.
  */

package/dist/_dts/sdk/src/cli/site-commands/oneOffCommands.d.ts

@@ -0,0 +1,81 @@
+import { type Result, type SiteId } from '../../../../core/src/index';
+import type { ManagementBlock, ManagementClient, ManagementEntry, ManagementNavigationMenu, ManagementPage, NavigationItemInput } from '../../client/management/types';
+import type { EnvTarget } from '../helpers';
+import { type CliCommandCompileBatchSuccessWithReports, type CliCommandValidationCompileError } from './commandRuntime';
+import { type EntryCommandReportSubject, type EntrySiteCommand, type EntrySiteCommandType } from './entryCommands';
+import { type NavigationCommandReportSubject, type NavigationSiteCommand, type NavigationSiteCommandType } from './navigationCommands';
+import { type PageCommandReportSubject, type PageSiteCommand, type PageSiteCommandType } from './pageCommands';
+export type OneOffCommandBatchSource = 'one_off_entry' | 'one_off_page' | 'one_off_block' | 'one_off_navigation';
+type OneOffCompileInput<TMutation> = Readonly<{
+    source: OneOffCommandBatchSource;
+    siteId: SiteId;
+    targetEnv: EnvTarget;
+    mutation: TMutation;
+}>;
+export type OneOffEntryMutation = Readonly<{
+    kind: 'upsert';
+    contentType: string;
+    identifier: string;
+    data: Record<string, unknown>;
+    slug?: string;
+}> | Readonly<{
+    kind: 'publish' | 'unpublish';
+    contentType: string;
+    identifier: string;
+}>;
+export type OneOffPageMutation = Readonly<{
+    kind: 'upsert';
+    identifier: string;
+    title: string;
+    path: string;
+    seoTitle?: string;
+    seoDescription?: string;
+}> | Readonly<{
+    kind: 'publish' | 'unpublish';
+    identifier: string;
+}>;
+export type OneOffBlockMutation = Readonly<{
+    kind: 'upsert';
+    pageIdentifier: string;
+    blockIdentifier: string;
+    blockKind: string;
+    data: Record<string, unknown>;
+}> | Readonly<{
+    kind: 'reorder';
+    pageIdentifier: string;
+    blockIdentifiers: readonly string[];
+}>;
+export type OneOffNavigationMutation = Readonly<{
+    kind: 'upsert';
+    menuName: string;
+    items: readonly NavigationItemInput[];
+}>;
+export type OneOffEntryCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<EntrySiteCommandType, EntryCommandReportSubject>;
+export type OneOffPageCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<PageSiteCommandType, PageCommandReportSubject>;
+export type OneOffNavigationCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<NavigationSiteCommandType, NavigationCommandReportSubject>;
+export declare function compileOneOffEntryCommand(input: OneOffCompileInput<OneOffEntryMutation>): Result<OneOffEntryCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function compileOneOffPageCommand(input: OneOffCompileInput<OneOffPageMutation>): Result<OneOffPageCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function compileOneOffBlockCommand(input: OneOffCompileInput<OneOffBlockMutation>): Result<OneOffPageCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function compileOneOffNavigationCommand(input: OneOffCompileInput<OneOffNavigationMutation>): Result<OneOffNavigationCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function executeOneOffEntryCommand<TResult>(input: Readonly<{
+    compiledPlan: Pick<OneOffEntryCommandCompileSuccess, 'plan'>;
+    client: Pick<ManagementClient, 'entries'>;
+    apply: (command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>) => Promise<TResult>;
+}>): Promise<TResult>;
+export declare function executeOneOffPageCommand<TResult>(input: Readonly<{
+    compiledPlan: Pick<OneOffPageCommandCompileSuccess, 'plan'>;
+    client: Pick<ManagementClient, 'pages' | 'blocks'>;
+    apply: (command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>) => Promise<TResult>;
+}>): Promise<TResult>;
+export declare function executeOneOffNavigationCommand<TResult>(input: Readonly<{
+    compiledPlan: Pick<OneOffNavigationCommandCompileSuccess, 'plan'>;
+    client: Pick<ManagementClient, 'navigation'>;
+    apply: (command: NavigationSiteCommand, client: Pick<ManagementClient, 'navigation'>) => Promise<TResult>;
+}>): Promise<TResult>;
+export declare function applyOneOffEntryCommand(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<ManagementEntry | void>;
+export declare function applyOneOffEntryCommandReturningEntry(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<ManagementEntry>;
+export declare function applyOneOffPageCommand(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementPage | ManagementBlock | void>;
+export declare function applyOneOffPageCommandReturningPage(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementPage>;
+export declare function applyOneOffPageCommandReturningBlock(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementBlock>;
+export declare function applyOneOffNavigationCommand(command: NavigationSiteCommand, client: Pick<ManagementClient, 'navigation'>): Promise<ManagementNavigationMenu>;
+export {};

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

@@ -36,6 +36,7 @@ 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, EventPricing, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, PageUpsertInput, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, ThemeUpsertInput, ThemeUpsertResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, 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, EventPricing, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, PageUpsertInput, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInput, ThemeUpsertResult, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
 export { ManagementApiError, type ManagementApiErrorRequest } from './http';
+export { applySiteStyleSelectionBodyFromCommand, buildApplySiteStyleSelectionCommand, } from './theme';
 export { CourseSessionConflictError };

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

@@ -2,5 +2,7 @@
  * Theme Operations for Management Client
  */
 import type { HttpClient } from './http';
-import type { ThemeOperations } from './types';
+import type { SiteStyleSelectionApplyCommand, ThemeOperations, ThemeStyleSelectionApplyInput } from './types';
+export declare function buildApplySiteStyleSelectionCommand(input: ThemeStyleSelectionApplyInput): SiteStyleSelectionApplyCommand;
+export declare function applySiteStyleSelectionBodyFromCommand(command: SiteStyleSelectionApplyCommand, selectionId?: string | null): ThemeStyleSelectionApplyInput;
 export declare function createThemeOperations(http: HttpClient): ThemeOperations;

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

@@ -4,6 +4,7 @@
  * Type definitions for the SDK management client used for write operations.
  */
 import type { LinkPayload, NavigationLinkInput } from '../../public-api/contracts';
+import type { SiteCommandOf } from '../../../../site-commands/src/index';
 import type { Theme } from '../../contracts';
 export interface ManagementClientConfig {
     /**
@@ -465,6 +466,27 @@ export interface ThemeUpsertResult {
     selectionId: string;
     savedAt: string;
 }
+export type SiteStyleSelectionApplyCommand = SiteCommandOf<'applySiteStyleSelection'>;
+export type SiteStyleSelectionApplyCommandInput = SiteStyleSelectionApplyCommand['input'];
+export interface ThemeStyleSelectionApplyInput extends SiteStyleSelectionApplyCommandInput {
+    baseSelectionVersion: number;
+    selectionId?: string | null;
+}
+export interface ThemeStyleSelectionApplyResult {
+    success: boolean;
+    themeId: string;
+    selectionId: string;
+    selectionVersion: number;
+    selectionUpdatedAt: string | null;
+    savedAt: string;
+    theme: Theme;
+    siteStyleId: string;
+    buttonPersonalityId: string;
+    paletteVariantId: string;
+    paletteOverrides: Record<string, string> | null;
+    headerLookId: string;
+    footerLookId: string;
+}
 /**
  * Footer content for SDK management operations.
  * Matches the structure stored in site_settings.footer_content_json (bottomText only).
@@ -788,6 +810,7 @@ export interface FormOperations {
 }
 export interface ThemeOperations {
     upsert(input: ThemeUpsertInput): Promise<ThemeUpsertResult>;
+    applySelection(input: ThemeStyleSelectionApplyInput): Promise<ThemeStyleSelectionApplyResult>;
 }
 export interface FooterOperations {
     /** Get footer content */