@riverbankcms/sdk 0.7.5 → 0.8.0

package/dist/server/server.d.ts

@@ -1,10 +1,10 @@
-export { c as createRiverbankClient } from './index-DLvNddi-.js';
-export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-BRQyLrQU.js';
-export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-BmYJCe_V.js';
-export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-D7LQwI0o.js';
+export { c as createRiverbankClient } from './index-BxrAuL9K.js';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-D0rPF8l5.js';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-BZohBxxf.js';
+export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-DECnsp4k.js';
 import './schema-Z6-afHJG.js';
 import 'zod';
-import './types-Dt98DeYa.js';
+import './types-CgSO0yxg.js';
 import '@riverbankcms/ai';
 import './link-DjxLyC82.js';
 import '@riverbankcms/media-storage-supabase';

package/dist/server/server.js

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkKH3EXBJMjs = require('./chunk-KH3EXBJM.js');
+var _chunkWM646WI3js = require('./chunk-WM646WI3.js');
 
 
 var _chunkP3NNN73Gjs = require('./chunk-P3NNN73G.js');
@@ -19,5 +19,5 @@ require('./chunk-4CV4JOE5.js');
 
 
 
-exports.createRiverbankClient = _chunkKH3EXBJMjs.createRiverbankClient; exports.isEntryContent = _chunkEIJ27EZQjs.isEntryContent; exports.isPageContent = _chunkEIJ27EZQjs.isPageContent; exports.loadContent = _chunkEIJ27EZQjs.loadContent; exports.loadPage = _chunkP3NNN73Gjs.loadPage;
+exports.createRiverbankClient = _chunkWM646WI3js.createRiverbankClient; exports.isEntryContent = _chunkEIJ27EZQjs.isEntryContent; exports.isPageContent = _chunkEIJ27EZQjs.isPageContent; exports.loadContent = _chunkEIJ27EZQjs.loadContent; exports.loadPage = _chunkP3NNN73Gjs.loadPage;
 //# sourceMappingURL=server.js.map

package/dist/server/server.mjs

@@ -1,6 +1,6 @@
 import {
   createRiverbankClient
-} from "./chunk-2NBNOY3C.mjs";
+} from "./chunk-65A5HAUZ.mjs";
 import {
   loadPage
 } from "./chunk-C6FIJC7T.mjs";

package/dist/server/{types-C-LShyIg.d.mts → types-BRQ_6yOc.d.mts}

@@ -1,4 +1,4 @@
-import { A as APIEndpoints } from './types-BSV6Vc-P.mjs';
+import { A as APIEndpoints } from './types-DT30Qy7x.mjs';
 import './schema-Z6-afHJG.mjs';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
@@ -10,6 +10,7 @@ type PublicBookingServicesResponse = NonNullable<APIEndpoints['getPublicBookingS
 type PublicEventsResponse = NonNullable<APIEndpoints['listPublicEvents']['response']>;
 type ResolveEventOccurrenceResponse = NonNullable<APIEndpoints['resolveEventOccurrence']['response']>;
 type CheckRedirectResponse = NonNullable<APIEndpoints['checkRedirect']['response']>;
+type RoutableContentResponse = NonNullable<APIEndpoints['getRoutableContent']['response']>;
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -159,6 +160,13 @@ interface ResilienceConfig {
     /** Callback fired only when transitioning into/out of degraded mode */
     onDegradedMode?: (degraded: boolean, status: ResilienceStatus) => void;
 }
+/**
+ * Type of API key based on prefix detection.
+ * - 'content': bld_live_sk_* or bld_test_sk_* (for published content)
+ * - 'preview': bld_preview_sk_* (for draft content)
+ * - 'unknown': Unrecognized prefix
+ */
+type ApiKeyType = 'content' | 'preview' | 'unknown';
 /**
  * Configuration for creating a Riverbank CMS client
  */
@@ -351,10 +359,44 @@ interface RiverbankClient {
         siteId: string;
         path: string;
     } & SdkMethodOptions): Promise<CheckRedirectResponse>;
+    /**
+     * Get all published routes for a site.
+     * Useful for static site generation (SSG) to enumerate all pages.
+     *
+     * @param params.siteId - The site ID
+     *
+     * @example
+     * ```ts
+     * const routes = await client.getAllPublishedRoutes({ siteId: 'site-id' });
+     * // routes.items contains all published pages and content entries with routes
+     * ```
+     */
+    getAllPublishedRoutes(params: {
+        siteId: string;
+    } & SdkMethodOptions): Promise<RoutableContentResponse>;
     /**
      * Force clear the cache
      */
     clearCache(): void;
+    /**
+     * Get the detected API key type based on the key prefix.
+     *
+     * This allows SDK helpers like `createCatchAllPage` to automatically
+     * determine whether to fetch preview or published content based on
+     * which key the client was configured with.
+     *
+     * @returns The detected key type: 'content', 'preview', or 'unknown'
+     *
+     * @example
+     * ```ts
+     * const client = createRiverbankClient({ apiKey: 'bld_live_sk_...' });
+     * client.getKeyType(); // 'content'
+     *
+     * const previewClient = createRiverbankClient({ apiKey: 'bld_preview_sk_...' });
+     * previewClient.getKeyType(); // 'preview'
+     * ```
+     */
+    getKeyType(): ApiKeyType;
     /**
      * Get the status from the most recently emitted request
      *

package/dist/server/{types-BjgZt8xJ.d.mts → types-CJfJwcuL.d.mts}

@@ -503,6 +503,28 @@ interface SyncConfig {
      */
     contentTarget?: 'draft' | 'publish';
 }
+/**
+ * Deploy command configuration for automated deployment workflow.
+ *
+ * The deploy command automates the full deploy workflow:
+ * 1. Run verification (if configured)
+ * 2. Generate prebuild cache
+ * 3. Commit cache changes
+ * 4. Push to remote
+ */
+interface DeployConfig {
+    /**
+     * Command to run for verification before deploy.
+     * If not set, verification step is skipped with a warning.
+     * @example 'pnpm verify'
+     */
+    verifyCommand?: string;
+    /**
+     * Directory where prebuild cache is output.
+     * @default '.riverbank-cache'
+     */
+    prebuildOutput?: string;
+}
 /**
  * Top-level SDK site configuration.
  *
@@ -673,6 +695,21 @@ interface RiverbankSiteConfig {
      * ```
      */
     sync?: SyncConfig;
+    /**
+     * Deploy command configuration.
+     *
+     * Configures the `riverbankcms deploy` command behavior for
+     * automated deployments with prebuild cache generation.
+     *
+     * @example
+     * ```typescript
+     * deploy: {
+     *   verifyCommand: 'pnpm verify',
+     *   prebuildOutput: '.riverbank-cache',
+     * }
+     * ```
+     */
+    deploy?: DeployConfig;
 }
 
 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 };

package/dist/server/{types-Dt98DeYa.d.ts → types-CgSO0yxg.d.ts}

@@ -2871,6 +2871,14 @@ type APIEndpoints = {
     }>;
     getRoutableContent: APIEndpoint<never, {
         siteId: string;
+        publishedOnly?: string;
+    }, {
+        items: RoutableContentItem[];
+    }>;
+    /** Public endpoint for SDK SSG - requires content API key */
+    getPublicRoutableContent: APIEndpoint<never, {
+        siteId: string;
+        publishedOnly?: string;
     }, {
         items: RoutableContentItem[];
     }>;

package/dist/server/{types-BRQyLrQU.d.ts → types-D0rPF8l5.d.ts}

@@ -1,4 +1,4 @@
-import { A as APIEndpoints } from './types-Dt98DeYa.js';
+import { A as APIEndpoints } from './types-CgSO0yxg.js';
 import './schema-Z6-afHJG.js';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
@@ -10,6 +10,7 @@ type PublicBookingServicesResponse = NonNullable<APIEndpoints['getPublicBookingS
 type PublicEventsResponse = NonNullable<APIEndpoints['listPublicEvents']['response']>;
 type ResolveEventOccurrenceResponse = NonNullable<APIEndpoints['resolveEventOccurrence']['response']>;
 type CheckRedirectResponse = NonNullable<APIEndpoints['checkRedirect']['response']>;
+type RoutableContentResponse = NonNullable<APIEndpoints['getRoutableContent']['response']>;
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -159,6 +160,13 @@ interface ResilienceConfig {
     /** Callback fired only when transitioning into/out of degraded mode */
     onDegradedMode?: (degraded: boolean, status: ResilienceStatus) => void;
 }
+/**
+ * Type of API key based on prefix detection.
+ * - 'content': bld_live_sk_* or bld_test_sk_* (for published content)
+ * - 'preview': bld_preview_sk_* (for draft content)
+ * - 'unknown': Unrecognized prefix
+ */
+type ApiKeyType = 'content' | 'preview' | 'unknown';
 /**
  * Configuration for creating a Riverbank CMS client
  */
@@ -351,10 +359,44 @@ interface RiverbankClient {
         siteId: string;
         path: string;
     } & SdkMethodOptions): Promise<CheckRedirectResponse>;
+    /**
+     * Get all published routes for a site.
+     * Useful for static site generation (SSG) to enumerate all pages.
+     *
+     * @param params.siteId - The site ID
+     *
+     * @example
+     * ```ts
+     * const routes = await client.getAllPublishedRoutes({ siteId: 'site-id' });
+     * // routes.items contains all published pages and content entries with routes
+     * ```
+     */
+    getAllPublishedRoutes(params: {
+        siteId: string;
+    } & SdkMethodOptions): Promise<RoutableContentResponse>;
     /**
      * Force clear the cache
      */
     clearCache(): void;
+    /**
+     * Get the detected API key type based on the key prefix.
+     *
+     * This allows SDK helpers like `createCatchAllPage` to automatically
+     * determine whether to fetch preview or published content based on
+     * which key the client was configured with.
+     *
+     * @returns The detected key type: 'content', 'preview', or 'unknown'
+     *
+     * @example
+     * ```ts
+     * const client = createRiverbankClient({ apiKey: 'bld_live_sk_...' });
+     * client.getKeyType(); // 'content'
+     *
+     * const previewClient = createRiverbankClient({ apiKey: 'bld_preview_sk_...' });
+     * previewClient.getKeyType(); // 'preview'
+     * ```
+     */
+    getKeyType(): ApiKeyType;
     /**
      * Get the status from the most recently emitted request
      *

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

@@ -503,6 +503,28 @@ interface SyncConfig {
      */
     contentTarget?: 'draft' | 'publish';
 }
+/**
+ * Deploy command configuration for automated deployment workflow.
+ *
+ * The deploy command automates the full deploy workflow:
+ * 1. Run verification (if configured)
+ * 2. Generate prebuild cache
+ * 3. Commit cache changes
+ * 4. Push to remote
+ */
+interface DeployConfig {
+    /**
+     * Command to run for verification before deploy.
+     * If not set, verification step is skipped with a warning.
+     * @example 'pnpm verify'
+     */
+    verifyCommand?: string;
+    /**
+     * Directory where prebuild cache is output.
+     * @default '.riverbank-cache'
+     */
+    prebuildOutput?: string;
+}
 /**
  * Top-level SDK site configuration.
  *
@@ -673,6 +695,21 @@ interface RiverbankSiteConfig {
      * ```
      */
     sync?: SyncConfig;
+    /**
+     * Deploy command configuration.
+     *
+     * Configures the `riverbankcms deploy` command behavior for
+     * automated deployments with prebuild cache generation.
+     *
+     * @example
+     * ```typescript
+     * deploy: {
+     *   verifyCommand: 'pnpm verify',
+     *   prebuildOutput: '.riverbank-cache',
+     * }
+     * ```
+     */
+    deploy?: DeployConfig;
 }
 
 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 };

package/dist/server/{types-BSV6Vc-P.d.mts → types-DT30Qy7x.d.mts}

@@ -2871,6 +2871,14 @@ type APIEndpoints = {
     }>;
     getRoutableContent: APIEndpoint<never, {
         siteId: string;
+        publishedOnly?: string;
+    }, {
+        items: RoutableContentItem[];
+    }>;
+    /** Public endpoint for SDK SSG - requires content API key */
+    getPublicRoutableContent: APIEndpoint<never, {
+        siteId: string;
+        publishedOnly?: string;
     }, {
         items: RoutableContentItem[];
     }>;

package/dist/server/{validation-DU2YE7u5.d.ts → validation-D1LaY1kQ.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { S as SdkCustomBlock } from './schema-Z6-afHJG.js';
-import { a as ContentConfig, C as ContentTypeConfig, R as RiverbankSiteConfig, j as BlockFieldOptionsMap, k as BlockFieldExtension, l as BlockFieldExtensionsMap, q as SyncConfig } from './types-DLBhEPSt.js';
+import { a as ContentConfig, C as ContentTypeConfig, R as RiverbankSiteConfig, j as BlockFieldOptionsMap, k as BlockFieldExtension, l as BlockFieldExtensionsMap, q as SyncConfig } from './types-D8XqwoVd.js';
 
 /**
  * SDK Content Config Validation

package/dist/server/{validation-BGuRo8P1.d.mts → validation-Pv3Zs6dP.d.mts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { S as SdkCustomBlock } from './schema-Z6-afHJG.mjs';
-import { a as ContentConfig, C as ContentTypeConfig, R as RiverbankSiteConfig, j as BlockFieldOptionsMap, k as BlockFieldExtension, l as BlockFieldExtensionsMap, q as SyncConfig } from './types-BjgZt8xJ.mjs';
+import { a as ContentConfig, C as ContentTypeConfig, R as RiverbankSiteConfig, j as BlockFieldOptionsMap, k as BlockFieldExtension, l as BlockFieldExtensionsMap, q as SyncConfig } from './types-CJfJwcuL.mjs';
 
 /**
  * SDK Content Config Validation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riverbankcms/sdk",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "description": "Riverbank CMS SDK for headless content consumption",
   "main": "./dist/server/index.js",
   "module": "./dist/server/index.mjs",
@@ -150,6 +150,7 @@
     "fast-deep-equal": "^3.1.3",
     "jiti": "^2.6.1",
     "prompts": "^2.4.2",
+    "simple-git": "^3.27.0",
     "zod": "^4.1.1"
   },
   "peerDependencies": {