@riverbankcms/sdk 0.8.1 → 0.9.0

package/dist/server/prebuild-loader.d.ts

@@ -0,0 +1,87 @@
+import { NavigationCacheFile, FormsCacheFile, PrebuildManifest } from './prebuild-types.js';
+import { S as SiteResponse, P as PageResponse, G as GetEntriesBaseParams, E as EntriesResponse, c as EntriesResponseWithMeta } from './types-gKcrQV09.js';
+import './types-C4jfCjaP.js';
+import '@riverbankcms/ai';
+import './schema-DYtW0zEu.js';
+import 'zod';
+import './link-DjxLyC82.js';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+
+/**
+ * Prebuild cache loader
+ *
+ * Loads content from the prebuild cache at runtime as a last-resort fallback.
+ */
+
+interface PrebuildLoaderConfig {
+    /** Path to prebuild cache directory */
+    prebuildDir: string;
+    /** Maximum age in seconds for prebuild cache */
+    maxPrebuildAgeSec?: number;
+}
+interface LoadResult<T> {
+    /** Loaded data */
+    data: T;
+    /** Age of prebuild in seconds */
+    prebuildAgeSec: number;
+}
+/**
+ * Check if we're running in a Node.js environment with filesystem access.
+ * Edge runtimes (Vercel Edge, Cloudflare Workers) don't have fs access.
+ */
+declare function canUsePrebuild(): boolean;
+/**
+ * Loader for reading data from the prebuild cache.
+ *
+ * Used as a last-resort fallback when the CMS is unavailable and
+ * there's no cached data.
+ */
+declare class PrebuildLoader {
+    private readonly prebuildDir;
+    private readonly maxPrebuildAgeSec;
+    constructor(config: PrebuildLoaderConfig);
+    /**
+     * Check if prebuild is available and not expired.
+     */
+    isAvailable(): boolean;
+    /**
+     * Load site data from prebuild cache.
+     */
+    loadSite(siteId: string): LoadResult<SiteResponse> | null;
+    /**
+     * Load page data from prebuild cache.
+     */
+    loadPage(siteId: string, pagePath: string): LoadResult<PageResponse> | null;
+    /**
+     * Load entries from prebuild cache with runtime filtering.
+     *
+     * The prebuild stores ALL entries for each content type.
+     * Filtering, ordering, and pagination are applied at runtime.
+     */
+    loadEntries(siteId: string, params: GetEntriesBaseParams & {
+        includeMeta?: boolean;
+    }): LoadResult<EntriesResponse | EntriesResponseWithMeta> | null;
+    /**
+     * Load navigation data from prebuild cache.
+     */
+    loadNavigation(): LoadResult<NavigationCacheFile['menus']> | null;
+    /**
+     * Load forms data from prebuild cache.
+     */
+    loadForms(): LoadResult<FormsCacheFile['forms']> | null;
+    /**
+     * Get the manifest for inspection.
+     */
+    getManifest(): PrebuildManifest | null;
+    /**
+     * Clear the cached manifest (for testing).
+     */
+    clearCache(): void;
+}
+/**
+ * Create a prebuild loader instance.
+ */
+declare function createPrebuildLoader(config: PrebuildLoaderConfig): PrebuildLoader;
+
+export { type LoadResult, PrebuildLoader, type PrebuildLoaderConfig, canUsePrebuild, createPrebuildLoader };

package/dist/server/prebuild-loader.js

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkNTG7XP3Ejs = require('./chunk-NTG7XP3E.js');
+require('./chunk-PSN6HXUD.js');
+require('./chunk-Z6ZWNWWR.js');
+_chunkNTG7XP3Ejs.init_loader.call(void 0, );
+
+
+
+
+exports.PrebuildLoader = _chunkNTG7XP3Ejs.PrebuildLoader; exports.canUsePrebuild = _chunkNTG7XP3Ejs.canUsePrebuild; exports.createPrebuildLoader = _chunkNTG7XP3Ejs.createPrebuildLoader;
+//# sourceMappingURL=prebuild-loader.js.map

package/dist/server/prebuild-loader.js.map

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

package/dist/server/prebuild-loader.mjs

@@ -0,0 +1,15 @@
+import {
+  PrebuildLoader,
+  canUsePrebuild,
+  createPrebuildLoader,
+  init_loader
+} from "./chunk-PAHSKNY5.mjs";
+import "./chunk-AGAOKSPY.mjs";
+import "./chunk-WMJKH4XE.mjs";
+init_loader();
+export {
+  PrebuildLoader,
+  canUsePrebuild,
+  createPrebuildLoader
+};
+//# sourceMappingURL=prebuild-loader.mjs.map

package/dist/server/prebuild-loader.mjs.map

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

package/dist/server/prebuild-types.d.mts

@@ -0,0 +1,201 @@
+import { R as RiverbankClient, S as SiteResponse, P as PageResponse, E as EntriesResponse } from './types-CSvCkmYi.mjs';
+import { a as NavigationItemRecord } from './types-B6P_iaDz.mjs';
+import './schema-DYtW0zEu.mjs';
+import 'zod';
+import '@riverbankcms/ai';
+import './link-DjxLyC82.mjs';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+
+/**
+ * Types for prebuild cache functionality
+ *
+ * The prebuild cache generates static JSON files at build time that serve
+ * as a last-resort fallback when the CMS is unavailable.
+ */
+
+/**
+ * Content types that can be included in the prebuild cache.
+ */
+type PrebuildContentType = 'site' | 'pages' | 'entries' | 'navigation' | 'forms';
+/**
+ * Progress callback data for prebuild operations.
+ */
+interface PrebuildProgress {
+    /** Current item number (1-indexed) */
+    current: number;
+    /** Total items to process */
+    total: number;
+    /** Description of current item being processed */
+    item: string;
+    /** Content type being processed */
+    contentType: PrebuildContentType;
+}
+/**
+ * Options for the prebuildCache function.
+ */
+interface PrebuildOptions {
+    /** Configured Riverbank client */
+    client: RiverbankClient;
+    /** Site ID to prebuild */
+    siteId: string;
+    /** Output directory for prebuild cache (e.g., '.riverbank-cache') */
+    outputDir: string;
+    /** Content types to include (default: all) */
+    include?: PrebuildContentType[];
+    /** Filter entries to specific content types (default: all configured) */
+    contentTypes?: string[];
+    /** Gzip compress output files (default: false) */
+    compress?: boolean;
+    /** Progress callback fired during generation */
+    onProgress?: (progress: PrebuildProgress) => void;
+}
+/**
+ * Result from prebuildCache function.
+ */
+interface PrebuildResult {
+    /** Whether prebuild completed successfully */
+    success: boolean;
+    /** Output directory path */
+    outputDir: string;
+    /** List of generated files (relative to outputDir) */
+    files: string[];
+    /** Total size of all files in bytes */
+    totalSize: number;
+    /** ISO timestamp when prebuild was generated */
+    generatedAt: string;
+    /** SHA256 checksum of manifest for validation */
+    checksum: string;
+    /** Any errors encountered (partial success possible) */
+    errors?: string[];
+}
+/**
+ * Manifest file structure for prebuild cache.
+ */
+interface PrebuildManifest {
+    /** Manifest version for compatibility checking */
+    version: string;
+    /** ISO timestamp when prebuild was generated */
+    generatedAt: string;
+    /** SHA256 checksum of manifest contents (excluding checksum field) */
+    checksum: string;
+    /** Site ID this prebuild is for */
+    siteId: string;
+    /** SDK version used to generate prebuild */
+    sdkVersion: string;
+    /** Mapping of cache keys to file paths */
+    keyToFile: Record<string, string>;
+    /** Content types included in this prebuild */
+    includedTypes: PrebuildContentType[];
+    /** Total number of files generated */
+    fileCount: number;
+    /** Total size in bytes */
+    totalSize: number;
+}
+/**
+ * Site cache file structure.
+ */
+interface SiteCacheFile {
+    /** Site data */
+    data: SiteResponse;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Page index file structure (list of all pages).
+ */
+interface PageIndexFile {
+    /** List of page paths and IDs */
+    pages: Array<{
+        path: string;
+        pageId: string;
+        title: string;
+    }>;
+    /** Total count */
+    totalCount: number;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Individual page cache file structure.
+ */
+interface PageCacheFile {
+    /** Page data */
+    data: PageResponse;
+    /** Original path */
+    path: string;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Entries cache file structure (all entries for a content type).
+ */
+interface EntriesCacheFile {
+    /** All entries for this content type */
+    entries: EntriesResponse['entries'];
+    /** Content type slug */
+    contentType: string;
+    /** Total count of entries */
+    totalCount: number;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Navigation cache file structure.
+ */
+interface NavigationCacheFile {
+    /** Navigation menu data */
+    menus: Array<{
+        /** Menu identifier (used as lookup key) */
+        identifier: string | null;
+        /** Menu ID (fallback if no identifier) */
+        id: string;
+        /** Menu display name */
+        name: string;
+        /** Navigation items in this menu */
+        items: NavigationItemRecord[];
+    }>;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Forms cache file structure.
+ */
+interface FormsCacheFile {
+    /** All forms for this site */
+    forms: Array<{
+        /** Form ID */
+        id: string;
+        /** URL-friendly slug */
+        slug: string;
+        /** Form display name */
+        name: string;
+        /** Form schema (field definitions) */
+        schema: Record<string, unknown>;
+        /** Form settings */
+        settings: Record<string, unknown>;
+    }>;
+    /** Total count of forms */
+    totalCount: number;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Prebuild configuration for the SDK client.
+ * Added to ResilienceConfig.
+ */
+interface PrebuildConfig {
+    /**
+     * Path to prebuild cache directory.
+     * If set, enables prebuild fallback in resilient fetch.
+     */
+    prebuildDir?: string;
+    /**
+     * Maximum age in seconds for prebuild cache.
+     * Prebuilds older than this are rejected.
+     * @default 86400 (24 hours)
+     */
+    maxPrebuildAgeSec?: number;
+}
+
+export type { EntriesCacheFile, FormsCacheFile, NavigationCacheFile, PageCacheFile, PageIndexFile, PrebuildConfig, PrebuildContentType, PrebuildManifest, PrebuildOptions, PrebuildProgress, PrebuildResult, SiteCacheFile };

package/dist/server/prebuild-types.d.ts

@@ -0,0 +1,201 @@
+import { R as RiverbankClient, S as SiteResponse, P as PageResponse, E as EntriesResponse } from './types-gKcrQV09.js';
+import { a as NavigationItemRecord } from './types-C4jfCjaP.js';
+import './schema-DYtW0zEu.js';
+import 'zod';
+import '@riverbankcms/ai';
+import './link-DjxLyC82.js';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+
+/**
+ * Types for prebuild cache functionality
+ *
+ * The prebuild cache generates static JSON files at build time that serve
+ * as a last-resort fallback when the CMS is unavailable.
+ */
+
+/**
+ * Content types that can be included in the prebuild cache.
+ */
+type PrebuildContentType = 'site' | 'pages' | 'entries' | 'navigation' | 'forms';
+/**
+ * Progress callback data for prebuild operations.
+ */
+interface PrebuildProgress {
+    /** Current item number (1-indexed) */
+    current: number;
+    /** Total items to process */
+    total: number;
+    /** Description of current item being processed */
+    item: string;
+    /** Content type being processed */
+    contentType: PrebuildContentType;
+}
+/**
+ * Options for the prebuildCache function.
+ */
+interface PrebuildOptions {
+    /** Configured Riverbank client */
+    client: RiverbankClient;
+    /** Site ID to prebuild */
+    siteId: string;
+    /** Output directory for prebuild cache (e.g., '.riverbank-cache') */
+    outputDir: string;
+    /** Content types to include (default: all) */
+    include?: PrebuildContentType[];
+    /** Filter entries to specific content types (default: all configured) */
+    contentTypes?: string[];
+    /** Gzip compress output files (default: false) */
+    compress?: boolean;
+    /** Progress callback fired during generation */
+    onProgress?: (progress: PrebuildProgress) => void;
+}
+/**
+ * Result from prebuildCache function.
+ */
+interface PrebuildResult {
+    /** Whether prebuild completed successfully */
+    success: boolean;
+    /** Output directory path */
+    outputDir: string;
+    /** List of generated files (relative to outputDir) */
+    files: string[];
+    /** Total size of all files in bytes */
+    totalSize: number;
+    /** ISO timestamp when prebuild was generated */
+    generatedAt: string;
+    /** SHA256 checksum of manifest for validation */
+    checksum: string;
+    /** Any errors encountered (partial success possible) */
+    errors?: string[];
+}
+/**
+ * Manifest file structure for prebuild cache.
+ */
+interface PrebuildManifest {
+    /** Manifest version for compatibility checking */
+    version: string;
+    /** ISO timestamp when prebuild was generated */
+    generatedAt: string;
+    /** SHA256 checksum of manifest contents (excluding checksum field) */
+    checksum: string;
+    /** Site ID this prebuild is for */
+    siteId: string;
+    /** SDK version used to generate prebuild */
+    sdkVersion: string;
+    /** Mapping of cache keys to file paths */
+    keyToFile: Record<string, string>;
+    /** Content types included in this prebuild */
+    includedTypes: PrebuildContentType[];
+    /** Total number of files generated */
+    fileCount: number;
+    /** Total size in bytes */
+    totalSize: number;
+}
+/**
+ * Site cache file structure.
+ */
+interface SiteCacheFile {
+    /** Site data */
+    data: SiteResponse;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Page index file structure (list of all pages).
+ */
+interface PageIndexFile {
+    /** List of page paths and IDs */
+    pages: Array<{
+        path: string;
+        pageId: string;
+        title: string;
+    }>;
+    /** Total count */
+    totalCount: number;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Individual page cache file structure.
+ */
+interface PageCacheFile {
+    /** Page data */
+    data: PageResponse;
+    /** Original path */
+    path: string;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Entries cache file structure (all entries for a content type).
+ */
+interface EntriesCacheFile {
+    /** All entries for this content type */
+    entries: EntriesResponse['entries'];
+    /** Content type slug */
+    contentType: string;
+    /** Total count of entries */
+    totalCount: number;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Navigation cache file structure.
+ */
+interface NavigationCacheFile {
+    /** Navigation menu data */
+    menus: Array<{
+        /** Menu identifier (used as lookup key) */
+        identifier: string | null;
+        /** Menu ID (fallback if no identifier) */
+        id: string;
+        /** Menu display name */
+        name: string;
+        /** Navigation items in this menu */
+        items: NavigationItemRecord[];
+    }>;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Forms cache file structure.
+ */
+interface FormsCacheFile {
+    /** All forms for this site */
+    forms: Array<{
+        /** Form ID */
+        id: string;
+        /** URL-friendly slug */
+        slug: string;
+        /** Form display name */
+        name: string;
+        /** Form schema (field definitions) */
+        schema: Record<string, unknown>;
+        /** Form settings */
+        settings: Record<string, unknown>;
+    }>;
+    /** Total count of forms */
+    totalCount: number;
+    /** When this was generated */
+    generatedAt: string;
+}
+/**
+ * Prebuild configuration for the SDK client.
+ * Added to ResilienceConfig.
+ */
+interface PrebuildConfig {
+    /**
+     * Path to prebuild cache directory.
+     * If set, enables prebuild fallback in resilient fetch.
+     */
+    prebuildDir?: string;
+    /**
+     * Maximum age in seconds for prebuild cache.
+     * Prebuilds older than this are rejected.
+     * @default 86400 (24 hours)
+     */
+    maxPrebuildAgeSec?: number;
+}
+
+export type { EntriesCacheFile, FormsCacheFile, NavigationCacheFile, PageCacheFile, PageIndexFile, PrebuildConfig, PrebuildContentType, PrebuildManifest, PrebuildOptions, PrebuildProgress, PrebuildResult, SiteCacheFile };

package/dist/server/prebuild-types.js

@@ -0,0 +1 @@
+"use strict";//# sourceMappingURL=prebuild-types.js.map

package/dist/server/prebuild-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/prebuild-types.js"],"names":[],"mappings":"AAAA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/prebuild-types.js"}

package/dist/server/prebuild-types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=prebuild-types.mjs.map

package/dist/server/prebuild-types.mjs.map

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

package/dist/server/prebuild.d.mts

@@ -0,0 +1,46 @@
+import { PrebuildOptions, PrebuildResult } from './prebuild-types.mjs';
+export { PrebuildContentType, PrebuildManifest, PrebuildProgress } from './prebuild-types.mjs';
+import './types-CSvCkmYi.mjs';
+import './types-B6P_iaDz.mjs';
+import '@riverbankcms/ai';
+import './schema-DYtW0zEu.mjs';
+import 'zod';
+import './link-DjxLyC82.mjs';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+
+/**
+ * Prebuild cache generation
+ *
+ * Exports static content at build time for use as a last-resort fallback
+ * when the CMS is unavailable.
+ */
+
+/**
+ * Generate a prebuild cache for the specified site.
+ *
+ * The prebuild cache contains static JSON files that can serve as a
+ * last-resort fallback when the CMS is unavailable.
+ *
+ * @param options - Prebuild configuration
+ * @returns Result with generated files and metadata
+ *
+ * @example
+ * ```typescript
+ * import { createRiverbankClient, prebuildCache } from '@riverbankcms/sdk';
+ *
+ * const client = createRiverbankClient({ apiKey, baseUrl });
+ *
+ * const result = await prebuildCache({
+ *   client,
+ *   siteId: 'your-site-id',
+ *   outputDir: '.riverbank-cache',
+ *   onProgress: (p) => console.log(`${p.current}/${p.total}: ${p.item}`),
+ * });
+ *
+ * console.log(`Generated ${result.files.length} files (${result.totalSize} bytes)`);
+ * ```
+ */
+declare function prebuildCache(options: PrebuildOptions): Promise<PrebuildResult>;
+
+export { PrebuildOptions, PrebuildResult, prebuildCache };

package/dist/server/prebuild.d.ts

@@ -0,0 +1,46 @@
+import { PrebuildOptions, PrebuildResult } from './prebuild-types.js';
+export { PrebuildContentType, PrebuildManifest, PrebuildProgress } from './prebuild-types.js';
+import './types-gKcrQV09.js';
+import './types-C4jfCjaP.js';
+import '@riverbankcms/ai';
+import './schema-DYtW0zEu.js';
+import 'zod';
+import './link-DjxLyC82.js';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+
+/**
+ * Prebuild cache generation
+ *
+ * Exports static content at build time for use as a last-resort fallback
+ * when the CMS is unavailable.
+ */
+
+/**
+ * Generate a prebuild cache for the specified site.
+ *
+ * The prebuild cache contains static JSON files that can serve as a
+ * last-resort fallback when the CMS is unavailable.
+ *
+ * @param options - Prebuild configuration
+ * @returns Result with generated files and metadata
+ *
+ * @example
+ * ```typescript
+ * import { createRiverbankClient, prebuildCache } from '@riverbankcms/sdk';
+ *
+ * const client = createRiverbankClient({ apiKey, baseUrl });
+ *
+ * const result = await prebuildCache({
+ *   client,
+ *   siteId: 'your-site-id',
+ *   outputDir: '.riverbank-cache',
+ *   onProgress: (p) => console.log(`${p.current}/${p.total}: ${p.item}`),
+ * });
+ *
+ * console.log(`Generated ${result.files.length} files (${result.totalSize} bytes)`);
+ * ```
+ */
+declare function prebuildCache(options: PrebuildOptions): Promise<PrebuildResult>;
+
+export { PrebuildOptions, PrebuildResult, prebuildCache };

package/dist/server/prebuild.js

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk274Y2CUEjs = require('./chunk-274Y2CUE.js');
+require('./chunk-7WJGJY3B.js');
+require('./chunk-PSN6HXUD.js');
+require('./chunk-Z6ZWNWWR.js');
+
+
+exports.prebuildCache = _chunk274Y2CUEjs.prebuildCache;
+//# sourceMappingURL=prebuild.js.map

package/dist/server/prebuild.js.map

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

package/dist/server/prebuild.mjs

@@ -0,0 +1,10 @@
+import {
+  prebuildCache
+} from "./chunk-SVEQVEA5.mjs";
+import "./chunk-WWGVFOLS.mjs";
+import "./chunk-AGAOKSPY.mjs";
+import "./chunk-WMJKH4XE.mjs";
+export {
+  prebuildCache
+};
+//# sourceMappingURL=prebuild.mjs.map

package/dist/server/prebuild.mjs.map

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

package/dist/server/rendering/server.d.mts

@@ -1,10 +1,10 @@
-export { b as Page, P as PageProps } from '../loadPage-DiHEl8BA.mjs';
-export { H as HeaderData, L as Layout, a as LayoutProps } from '../Layout-ESG8zvrk.mjs';
+export { b as Page, P as PageProps } from '../loadPage-B578Xg2W.mjs';
+export { H as HeaderData, L as Layout, a as LayoutProps } from '../Layout-CXkMcTR4.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { T as Theme } from '../types-BAM1kcGA.mjs';
+import { T as Theme } from '../types-B6P_iaDz.mjs';
 import '../schema-DYtW0zEu.mjs';
-import { R as RiverbankClient } from '../types-DDNKxQXw.mjs';
+import { R as RiverbankClient } from '../types-CSvCkmYi.mjs';
 import { B as BlockKind } from '../blockKinds-B6MWzNWp.mjs';
 import '../core-DsNWrl3o.mjs';
 import 'zod';