@riverbankcms/sdk 0.7.0 → 0.7.3

package/dist/client/{usePage-BiOReg0_.d.ts → usePage-BYmJCCm1.d.ts}

@@ -3354,7 +3354,7 @@ type ListSiteMembersResponse = {
     plan: SitePlanSummaryResponse;
 };
 type AuthFieldKey = 'email' | 'password' | 'confirmPassword' | 'name' | 'terms' | 'magicLink';
-type AuthSubmissionErrorReason = 'validation' | 'turnstile' | 'supabase' | 'already_registered' | 'rate_limited' | 'email' | 'closed' | 'invalid_credentials' | 'not_confirmed' | 'not_allowed';
+type AuthSubmissionErrorReason = 'validation' | 'spam_protection' | 'supabase' | 'already_registered' | 'rate_limited' | 'email' | 'closed' | 'invalid_credentials' | 'not_confirmed' | 'not_allowed';
 type AuthSubmissionSuccess = {
     status: 'success';
     message: string;
@@ -4926,7 +4926,7 @@ type APIEndpoints = {
             referer?: string;
             path?: string;
             honeypot?: string;
-            turnstileToken?: string | null;
+            altchaSolution?: string | null;
         };
     }, never, {
         ok: boolean;
@@ -6250,10 +6250,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') */
@@ -6271,6 +6278,104 @@ 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;
+    /**
+     * Path to prebuild cache directory.
+     * If set, enables prebuild fallback when live + stale cache both fail.
+     * @example '.riverbank-cache'
+     */
+    prebuildDir?: string;
+    /**
+     * Maximum age in seconds for prebuild cache.
+     * Prebuilds older than this are rejected.
+     * @default 86400 (24 hours)
+     */
+    maxPrebuildAgeSec?: number;
+    /** 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
  */
@@ -6302,6 +6407,10 @@ interface RiverbankClientConfig {
          */
         maxSize?: number;
     };
+    /**
+     * Resilience configuration for error handling, retries, and fallbacks
+     */
+    resilience?: ResilienceConfig;
 }
 /**
  * Riverbank CMS client interface
@@ -6314,7 +6423,7 @@ interface RiverbankClient {
         slug?: string;
         domain?: string;
         id?: string;
-    }): Promise<SiteResponse>;
+    } & SdkMethodOptions): Promise<SiteResponse>;
     /**
      * Fetch a specific page by path
      *
@@ -6324,7 +6433,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
      *
@@ -6385,20 +6494,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)
      */
@@ -6408,7 +6517,7 @@ interface RiverbankClient {
         from?: string;
         to?: string;
         stage?: string;
-    }): Promise<PublicEventsResponse>;
+    } & SdkMethodOptions): Promise<PublicEventsResponse>;
     /**
      * Resolve an event occurrence by URL segment (date or UUID)
      *
@@ -6437,7 +6546,7 @@ interface RiverbankClient {
         siteId: string;
         entryId: string;
         segment: string;
-    }): Promise<ResolveEventOccurrenceResponse>;
+    } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
     /**
      * Check if a path has a configured redirect rule
      *
@@ -6458,11 +6567,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;
 }
 
 /**

package/dist/client/{usePage-BXjk8BhD.d.mts → usePage-DZtrWajy.d.mts}

@@ -3354,7 +3354,7 @@ type ListSiteMembersResponse = {
     plan: SitePlanSummaryResponse;
 };
 type AuthFieldKey = 'email' | 'password' | 'confirmPassword' | 'name' | 'terms' | 'magicLink';
-type AuthSubmissionErrorReason = 'validation' | 'turnstile' | 'supabase' | 'already_registered' | 'rate_limited' | 'email' | 'closed' | 'invalid_credentials' | 'not_confirmed' | 'not_allowed';
+type AuthSubmissionErrorReason = 'validation' | 'spam_protection' | 'supabase' | 'already_registered' | 'rate_limited' | 'email' | 'closed' | 'invalid_credentials' | 'not_confirmed' | 'not_allowed';
 type AuthSubmissionSuccess = {
     status: 'success';
     message: string;
@@ -4926,7 +4926,7 @@ type APIEndpoints = {
             referer?: string;
             path?: string;
             honeypot?: string;
-            turnstileToken?: string | null;
+            altchaSolution?: string | null;
         };
     }, never, {
         ok: boolean;
@@ -6250,10 +6250,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') */
@@ -6271,6 +6278,104 @@ 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;
+    /**
+     * Path to prebuild cache directory.
+     * If set, enables prebuild fallback when live + stale cache both fail.
+     * @example '.riverbank-cache'
+     */
+    prebuildDir?: string;
+    /**
+     * Maximum age in seconds for prebuild cache.
+     * Prebuilds older than this are rejected.
+     * @default 86400 (24 hours)
+     */
+    maxPrebuildAgeSec?: number;
+    /** 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
  */
@@ -6302,6 +6407,10 @@ interface RiverbankClientConfig {
          */
         maxSize?: number;
     };
+    /**
+     * Resilience configuration for error handling, retries, and fallbacks
+     */
+    resilience?: ResilienceConfig;
 }
 /**
  * Riverbank CMS client interface
@@ -6314,7 +6423,7 @@ interface RiverbankClient {
         slug?: string;
         domain?: string;
         id?: string;
-    }): Promise<SiteResponse>;
+    } & SdkMethodOptions): Promise<SiteResponse>;
     /**
      * Fetch a specific page by path
      *
@@ -6324,7 +6433,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
      *
@@ -6385,20 +6494,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)
      */
@@ -6408,7 +6517,7 @@ interface RiverbankClient {
         from?: string;
         to?: string;
         stage?: string;
-    }): Promise<PublicEventsResponse>;
+    } & SdkMethodOptions): Promise<PublicEventsResponse>;
     /**
      * Resolve an event occurrence by URL segment (date or UUID)
      *
@@ -6437,7 +6546,7 @@ interface RiverbankClient {
         siteId: string;
         entryId: string;
         segment: string;
-    }): Promise<ResolveEventOccurrenceResponse>;
+    } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
     /**
      * Check if a path has a configured redirect rule
      *
@@ -6458,11 +6567,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;
 }
 
 /**

package/dist/server/{Layout-wBtJLTVX.d.ts → Layout-Yluyb6sK.d.ts}

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { buildMenu, buildLogo } from './navigation.js';
-import { S as SiteResponse, R as RiverbankClient } from './types-BvcJU7zk.js';
+import { S as SiteResponse, R as RiverbankClient } from './types-BRQyLrQU.js';
 
 type HeaderData = {
     menu: ReturnType<typeof buildMenu>;

package/dist/server/{Layout-B7cvis7r.d.mts → Layout-qWLdVm5-.d.mts}

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { buildMenu, buildLogo } from './navigation.mjs';
-import { S as SiteResponse, R as RiverbankClient } from './types-1cLz0vnq.mjs';
+import { S as SiteResponse, R as RiverbankClient } from './types-C-LShyIg.mjs';
 
 type HeaderData = {
     menu: ReturnType<typeof buildMenu>;

package/dist/server/chunk-2IZ6S225.js

@@ -0,0 +1,122 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/env.ts
+var RiverbankEnvError = class extends Error {
+  constructor(message, missingVars) {
+    super(message);
+    this.missingVars = missingVars;
+    this.name = "RiverbankEnvError";
+  }
+};
+function getEnvPrefix(target) {
+  return target === "remote" ? "RIVERBANK_REMOTE" : "RIVERBANK_LOCAL";
+}
+function detectTarget() {
+  const env = _optionalChain([process, 'access', _ => _.env, 'access', _2 => _2.RIVERBANK_ENV, 'optionalAccess', _3 => _3.toLowerCase, 'call', _4 => _4()]);
+  if (env === "remote" || env === "production" || env === "prod") {
+    return "remote";
+  }
+  return "local";
+}
+function detectPreviewMode() {
+  const previewMode = process.env.RIVERBANK_PREVIEW_MODE;
+  if (previewMode !== void 0 && previewMode !== "") {
+    return previewMode === "true";
+  }
+  const previewLegacy = process.env.RIVERBANK_PREVIEW;
+  if (previewLegacy !== void 0 && previewLegacy !== "") {
+    return previewLegacy === "true";
+  }
+  return process.env.VERCEL_ENV === "preview";
+}
+function validateKeyType(key, expectedType) {
+  const isPreviewKey = key.startsWith("bld_preview_sk_");
+  const isContentKey = key.startsWith("bld_live_sk_");
+  if (expectedType === "preview" && !isPreviewKey) {
+    if (isContentKey) {
+      throw new RiverbankEnvError(
+        `Preview mode is enabled (RIVERBANK_PREVIEW_MODE=true) but a content key was provided. Preview mode requires a preview API key (bld_preview_sk_...) to access draft content. Either:
+  1. Set RIVERBANK_*_PREVIEW_API_KEY with your preview key, or
+  2. Set RIVERBANK_PREVIEW_MODE=false to fetch published content instead.`,
+        []
+      );
+    }
+    throw new RiverbankEnvError(
+      `Invalid API key format for preview mode. Expected key starting with bld_preview_sk_`,
+      []
+    );
+  }
+  if (expectedType === "content" && !isContentKey) {
+    if (isPreviewKey) {
+      console.debug(
+        "[getRiverbankEnv] Using preview key for published content. Consider using a content key (bld_live_sk_...) for production."
+      );
+      return;
+    }
+    throw new RiverbankEnvError(
+      `Invalid API key format for content access. Expected key starting with bld_live_sk_ or bld_preview_sk_`,
+      []
+    );
+  }
+}
+function isPreviewMode() {
+  return detectPreviewMode();
+}
+function getRiverbankTarget() {
+  return detectTarget();
+}
+function getRiverbankEnv() {
+  const target = detectTarget();
+  const previewMode = detectPreviewMode();
+  const prefix = getEnvPrefix(target);
+  const siteId = process.env[`${prefix}_SITE_ID`];
+  const dashboardUrl = process.env[`${prefix}_DASHBOARD_URL`];
+  const contentKey = process.env[`${prefix}_API_KEY`];
+  const previewKey = process.env[`${prefix}_PREVIEW_API_KEY`];
+  const missingVars = [];
+  if (!siteId) missingVars.push(`${prefix}_SITE_ID`);
+  if (!dashboardUrl) missingVars.push(`${prefix}_DASHBOARD_URL`);
+  let apiKey;
+  let keyType;
+  if (previewMode) {
+    apiKey = previewKey;
+    keyType = "preview";
+    if (!apiKey) {
+      missingVars.push(`${prefix}_PREVIEW_API_KEY`);
+    }
+  } else {
+    apiKey = contentKey || previewKey;
+    keyType = contentKey ? "content" : "preview";
+    if (!apiKey) {
+      missingVars.push(`${prefix}_API_KEY`);
+    }
+  }
+  if (missingVars.length > 0) {
+    throw new RiverbankEnvError(
+      `Missing required environment variables for Riverbank SDK:
+` + missingVars.map((v) => `  - ${v}`).join("\n") + `
+
+Current settings: RIVERBANK_ENV=${process.env.RIVERBANK_ENV || "local"}, RIVERBANK_PREVIEW_MODE=${process.env.RIVERBANK_PREVIEW_MODE || "false"}`,
+      missingVars
+    );
+  }
+  validateKeyType(apiKey, keyType);
+  let baseUrl = dashboardUrl;
+  if (!baseUrl.endsWith("/api")) {
+    baseUrl = baseUrl.replace(/\/$/, "") + "/api";
+  }
+  return {
+    target,
+    previewMode,
+    siteId,
+    baseUrl,
+    apiKey,
+    keyType
+  };
+}
+
+
+
+
+
+
+exports.RiverbankEnvError = RiverbankEnvError; exports.isPreviewMode = isPreviewMode; exports.getRiverbankTarget = getRiverbankTarget; exports.getRiverbankEnv = getRiverbankEnv;
+//# sourceMappingURL=chunk-2IZ6S225.js.map

package/dist/server/chunk-2IZ6S225.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-2IZ6S225.js","../../src/env.ts"],"names":[],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-2IZ6S225.js","sourcesContent":[null,"/**\n * Environment detection utilities for SDK\n *\n * Provides helpers for detecting preview mode and auto-selecting the correct API key.\n *\n * @example\n * ```ts\n * import { getRiverbankEnv } from '@riverbankcms/sdk/env';\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n *\n * const env = getRiverbankEnv();\n * const client = createRiverbankClient({\n *   apiKey: env.apiKey,\n *   baseUrl: env.baseUrl,\n * });\n * ```\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Environment target: 'local' for development, 'remote' for production\n */\nexport type RiverbankEnvTarget = 'local' | 'remote';\n\n/**\n * Runtime environment configuration\n */\nexport interface RiverbankEnvConfig {\n  /** The detected environment target */\n  target: RiverbankEnvTarget;\n  /** Whether preview mode is enabled */\n  previewMode: boolean;\n  /** Site ID */\n  siteId: string;\n  /** Dashboard/API base URL */\n  baseUrl: string;\n  /** The auto-selected API key (preview or content key based on mode) */\n  apiKey: string;\n  /** The type of key being used */\n  keyType: 'preview' | 'content';\n}\n\n/**\n * Error thrown when required environment variables are missing\n */\nexport class RiverbankEnvError extends Error {\n  constructor(\n    message: string,\n    public readonly missingVars: string[]\n  ) {\n    super(message);\n    this.name = 'RiverbankEnvError';\n  }\n}\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\n/**\n * Get the environment variable prefix based on target\n */\nfunction getEnvPrefix(target: RiverbankEnvTarget): string {\n  return target === 'remote' ? 'RIVERBANK_REMOTE' : 'RIVERBANK_LOCAL';\n}\n\n/**\n * Detect the environment target from RIVERBANK_ENV\n */\nfunction detectTarget(): RiverbankEnvTarget {\n  const env = process.env.RIVERBANK_ENV?.toLowerCase();\n  if (env === 'remote' || env === 'production' || env === 'prod') {\n    return 'remote';\n  }\n  return 'local';\n}\n\n/**\n * Detect if preview mode is enabled.\n * Uses RIVERBANK_PREVIEW_MODE first, then falls back to RIVERBANK_PREVIEW for backward compat.\n */\nfunction detectPreviewMode(): boolean {\n  // RIVERBANK_PREVIEW_MODE takes precedence (new convention)\n  const previewMode = process.env.RIVERBANK_PREVIEW_MODE;\n  if (previewMode !== undefined && previewMode !== '') {\n    return previewMode === 'true';\n  }\n\n  // Fall back to RIVERBANK_PREVIEW (backward compatibility)\n  const previewLegacy = process.env.RIVERBANK_PREVIEW;\n  if (previewLegacy !== undefined && previewLegacy !== '') {\n    return previewLegacy === 'true';\n  }\n\n  // Fall back to Vercel environment detection\n  return process.env.VERCEL_ENV === 'preview';\n}\n\n/**\n * Validate that an API key matches the expected format for its type\n */\nfunction validateKeyType(key: string, expectedType: 'preview' | 'content'): void {\n  const isPreviewKey = key.startsWith('bld_preview_sk_');\n  const isContentKey = key.startsWith('bld_live_sk_');\n\n  if (expectedType === 'preview' && !isPreviewKey) {\n    if (isContentKey) {\n      throw new RiverbankEnvError(\n        `Preview mode is enabled (RIVERBANK_PREVIEW_MODE=true) but a content key was provided. ` +\n          `Preview mode requires a preview API key (bld_preview_sk_...) to access draft content. ` +\n          `Either:\\n` +\n          `  1. Set RIVERBANK_*_PREVIEW_API_KEY with your preview key, or\\n` +\n          `  2. Set RIVERBANK_PREVIEW_MODE=false to fetch published content instead.`,\n        []\n      );\n    }\n    throw new RiverbankEnvError(\n      `Invalid API key format for preview mode. Expected key starting with bld_preview_sk_`,\n      []\n    );\n  }\n\n  if (expectedType === 'content' && !isContentKey) {\n    if (isPreviewKey) {\n      // This is actually fine - preview keys can access both draft and published content\n      // Just log a note that they could use a more restrictive key\n      console.debug(\n        '[getRiverbankEnv] Using preview key for published content. ' +\n          'Consider using a content key (bld_live_sk_...) for production.'\n      );\n      return;\n    }\n    throw new RiverbankEnvError(\n      `Invalid API key format for content access. Expected key starting with bld_live_sk_ or bld_preview_sk_`,\n      []\n    );\n  }\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Detects if the current environment is in preview mode.\n *\n * Precedence:\n * 1. RIVERBANK_PREVIEW_MODE env var (explicit override) - 'true' or 'false'\n * 2. RIVERBANK_PREVIEW env var (legacy) - 'true' or 'false'\n * 3. VERCEL_ENV === 'preview' (Vercel preview deployments)\n * 4. Default: false (production behavior)\n *\n * In preview mode:\n * - Draft content is visible\n * - ISR revalidation is more aggressive\n * - Cache bypass may be enabled\n *\n * @returns true if in preview mode, false otherwise\n */\nexport function isPreviewMode(): boolean {\n  return detectPreviewMode();\n}\n\n/**\n * Get the current environment target.\n *\n * This is a convenience function for checking `RIVERBANK_ENV`.\n *\n * @returns 'local' or 'remote'\n */\nexport function getRiverbankTarget(): RiverbankEnvTarget {\n  return detectTarget();\n}\n\n/**\n * Get runtime environment configuration with automatic API key selection.\n *\n * This helper reads environment variables and automatically selects the correct\n * API key based on the current environment and preview mode:\n *\n * - When `RIVERBANK_PREVIEW_MODE=true`: Uses preview API key (bld_preview_sk_...)\n * - When `RIVERBANK_PREVIEW_MODE=false` (default): Uses content API key (bld_live_sk_...)\n *\n * Environment variable patterns:\n * - `RIVERBANK_ENV`: 'local' (default) or 'remote'\n * - `RIVERBANK_PREVIEW_MODE`: 'true' or 'false' (default)\n * - `RIVERBANK_{LOCAL|REMOTE}_SITE_ID`: Site ID\n * - `RIVERBANK_{LOCAL|REMOTE}_DASHBOARD_URL`: Dashboard URL\n * - `RIVERBANK_{LOCAL|REMOTE}_API_KEY`: Content/live API key\n * - `RIVERBANK_{LOCAL|REMOTE}_PREVIEW_API_KEY`: Preview API key\n *\n * @returns Environment configuration with auto-selected API key\n * @throws {RiverbankEnvError} If required environment variables are missing\n *\n * @example\n * ```ts\n * // lib/builder-client.ts\n * import { getRiverbankEnv } from '@riverbankcms/sdk/env';\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n *\n * const env = getRiverbankEnv();\n *\n * export const client = createRiverbankClient({\n *   apiKey: env.apiKey,\n *   baseUrl: env.baseUrl,\n * });\n *\n * export const siteId = env.siteId;\n * ```\n */\nexport function getRiverbankEnv(): RiverbankEnvConfig {\n  const target = detectTarget();\n  const previewMode = detectPreviewMode();\n  const prefix = getEnvPrefix(target);\n\n  // Required vars\n  const siteId = process.env[`${prefix}_SITE_ID`];\n  const dashboardUrl = process.env[`${prefix}_DASHBOARD_URL`];\n\n  // API keys - pick based on preview mode\n  const contentKey = process.env[`${prefix}_API_KEY`];\n  const previewKey = process.env[`${prefix}_PREVIEW_API_KEY`];\n\n  // Collect missing required vars\n  const missingVars: string[] = [];\n  if (!siteId) missingVars.push(`${prefix}_SITE_ID`);\n  if (!dashboardUrl) missingVars.push(`${prefix}_DASHBOARD_URL`);\n\n  // Select the appropriate key\n  let apiKey: string | undefined;\n  let keyType: 'preview' | 'content';\n\n  if (previewMode) {\n    apiKey = previewKey;\n    keyType = 'preview';\n    if (!apiKey) {\n      missingVars.push(`${prefix}_PREVIEW_API_KEY`);\n    }\n  } else {\n    // For published content, prefer content key but allow preview key as fallback\n    apiKey = contentKey || previewKey;\n    keyType = contentKey ? 'content' : 'preview';\n    if (!apiKey) {\n      missingVars.push(`${prefix}_API_KEY`);\n    }\n  }\n\n  if (missingVars.length > 0) {\n    throw new RiverbankEnvError(\n      `Missing required environment variables for Riverbank SDK:\\n` +\n        missingVars.map((v) => `  - ${v}`).join('\\n') +\n        `\\n\\nCurrent settings: RIVERBANK_ENV=${process.env.RIVERBANK_ENV || 'local'}, ` +\n        `RIVERBANK_PREVIEW_MODE=${process.env.RIVERBANK_PREVIEW_MODE || 'false'}`,\n      missingVars\n    );\n  }\n\n  // Validate key type matches expected usage\n  validateKeyType(apiKey!, keyType);\n\n  // Construct base URL (ensure it ends with /api)\n  let baseUrl = dashboardUrl!;\n  if (!baseUrl.endsWith('/api')) {\n    baseUrl = baseUrl.replace(/\\/$/, '') + '/api';\n  }\n\n  return {\n    target,\n    previewMode,\n    siteId: siteId!,\n    baseUrl,\n    apiKey: apiKey!,\n    keyType,\n  };\n}\n"]}

package/dist/server/chunk-4CV4JOE5.js

@@ -0,0 +1,27 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+
+
+
+
+exports.__esm = __esm; exports.__export = __export; exports.__toCommonJS = __toCommonJS;
+//# sourceMappingURL=chunk-4CV4JOE5.js.map

package/dist/server/chunk-4CV4JOE5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-4CV4JOE5.js"],"names":[],"mappings":"AAAA,6EAAI,UAAU,EAAE,MAAM,CAAC,cAAc;AACrC,IAAI,iBAAiB,EAAE,MAAM,CAAC,wBAAwB;AACtD,IAAI,kBAAkB,EAAE,MAAM,CAAC,mBAAmB;AAClD,IAAI,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc;AAClD,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,SAAS,MAAM,CAAC,EAAE;AAC3C,EAAE,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;AACrE,CAAC;AACD,IAAI,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG;AAChC,EAAE,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG;AACtB,IAAI,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AACD,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;AAC9C,EAAE,GAAG,CAAC,KAAK,GAAG,OAAO,KAAK,IAAI,SAAS,GAAG,OAAO,KAAK,IAAI,UAAU,EAAE;AACtE,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;AAC3C,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,MAAM;AACvD,QAAQ,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;AAC1H,EAAE;AACF,EAAE,OAAO,EAAE;AACX,CAAC;AACD,IAAI,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;AAC1F;AACA;AACE;AACA;AACA;AACF,wFAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-4CV4JOE5.js"}