@riverbankcms/sdk 0.6.1 → 0.7.2

package/dist/server/theme.js

@@ -1,6 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }require('./chunk-DGUM43GV.js');
-
-// src/theme/index.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/theme/index.ts
 function applyTheme(theme, element) {
   const targetElement = _nullishCoalesce(element, () => ( (typeof document !== "undefined" ? document.documentElement : null)));
   if (!targetElement) {

package/dist/server/theme.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/theme.js","../../src/theme/index.ts"],"names":[],"mappings":"AAAA,4MAA4B;AAC5B;AACA;ACgBO,SAAS,UAAA,CAAW,KAAA,EAAgC,OAAA,EAA6B;AACtF,EAAA,MAAM,cAAA,mBAAgB,OAAA,UAAA,CAAY,OAAO,SAAA,IAAa,YAAA,EAAc,QAAA,CAAS,gBAAA,EAAkB,IAAA,GAAA;AAE/F,EAAA,GAAA,CAAI,CAAC,aAAA,EAAe;AAClB,IAAA,OAAA,CAAQ,IAAA,CAAK,yDAAyD,CAAA;AACtE,IAAA,MAAA;AAAA,EACF;AAIA,EAAA,aAAA,CAAc,YAAA,CAAa,oBAAA,EAAsB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AAIxE;AAiBO,SAAS,WAAA,CAAY,QAAA,EAAmC,CAAC,CAAA,EAA4B;AAI1F,EAAA,OAAO,EAAE,GAAG,QAAQ,CAAA;AACtB;ADxCA;AACE;AACA;AACF,mEAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/theme.js","sourcesContent":[null,"/**\n * Theme utilities for Riverbank CMS\n *\n * These utilities help you work with Builder themes in your application.\n */\n\n/**\n * Apply a Builder theme to the DOM by injecting CSS variables\n *\n * @param theme - The theme object from Riverbank CMS\n * @param element - The element to apply the theme to (default: document.documentElement)\n *\n * @example\n * ```ts\n * const site = await client.getSite({ slug: 'my-site' });\n * applyTheme(site.theme);\n * ```\n */\nexport function applyTheme(theme: Record<string, unknown>, element?: HTMLElement): void {\n  const targetElement = element ?? (typeof document !== 'undefined' ? document.documentElement : null);\n\n  if (!targetElement) {\n    console.warn('[Builder SDK] Cannot apply theme: no document available');\n    return;\n  }\n\n  // Theme application will use the theme runtime from @riverbankcms/blocks\n  // For now, we'll set a data attribute that the theme runtime can pick up\n  targetElement.setAttribute('data-builder-theme', JSON.stringify(theme));\n\n  // Note: Full CSS variable injection will be implemented once we\n  // finalize the theme transformation API from @riverbankcms/blocks\n}\n\n/**\n * Create a theme object with type-safe defaults\n *\n * @param partial - Partial theme configuration\n * @returns Complete theme object\n *\n * @example\n * ```ts\n * const customTheme = createTheme({\n *   colors: {\n *     primary: '#007bff',\n *   },\n * });\n * ```\n */\nexport function createTheme(partial: Record<string, unknown> = {}): Record<string, unknown> {\n  // For now, return the partial as-is\n  // Full theme creation with defaults will be implemented once we\n  // finalize the theme structure from @riverbankcms/blocks\n  return { ...partial };\n}\n\n/**\n * Re-export theme types from @riverbankcms/blocks when available\n */\nexport type Theme = Record<string, unknown>;\n"]}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/theme.js","../../src/theme/index.ts"],"names":[],"mappings":"AAAA;ACkBO,SAAS,UAAA,CAAW,KAAA,EAAgC,OAAA,EAA6B;AACtF,EAAA,MAAM,cAAA,mBAAgB,OAAA,UAAA,CAAY,OAAO,SAAA,IAAa,YAAA,EAAc,QAAA,CAAS,gBAAA,EAAkB,IAAA,GAAA;AAE/F,EAAA,GAAA,CAAI,CAAC,aAAA,EAAe;AAClB,IAAA,OAAA,CAAQ,IAAA,CAAK,yDAAyD,CAAA;AACtE,IAAA,MAAA;AAAA,EACF;AAIA,EAAA,aAAA,CAAc,YAAA,CAAa,oBAAA,EAAsB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AAIxE;AAiBO,SAAS,WAAA,CAAY,QAAA,EAAmC,CAAC,CAAA,EAA4B;AAI1F,EAAA,OAAO,EAAE,GAAG,QAAQ,CAAA;AACtB;AD1CA;AACE;AACA;AACF,mEAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/theme.js","sourcesContent":[null,"/**\n * Theme utilities for Riverbank CMS\n *\n * These utilities help you work with Builder themes in your application.\n */\n\n/**\n * Apply a Builder theme to the DOM by injecting CSS variables\n *\n * @param theme - The theme object from Riverbank CMS\n * @param element - The element to apply the theme to (default: document.documentElement)\n *\n * @example\n * ```ts\n * const site = await client.getSite({ slug: 'my-site' });\n * applyTheme(site.theme);\n * ```\n */\nexport function applyTheme(theme: Record<string, unknown>, element?: HTMLElement): void {\n  const targetElement = element ?? (typeof document !== 'undefined' ? document.documentElement : null);\n\n  if (!targetElement) {\n    console.warn('[Builder SDK] Cannot apply theme: no document available');\n    return;\n  }\n\n  // Theme application will use the theme runtime from @riverbankcms/blocks\n  // For now, we'll set a data attribute that the theme runtime can pick up\n  targetElement.setAttribute('data-builder-theme', JSON.stringify(theme));\n\n  // Note: Full CSS variable injection will be implemented once we\n  // finalize the theme transformation API from @riverbankcms/blocks\n}\n\n/**\n * Create a theme object with type-safe defaults\n *\n * @param partial - Partial theme configuration\n * @returns Complete theme object\n *\n * @example\n * ```ts\n * const customTheme = createTheme({\n *   colors: {\n *     primary: '#007bff',\n *   },\n * });\n * ```\n */\nexport function createTheme(partial: Record<string, unknown> = {}): Record<string, unknown> {\n  // For now, return the partial as-is\n  // Full theme creation with defaults will be implemented once we\n  // finalize the theme structure from @riverbankcms/blocks\n  return { ...partial };\n}\n\n/**\n * Re-export theme types from @riverbankcms/blocks when available\n */\nexport type Theme = Record<string, unknown>;\n"]}

package/dist/server/theme.mjs

@@ -1,5 +1,3 @@
-import "./chunk-BJTO5JO5.mjs";
-
 // src/theme/index.ts
 function applyTheme(theme, element) {
   const targetElement = element ?? (typeof document !== "undefined" ? document.documentElement : null);

package/dist/server/theme.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/index.ts"],"sourcesContent":["/**\n * Theme utilities for Riverbank CMS\n *\n * These utilities help you work with Builder themes in your application.\n */\n\n/**\n * Apply a Builder theme to the DOM by injecting CSS variables\n *\n * @param theme - The theme object from Riverbank CMS\n * @param element - The element to apply the theme to (default: document.documentElement)\n *\n * @example\n * ```ts\n * const site = await client.getSite({ slug: 'my-site' });\n * applyTheme(site.theme);\n * ```\n */\nexport function applyTheme(theme: Record<string, unknown>, element?: HTMLElement): void {\n  const targetElement = element ?? (typeof document !== 'undefined' ? document.documentElement : null);\n\n  if (!targetElement) {\n    console.warn('[Builder SDK] Cannot apply theme: no document available');\n    return;\n  }\n\n  // Theme application will use the theme runtime from @riverbankcms/blocks\n  // For now, we'll set a data attribute that the theme runtime can pick up\n  targetElement.setAttribute('data-builder-theme', JSON.stringify(theme));\n\n  // Note: Full CSS variable injection will be implemented once we\n  // finalize the theme transformation API from @riverbankcms/blocks\n}\n\n/**\n * Create a theme object with type-safe defaults\n *\n * @param partial - Partial theme configuration\n * @returns Complete theme object\n *\n * @example\n * ```ts\n * const customTheme = createTheme({\n *   colors: {\n *     primary: '#007bff',\n *   },\n * });\n * ```\n */\nexport function createTheme(partial: Record<string, unknown> = {}): Record<string, unknown> {\n  // For now, return the partial as-is\n  // Full theme creation with defaults will be implemented once we\n  // finalize the theme structure from @riverbankcms/blocks\n  return { ...partial };\n}\n\n/**\n * Re-export theme types from @riverbankcms/blocks when available\n */\nexport type Theme = Record<string, unknown>;\n"],"mappings":";;;AAkBO,SAAS,WAAW,OAAgC,SAA6B;AACtF,QAAM,gBAAgB,YAAY,OAAO,aAAa,cAAc,SAAS,kBAAkB;AAE/F,MAAI,CAAC,eAAe;AAClB,YAAQ,KAAK,yDAAyD;AACtE;AAAA,EACF;AAIA,gBAAc,aAAa,sBAAsB,KAAK,UAAU,KAAK,CAAC;AAIxE;AAiBO,SAAS,YAAY,UAAmC,CAAC,GAA4B;AAI1F,SAAO,EAAE,GAAG,QAAQ;AACtB;","names":[]}
+{"version":3,"sources":["../../src/theme/index.ts"],"sourcesContent":["/**\n * Theme utilities for Riverbank CMS\n *\n * These utilities help you work with Builder themes in your application.\n */\n\n/**\n * Apply a Builder theme to the DOM by injecting CSS variables\n *\n * @param theme - The theme object from Riverbank CMS\n * @param element - The element to apply the theme to (default: document.documentElement)\n *\n * @example\n * ```ts\n * const site = await client.getSite({ slug: 'my-site' });\n * applyTheme(site.theme);\n * ```\n */\nexport function applyTheme(theme: Record<string, unknown>, element?: HTMLElement): void {\n  const targetElement = element ?? (typeof document !== 'undefined' ? document.documentElement : null);\n\n  if (!targetElement) {\n    console.warn('[Builder SDK] Cannot apply theme: no document available');\n    return;\n  }\n\n  // Theme application will use the theme runtime from @riverbankcms/blocks\n  // For now, we'll set a data attribute that the theme runtime can pick up\n  targetElement.setAttribute('data-builder-theme', JSON.stringify(theme));\n\n  // Note: Full CSS variable injection will be implemented once we\n  // finalize the theme transformation API from @riverbankcms/blocks\n}\n\n/**\n * Create a theme object with type-safe defaults\n *\n * @param partial - Partial theme configuration\n * @returns Complete theme object\n *\n * @example\n * ```ts\n * const customTheme = createTheme({\n *   colors: {\n *     primary: '#007bff',\n *   },\n * });\n * ```\n */\nexport function createTheme(partial: Record<string, unknown> = {}): Record<string, unknown> {\n  // For now, return the partial as-is\n  // Full theme creation with defaults will be implemented once we\n  // finalize the theme structure from @riverbankcms/blocks\n  return { ...partial };\n}\n\n/**\n * Re-export theme types from @riverbankcms/blocks when available\n */\nexport type Theme = Record<string, unknown>;\n"],"mappings":";AAkBO,SAAS,WAAW,OAAgC,SAA6B;AACtF,QAAM,gBAAgB,YAAY,OAAO,aAAa,cAAc,SAAS,kBAAkB;AAE/F,MAAI,CAAC,eAAe;AAClB,YAAQ,KAAK,yDAAyD;AACtE;AAAA,EACF;AAIA,gBAAc,aAAa,sBAAsB,KAAK,UAAU,KAAK,CAAC;AAIxE;AAiBO,SAAS,YAAY,UAAmC,CAAC,GAA4B;AAI1F,SAAO,EAAE,GAAG,QAAQ;AACtB;","names":[]}

package/dist/server/{types-BvcJU7zk.d.ts → types-DnkRh0UL.d.ts}

@@ -33,10 +33,17 @@ interface PaginationMeta {
 type EntriesResponseWithMeta = {
     entries: EntriesResponse['entries'];
 } & PaginationMeta;
+/**
+ * Common options for all SDK methods
+ */
+interface SdkMethodOptions {
+    /** AbortSignal for cancelling the request */
+    signal?: AbortSignal;
+}
 /**
  * Base parameters for getEntries - shared across all overloads
  */
-interface GetEntriesBaseParams {
+interface GetEntriesBaseParams extends SdkMethodOptions {
     /** The site ID */
     siteId: string;
     /** The content type key (e.g., 'blog-post', 'product') */
@@ -54,6 +61,92 @@ interface GetEntriesBaseParams {
     /** Entry IDs to fetch when mode is 'manual' */
     entryIds?: string[];
 }
+/**
+ * Source of the data returned by a resilient fetch
+ */
+type ResilienceSource = 'live' | 'cache' | 'stale' | 'prebuild' | 'error';
+/**
+ * Status information from a resilient fetch operation
+ */
+interface ResilienceStatus {
+    /** Where the data came from */
+    source: ResilienceSource;
+    /** Whether this was a preview request */
+    isPreview: boolean;
+    /** Cache key used for this request */
+    cacheKey?: string;
+    /** Error details if fetch failed */
+    error?: {
+        code?: string;
+        message: string;
+    };
+    /** Seconds since cache TTL expired (when source='stale') */
+    staleAgeSec?: number;
+    /** Seconds since prebuild was generated (when source='prebuild') */
+    prebuildAgeSec?: number;
+    /** Circuit breaker state at time of request */
+    circuit: CircuitState;
+    /** Correlation ID for debugging */
+    requestId?: string;
+    /** Total request duration including retries (ms) */
+    durationMs?: number;
+}
+/**
+ * Circuit breaker state information
+ */
+interface CircuitState {
+    state: 'closed' | 'open' | 'half-open';
+    failureCount: number;
+    /** Timestamp when circuit will transition from open to half-open */
+    openUntil?: number;
+}
+/**
+ * Retry configuration
+ */
+interface RetryConfig {
+    /** Maximum number of attempts (including initial) */
+    maxAttempts?: number;
+    /** Base delay between retries in ms */
+    baseDelayMs?: number;
+    /** Maximum delay between retries in ms */
+    maxDelayMs?: number;
+    /** Jitter strategy: 'full' adds randomization, 'none' uses exact delays */
+    jitter?: 'full' | 'none';
+    /** Custom function to determine if an error should be retried */
+    retryOn?: (error: Error, statusCode?: number) => boolean;
+}
+/**
+ * Circuit breaker configuration
+ */
+interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit */
+    resetTimeoutMs?: number;
+    /** Number of successful requests needed to close from half-open */
+    halfOpenMaxRequests?: number;
+}
+/**
+ * Resilience configuration for the SDK client
+ */
+interface ResilienceConfig {
+    /** Enable resilience features (default: true) */
+    enabled?: boolean;
+    /** Serve stale data on fetch failure (default: true) */
+    staleIfError?: boolean;
+    /** Seconds AFTER cache TTL expires that stale data remains valid (default: 300) */
+    staleTtlSec?: number;
+    /** Request timeout in ms (default: 8000 server, 5000 browser) */
+    requestTimeoutMs?: number;
+    /** Retry configuration */
+    retry?: RetryConfig;
+    /** Circuit breaker configuration */
+    circuitBreaker?: CircuitBreakerConfig;
+    /** Callback fired on every request with status information */
+    onStatusChange?: (status: ResilienceStatus) => void;
+    /** Callback fired only when transitioning into/out of degraded mode */
+    onDegradedMode?: (degraded: boolean, status: ResilienceStatus) => void;
+}
 /**
  * Configuration for creating a Riverbank CMS client
  */
@@ -85,6 +178,10 @@ interface RiverbankClientConfig {
          */
         maxSize?: number;
     };
+    /**
+     * Resilience configuration for error handling, retries, and fallbacks
+     */
+    resilience?: ResilienceConfig;
 }
 /**
  * Riverbank CMS client interface
@@ -97,7 +194,7 @@ interface RiverbankClient {
         slug?: string;
         domain?: string;
         id?: string;
-    }): Promise<SiteResponse>;
+    } & SdkMethodOptions): Promise<SiteResponse>;
     /**
      * Fetch a specific page by path
      *
@@ -107,7 +204,7 @@ interface RiverbankClient {
         siteId: string;
         path: string;
         preview?: boolean;
-    }): Promise<PageResponse>;
+    } & SdkMethodOptions): Promise<PageResponse>;
     /**
      * Fetch published content entries with optional pagination, sorting, and preview mode
      *
@@ -168,20 +265,20 @@ interface RiverbankClient {
         siteId: string;
         contentType: string;
         slug: string;
-    }): Promise<EntryResponse>;
+    } & SdkMethodOptions): Promise<EntryResponse>;
     /**
      * Fetch a public form definition by ID
      */
     getPublicFormById(params: {
         formId: string;
-    }): Promise<PublicFormResponse>;
+    } & SdkMethodOptions): Promise<PublicFormResponse>;
     /**
      * Fetch public booking services for a site
      */
     getPublicBookingServices(params: {
         siteId: string;
         ids?: string;
-    }): Promise<PublicBookingServicesResponse>;
+    } & SdkMethodOptions): Promise<PublicBookingServicesResponse>;
     /**
      * List public events for a site (optionally time-filtered)
      */
@@ -191,7 +288,7 @@ interface RiverbankClient {
         from?: string;
         to?: string;
         stage?: string;
-    }): Promise<PublicEventsResponse>;
+    } & SdkMethodOptions): Promise<PublicEventsResponse>;
     /**
      * Resolve an event occurrence by URL segment (date or UUID)
      *
@@ -220,7 +317,7 @@ interface RiverbankClient {
         siteId: string;
         entryId: string;
         segment: string;
-    }): Promise<ResolveEventOccurrenceResponse>;
+    } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
     /**
      * Check if a path has a configured redirect rule
      *
@@ -241,11 +338,23 @@ interface RiverbankClient {
     checkRedirect(params: {
         siteId: string;
         path: string;
-    }): Promise<CheckRedirectResponse>;
+    } & SdkMethodOptions): Promise<CheckRedirectResponse>;
     /**
      * Force clear the cache
      */
     clearCache(): void;
+    /**
+     * Get the status from the most recently emitted request
+     *
+     * Note: With concurrent requests, this returns the last status emitted,
+     * which may not be from the request you're interested in. For reliable
+     * per-request status, use the onStatusChange callback instead.
+     */
+    getLastEmittedStatus(): ResilienceStatus | null;
+    /**
+     * Get the current circuit breaker state
+     */
+    getCircuitState(): CircuitState;
 }
 
 export type { EntriesResponse as E, PageResponse as P, RiverbankClient as R, SiteResponse as S, RiverbankClientConfig as a, EntryResponse as b, EntriesResponseWithMeta as c, PaginationMeta as d, ResolveEventOccurrenceResponse as e };

package/dist/server/{types-1cLz0vnq.d.mts → types-MF2AWoKv.d.mts}

@@ -33,10 +33,17 @@ interface PaginationMeta {
 type EntriesResponseWithMeta = {
     entries: EntriesResponse['entries'];
 } & PaginationMeta;
+/**
+ * Common options for all SDK methods
+ */
+interface SdkMethodOptions {
+    /** AbortSignal for cancelling the request */
+    signal?: AbortSignal;
+}
 /**
  * Base parameters for getEntries - shared across all overloads
  */
-interface GetEntriesBaseParams {
+interface GetEntriesBaseParams extends SdkMethodOptions {
     /** The site ID */
     siteId: string;
     /** The content type key (e.g., 'blog-post', 'product') */
@@ -54,6 +61,92 @@ interface GetEntriesBaseParams {
     /** Entry IDs to fetch when mode is 'manual' */
     entryIds?: string[];
 }
+/**
+ * Source of the data returned by a resilient fetch
+ */
+type ResilienceSource = 'live' | 'cache' | 'stale' | 'prebuild' | 'error';
+/**
+ * Status information from a resilient fetch operation
+ */
+interface ResilienceStatus {
+    /** Where the data came from */
+    source: ResilienceSource;
+    /** Whether this was a preview request */
+    isPreview: boolean;
+    /** Cache key used for this request */
+    cacheKey?: string;
+    /** Error details if fetch failed */
+    error?: {
+        code?: string;
+        message: string;
+    };
+    /** Seconds since cache TTL expired (when source='stale') */
+    staleAgeSec?: number;
+    /** Seconds since prebuild was generated (when source='prebuild') */
+    prebuildAgeSec?: number;
+    /** Circuit breaker state at time of request */
+    circuit: CircuitState;
+    /** Correlation ID for debugging */
+    requestId?: string;
+    /** Total request duration including retries (ms) */
+    durationMs?: number;
+}
+/**
+ * Circuit breaker state information
+ */
+interface CircuitState {
+    state: 'closed' | 'open' | 'half-open';
+    failureCount: number;
+    /** Timestamp when circuit will transition from open to half-open */
+    openUntil?: number;
+}
+/**
+ * Retry configuration
+ */
+interface RetryConfig {
+    /** Maximum number of attempts (including initial) */
+    maxAttempts?: number;
+    /** Base delay between retries in ms */
+    baseDelayMs?: number;
+    /** Maximum delay between retries in ms */
+    maxDelayMs?: number;
+    /** Jitter strategy: 'full' adds randomization, 'none' uses exact delays */
+    jitter?: 'full' | 'none';
+    /** Custom function to determine if an error should be retried */
+    retryOn?: (error: Error, statusCode?: number) => boolean;
+}
+/**
+ * Circuit breaker configuration
+ */
+interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit */
+    resetTimeoutMs?: number;
+    /** Number of successful requests needed to close from half-open */
+    halfOpenMaxRequests?: number;
+}
+/**
+ * Resilience configuration for the SDK client
+ */
+interface ResilienceConfig {
+    /** Enable resilience features (default: true) */
+    enabled?: boolean;
+    /** Serve stale data on fetch failure (default: true) */
+    staleIfError?: boolean;
+    /** Seconds AFTER cache TTL expires that stale data remains valid (default: 300) */
+    staleTtlSec?: number;
+    /** Request timeout in ms (default: 8000 server, 5000 browser) */
+    requestTimeoutMs?: number;
+    /** Retry configuration */
+    retry?: RetryConfig;
+    /** Circuit breaker configuration */
+    circuitBreaker?: CircuitBreakerConfig;
+    /** Callback fired on every request with status information */
+    onStatusChange?: (status: ResilienceStatus) => void;
+    /** Callback fired only when transitioning into/out of degraded mode */
+    onDegradedMode?: (degraded: boolean, status: ResilienceStatus) => void;
+}
 /**
  * Configuration for creating a Riverbank CMS client
  */
@@ -85,6 +178,10 @@ interface RiverbankClientConfig {
          */
         maxSize?: number;
     };
+    /**
+     * Resilience configuration for error handling, retries, and fallbacks
+     */
+    resilience?: ResilienceConfig;
 }
 /**
  * Riverbank CMS client interface
@@ -97,7 +194,7 @@ interface RiverbankClient {
         slug?: string;
         domain?: string;
         id?: string;
-    }): Promise<SiteResponse>;
+    } & SdkMethodOptions): Promise<SiteResponse>;
     /**
      * Fetch a specific page by path
      *
@@ -107,7 +204,7 @@ interface RiverbankClient {
         siteId: string;
         path: string;
         preview?: boolean;
-    }): Promise<PageResponse>;
+    } & SdkMethodOptions): Promise<PageResponse>;
     /**
      * Fetch published content entries with optional pagination, sorting, and preview mode
      *
@@ -168,20 +265,20 @@ interface RiverbankClient {
         siteId: string;
         contentType: string;
         slug: string;
-    }): Promise<EntryResponse>;
+    } & SdkMethodOptions): Promise<EntryResponse>;
     /**
      * Fetch a public form definition by ID
      */
     getPublicFormById(params: {
         formId: string;
-    }): Promise<PublicFormResponse>;
+    } & SdkMethodOptions): Promise<PublicFormResponse>;
     /**
      * Fetch public booking services for a site
      */
     getPublicBookingServices(params: {
         siteId: string;
         ids?: string;
-    }): Promise<PublicBookingServicesResponse>;
+    } & SdkMethodOptions): Promise<PublicBookingServicesResponse>;
     /**
      * List public events for a site (optionally time-filtered)
      */
@@ -191,7 +288,7 @@ interface RiverbankClient {
         from?: string;
         to?: string;
         stage?: string;
-    }): Promise<PublicEventsResponse>;
+    } & SdkMethodOptions): Promise<PublicEventsResponse>;
     /**
      * Resolve an event occurrence by URL segment (date or UUID)
      *
@@ -220,7 +317,7 @@ interface RiverbankClient {
         siteId: string;
         entryId: string;
         segment: string;
-    }): Promise<ResolveEventOccurrenceResponse>;
+    } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
     /**
      * Check if a path has a configured redirect rule
      *
@@ -241,11 +338,23 @@ interface RiverbankClient {
     checkRedirect(params: {
         siteId: string;
         path: string;
-    }): Promise<CheckRedirectResponse>;
+    } & SdkMethodOptions): Promise<CheckRedirectResponse>;
     /**
      * Force clear the cache
      */
     clearCache(): void;
+    /**
+     * Get the status from the most recently emitted request
+     *
+     * Note: With concurrent requests, this returns the last status emitted,
+     * which may not be from the request you're interested in. For reliable
+     * per-request status, use the onStatusChange callback instead.
+     */
+    getLastEmittedStatus(): ResilienceStatus | null;
+    /**
+     * Get the current circuit breaker state
+     */
+    getCircuitState(): CircuitState;
 }
 
 export type { EntriesResponse as E, PageResponse as P, RiverbankClient as R, SiteResponse as S, RiverbankClientConfig as a, EntryResponse as b, EntriesResponseWithMeta as c, PaginationMeta as d, ResolveEventOccurrenceResponse as e };

package/dist/server/webhooks.d.mts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+
+/**
+ * Webhook verification utilities for Riverbank SDK
+ *
+ * Provides framework-agnostic webhook signature verification and payload parsing.
+ */
+
+/**
+ * Zod schema for webhook payload validation.
+ */
+declare const WebhookPayloadSchema: z.ZodObject<{
+    event: z.ZodString;
+    timestamp: z.ZodString;
+    siteId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Webhook payload structure sent by the CMS.
+ */
+type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
+/**
+ * Verify a webhook signature using HMAC-SHA256.
+ *
+ * Uses timing-safe comparison to prevent timing attacks.
+ *
+ * @param payload - The raw request body as a string
+ * @param signature - The X-Riverbank-Signature header value
+ * @param secret - The webhook signing secret (RIVERBANK_WEBHOOK_SECRET)
+ * @returns true if signature is valid, false otherwise
+ *
+ * @example
+ * ```ts
+ * const body = await request.text();
+ * const signature = request.headers.get('x-riverbank-signature');
+ * const secret = process.env.RIVERBANK_WEBHOOK_SECRET;
+ *
+ * if (!verifyWebhookSignature(body, signature, secret)) {
+ *   return new Response('Invalid signature', { status: 401 });
+ * }
+ * ```
+ */
+declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
+/**
+ * Result type for webhook payload parsing.
+ */
+type ParseWebhookResult = {
+    success: true;
+    payload: WebhookPayload;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Parse and validate a webhook payload from the request body.
+ *
+ * Uses Zod schema validation to ensure the payload has the expected structure.
+ *
+ * @param body - The raw request body as a string
+ * @returns A result object with either the validated payload or an error message
+ *
+ * @example
+ * ```ts
+ * const body = await request.text();
+ * const result = parseWebhookPayload(body);
+ * if (!result.success) {
+ *   return new Response(result.error, { status: 400 });
+ * }
+ * console.log(`Received ${result.payload.event} for site ${result.payload.siteId}`);
+ * ```
+ */
+declare function parseWebhookPayload(body: string): ParseWebhookResult;
+
+export { type ParseWebhookResult, type WebhookPayload, WebhookPayloadSchema, parseWebhookPayload, verifyWebhookSignature };

package/dist/server/webhooks.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+
+/**
+ * Webhook verification utilities for Riverbank SDK
+ *
+ * Provides framework-agnostic webhook signature verification and payload parsing.
+ */
+
+/**
+ * Zod schema for webhook payload validation.
+ */
+declare const WebhookPayloadSchema: z.ZodObject<{
+    event: z.ZodString;
+    timestamp: z.ZodString;
+    siteId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Webhook payload structure sent by the CMS.
+ */
+type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
+/**
+ * Verify a webhook signature using HMAC-SHA256.
+ *
+ * Uses timing-safe comparison to prevent timing attacks.
+ *
+ * @param payload - The raw request body as a string
+ * @param signature - The X-Riverbank-Signature header value
+ * @param secret - The webhook signing secret (RIVERBANK_WEBHOOK_SECRET)
+ * @returns true if signature is valid, false otherwise
+ *
+ * @example
+ * ```ts
+ * const body = await request.text();
+ * const signature = request.headers.get('x-riverbank-signature');
+ * const secret = process.env.RIVERBANK_WEBHOOK_SECRET;
+ *
+ * if (!verifyWebhookSignature(body, signature, secret)) {
+ *   return new Response('Invalid signature', { status: 401 });
+ * }
+ * ```
+ */
+declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
+/**
+ * Result type for webhook payload parsing.
+ */
+type ParseWebhookResult = {
+    success: true;
+    payload: WebhookPayload;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Parse and validate a webhook payload from the request body.
+ *
+ * Uses Zod schema validation to ensure the payload has the expected structure.
+ *
+ * @param body - The raw request body as a string
+ * @returns A result object with either the validated payload or an error message
+ *
+ * @example
+ * ```ts
+ * const body = await request.text();
+ * const result = parseWebhookPayload(body);
+ * if (!result.success) {
+ *   return new Response(result.error, { status: 400 });
+ * }
+ * console.log(`Received ${result.payload.event} for site ${result.payload.siteId}`);
+ * ```
+ */
+declare function parseWebhookPayload(body: string): ParseWebhookResult;
+
+export { type ParseWebhookResult, type WebhookPayload, WebhookPayloadSchema, parseWebhookPayload, verifyWebhookSignature };

package/dist/server/webhooks.js

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkVODFQMUWjs = require('./chunk-VODFQMUW.js');
+
+
+
+
+exports.WebhookPayloadSchema = _chunkVODFQMUWjs.WebhookPayloadSchema; exports.parseWebhookPayload = _chunkVODFQMUWjs.parseWebhookPayload; exports.verifyWebhookSignature = _chunkVODFQMUWjs.verifyWebhookSignature;
+//# sourceMappingURL=webhooks.js.map

package/dist/server/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/webhooks.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACA;AACA;AACF,mNAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/webhooks.js"}

package/dist/server/webhooks.mjs

@@ -0,0 +1,11 @@
+import {
+  WebhookPayloadSchema,
+  parseWebhookPayload,
+  verifyWebhookSignature
+} from "./chunk-AET56TQX.mjs";
+export {
+  WebhookPayloadSchema,
+  parseWebhookPayload,
+  verifyWebhookSignature
+};
+//# sourceMappingURL=webhooks.mjs.map

package/dist/server/webhooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}