@riverbankcms/sdk 0.4.2 → 0.5.0

package/dist/server/{types-BiRZnxDx.d.ts → types-C28kMfa1.d.ts}

@@ -1,9 +1,18 @@
 import { AIChatMessage } from '@riverbankcms/ai';
-import { S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
+import { S as SdkCustomBlock } from './schema-Z6-afHJG.js';
 import { z } from 'zod';
+import { L as LinkValue } from './link-DjxLyC82.js';
 import { ListMediaAssetsResult, MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
 import { ImpersonationScope, DbRow, CamelizeKeys, DbJson, DbDatabase } from '@riverbankcms/db';
 
+/**
+ * Common types shared between public and internal API modules.
+ * These types form the foundation of the API type system.
+ */
+type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD';
+type ApiResponseKind = 'json' | 'stream' | 'text' | 'void';
+type ApiAuthRequirement = 'public' | 'user' | 'admin' | 'service';
+
 type BillingInterval = 'monthly' | 'annual';
 type FeatureKey = 'sites.multiple' | 'ai.workflows' | 'support.priority' | 'themes.advanced' | 'limits.highUsage' | 'collaboration.admin' | 'collaboration.editor';
 
@@ -143,153 +152,181 @@ declare const themeSchema: z.ZodObject<{
                     normal: "normal";
                     smallCaps: "smallCaps";
                 }>>;
+                italic: z.ZodNullable<z.ZodBoolean>;
             }, z.core.$strip>;
             h1: z.ZodObject<{
-                weight: z.ZodNullable<z.ZodEnum<{
+                weight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     bold: "bold";
                     medium: "medium";
                     light: "light";
                     regular: "regular";
                     semibold: "semibold";
-                }>>;
-                letterSpacing: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                letterSpacing: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     tight: "tight";
-                }>>;
-                size: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
                     md: "md";
                     lg: "lg";
                     xl: "xl";
-                }>>;
-                lineHeight: z.ZodNullable<z.ZodEnum<{
+                    "2xl": "2xl";
+                }>>>;
+                lineHeight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     relaxed: "relaxed";
-                }>>;
+                }>>>;
+                italic: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>;
             h2: z.ZodObject<{
-                weight: z.ZodNullable<z.ZodEnum<{
+                weight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     bold: "bold";
                     medium: "medium";
                     light: "light";
                     regular: "regular";
                     semibold: "semibold";
-                }>>;
-                letterSpacing: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                letterSpacing: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     tight: "tight";
-                }>>;
-                size: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
                     md: "md";
                     lg: "lg";
                     xl: "xl";
-                }>>;
-                lineHeight: z.ZodNullable<z.ZodEnum<{
+                    "2xl": "2xl";
+                }>>>;
+                lineHeight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     relaxed: "relaxed";
-                }>>;
+                }>>>;
+                italic: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>;
             h3: z.ZodObject<{
-                weight: z.ZodNullable<z.ZodEnum<{
+                weight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     bold: "bold";
                     medium: "medium";
                     light: "light";
                     regular: "regular";
                     semibold: "semibold";
-                }>>;
-                letterSpacing: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                letterSpacing: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     tight: "tight";
-                }>>;
-                size: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
                     md: "md";
                     lg: "lg";
                     xl: "xl";
-                }>>;
-                lineHeight: z.ZodNullable<z.ZodEnum<{
+                    "2xl": "2xl";
+                }>>>;
+                lineHeight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     relaxed: "relaxed";
-                }>>;
+                }>>>;
+                italic: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>;
             h4: z.ZodOptional<z.ZodObject<{
-                weight: z.ZodNullable<z.ZodEnum<{
+                weight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     bold: "bold";
                     medium: "medium";
                     light: "light";
                     regular: "regular";
                     semibold: "semibold";
-                }>>;
-                letterSpacing: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                letterSpacing: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     tight: "tight";
-                }>>;
-                size: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
                     md: "md";
                     lg: "lg";
                     xl: "xl";
-                }>>;
-                lineHeight: z.ZodNullable<z.ZodEnum<{
+                    "2xl": "2xl";
+                }>>>;
+                lineHeight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     relaxed: "relaxed";
-                }>>;
+                }>>>;
+                italic: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>>;
             h5: z.ZodOptional<z.ZodObject<{
-                weight: z.ZodNullable<z.ZodEnum<{
+                weight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     bold: "bold";
                     medium: "medium";
                     light: "light";
                     regular: "regular";
                     semibold: "semibold";
-                }>>;
-                letterSpacing: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                letterSpacing: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     tight: "tight";
-                }>>;
-                size: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
                     md: "md";
                     lg: "lg";
                     xl: "xl";
-                }>>;
-                lineHeight: z.ZodNullable<z.ZodEnum<{
+                    "2xl": "2xl";
+                }>>>;
+                lineHeight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     relaxed: "relaxed";
-                }>>;
+                }>>>;
+                italic: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>>;
             h6: z.ZodOptional<z.ZodObject<{
-                weight: z.ZodNullable<z.ZodEnum<{
+                weight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     bold: "bold";
                     medium: "medium";
                     light: "light";
                     regular: "regular";
                     semibold: "semibold";
-                }>>;
-                letterSpacing: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                letterSpacing: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     tight: "tight";
-                }>>;
-                size: z.ZodNullable<z.ZodEnum<{
+                }>>>;
+                size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    xs: "xs";
+                    sm: "sm";
                     md: "md";
                     lg: "lg";
                     xl: "xl";
-                }>>;
-                lineHeight: z.ZodNullable<z.ZodEnum<{
+                    "2xl": "2xl";
+                }>>>;
+                lineHeight: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     normal: "normal";
                     loose: "loose";
                     relaxed: "relaxed";
-                }>>;
+                }>>>;
+                italic: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
         scale: z.ZodEnum<{
+            compact: "compact";
+            spacious: "spacious";
+            balanced: "balanced";
             minorThird: "minorThird";
             majorThird: "majorThird";
             perfectFourth: "perfectFourth";
@@ -438,6 +475,7 @@ declare const themeSchema: z.ZodObject<{
             }, z.core.$strip>>>;
             textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
+        textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         navStyle: z.ZodEnum<{
             solid: "solid";
             underline: "underline";
@@ -522,6 +560,56 @@ declare const themeSchema: z.ZodObject<{
             tint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             opacity: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
+        navLinkStyle: z.ZodOptional<z.ZodObject<{
+            colorToken: z.ZodDefault<z.ZodString>;
+            hoverColorToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            padding: z.ZodDefault<z.ZodEnum<{
+                default: "default";
+                none: "none";
+                compact: "compact";
+            }>>;
+            borderRadius: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                none: "none";
+                sm: "sm";
+                md: "md";
+            }>>;
+            effects: z.ZodOptional<z.ZodObject<{
+                base: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+                hover: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+                active: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+                focus: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            typography: z.ZodDefault<z.ZodEnum<{
+                heading: "heading";
+                body: "body";
+            }>>;
+            fontWeight: z.ZodDefault<z.ZodEnum<{
+                bold: "bold";
+                medium: "medium";
+                regular: "regular";
+                semibold: "semibold";
+            }>>;
+            textTransform: z.ZodDefault<z.ZodEnum<{
+                none: "none";
+                uppercase: "uppercase";
+                capitalize: "capitalize";
+            }>>;
+            italic: z.ZodDefault<z.ZodBoolean>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     footer: z.ZodObject<{
         variant: z.ZodEnum<{
@@ -576,6 +664,72 @@ declare const themeSchema: z.ZodObject<{
             }, z.core.$strip>>>;
             textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
+        navStyle: z.ZodDefault<z.ZodEnum<{
+            solid: "solid";
+            underline: "underline";
+            scale: "scale";
+            minimal: "minimal";
+            "underline-grow": "underline-grow";
+            capsule: "capsule";
+            frosted: "frosted";
+        }>>;
+        navColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        navWeight: z.ZodDefault<z.ZodEnum<{
+            bold: "bold";
+            medium: "medium";
+            regular: "regular";
+            semibold: "semibold";
+        }>>;
+        navLinkStyle: z.ZodOptional<z.ZodObject<{
+            colorToken: z.ZodDefault<z.ZodString>;
+            hoverColorToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            padding: z.ZodDefault<z.ZodEnum<{
+                default: "default";
+                none: "none";
+                compact: "compact";
+            }>>;
+            borderRadius: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                none: "none";
+                sm: "sm";
+                md: "md";
+            }>>;
+            effects: z.ZodOptional<z.ZodObject<{
+                base: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+                hover: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+                active: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+                focus: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    effectId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            typography: z.ZodDefault<z.ZodEnum<{
+                heading: "heading";
+                body: "body";
+            }>>;
+            fontWeight: z.ZodDefault<z.ZodEnum<{
+                bold: "bold";
+                medium: "medium";
+                regular: "regular";
+                semibold: "semibold";
+            }>>;
+            textTransform: z.ZodDefault<z.ZodEnum<{
+                none: "none";
+                uppercase: "uppercase";
+                capitalize: "capitalize";
+            }>>;
+            italic: z.ZodDefault<z.ZodBoolean>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     buttons: z.ZodOptional<z.ZodObject<{
         global: z.ZodObject<{
@@ -599,6 +753,16 @@ declare const themeSchema: z.ZodObject<{
             }>;
             fontWeight: z.ZodUnion<readonly [z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>]>;
             borderWidth: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+            typography: z.ZodOptional<z.ZodEnum<{
+                heading: "heading";
+                body: "body";
+            }>>;
+            italic: z.ZodOptional<z.ZodBoolean>;
+            paddingPreset: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                compact: "compact";
+                spacious: "spacious";
+            }>>;
             hoverTransform: z.ZodEnum<{
                 none: "none";
                 scale: "scale";
@@ -607,10 +771,12 @@ declare const themeSchema: z.ZodObject<{
             }>;
             hoverColor: z.ZodEnum<{
                 none: "none";
+                token: "token";
                 darken: "darken";
                 brighten: "brighten";
                 saturate: "saturate";
             }>;
+            hoverColorToken: z.ZodOptional<z.ZodString>;
             gradientStyle: z.ZodOptional<z.ZodEnum<{
                 linear: "linear";
                 radial: "radial";
@@ -672,6 +838,7 @@ declare const themeSchema: z.ZodObject<{
             }, z.core.$strip>>;
             padding: z.ZodOptional<z.ZodString>;
             fontSize: z.ZodOptional<z.ZodString>;
+            hoverBackgroundToken: z.ZodOptional<z.ZodString>;
             effects: z.ZodOptional<z.ZodObject<{
                 base: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     effectId: z.ZodString;
@@ -935,28 +1102,6 @@ type HydratedTheme = Omit<Theme, 'palette'> & {
 
 type SiteHeaderContent = Record<string, never>;
 
-type InternalLinkValue = {
-    kind: 'internal';
-    routeId: string;
-    entityId: string;
-    entityType: 'page' | 'content';
-    href: string;
-    title: string;
-    typeLabel: string;
-    contentTypeKey?: string | null;
-    contentTypeName?: string | null;
-    updatedAt?: string | null;
-};
-type ExternalLinkValue = {
-    kind: 'external';
-    href: string;
-};
-type CustomLinkValue = {
-    kind: 'url';
-    href: string;
-};
-type LinkValue = InternalLinkValue | ExternalLinkValue | CustomLinkValue;
-
 type SiteFooterLink = {
     label: string;
     link: LinkValue | null;
@@ -1105,9 +1250,6 @@ interface RiverbankSiteConfig {
     customBlocks?: SdkCustomBlock[];
     blockFieldOptions?: SdkBlockFieldOptionsMap;
 }
-type HTTPMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD";
-type ApiResponseKind = 'json' | 'stream' | 'text' | 'void';
-type ApiAuthRequirement = 'public' | 'user' | 'admin' | 'service';
 
 type APIEndpoint<TBody = unknown, TQuery = unknown, TResponse = unknown> = {
     path: string;
@@ -2293,6 +2435,8 @@ type SiteBySlugResponse = {
     layout: SiteLayoutResolvedPayload;
     customDomain: string | null;
     sdkConfig?: RiverbankSiteConfig | null;
+    /** Supabase storage URL for direct image access (SDK sites use this instead of env var) */
+    supabaseUrl?: string;
 };
 type BlockWithContentResponse = {
     id: string;
@@ -2334,6 +2478,7 @@ type CreateManualSiteRequest = {
     scaffoldContact?: boolean;
     scaffoldBlog?: boolean;
     invitees?: SiteInvitee[];
+    userId?: string;
 };
 type CreateManualSiteResponse = {
     siteId: string;
@@ -3286,6 +3431,21 @@ type APIEndpoints = {
             address: string | null;
         } | null;
     }>>;
+    resolveEventOccurrence: APIEndpoint<never, {
+        siteId: string;
+        entryId: string;
+        segment: string;
+    }, {
+        occurrence: {
+            id: string;
+            seriesId: string;
+            startsAt: string;
+            endsAt: string;
+            status: string;
+            capacityOverride: number | null;
+            overridesJson: Record<string, unknown>;
+        } | null;
+    }>;
     registerForEvent: APIEndpoint<{
         occurrenceId: string;
         email: string;
@@ -3451,7 +3611,7 @@ type APIEndpoints = {
     }, DeleteBlackoutResponse>;
     getAvailableSlots: APIEndpoint<GetAvailableSlotsQuery, {
         siteId: string;
-    } & GetAvailableSlotsQuery, GetAvailableSlotsResponse>;
+    }, GetAvailableSlotsResponse>;
     createAppointment: APIEndpoint<CreateAppointmentRequest, {
         siteId: string;
     }, CreateAppointmentResponse>;
@@ -3503,26 +3663,40 @@ type APIEndpoints = {
     previewBackup: APIEndpoint<FormData, never, BackupPreviewResponse>;
     importBackupAsNewSite: APIEndpoint<FormData, never, ImportBackupAsNewSiteResponse>;
 };
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
+type IsNonEmptyQuery<T> = [
+    T
+] extends [never] ? false : T extends undefined ? false : keyof T extends never ? false : true;
+type QueryToStringParams<T> = {
+    [K in keyof T]: string;
+};
+type ParamsPart<E extends keyof APIEndpoints> = IsNonEmptyQuery<APIEndpoints[E]['query']> extends false ? {
+    params?: Record<string, string>;
+} : HasRequiredKeys<APIEndpoints[E]['query']> extends true ? {
+    params: QueryToStringParams<APIEndpoints[E]['query']>;
+} : {
+    params?: QueryToStringParams<APIEndpoints[E]['query']>;
+};
 type APICallParams<E extends keyof APIEndpoints> = APIEndpoints[E] extends {
     method: 'GET';
 } ? {
     endpoint: E;
     body?: APIEndpoints[E]['body'];
-    params?: APIEndpoints[E]['query'] extends Record<string, any> ? Record<keyof APIEndpoints[E]['query'], string> : Record<string, string>;
     options?: RequestInit;
-} : APIEndpoints[E] extends {
+} & ParamsPart<E> : APIEndpoints[E] extends {
     method: 'POST' | 'PUT' | 'PATCH';
 } ? {
     endpoint: E;
     body: APIEndpoints[E]['body'];
-    params?: APIEndpoints[E]['query'] extends Record<string, any> ? Record<keyof APIEndpoints[E]['query'], string> : Record<string, string>;
     options?: RequestInit;
-} : {
+} & ParamsPart<E> : {
     endpoint: E;
     body?: APIEndpoints[E]['body'];
-    params?: APIEndpoints[E]['query'] extends Record<string, any> ? Record<keyof APIEndpoints[E]['query'], string> : Record<string, string>;
     options?: RequestInit;
-};
+} & ParamsPart<E>;
 type AiPatchPageMetaOp = {
     type: 'pageMeta';
     set: {
@@ -4053,4 +4227,4 @@ type ImportBackupAsNewSiteResponse = {
     code?: string;
 };
 
-export type { APIEndpoints as A, CustomLinkValue as C, ExternalLinkValue as E, HydratedTheme as H, InternalLinkValue as I, LinkPayload as L, NavigationMenuWithItems as N, SiteHeaderContent as S, Theme as T, NavigationItemRecord as a, APICallParams as b, SiteFooterContent as c, LinkValue as d, ExpandedPalette as e };
+export type { APIEndpoints as A, ExpandedPalette as E, HydratedTheme as H, LinkPayload as L, NavigationMenuWithItems as N, SiteHeaderContent as S, Theme as T, NavigationItemRecord as a, APICallParams as b, SiteFooterContent as c };

package/dist/server/{types-CL916r6x.d.ts → types-DLBhEPSt.d.ts}

@@ -1,4 +1,4 @@
-import { F as FieldDefinition, S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
+import { F as FieldDefinition, S as SdkCustomBlock } from './schema-Z6-afHJG.js';
 import { B as BlockKind } from './blockKinds-B6MWzNWp.js';
 
 /**
@@ -482,6 +482,27 @@ interface BlockFieldExtension {
  * ```
  */
 type BlockFieldExtensionsMap = Record<string, BlockFieldExtension>;
+/**
+ * Sync behavior configuration for CLI push operations.
+ *
+ * Controls how the SDK CLI handles content synchronization.
+ */
+interface SyncConfig {
+    /**
+     * How to handle existing entries during push.
+     * - 'skip': Only create new entries, never update existing
+     * - 'update': Create new entries and update existing ones
+     * @default 'skip'
+     */
+    existingEntries?: 'skip' | 'update';
+    /**
+     * Target for content updates.
+     * - 'draft': Updates save as draft (unpublished changes)
+     * - 'publish': Updates are published immediately
+     * @default 'draft'
+     */
+    contentTarget?: 'draft' | 'publish';
+}
 /**
  * Top-level SDK site configuration.
  *
@@ -530,6 +551,20 @@ type BlockFieldExtensionsMap = Record<string, BlockFieldExtension>;
 interface RiverbankSiteConfig {
     /** Site UUID from the dashboard - identifies which site this config belongs to */
     siteId: string;
+    /**
+     * Preview URL for this SDK site.
+     * Used by dashboard preview buttons to open the site's preview/staging environment.
+     * If not provided, preview buttons will be hidden for SDK sites.
+     * @example 'https://staging.mysite.com'
+     */
+    previewUrl?: string;
+    /**
+     * Live/production URL for this SDK site.
+     * Used by "View live site" links in the dashboard.
+     * If not provided, live site links will be hidden for SDK sites.
+     * @example 'https://mysite.com'
+     */
+    liveUrl?: string;
     /** SDK-defined theme with color palette for token resolution */
     theme?: SdkThemeConfig;
     /** Style configuration for curating editor options */
@@ -612,6 +647,32 @@ interface RiverbankSiteConfig {
      * ```
      */
     content?: ContentConfig;
+    /**
+     * Content directory path for CLI operations.
+     *
+     * When using `riverbankcms push` or `riverbankcms pull`, content is
+     * read from or written to this directory. JSON files in this directory
+     * are the source of truth for content.
+     *
+     * @default './content'
+     * @example './src/content'
+     */
+    contentDir?: string;
+    /**
+     * Sync behavior configuration for CLI push operations.
+     *
+     * Controls how the SDK CLI handles content synchronization when
+     * pushing content from local files to the CMS.
+     *
+     * @example
+     * ```typescript
+     * sync: {
+     *   existingEntries: 'update',  // Update existing entries
+     *   contentTarget: 'draft',     // Keep updates as drafts
+     * }
+     * ```
+     */
+    sync?: SyncConfig;
 }
 
-export type { BlockFieldConfig as B, ContentConfig as C, EntryConfig as E, FieldSelectOption as F, NavigationMenuConfig as N, PageConfig as P, RiverbankSiteConfig as R, SiteStyleConfig as S, SectionBackground as a, SectionOptionsConfig as b, ContainerOptionsConfig as c, SectionSpacing as d, ContainerMaxWidth as e, ContainerAlignment as f, SdkThemeConfig as g, SdkThemePalette as h, BlockFieldOptionsMap as i, BlockFieldExtension as j, BlockFieldExtensionsMap as k, ContentTypeConfig as l, BlockConfig as m, NavigationItemConfig as n, NavigationLinkType as o, SiteSettingsConfig as p };
+export type { BlockFieldConfig as B, ContentTypeConfig as C, EntryConfig as E, FieldSelectOption as F, NavigationMenuConfig as N, PageConfig as P, RiverbankSiteConfig as R, SiteStyleConfig as S, ContentConfig as a, SectionBackground as b, SectionOptionsConfig as c, ContainerOptionsConfig as d, SectionSpacing as e, ContainerMaxWidth as f, ContainerAlignment as g, SdkThemeConfig as h, SdkThemePalette as i, BlockFieldOptionsMap as j, BlockFieldExtension as k, BlockFieldExtensionsMap as l, BlockConfig as m, NavigationItemConfig as n, NavigationLinkType as o, SiteSettingsConfig as p, SyncConfig as q };