@riverbankcms/sdk 0.104.1 → 0.107.0

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

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { ApiClient } from '../../../../api/src/request';
+import type { Theme } from '../../../../blocks/src/index';
+import { type GoogleFontRecord, type SiteFontRecord, type TypographyFontSlot } from './typographyFontCatalog';
+type ThemeTypography = Theme['typography'];
+type BodyTypography = ThemeTypography['body'];
+type HeadingTypography = ThemeTypography['headings']['default'];
+type CatalogResource<T> = Readonly<{
+    kind: 'idle';
+    value: T;
+}> | Readonly<{
+    kind: 'loading';
+    value: T;
+}> | Readonly<{
+    kind: 'loaded';
+    value: T;
+}> | Readonly<{
+    kind: 'failed';
+    value: T;
+    message: string;
+}>;
+export type TypographyFontCatalogState = Readonly<{
+    google: CatalogResource<readonly GoogleFontRecord[]>;
+    site: CatalogResource<readonly SiteFontRecord[]>;
+}>;
+export type TypographyEditorSurface = Readonly<{
+    kind: 'overview';
+}> | Readonly<{
+    kind: 'font-picker';
+    slot: TypographyFontSlot;
+}> | Readonly<{
+    kind: 'advanced';
+}>;
+export declare const typographyOverviewSurface: TypographyEditorSurface;
+export declare function useTypographyFontCatalog(apiClient: ApiClient, siteId: string, enabled: boolean): TypographyFontCatalogState;
+export declare function TypographyOverviewContent({ typography, catalog, onChooseFont, onOpenAdvanced, onReset, disabled, }: Readonly<{
+    typography: ThemeTypography;
+    catalog: TypographyFontCatalogState;
+    onChooseFont: (slot: TypographyFontSlot) => void;
+    onOpenAdvanced: () => void;
+    onReset: () => void;
+    disabled?: boolean;
+}>): React.JSX.Element;
+export declare function TypographyFontPickerTakeover({ slot, value, catalog, onBack, onChange, disabled, }: Readonly<{
+    slot: TypographyFontSlot;
+    value: string;
+    catalog: TypographyFontCatalogState;
+    onBack: () => void;
+    onChange: (family: string) => void;
+    disabled?: boolean;
+}>): React.JSX.Element;
+export declare function TypographyAdvancedTakeover({ typography, catalog, onBack, onHeadingChange, onBodyChange, onScaleChange, disabled, }: Readonly<{
+    typography: ThemeTypography;
+    catalog: TypographyFontCatalogState;
+    onBack: () => void;
+    onHeadingChange: (patch: Partial<HeadingTypography>) => void;
+    onBodyChange: (patch: Partial<BodyTypography>) => void;
+    onScaleChange: (scale: ThemeTypography['scale']) => void;
+    disabled?: boolean;
+}>): React.JSX.Element;
+export {};

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

@@ -1,14 +1,14 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import { type CuratedPaletteId } from '../../../../theme-core/src/palette/index';
-import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
-import { type CuratedSiteStyle, type CompiledTypographySelection, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
-import type { PaletteSelectionSnapshot, TypographySelectionSnapshot } from './StyleConfigurator.state';
+import { type CompleteResolvedPaletteSelection } from '../../../../theme-core/src/palette/index';
+import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import { compileSiteThemeFromSelections, type CuratedSiteStyle, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import type { PaletteSelectionSnapshot } from './StyleConfigurator.state';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
     buttonPersonalityId: ButtonPersonalityId;
     palette: PaletteSelectionSnapshot;
-    typographySelection?: TypographySelectionSnapshot;
+    typography: Theme['typography'];
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
     headerLookId: HeaderLookId | null;
@@ -20,18 +20,7 @@ export type SiteStyleChromePreviewSelection = Readonly<{
 }>;
 export type SiteStylePreviewPlan = Readonly<{
     themeOverlay: Theme;
-    resolvedSelections: Readonly<{
-        buttonPersonalityId: ButtonPersonalityId;
-        paletteVariantId: CuratedPaletteId;
-        typographySelection: CompiledTypographySelection['resolvedSelection'];
-        typographyPresetId: TypographyPresetId | null;
-        typographyBodyFontOverride: string | null;
-        typographyHeadingFontOverride: string | null;
-        headerLayoutId: HeaderLayoutId;
-        headerStyleId: HeaderStyleId;
-        headerLookId: HeaderLookId | null;
-        footerLookId: FooterLookId;
-    }>;
+    resolvedSelections: ReturnType<typeof compileSiteThemeFromSelections>['resolvedSelections'];
     chromeSelection: SiteStyleChromePreviewSelection;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
@@ -43,3 +32,4 @@ export type SiteStylePreviewPlanInput = Readonly<{
     footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
 export declare function planSiteStylePreviewChange(input: SiteStylePreviewPlanInput): SiteStylePreviewPlan;
+export declare function resolvedPaletteForPreview(palette: PaletteSelectionSnapshot, siteStyle: CuratedSiteStyle): CompleteResolvedPaletteSelection;

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

@@ -1,28 +1,35 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
-import { type CuratedPaletteId, type PaletteOverrides, type RuntimePaletteState } from '../../../../theme-core/src/palette/index';
-import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import { type RuntimePaletteState } from '../../../../theme-core/src/palette/index';
+import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
+export type PreviewRuntimePaletteState = Extract<RuntimePaletteState, Readonly<{
+    authority: 'curated';
+}>> | Extract<RuntimePaletteState, Readonly<{
+    authority: 'site';
+}>> | Extract<RuntimePaletteState, Readonly<{
+    kind: 'invalid';
+}>>;
 type StyleConfiguratorSnapshotInput = Readonly<{
     theme?: Theme | null;
     initialSelections: Readonly<{
         selectionVersion?: number | null;
         selectionUpdatedAt?: string | null;
         buttonPersonalityId: ButtonPersonalityId | null;
-        runtimePaletteState?: RuntimePaletteState | null;
-        paletteVariantId?: CuratedPaletteId | null;
-        paletteOverrides?: PaletteOverrides | null;
+        runtimePaletteState: PreviewRuntimePaletteState;
         headerLayoutId?: HeaderLayoutId | null;
         headerStyleId?: HeaderStyleId | null;
-        typographyPresetId?: TypographyPresetId | null;
-        typographyBodyFontOverride?: string | null;
-        typographyHeadingFontOverride?: string | null;
         headerLookId?: HeaderLookId | null;
         footerLookId?: FooterLookId | null;
     }>;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
+/**
+ * Preview only accepts the modern, server-resolved palette runtime state. The
+ * old Theme-plus-overrides reconstruction belongs to migration tooling, never
+ * to a live editor where it could silently overwrite authoritative state.
+ */
 export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<{
     theme?: Theme | null;
     initialSelections: StyleConfiguratorSnapshotInput['initialSelections'];

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

@@ -0,0 +1,57 @@
+import type { APIEndpoints } from '../../../../api/src/index';
+export type GoogleFontRecord = NonNullable<APIEndpoints['listFonts']['response']>[number];
+export type SiteFontRecord = NonNullable<APIEndpoints['listSiteFonts']['response']>['fonts'][number];
+export type TypographyFontCategory = 'all' | 'sans-serif' | 'serif' | 'display' | 'handwriting' | 'monospace';
+export type TypographyFontSlot = 'body' | 'heading';
+export type TypographyFontOption = Readonly<{
+    source: 'site';
+    family: string;
+    label: string;
+    category: Exclude<TypographyFontCategory, 'all'> | null;
+    siteFont: SiteFontRecord;
+}> | Readonly<{
+    source: 'google';
+    family: string;
+    label: string;
+    category: Exclude<TypographyFontCategory, 'all'> | null;
+    googleFont: GoogleFontRecord;
+}>;
+export declare const TYPOGRAPHY_INITIAL_GOOGLE_FONT_COUNT = 24;
+export declare const typographyFontCategories: readonly [{
+    readonly value: "all";
+    readonly label: "All";
+}, {
+    readonly value: "sans-serif";
+    readonly label: "Sans";
+}, {
+    readonly value: "serif";
+    readonly label: "Serif";
+}, {
+    readonly value: "display";
+    readonly label: "Display";
+}, {
+    readonly value: "handwriting";
+    readonly label: "Handwriting";
+}, {
+    readonly value: "monospace";
+    readonly label: "Mono";
+}];
+export declare function buildTypographyFontCatalog(input: Readonly<{
+    googleFonts: readonly GoogleFontRecord[];
+    siteFonts: readonly SiteFontRecord[];
+    query: string;
+    category: TypographyFontCategory;
+}>): Readonly<{
+    site: readonly TypographyFontOption[];
+    google: readonly TypographyFontOption[];
+}>;
+export declare function visibleTypographyFontOptions(input: Readonly<{
+    options: readonly TypographyFontOption[];
+    selectedFamily: string;
+    limit: number;
+}>): readonly TypographyFontOption[];
+export declare function fontOptionForFamily(family: string, catalog: Readonly<{
+    googleFonts: readonly GoogleFontRecord[];
+    siteFonts: readonly SiteFontRecord[];
+}>): TypographyFontOption | null;
+export declare function primaryFontFamily(cssFamily: string): string;

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

@@ -27,7 +27,7 @@ export declare function entryBaseSnapshotTargetForPull(input: Readonly<{
  * then remove canonical/owner-managed entry types before diffing or writing.
  */
 export declare function pullAllContentWithCanonicalEntryPolicy(client: ManagementClient, output: OutputContext): Promise<PulledContent>;
-export declare function createScopedPullContent(meta: PulledContent['meta'], overrides: Partial<Omit<PulledContent, 'meta'>>): PulledContent;
+export declare function createScopedPullContent(meta: Omit<PulledContent['meta'], 'truncation'> & Partial<Pick<PulledContent['meta'], 'truncation'>>, overrides: Partial<Omit<PulledContent, 'meta'>>): PulledContent;
 /**
  * Determines whether the pull command should prompt for overwrite confirmation.
  * Scoped pulls (e.g., `pull entries blog-post`) only modify their target subdirectory,

package/dist/_dts/sdk/src/cli/commands/push/execute/theme.d.ts

@@ -1,12 +1,9 @@
 import type { OutputContext } from '../../../output';
 import type { Theme } from '../../../../contracts';
+import type { ThemeUpsertUpdateInput } from '../../../../client/management/types';
 export type ThemePushClient = {
     theme: {
-        upsert: (params: {
-            theme: Theme;
-            themeId?: string;
-            selectionId?: string;
-        }) => Promise<{
+        upsert: (params: ThemeUpsertUpdateInput) => Promise<{
             themeId: string;
             selectionId: string;
             savedAt: string;
@@ -33,7 +30,7 @@ export declare function pushThemeAndUpdateMeta(params: {
     client: ThemePushClient;
     contentDir: string;
     themeName: string;
-    theme: Theme;
+    theme: ThemeUpsertUpdateInput['theme'];
     existingMeta?: ThemeMetaEntry;
     readThemesMeta: (contentDir: string) => Promise<ThemesMetaFile | null>;
     writeThemesMeta: (contentDir: string, data: ThemesMetaFile) => Promise<void>;
@@ -66,7 +63,7 @@ export declare function handleThemePushForAllScope(params: {
     themeSchema: {
         safeParse: (value: unknown) => {
             success: true;
-            data?: unknown;
+            data: ThemeUpsertUpdateInput['theme'];
         } | {
             success: false;
             error: {

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

@@ -5,22 +5,29 @@
  */
 import { Command } from 'commander';
 import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/index';
-import type { ThemeStyleSelectionApplyInput } from '../../client/management';
-export type StyleApplyOptions = Readonly<{
+import type { ManagementClient, ThemeStyleSelectionApplyInput } from '../../client/management';
+import { type SiteStyleSelectionApplyCommand } from '../../client/management';
+import type { OutputContext } from '../output';
+type StyleSelectionOptions = Readonly<{
     siteStyleId: string;
-    baseSelectionVersion: string;
-    selectionId?: string;
     buttonPersonalityId?: string;
-    paletteVariantId?: string;
-    paletteOverrides?: string;
-    typographyPresetId?: string;
-    typographyBodyFontOverride?: string;
-    typographyHeadingFontOverride?: string;
+    paletteCommand?: string;
+    typography?: string;
     headerLookId?: string;
     headerLayoutId?: string;
     headerStyleId?: string;
     footerLookId?: string;
 }>;
+export type StyleApplyOptions = StyleSelectionOptions & Readonly<{
+    baseSelectionVersion: string;
+    selectionId?: string;
+}>;
+export type StyleInitOptions = StyleSelectionOptions;
+export type StyleInitCommandDeps = Readonly<{
+    upsertTheme: ManagementClient['theme']['upsert'];
+    info: OutputContext['info'];
+    success: OutputContext['success'];
+}>;
 export type StyleCatalogListOptions = Readonly<{
     siteStyleId?: string;
 }>;
@@ -33,13 +40,20 @@ export type StyleCatalogListRow = Readonly<{
     name: string;
     palettes: readonly StyleCatalogChoice[];
     buttonPersonalities: readonly StyleCatalogChoice[];
-    typographyPresets: readonly StyleCatalogChoice[];
+    typography: Readonly<{
+        body: string;
+        heading: string;
+    }>;
     headerLayouts: readonly StyleCatalogChoice[];
     headerStyles: readonly StyleCatalogChoice[];
     headerLooks: readonly StyleCatalogChoice[];
     footerLooks: readonly StyleCatalogChoice[];
 }>;
 export declare function buildStyleSelectionApplyInputFromOptions(options: StyleApplyOptions): ThemeStyleSelectionApplyInput;
+/** Builds the complete first-theme command without reading current selection state. */
+export declare function buildStyleSelectionInitializeCommandFromOptions(options: StyleInitOptions): SiteStyleSelectionApplyCommand;
 export declare function buildStyleCatalogListRows(styles?: readonly CuratedSiteStyle[], options?: StyleCatalogListOptions): readonly StyleCatalogListRow[];
 export declare function formatStyleCatalogListRow(row: StyleCatalogListRow): string[];
+export declare function executeStyleInitWithDeps(deps: StyleInitCommandDeps, options: StyleInitOptions): Promise<void>;
 export declare const styleCommand: Command;
+export {};

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

@@ -1,5 +1,5 @@
 import { type Result, type SiteId } from '../../../../core/src/index';
-import type { ManagementBlock, ManagementClient, ManagementEntry, ManagementNavigationMenu, ManagementPage, NavigationItemInput } from '../../client/management/types';
+import type { ManagementBlock, ManagementClient, ManagementNavigationMenu, ManagementPage, NavigationItemInput, UpsertedManagementEntry } 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';
@@ -73,8 +73,8 @@ export declare function executeOneOffNavigationCommand<TResult>(input: Readonly<
     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 applyOneOffEntryCommand(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<UpsertedManagementEntry | void>;
+export declare function applyOneOffEntryCommandReturningEntry(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<UpsertedManagementEntry>;
 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>;

package/dist/_dts/sdk/src/cli/sync/media.d.ts

@@ -13,6 +13,7 @@
  *
  * No path rewriting in content data is needed since paths are relative!
  */
+import { type StoragePathParseError } from '../../../../media-core/src/index';
 /**
  * Extract all unique storagePath values from content data.
  * Recursively walks through objects and arrays to find all media references.
@@ -30,7 +31,20 @@ export declare function extractMediaIdentifiers(data: unknown): Set<string>;
  * @param siteId - The site ID context for relative paths
  * @param bucket - Storage bucket name (default: "media")
  */
-export declare function buildStorageUrl(supabaseUrl: string, storagePath: string, siteId: string, bucket?: string): string;
+export type MediaStorageUrlBuildError = Readonly<{
+    tag: 'invalid_storage_path';
+    siteId: string;
+    storagePath: string;
+    cause: StoragePathParseError;
+}>;
+export type MediaStorageUrlBuildResult = Readonly<{
+    ok: true;
+    value: string;
+}> | Readonly<{
+    ok: false;
+    error: MediaStorageUrlBuildError;
+}>;
+export declare function buildStorageUrl(supabaseUrl: string, storagePath: string, siteId: string, bucket?: string): MediaStorageUrlBuildResult;
 /**
  * Check if a file path is an image that can be transformed by Supabase.
  * @param path - The file path or storage path
@@ -48,7 +62,7 @@ export declare function isTransformableImage(path: string): boolean;
 export declare function buildImageTransformUrl(supabaseUrl: string, storagePath: string, siteId: string, options?: {
     width?: number;
     quality?: number;
-}): string;
+}): MediaStorageUrlBuildResult;
 /**
  * Download a file from a public Supabase storage URL.
  * Returns the file data as a Buffer, or null if download fails after retries.

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

@@ -1,6 +1,6 @@
 /**
  * Block Operations for Management Client
  */
+import { type HttpClient } from './http';
 import type { BlockOperations } from './types';
-import type { HttpClient } from './http';
 export declare function createBlockOperations(http: HttpClient): BlockOperations;

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

@@ -36,7 +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, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, 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, 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, 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/types.d.ts

@@ -4,13 +4,21 @@
  * Type definitions for the SDK management client used for write operations.
  */
 import type { LinkPayload, NavigationLinkInput } from '../../public-api/contracts';
+import type { APIEndpoints } from '../../../../api/src/index';
 import type { SiteCommandOf } from '../../../../site-commands/src/index';
 import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } from '../../../../api/src/sdk-event-pricing';
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../../api/src/sdk-event-payment-terms';
 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 { 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 SdkPullEntriesAllResponse = NonNullable<APIEndpoints['sdkPullEntriesAll']['response']>;
+export type SdkUpsertEntryResponse = NonNullable<APIEndpoints['sdkUpsertEntry']['response']>;
+export type SdkUpsertPageResponse = NonNullable<APIEndpoints['sdkUpsertPage']['response']>;
 export interface ManagementClientConfig {
     /**
      * Dashboard URL (e.g., http://localhost:4000 or https://dashboard.riverbankcms.com)
@@ -66,6 +74,28 @@ export interface EntryUpsertInput {
     slug?: string;
     manualOrder?: number;
     blocks?: EntrySlotBlocksInput;
+    /**
+     * Publication intent. 'draft' (default) writes a draft only; 'publish' runs
+     * the publish operation after a successful save. Save and publish are not
+     * atomic — a publish that fails after a successful save is reported in-band on
+     * the response, not as an error.
+     */
+    publication?: 'draft' | 'publish';
+}
+/**
+ * The entry shape upsert responses carry — the wire envelope omits
+ * `publishedData` (the caller just wrote the draft; fetch with `get` when the
+ * published side is needed).
+ */
+export type UpsertedManagementEntry = Omit<ManagementEntry, 'publishedData'>;
+/**
+ * Result of an entry upsert with `publication: 'publish'`. The promise resolves
+ * even when the publish stage failed — the save succeeded and the entry exists
+ * as a draft; branch on `publication.published`.
+ */
+export interface EntryPublishUpsertResult {
+    entry: UpsertedManagementEntry;
+    publication: SdkPublicationOutcome<SdkEntryPublishErrorCode>;
 }
 export interface ManagementPage {
     id: string;
@@ -84,6 +114,20 @@ export interface PageUpsertInput {
     path: string;
     seoTitle?: string;
     seoDescription?: string;
+    /**
+     * Publication intent. 'draft' (default) writes a draft only; 'publish' runs
+     * page publish after a successful save. Save and publish are non-atomic; a
+     * publish failure after a successful save is reported in-band, not as an error.
+     */
+    publication?: 'draft' | 'publish';
+}
+/**
+ * Result of a page upsert with `publication: 'publish'`. Resolves even when the
+ * publish stage failed — the save succeeded; branch on `publication.published`.
+ */
+export interface PagePublishUpsertResult {
+    page: ManagementPage;
+    publication: SdkPublicationOutcome<SdkPagePublishErrorCode>;
 }
 export interface ManagementBlock {
     id: string;
@@ -487,16 +531,18 @@ export interface MediaResolveResponse {
     missingAssetIds: string[];
 }
 /**
- * Input for creating or updating a theme.
- * Include themeId/selectionId for idempotent updates (push after pull).
+ * Explicitly separates an existing-theme update from first-theme provisioning.
+ * Initialization never accepts a separately authoritative Theme payload.
  */
-export interface ThemeUpsertInput {
-    theme: Theme;
-    /** Optional: update existing theme row (for idempotent push) */
-    themeId?: string;
-    /** Optional: update existing selection row (for idempotent push) */
-    selectionId?: string;
-}
+export type ThemeUpsertInput = NonNullable<APIEndpoints['sdkUpsertTheme']['body']>;
+/** Updates an existing theme selection with a caller-supplied theme. */
+export type ThemeUpsertUpdateInput = Extract<ThemeUpsertInput, {
+    kind: 'update';
+}>;
+/** Creates the first theme by compiling this complete style-selection command. */
+export type ThemeUpsertInitializeInput = Extract<ThemeUpsertInput, {
+    kind: 'initialize';
+}>;
 /**
  * Response from theme upsert operation.
  */
@@ -507,10 +553,29 @@ export interface ThemeUpsertResult {
 }
 export type SiteStyleSelectionApplyCommand = SiteCommandOf<'applySiteStyleSelection'>;
 export type SiteStyleSelectionApplyCommandInput = SiteStyleSelectionApplyCommand['input'];
-export interface ThemeStyleSelectionApplyInput extends SiteStyleSelectionApplyCommandInput {
+/**
+ * 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.
+ */
+export type ThemeStyleSelectionApplyInput = Omit<SiteStyleSelectionApplyCommandInput, 'siteStyleId' | 'headerLayoutId' | 'headerStyleId'> & Readonly<{
+    siteStyleId: string;
     baseSelectionVersion: number;
     selectionId?: string | null;
-}
+}> & (Readonly<{
+    headerLayoutId?: undefined;
+    headerStyleId?: undefined;
+}> | Readonly<{
+    headerLayoutId: null;
+    headerStyleId: null;
+}> | Readonly<{
+    headerLayoutId: string;
+    headerStyleId: string;
+}>);
 export interface ThemeStyleSelectionApplyResult {
     success: boolean;
     themeId: string;
@@ -521,16 +586,11 @@ export interface ThemeStyleSelectionApplyResult {
     theme: Theme;
     siteStyleId: string;
     buttonPersonalityId: string;
-    paletteVariantId: string;
-    paletteOverrides: Record<string, string> | null;
     activePaletteSelection: PaletteSelection;
     activeSitePaletteVersion: number | null;
     headerLookId: string | null;
     headerLayoutId: string;
     headerStyleId: string;
-    typographyPresetId: string | null;
-    typographyBodyFontOverride: string | null;
-    typographyHeadingFontOverride: string | null;
     footerLookId: string;
 }
 /**
@@ -586,6 +646,7 @@ export interface PulledEntries {
             updatedAt: string;
             publishedAt: string | null;
         }>;
+        truncation?: SdkPullTruncationMeta;
     };
     pagination: {
         page: number;
@@ -625,6 +686,30 @@ export interface PulledNavigation {
         pulledAt: string;
     };
 }
+/**
+ * Cross-type overview of everything with pending (unpublished) changes.
+ * Mirrors `SdkPullDraftsResponse` in `@riverbankcms/api`; kept structurally in
+ * sync by the API↔SDK typetest.
+ */
+export interface PulledDrafts {
+    pages: Array<{
+        identifier: string;
+        hasUnpublishedChanges: boolean;
+        status: 'draft' | 'published';
+    }>;
+    entries: Array<{
+        contentType: string;
+        identifier: string;
+        status: 'draft' | 'published';
+    }>;
+    summary: {
+        pageCount: number;
+        entryCount: number;
+    };
+    meta: {
+        pulledAt: string;
+    };
+}
 export interface PulledSettings {
     settings: ManagementSettings;
     warnings?: string[];
@@ -783,10 +868,8 @@ export interface PulledContent {
     meta: {
         pulledAt: string;
         settingsUpdatedAt?: string | null;
-        /** Whether the response was truncated due to size limits */
-        truncated?: boolean;
-        /** Message explaining what was truncated */
-        truncationMessage?: string;
+        /** Whether the response was truncated due to size limits and what was returned. */
+        truncation: SdkPullTruncationMeta;
         entries?: Record<string, {
             createdAt: string;
             updatedAt: string;
@@ -828,7 +911,19 @@ export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
 export interface EntryOperations {
     list(contentType: string, options?: PaginationOptions): Promise<PaginatedResult<ManagementEntry>>;
     get(contentType: string, identifier: string): Promise<ManagementEntry | null>;
-    upsert(input: EntryUpsertInput): Promise<ManagementEntry>;
+    /**
+     * Correlated overloads: a publish-intent upsert resolves to the entry plus
+     * the publication outcome (which may report a failed publish); a draft upsert
+     * resolves to the entry alone. Statically-unknown intent gets the honest
+     * union.
+     */
+    upsert(input: EntryUpsertInput & {
+        publication: 'publish';
+    }): Promise<EntryPublishUpsertResult>;
+    upsert(input: EntryUpsertInput & {
+        publication?: 'draft';
+    }): Promise<UpsertedManagementEntry>;
+    upsert(input: EntryUpsertInput): Promise<UpsertedManagementEntry | EntryPublishUpsertResult>;
     publish(contentType: string, identifier: string): Promise<void>;
     unpublish(contentType: string, identifier: string): Promise<void>;
     delete(contentType: string, identifier: string): Promise<void>;
@@ -836,13 +931,22 @@ export interface EntryOperations {
 export interface PageOperations {
     list(options?: PaginationOptions): Promise<PaginatedResult<ManagementPage>>;
     get(identifier: string): Promise<ManagementPage | null>;
-    upsert(input: PageUpsertInput): Promise<ManagementPage>;
+    /** Correlated overloads — see {@link EntryOperations.upsert}. */
+    upsert(input: PageUpsertInput & {
+        publication: 'publish';
+    }): Promise<PagePublishUpsertResult>;
+    upsert(input: PageUpsertInput & {
+        publication?: 'draft';
+    }): Promise<ManagementPage>;
+    upsert(input: PageUpsertInput): Promise<ManagementPage | PagePublishUpsertResult>;
     publish(identifier: string): Promise<void>;
     unpublish(identifier: string): Promise<void>;
+    delete(identifier: string): Promise<void>;
 }
+export type ManagementPageBlock = SdkGetPageBlockResponse['block'];
 export interface BlockOperations {
     list(pageIdentifier: string): Promise<ManagementBlock[]>;
-    get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementBlock | null>;
+    get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementPageBlock | null>;
     upsert(pageIdentifier: string, input: BlockUpsertInput): Promise<ManagementBlock>;
     reorder(pageIdentifier: string, blockIdentifiers: string[]): Promise<void>;
     delete(pageIdentifier: string, blockIdentifier: string): Promise<void>;
@@ -903,6 +1007,11 @@ export interface CourseOperations {
 export interface PullOperations {
     entries(contentType?: string, options?: PaginationOptions): Promise<PulledEntries>;
     pages(): Promise<PulledPages>;
+    /**
+     * Cross-type overview of pages and entries with pending (unpublished) changes.
+     * Server-side filtered and fully enumerated.
+     */
+    drafts(): Promise<PulledDrafts>;
     navigation(): Promise<PulledNavigation>;
     settings(): Promise<PulledSettings>;
     forms(): Promise<PulledForms>;