@riverbankcms/sdk 0.4.0 → 0.4.2

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

@@ -16,6 +16,7 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.js';
  *
  * @example
  * ```typescript
+ * // Regular content type with multiple entries
  * {
  *   key: 'testimonial',
  *   name: 'Testimonial',
@@ -25,6 +26,17 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.js';
  *     { id: 'author', type: 'text', label: 'Author', required: true },
  *   ],
  * }
+ *
+ * // Singleton content type (only one entry allowed)
+ * {
+ *   key: 'site-settings',
+ *   name: 'Site Settings',
+ *   isSingleton: true,
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'contactEmail', type: 'text', label: 'Contact Email' },
+ *   ],
+ * }
  * ```
  */
 interface ContentTypeConfig {
@@ -36,12 +48,22 @@ interface ContentTypeConfig {
     description?: string;
     /** Whether entries of this type have routable pages */
     hasPages: boolean;
-    /** Route pattern with {slug} placeholder. Required if hasPages=true. */
+    /**
+     * Route pattern for routable content types. Required if hasPages=true.
+     * - For regular types: must include {slug} placeholder (e.g., '/blog/{slug}')
+     * - For singletons: can be a fixed path without {slug} (e.g., '/')
+     */
     routePattern?: string;
     /** Field definitions for this content type */
     fields: FieldDefinition[];
     /** Field ID to use as the entry title source */
     titleField?: string;
+    /**
+     * When true, only one entry can exist for this content type.
+     * The entry is auto-created when the content type is created.
+     * Use for homepage content, site-wide settings, etc.
+     */
+    isSingleton?: boolean;
 }
 /**
  * Block content for page scaffolding.

package/dist/server/{types-BuZJWVmj.d.mts → types-CbagRQ_7.d.mts}

@@ -55,6 +55,21 @@ interface DataLoaderContext {
     content: Record<string, unknown>;
     /** Whether fetching preview/draft content */
     previewStage: 'published' | 'preview';
+    /**
+     * URL search parameters from the page request.
+     * Use for pagination, filtering, or sorting based on URL params.
+     *
+     * Always defined (defaults to empty object if not provided to loadPage).
+     * This allows loaders to safely access properties without null checks.
+     *
+     * @example
+     * ```typescript
+     * const page = parseInt(searchParams?.page as string || '1', 10);
+     * const limit = parseInt(content.postsPerPage as string || '12', 10);
+     * const offset = (page - 1) * limit;
+     * ```
+     */
+    searchParams: Record<string, string | string[] | undefined>;
 }
 /**
  * A code-based data loader function.

package/dist/server/{types-BA-J9K8r.d.mts → types-CdrJqlKx.d.mts}

@@ -2320,15 +2320,20 @@ type DevToolsSeedResponse = {
         blocksCreated: number;
     };
 };
+type SiteInvitee = {
+    email: string;
+    role: 'editor' | 'administrator';
+};
 type CreateManualSiteRequest = {
     title: string;
+    deploymentMode?: 'managed' | 'headless_full';
     description?: string | null;
-    themeKey: string;
-    contentTypes: Array<'page' | 'post' | 'event' | 'testimonial'>;
-    scaffoldHome: boolean;
-    scaffoldContact: boolean;
-    scaffoldBlog: boolean;
-    invitees?: string[];
+    themeKey?: string;
+    contentTypes?: Array<'page' | 'post' | 'event' | 'testimonial'>;
+    scaffoldHome?: boolean;
+    scaffoldContact?: boolean;
+    scaffoldBlog?: boolean;
+    invitees?: SiteInvitee[];
 };
 type CreateManualSiteResponse = {
     siteId: string;
@@ -2346,6 +2351,10 @@ type CreateManualSiteResponse = {
         }>;
         contentTypes: Array<'page' | 'post' | 'event' | 'testimonial'>;
     };
+    invitations?: {
+        sent: number;
+        failed: number;
+    };
 };
 type APIEndpoints = {
     aiContentUpdateChat: APIEndpoint<{
@@ -3921,6 +3930,7 @@ type ContentTypeSummary = {
     hasPages: boolean;
     routePattern: string | null;
     isBuiltin: boolean;
+    isSingleton: boolean;
     createdAt: string;
     updatedAt: string;
 };
@@ -3934,6 +3944,7 @@ type CreateContentTypeRequest = {
     description?: string | null;
     schema: Record<string, unknown>;
     titleField?: string | null;
+    isSingleton?: boolean;
 };
 type UpdateContentTypeRequest = {
     name?: string;

package/dist/server/{types-BC9eB2KH.d.mts → types-DkKEctWn.d.mts}

@@ -1,4 +1,4 @@
-import { A as APIEndpoints } from './types-BA-J9K8r.mjs';
+import { A as APIEndpoints } from './types-CdrJqlKx.mjs';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
 type PageResponse = NonNullable<APIEndpoints['getContentByPath']['response']>;

package/dist/server/{types-DSFvXKhO.d.ts → types-DuQCNVV0.d.ts}

@@ -55,6 +55,21 @@ interface DataLoaderContext {
     content: Record<string, unknown>;
     /** Whether fetching preview/draft content */
     previewStage: 'published' | 'preview';
+    /**
+     * URL search parameters from the page request.
+     * Use for pagination, filtering, or sorting based on URL params.
+     *
+     * Always defined (defaults to empty object if not provided to loadPage).
+     * This allows loaders to safely access properties without null checks.
+     *
+     * @example
+     * ```typescript
+     * const page = parseInt(searchParams?.page as string || '1', 10);
+     * const limit = parseInt(content.postsPerPage as string || '12', 10);
+     * const offset = (page - 1) * limit;
+     * ```
+     */
+    searchParams: Record<string, string | string[] | undefined>;
 }
 /**
  * A code-based data loader function.

package/dist/server/{types-CAnC529E.d.ts → types-oCM-fw4O.d.ts}

@@ -1,4 +1,4 @@
-import { A as APIEndpoints } from './types-5XdVD2J1.js';
+import { A as APIEndpoints } from './types-BiRZnxDx.js';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
 type PageResponse = NonNullable<APIEndpoints['getContentByPath']['response']>;

package/dist/server/{types-CYfHxUhe.d.mts → types-txWsSxN7.d.mts}

@@ -16,6 +16,7 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.mjs';
  *
  * @example
  * ```typescript
+ * // Regular content type with multiple entries
  * {
  *   key: 'testimonial',
  *   name: 'Testimonial',
@@ -25,6 +26,17 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.mjs';
  *     { id: 'author', type: 'text', label: 'Author', required: true },
  *   ],
  * }
+ *
+ * // Singleton content type (only one entry allowed)
+ * {
+ *   key: 'site-settings',
+ *   name: 'Site Settings',
+ *   isSingleton: true,
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'contactEmail', type: 'text', label: 'Contact Email' },
+ *   ],
+ * }
  * ```
  */
 interface ContentTypeConfig {
@@ -36,12 +48,22 @@ interface ContentTypeConfig {
     description?: string;
     /** Whether entries of this type have routable pages */
     hasPages: boolean;
-    /** Route pattern with {slug} placeholder. Required if hasPages=true. */
+    /**
+     * Route pattern for routable content types. Required if hasPages=true.
+     * - For regular types: must include {slug} placeholder (e.g., '/blog/{slug}')
+     * - For singletons: can be a fixed path without {slug} (e.g., '/')
+     */
     routePattern?: string;
     /** Field definitions for this content type */
     fields: FieldDefinition[];
     /** Field ID to use as the entry title source */
     titleField?: string;
+    /**
+     * When true, only one entry can exist for this content type.
+     * The entry is auto-created when the content type is created.
+     * Use for homepage content, site-wide settings, etc.
+     */
+    isSingleton?: boolean;
 }
 /**
  * Block content for page scaffolding.

package/dist/server/{validation-C7W2Fe0i.d.ts → validation-CoU8uAiu.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
-import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-CMqVHYLG.js';
+import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-CL916r6x.js';
 
 /**
  * SDK Content Config Validation

package/dist/server/{validation-hg1sqhrt.d.mts → validation-DzvDwwRo.d.mts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { S as SdkCustomBlock } from './schema-Bpy9N5ZI.mjs';
-import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-CYfHxUhe.mjs';
+import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-txWsSxN7.mjs';
 
 /**
  * SDK Content Config Validation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riverbankcms/sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Riverbank CMS SDK for headless content consumption",
   "main": "./dist/server/index.js",
   "module": "./dist/server/index.mjs",

package/dist/server/chunk-BOHTTHY5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/config/validation.ts","../../src/config/content-validation.ts"],"sourcesContent":["/**\n * Zod validation schemas for SDK site configuration.\n *\n * These schemas are used to validate configuration fetched from\n * SDK sites before storing in the database.\n */\n\nimport { z } from 'zod';\nimport { blockCategoryEnum, fieldSchema, getBlockDefinition, type SdkCustomBlock, type FieldDefinition } from '@riverbankcms/blocks';\nimport type { RiverbankSiteConfig, BlockFieldOptionsMap, BlockFieldExtensionsMap, BlockFieldExtension } from './types';\nimport { contentConfigSchema } from './content-validation';\n\n// Re-export content schemas for convenience\nexport { contentConfigSchema } from './content-validation';\nexport type { ContentConfigInput, ContentConfigOutput } from './content-validation';\n\n/**\n * Schema for SDK theme palette.\n * Maps token names to CSS color values.\n */\nexport const sdkThemePaletteSchema = z.record(z.string(), z.string());\n\n/**\n * Schema for SDK theme configuration.\n */\nexport const sdkThemeConfigSchema = z.object({\n  palette: sdkThemePaletteSchema,\n});\n\n/**\n * Schema for section background color options.\n */\nexport const sectionBackgroundSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  token: z.string(), // Reference to theme palette token\n});\n\n/**\n * Schema for section spacing values.\n */\nexport const sectionSpacingSchema = z.enum(['compact', 'default', 'spacious']);\n\n/**\n * Schema for container max-width values.\n */\nexport const containerMaxWidthSchema = z.enum(['narrow', 'default', 'wide', 'full']);\n\n/**\n * Schema for container alignment values.\n */\nexport const containerAlignmentSchema = z.enum(['left', 'center', 'right']);\n\n/**\n * Schema for section options configuration.\n */\nexport const sectionOptionsSchema = z.object({\n  backgroundColor: z.boolean().optional(),\n  backgroundImage: z.boolean().optional(),\n  backgroundGradient: z.boolean().optional(),\n  spacing: z.union([\n    z.array(sectionSpacingSchema),\n    z.boolean(),\n  ]).optional(),\n  textColor: z.boolean().optional(),\n}).optional();\n\n/**\n * Schema for container options configuration.\n */\nexport const containerOptionsSchema = z.object({\n  maxWidth: z.union([\n    z.array(containerMaxWidthSchema),\n    z.boolean(),\n  ]).optional(),\n  alignment: z.union([\n    z.array(containerAlignmentSchema),\n    z.boolean(),\n  ]).optional(),\n}).optional();\n\n/**\n * Schema for site style configuration.\n */\nexport const siteStyleConfigSchema = z.object({\n  sectionBackgrounds: z.array(sectionBackgroundSchema).optional(),\n  sectionOptions: sectionOptionsSchema,\n  containerOptions: containerOptionsSchema,\n}).optional();\n\n// ============================================================================\n// Data Loader Schemas\n// ============================================================================\n\nimport { SUPPORTED_LOADER_ENDPOINTS } from '../data/prefetchBlockData';\n\n/**\n * Whitelisted endpoints for SDK data loaders.\n *\n * These are the only CMS endpoints that can be called from config-based loaders.\n * This ensures SDK sites can only access safe, read-only public endpoints.\n *\n * Derived from SUPPORTED_LOADER_ENDPOINTS - the single source of truth.\n */\nexport const sdkLoaderEndpointSchema = z.enum(SUPPORTED_LOADER_ENDPOINTS);\n\n/**\n * A binding expression for dynamic loader params.\n *\n * @example\n * ```typescript\n * { $bind: { from: 'content.categoryId' } }\n * { $bind: { from: '$root.siteId' } }\n * { $bind: { from: 'content.limit', fallback: '10' } }\n * ```\n */\nexport const loaderParamBindingSchema = z.object({\n  $bind: z.object({\n    from: z.string().min(1, \"Binding path is required\"),\n    fallback: z.string().optional(),\n  }),\n});\n\n/**\n * A loader param value can be static or a binding expression.\n */\nexport const loaderParamValueSchema = z.union([\n  z.string(),\n  z.number(),\n  z.boolean(),\n  loaderParamBindingSchema,\n]);\n\n/**\n * Schema for config-based data loader.\n *\n * Config loaders execute server-side during loadPage() and are\n * restricted to whitelisted CMS endpoints.\n */\nexport const sdkConfigLoaderSchema = z.object({\n  endpoint: sdkLoaderEndpointSchema,\n  params: z.record(z.string(), loaderParamValueSchema),\n  mode: z.enum(['server', 'client']).default('server'),\n});\n\n/**\n * Schema for the dataLoaders field on custom blocks.\n * Validates the loader configuration and limits the number of loaders.\n */\nexport const sdkDataLoadersSchema = z.record(z.string(), sdkConfigLoaderSchema)\n  .refine(\n    (loaders) => Object.keys(loaders).length <= 5,\n    { message: \"Maximum 5 data loaders per block\" }\n  )\n  .optional();\n\n// ============================================================================\n// Custom Block Schema\n// ============================================================================\n\n/**\n * Schema for field select option.\n */\nexport const fieldSelectOptionSchema = z.object({\n  value: z.string().min(1, \"Option value is required\"),\n  label: z.string().min(1, \"Option label is required\"),\n});\n\n/**\n * Schema for per-field configuration within a block.\n */\nexport const blockFieldConfigSchema = z.object({\n  options: z.array(fieldSelectOptionSchema).min(1, \"At least one option is required\").optional(),\n});\n\n/**\n * Schema for per-block field options.\n *\n * Block IDs must be either 'block.*' (system blocks) or 'custom.*' (custom blocks).\n * Field IDs can be any valid identifier string.\n */\nexport const blockFieldOptionsSchema: z.ZodType<BlockFieldOptionsMap> = z.record(\n  z.string().regex(/^(block\\.|custom\\.)[a-z][a-z0-9-]*$/, {\n    message: \"Block ID must be 'block.*' or 'custom.*' format\",\n  }),\n  z.record(\n    z.string().min(1, \"Field ID is required\"),\n    blockFieldConfigSchema\n  )\n).optional() as z.ZodType<BlockFieldOptionsMap>;\n\n// ============================================================================\n// Block Field Extensions Schema\n// ============================================================================\n\n/**\n * Schema for block field extension configuration.\n *\n * Validates additional fields to be appended to a built-in block.\n * Includes refinement to ensure required fields have defaultValue.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const blockFieldExtensionSchema: z.ZodType<BlockFieldExtension> = z.object({\n  fields: fieldSchema.array().min(1, \"At least one field is required\"),\n}).refine(\n  (data) => {\n    // All required fields must have a defaultValue\n    return data.fields.every((field: FieldDefinition) => {\n      if (!field.required) return true;\n      return field.defaultValue !== undefined;\n    });\n  },\n  {\n    message: \"Required fields must have a defaultValue to support existing blocks\",\n  }\n) as z.ZodType<BlockFieldExtension>;\n\n/**\n * Schema for block field extensions map.\n *\n * Block IDs must be system blocks (e.g., 'block.bodyText', 'block.hero').\n * Custom blocks ('custom.*') should define their fields directly, not via extensions.\n */\nexport const blockFieldExtensionsSchema: z.ZodType<BlockFieldExtensionsMap | undefined> = z.record(\n  z.string().regex(/^block\\.[a-z][a-zA-Z0-9]*$/, {\n    message: \"Block ID must be 'block.*' format (system blocks only)\",\n  }),\n  blockFieldExtensionSchema\n).optional() as z.ZodType<BlockFieldExtensionsMap | undefined>;\n\n/**\n * Validates that extended field IDs don't conflict with existing block fields.\n *\n * This validation should be called during config push to provide clear error messages.\n * Returns an array of conflict errors, or empty array if valid.\n *\n * @example\n * ```typescript\n * const conflicts = validateFieldIdConflicts(config.blockFieldExtensions);\n * if (conflicts.length > 0) {\n *   throw new Error(conflicts.map(c => c.message).join('\\n'));\n * }\n * ```\n */\nexport function validateFieldIdConflicts(\n  blockFieldExtensions?: BlockFieldExtensionsMap | null\n): { blockId: string; fieldId: string; message: string }[] {\n  if (!blockFieldExtensions) return [];\n\n  const conflicts: { blockId: string; fieldId: string; message: string }[] = [];\n\n  for (const [blockId, extension] of Object.entries(blockFieldExtensions)) {\n    const definition = getBlockDefinition(blockId);\n    if (!definition) {\n      conflicts.push({\n        blockId,\n        fieldId: '',\n        message: `Unknown block type: ${blockId}`,\n      });\n      continue;\n    }\n\n    // Get all existing field IDs from the block manifest\n    const existingFieldIds = new Set<string>();\n    const collectFieldIds = (fields: FieldDefinition[] | undefined) => {\n      if (!fields) return;\n      for (const field of fields) {\n        existingFieldIds.add(field.id);\n        // Also collect nested field IDs from groups, modals, repeaters, tab groups\n        if (field.type === 'group' || field.type === 'modal') {\n          collectFieldIds(field.schema?.fields);\n        } else if (field.type === 'repeater' && field.schema?.fields) {\n          collectFieldIds(field.schema.fields);\n        } else if (field.type === 'tabGroup') {\n          for (const tab of field.tabs ?? []) {\n            collectFieldIds(tab.fields);\n          }\n        }\n      }\n    };\n    collectFieldIds(definition.manifest.fields);\n\n    // Check for conflicts\n    for (const field of extension.fields) {\n      if (existingFieldIds.has(field.id)) {\n        conflicts.push({\n          blockId,\n          fieldId: field.id,\n          message: `Field ID \"${field.id}\" conflicts with existing field in ${blockId}`,\n        });\n      }\n    }\n  }\n\n  return conflicts;\n}\n\n/**\n * Schema for SDK custom block definitions.\n *\n * Validates custom blocks defined in riverbank.config.ts.\n * Reuses fieldSchema from @riverbankcms/blocks for field validation.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const sdkCustomBlockSchema: z.ZodType<SdkCustomBlock> = z.object({\n  // Block ID must start with 'custom.'\n  id: z.string()\n    .min(8) // 'custom.' + at least 1 char\n    .regex(/^custom\\.[a-z][a-z0-9-]*$/, {\n      message: \"Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens\",\n    }),\n  title: z.string().min(1, \"Title is required\"),\n  titleSource: z.string().optional(),\n  description: z.string().optional(),\n  category: blockCategoryEnum,\n  icon: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  // Reuse the exact field schema from @riverbankcms/blocks - all field types supported\n  fields: fieldSchema.array().min(1, \"Custom blocks must have at least one field\"),\n  // Data loaders for CMS endpoints\n  dataLoaders: sdkDataLoadersSchema,\n}).refine(\n  // Validate titleSource references a valid field if provided\n  (data) => {\n    if (!data.titleSource) return true;\n    return data.fields.some(f => f.id === data.titleSource);\n  },\n  {\n    message: \"titleSource must reference a valid field ID\",\n    path: [\"titleSource\"],\n  }\n) as z.ZodType<SdkCustomBlock>;\n\n/**\n * Schema for the complete SDK site configuration.\n *\n * Use this schema to validate configuration fetched from SDK sites\n * before storing in the database.\n *\n * @example\n * ```typescript\n * import { riverbankSiteConfigSchema } from '@riverbankcms/sdk/config/validation';\n *\n * const rawConfig = await response.json();\n * const config = riverbankSiteConfigSchema.parse(rawConfig);\n * ```\n */\nexport const riverbankSiteConfigSchema: z.ZodType<RiverbankSiteConfig> = z.object({\n  siteId: z.string().uuid(),\n  theme: sdkThemeConfigSchema.optional(),\n  styles: siteStyleConfigSchema,\n  customBlocks: z.array(sdkCustomBlockSchema)\n    .max(20, \"Maximum 20 custom blocks per site\")\n    .refine(\n      // Ensure unique block IDs\n      (blocks) => {\n        const ids = blocks.map(b => b.id);\n        return ids.length === new Set(ids).size;\n      },\n      { message: \"Block IDs must be unique\" }\n    )\n    .optional(),\n  blockFieldOptions: blockFieldOptionsSchema,\n  blockFieldExtensions: blockFieldExtensionsSchema,\n  content: contentConfigSchema.optional(),\n}).strict() as z.ZodType<RiverbankSiteConfig>;\n\n/**\n * Type inferred from the validation schema.\n * This should match the RiverbankSiteConfig type from ./types.ts\n */\nexport type ValidatedRiverbankSiteConfig = z.infer<typeof riverbankSiteConfigSchema>;\n\n/**\n * Type for a validated SDK custom block.\n */\nexport type ValidatedSdkCustomBlock = z.infer<typeof sdkCustomBlockSchema>;\n\n// ============================================================================\n// Compile-time type assertions\n//\n// These assertions ensure the Zod schemas stay in sync with the TypeScript types.\n// If the schema output diverges from the expected type, TypeScript will error here.\n// ============================================================================\n\n/** Asserts sdkCustomBlockSchema output matches SdkCustomBlock */\ntype _AssertSdkCustomBlockSchema = z.infer<typeof sdkCustomBlockSchema> extends SdkCustomBlock\n  ? SdkCustomBlock extends z.infer<typeof sdkCustomBlockSchema>\n    ? true\n    : never\n  : never;\n\n/** Asserts riverbankSiteConfigSchema output matches RiverbankSiteConfig */\ntype _AssertRiverbankSiteConfigSchema = z.infer<typeof riverbankSiteConfigSchema> extends RiverbankSiteConfig\n  ? RiverbankSiteConfig extends z.infer<typeof riverbankSiteConfigSchema>\n    ? true\n    : never\n  : never;\n\n// These assignments will fail to compile if the types don't match\nconst _checkSdkCustomBlock: _AssertSdkCustomBlockSchema = true;\nconst _checkRiverbankSiteConfig: _AssertRiverbankSiteConfigSchema = true;\n\n// Prevent unused variable warnings\nvoid _checkSdkCustomBlock;\nvoid _checkRiverbankSiteConfig;\n","/**\n * SDK Content Config Validation\n *\n * Zod schemas for validating SDK content configuration.\n */\n\nimport { z } from 'zod';\nimport { SYSTEM_BLOCK_KINDS } from '../types';\nimport type { ContentConfig, ContentTypeConfig } from './content-types';\n\n// Use looseObject for data fields that can contain arbitrary values\nconst jsonDataSchema = z.record(z.string(), z.any());\n\n// ============================================================================\n// Content Type Schema\n// ============================================================================\n\n/**\n * Content type key validation.\n * Must be lowercase, start with a letter, and contain only letters, numbers, and hyphens.\n */\nconst contentTypeKeySchema = z\n  .string()\n  .min(1)\n  .regex(\n    /^[a-z][a-z0-9-]*$/,\n    'Key must be lowercase, start with a letter, and contain only letters, numbers, and hyphens'\n  );\n\n/**\n * Content type config schema.\n */\nexport const contentTypeConfigSchema: z.ZodType<ContentTypeConfig> = z\n  .object({\n    key: contentTypeKeySchema,\n    name: z.string().min(1),\n    description: z.string().optional(),\n    hasPages: z.boolean(),\n    routePattern: z.string().optional(),\n    // Fields are validated as any[] here - deep field validation happens in @riverbankcms/blocks\n    fields: z.array(z.any()).min(1, 'At least one field is required'),\n    titleField: z.string().optional(),\n  })\n  .refine(\n    (data) => {\n      // If hasPages is true, routePattern must be provided and contain {slug}\n      if (data.hasPages) {\n        return data.routePattern && data.routePattern.includes('{slug}');\n      }\n      return true;\n    },\n    { message: 'routePattern with {slug} is required when hasPages is true' }\n  )\n  .refine(\n    (data) => {\n      // If hasPages is false, routePattern must NOT be defined\n      if (!data.hasPages && data.routePattern) {\n        return false;\n      }\n      return true;\n    },\n    { message: 'routePattern must not be defined when hasPages is false' }\n  ) as z.ZodType<ContentTypeConfig>;\n\n// ============================================================================\n// Block Config Schema\n// ============================================================================\n\n/**\n * Block kind validation.\n * Must be either a system block kind (e.g., 'block.hero') or a custom block kind (e.g., 'custom.myBlock').\n */\nconst blockKindSchema = z.string().refine(\n  (kind) => {\n    // Check if it's a system block kind\n    if ((SYSTEM_BLOCK_KINDS as readonly string[]).includes(kind)) {\n      return true;\n    }\n    // Check if it's a custom block kind (custom.${string})\n    if (kind.startsWith('custom.') && kind.length > 7) {\n      return true;\n    }\n    return false;\n  },\n  {\n    message:\n      'Block kind must be a system block (e.g., \"block.hero\") or a custom block (e.g., \"custom.myBlock\")',\n  }\n);\n\nexport const blockConfigSchema = z.object({\n  kind: blockKindSchema,\n  content: jsonDataSchema,\n  orderIndex: z.number().optional(),\n});\n\n// ============================================================================\n// Page Config Schema\n// ============================================================================\n\nexport const pageConfigSchema = z.object({\n  identifier: z.string().min(1, 'Identifier is required'),\n  title: z.string().min(1, 'Title is required'),\n  path: z.string().regex(/^\\//, 'Path must start with /'),\n  purpose: z.string().default('content'),\n  blocks: z.array(blockConfigSchema).optional(),\n  status: z.enum(['draft', 'published']).default('draft'),\n  metaTitle: z.string().optional(),\n  metaDescription: z.string().optional(),\n});\n\n// ============================================================================\n// Entry Config Schema\n// ============================================================================\n\nexport const entryConfigSchema = z.object({\n  identifier: z.string().min(1, 'Identifier is required'),\n  contentType: z.string().min(1, 'Content type is required'),\n  data: jsonDataSchema,\n  status: z.enum(['draft', 'published']).default('draft'),\n  slug: z.string().optional(),\n  title: z.string().optional(),\n  summary: z.string().optional(),\n  metaTitle: z.string().optional(),\n  metaDescription: z.string().optional(),\n});\n\n// ============================================================================\n// Navigation Config Schema\n// ============================================================================\n\nconst pageLinkSchema = z.object({\n  kind: z.literal('page'),\n  identifier: z.string().min(1),\n});\n\nconst entryLinkSchema = z.object({\n  kind: z.literal('entry'),\n  identifier: z.string().min(1),\n});\n\nconst externalLinkSchema = z.object({\n  kind: z.literal('external'),\n  href: z.string().url('Invalid URL'),\n});\n\nconst dropdownLinkSchema = z.object({\n  kind: z.literal('dropdown'),\n});\n\nconst navigationLinkSchema = z.discriminatedUnion('kind', [\n  pageLinkSchema,\n  entryLinkSchema,\n  externalLinkSchema,\n  dropdownLinkSchema,\n]);\n\n// Navigation item with recursive children support\nconst baseNavigationItemSchema = z.object({\n  label: z.string().min(1, 'Label is required'),\n  link: navigationLinkSchema,\n  isCta: z.boolean().optional(),\n});\n\n// Using z.lazy for recursive type\nexport const navigationItemConfigSchema: z.ZodType<{\n  label: string;\n  link:\n    | { kind: 'page'; identifier: string }\n    | { kind: 'entry'; identifier: string }\n    | { kind: 'external'; href: string }\n    | { kind: 'dropdown' };\n  isCta?: boolean;\n  children?: Array<{\n    label: string;\n    link:\n      | { kind: 'page'; identifier: string }\n      | { kind: 'entry'; identifier: string }\n      | { kind: 'external'; href: string }\n      | { kind: 'dropdown' };\n    isCta?: boolean;\n    children?: unknown[];\n  }>;\n}> = baseNavigationItemSchema.extend({\n  children: z.lazy(() => z.array(navigationItemConfigSchema)).optional(),\n});\n\nexport const navigationMenuConfigSchema = z.object({\n  identifier: z.string().min(1, 'Identifier is required'),\n  name: z.string().min(1, 'Name is required'),\n  isPrimary: z.boolean().optional(),\n  items: z.array(navigationItemConfigSchema),\n});\n\n// ============================================================================\n// Site Settings Schema\n// ============================================================================\n\nexport const siteSettingsConfigSchema = z.object({\n  homepagePath: z.string().optional(),\n  siteTitle: z.string().optional(),\n  siteDescription: z.string().optional(),\n  defaultTemplates: z.record(z.string(), z.string()).optional(),\n});\n\n// ============================================================================\n// Complete Content Config Schema\n// ============================================================================\n\nconst contentConfigBaseSchema = z.object({\n  contentTypes: z.array(contentTypeConfigSchema).optional(),\n  entries: z.array(entryConfigSchema).optional(),\n  pages: z.array(pageConfigSchema).optional(),\n  navigationMenus: z.array(navigationMenuConfigSchema).optional(),\n  settings: siteSettingsConfigSchema.optional(),\n});\n\nexport const contentConfigSchema: z.ZodType<ContentConfig> = contentConfigBaseSchema\n  .superRefine((data, ctx) => {\n    // Validate unique content type keys\n    if (data.contentTypes && data.contentTypes.length > 1) {\n      const keys = data.contentTypes.map((ct) => ct.key);\n      const duplicateKeys = keys.filter((key, i) => keys.indexOf(key) !== i);\n      if (duplicateKeys.length > 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Content type keys must be unique. Duplicates: ${duplicateKeys.join(', ')}`,\n          path: ['contentTypes'],\n        });\n      }\n    }\n\n    // Validate unique page identifiers\n    if (data.pages && data.pages.length > 1) {\n      const identifiers = data.pages.map((p) => p.identifier);\n      const duplicateIds = identifiers.filter((id, i) => identifiers.indexOf(id) !== i);\n      if (duplicateIds.length > 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Page identifiers must be unique. Duplicates: ${duplicateIds.join(', ')}`,\n          path: ['pages'],\n        });\n      }\n\n      // Validate unique page paths\n      const paths = data.pages.map((p) => p.path);\n      const duplicatePaths = paths.filter((path, i) => paths.indexOf(path) !== i);\n      if (duplicatePaths.length > 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Page paths must be unique. Duplicates: ${duplicatePaths.join(', ')}`,\n          path: ['pages'],\n        });\n      }\n    }\n\n    // Validate unique entry identifiers\n    if (data.entries && data.entries.length > 1) {\n      const identifiers = data.entries.map((e) => e.identifier);\n      const duplicateIds = identifiers.filter((id, i) => identifiers.indexOf(id) !== i);\n      if (duplicateIds.length > 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Entry identifiers must be unique. Duplicates: ${duplicateIds.join(', ')}`,\n          path: ['entries'],\n        });\n      }\n    }\n\n    // Validate unique navigation menu identifiers\n    if (data.navigationMenus && data.navigationMenus.length > 1) {\n      const identifiers = data.navigationMenus.map((m) => m.identifier);\n      const duplicateIds = identifiers.filter((id, i) => identifiers.indexOf(id) !== i);\n      if (duplicateIds.length > 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Navigation menu identifiers must be unique. Duplicates: ${duplicateIds.join(', ')}`,\n          path: ['navigationMenus'],\n        });\n      }\n    }\n  }) as z.ZodType<ContentConfig>;\n\n// ============================================================================\n// Type Exports\n// ============================================================================\n\nexport type ContentTypeConfigInput = z.input<typeof contentTypeConfigSchema>;\nexport type ContentTypeConfigOutput = z.output<typeof contentTypeConfigSchema>;\n\nexport type PageConfigInput = z.input<typeof pageConfigSchema>;\nexport type PageConfigOutput = z.output<typeof pageConfigSchema>;\n\nexport type EntryConfigInput = z.input<typeof entryConfigSchema>;\nexport type EntryConfigOutput = z.output<typeof entryConfigSchema>;\n\nexport type NavigationMenuConfigInput = z.input<typeof navigationMenuConfigSchema>;\nexport type NavigationMenuConfigOutput = z.output<typeof navigationMenuConfigSchema>;\n\nexport type ContentConfigInput = z.input<typeof contentConfigSchema>;\nexport type ContentConfigOutput = z.output<typeof contentConfigSchema>;\n"],"mappings":"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","names":["z","z"]}

package/dist/server/chunk-FPYK6527.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-FPYK6527.js","../../src/rendering/helpers/loadPage.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACA;ACqHA,MAAA,SAAsB,QAAA,CAAS,MAAA,EAAiD;AAC9E,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,IAAA,EAAM,MAAA,EAAQ,QAAA,EAAU,KAAA,EAAO,oBAAoB,EAAA,EAAI,MAAA;AAG/E,EAAA,MAAM,CAAC,IAAA,EAAM,YAAY,EAAA,EAAI,MAAM,OAAA,CAAQ,GAAA,CAAI;AAAA,IAC7C,MAAA,CAAO,OAAA,CAAQ,EAAE,EAAA,EAAI,OAAO,CAAC,CAAA;AAAA,IAC7B,MAAA,CAAO,OAAA,CAAQ,EAAE,MAAA,EAAQ,IAAA,EAAM,QAAQ,CAAC;AAAA,EAC1C,CAAC,CAAA;AAGD,EAAA,GAAA,CAAI,QAAA,GAAW,YAAA,EAAc;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,IAGF,CAAA;AAAA,EACF;AAEA,EAAA,MAAM,EAAE,IAAA,EAAM,SAAS,EAAA,EAAI,YAAA;AAI3B,EAAA,MAAM,OAAA,EAAS,QAAA,CAAS,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,EAAA,GAAU;AAC5C,IAAA,GAAA,CAAI,CAAC,MAAA,GAAS,OAAO,MAAA,IAAU,QAAA,EAAU;AACvC,MAAA,MAAM,IAAI,KAAA,CAAM,sCAAsC,CAAA;AAAA,IACxD;AACA,IAAA,GAAA,CAAI,OAAO,KAAA,CAAM,GAAA,IAAO,SAAA,GAAY,KAAA,CAAM,GAAA,IAAO,IAAA,EAAM;AACrD,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+CAAA,EAAkD,OAAO,KAAA,CAAM,EAAE,CAAA,CAAA;AACnF,IAAA;AACoC,IAAA;AAC6C,MAAA;AACjF,IAAA;AACuC,IAAA;AACuC,MAAA;AAC9E,IAAA;AAKmB,IAAA;AAQZ,IAAA;AACU,MAAA;AACE,MAAA;AACG,MAAA;AAAA;AAEY,MAAA;AAAA;AAEe,MAAA;AACjD,IAAA;AACD,EAAA;AAEmB,EAAA;AACH,IAAA;AACA,IAAA;AACG,IAAA;AAClB,IAAA;AACF,EAAA;AAGmG,EAAA;AACjG,IAAA;AAC2B,IAAA;AACS,IAAA;AACtC,EAAA;AAGyB,EAAA;AACvB,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AAAA;AAEgC,MAAA;AAChC,IAAA;AACF,EAAA;AAGmB,EAAA;AACqD,EAAA;AACE,IAAA;AAClB,IAAA;AACxD,EAAA;AAEO,EAAA;AACC,IAAA;AACM,IAAA;AACiB,IAAA;AAC7B,IAAA;AACA,IAAA;AAAA;AAAA;AAAA;AAIF,EAAA;AACF;ADhJwF;AACA;AACA;AACA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-FPYK6527.js","sourcesContent":[null,"/**\n * Server-side helper to fetch all data needed for <Page> component.\n *\n * Use this in server components, getServerSideProps, or API routes.\n */\n\nimport type { RiverbankClient, SiteResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport { executeCodeLoaders, mergeLoaderResults } from '../../data/executeCodeLoaders';\nimport type { DataLoaderOverrides } from '../../data/types';\n\n/**\n * SDK config from API response (without siteId which is stripped at storage).\n * This is the runtime representation - for defining configs, use RiverbankSiteConfig.\n */\nexport type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;\n\nexport type LoadPageParams = {\n  client: RiverbankClient;\n  siteId: string;\n  path: string;\n  pageId?: string;\n  /**\n   * If true, fetches draft/unpublished content instead of published content.\n   * This affects both the page structure and block data loaders.\n   * Requires API key with site access.\n   *\n   * @default false\n   */\n  preview?: boolean;\n  /**\n   * Code-based data loaders for custom blocks.\n   *\n   * Use this to fetch data from external APIs (not just whitelisted CMS endpoints).\n   * Keys are block kinds (e.g., 'custom.featured-products').\n   *\n   * Config-based loaders (defined in riverbank.config.ts) run first.\n   * Code loaders run second and take precedence on key conflicts.\n   *\n   * @example\n   * ```typescript\n   * const pageData = await loadPage({\n   *   client,\n   *   siteId: 'site-123',\n   *   path: '/',\n   *   dataLoaderOverrides: {\n   *     'custom.featured-products': {\n   *       products: async (ctx) => {\n   *         const res = await fetch(`https://api.shop.com/products?category=${ctx.content.categoryId}`);\n   *         return res.json();\n   *       },\n   *     },\n   *   },\n   * });\n   * ```\n   */\n  dataLoaderOverrides?: DataLoaderOverrides;\n};\n\nexport type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides'> & {\n  /**\n   * SDK site configuration, if available.\n   * Contains SDK-defined theme palette, section backgrounds, and style options.\n   */\n  sdkConfig: RuntimeSdkConfig | null;\n};\n\n/**\n * Server-side helper to fetch all data needed for <Page> component.\n *\n * Fetches site data, page data, and prefetches block data loaders in parallel.\n *\n * @example Next.js App Router (published content)\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { loadPage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({\n *   apiKey: process.env.RIVERBANK_API_KEY!,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * export default async function PageRoute({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug || ''}`,\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Next.js App Router (preview/draft content)\n * ```tsx\n * export default async function PreviewRoute({ params, searchParams }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: searchParams.siteId,\n *     path: `/${params.slug || ''}`,\n *     preview: true, // Fetch draft content\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Next.js Pages Router (getServerSideProps)\n * ```tsx\n * export async function getServerSideProps({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug || ''}`,\n *   });\n *\n *   return { props: pageData };\n * }\n *\n * export default function PageRoute(props) {\n *   return <Page {...props} />;\n * }\n * ```\n */\nexport async function loadPage(params: LoadPageParams): Promise<LoadPageResult> {\n  const { client, siteId, path, pageId, preview = false, dataLoaderOverrides } = params;\n\n  // Fetch site and page data in parallel\n  const [site, pageResponse] = await Promise.all([\n    client.getSite({ id: siteId }),\n    client.getPage({ siteId, path, preview }),\n  ]);\n\n  // Extract page data (getContentByPath can return page or entry)\n  if ('entry' in pageResponse) {\n    throw new Error(\n      'This path resolves to a content entry, not a page. ' +\n      'Use loadContent() instead, which handles both pages and entries. ' +\n      'For entries, loadContent() returns the raw entry data for custom rendering.'\n    );\n  }\n\n  const { page: pageData } = pageResponse;\n\n  // Convert API response blocks to PageOutline format with content\n  // API returns blocks with full content - PageRenderer needs the content field for rendering\n  const blocks = pageData.blocks.map((block) => {\n    if (!block || typeof block !== 'object') {\n      throw new Error('Invalid block format in API response');\n    }\n    if (typeof block.id !== 'string' && block.id !== null) {\n      throw new Error(`Invalid block id: expected string or null, got ${typeof block.id}`);\n    }\n    if (typeof block.kind !== 'string') {\n      throw new Error(`Invalid block kind: expected string, got ${typeof block.kind}`);\n    }\n    if (typeof block.purpose !== 'string') {\n      throw new Error(`Invalid block purpose: expected string, got ${typeof block.purpose}`);\n    }\n\n    // Include content for rendering\n    // API provides `content` (active content for the requested stage)\n    // and optionally `draftContent` for preview mode\n    const typedBlock = block as {\n      id: string | null;\n      kind: string;\n      purpose: string;\n      content?: Record<string, unknown>;\n      draftContent?: { data: Record<string, unknown> } | null;\n    };\n\n    return {\n      id: typedBlock.id,\n      kind: typedBlock.kind,\n      purpose: typedBlock.purpose,\n      // Include content for PageRenderer's getRenderableContent()\n      content: typedBlock.content ?? {},\n      // Include draftContent if available (for preview mode)\n      draftContent: typedBlock.draftContent?.data ?? null,\n    };\n  });\n\n  const pageOutline = {\n    name: pageData.name,\n    path: pageData.path,\n    purpose: pageData.purpose,\n    blocks,\n  };\n\n  // Build prefetch context\n  const prefetchContext: { siteId: string; pageId: string; previewStage: 'published' | 'preview' } = {\n    siteId,\n    pageId: pageId ?? pageData.id,\n    previewStage: preview ? 'preview' : 'published',\n  };\n\n  // Prefetch block data loaders (config-based loaders for CMS endpoints)\n  const configData = await prefetchBlockData(\n    pageOutline,\n    prefetchContext,\n    client,\n    {\n      // Pass custom blocks so their config-based loaders are discovered\n      customBlocks: site.sdkConfig?.customBlocks,\n    }\n  );\n\n  // Execute code-based loaders (external APIs) and merge results\n  let resolvedData = configData;\n  if (dataLoaderOverrides && Object.keys(dataLoaderOverrides).length > 0) {\n    const codeData = await executeCodeLoaders(pageOutline, prefetchContext, dataLoaderOverrides);\n    resolvedData = mergeLoaderResults(configData, codeData);\n  }\n\n  return {\n    page: pageOutline,\n    theme: site.theme,\n    sdkConfig: site.sdkConfig ?? null,\n    siteId,\n    resolvedData,\n    // Note: routeMap is optional and can be built from site data if needed for internal links.\n    // Consumers can construct it from site.pages and pass explicitly via Page component props.\n    // Example: const routeMap = site.pages.reduce((map, p) => ({ ...map, [p.id]: p.path }), {});\n  };\n}\n"]}

package/dist/server/chunk-G4CKM4EN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-G4CKM4EN.js","../../src/data/executeCodeLoaders.ts"],"names":[],"mappings":"AAAA;ACkCA,MAAA,SAAsB,kBAAA,CACpB,IAAA,EACA,OAAA,EACA,SAAA,EAC4B;AAC5B,EAAA,MAAM,QAAA,EAA6B,CAAC,CAAA;AACpC,EAAA,MAAM,MAAA,EAAyB,CAAC,CAAA;AAEhC,EAAA,IAAA,CAAA,MAAW,MAAA,GAAS,IAAA,CAAK,MAAA,EAAQ;AAC/B,IAAA,MAAM,QAAA,EAAU,KAAA,CAAM,EAAA;AACtB,IAAA,GAAA,CAAI,CAAC,OAAA,EAAS,QAAA;AAGd,IAAA,MAAM,aAAA,EAAe,SAAA,CAAU,KAAA,CAAM,IAAI,CAAA;AACzC,IAAA,GAAA,CAAI,CAAC,YAAA,EAAc,QAAA;AAGnB,IAAA,MAAM,QAAA,oCACH,KAAA,CAAqC,YAAA,UACrC,KAAA,CAAgC,SAAA,UACjC,CAAC,GAAA;AAIH,IAAA,IAAA,CAAA,MAAW,CAAC,GAAA,EAAK,QAAQ,EAAA,GAAK,MAAA,CAAO,OAAA,CAAQ,YAAY,CAAA,EAAG;AAC1D,MAAA,KAAA,CAAM,IAAA;AAAA,QAAA,CACH,MAAA,CAAA,EAAA,GAAY;AACX,UAAA,IAAI;AACF,YAAA,MAAM,cAAA,EAAmC;AAAA,cACvC,MAAA,mBAAQ,OAAA,CAAQ,MAAA,UAAU,IAAA;AAAA,cAC1B,MAAA,mBAAQ,OAAA,CAAQ,MAAA,UAAU,IAAA;AAAA,cAC1B,OAAA;AAAA,cACA,SAAA,EAAW,KAAA,CAAM,IAAA;AAAA,cACjB,OAAA;AAAA,cACA,YAAA,mBAAc,OAAA,CAAQ,YAAA,UAAgB;AAAA,YACxC,CAAA;AAEA,YAAA,MAAM,KAAA,EAAO,MAAM,QAAA,CAAS,aAAa,CAAA;AAEzC,YAAA,GAAA,CAAI,CAAC,OAAA,CAAQ,OAAO,CAAA,EAAG;AACrB,cAAA,OAAA,CAAQ,OAAO,EAAA,EAAI,CAAC,CAAA;AAAA,YACtB;AACA,YAAA,OAAA,CAAQ,OAAO,CAAA,CAAG,GAAG,EAAA,EAAI,IAAA;AAAA,UAC3B,EAAA,MAAA,CAAS,KAAA,EAAO;AAGd,YAAA,OAAA,CAAQ,IAAA,CAAK,qCAAA,EAAuC;AAAA,cAClD,SAAA,EAAW,KAAA,CAAM,IAAA;AAAA,cACjB,SAAA,EAAW,GAAA;AAAA,cACX;AAAA,YACF,CAAC,CAAA;AAAA,UACH;AAAA,QACF,CAAA,CAAA,CAAG;AAAA,MACL,CAAA;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,OAAA,CAAQ,GAAA,CAAI,KAAK,CAAA;AACvB,EAAA,OAAO,OAAA;AACT;AAWO,SAAS,kBAAA,CACd,aAAA,EACA,WAAA,EACmB;AACnB,EAAA,MAAM,OAAA,EAA4B,EAAE,GAAG,cAAc,CAAA;AAErD,EAAA,IAAA,CAAA,MAAW,CAAC,OAAA,EAAS,UAAU,EAAA,GAAK,MAAA,CAAO,OAAA,CAAQ,WAAW,CAAA,EAAG;AAC/D,IAAA,GAAA,CAAI,CAAC,MAAA,CAAO,OAAO,CAAA,EAAG;AACpB,MAAA,MAAA,CAAO,OAAO,EAAA,EAAI,CAAC,CAAA;AAAA,IACrB;AAEA,IAAA,MAAA,CAAO,OAAO,EAAA,EAAI,EAAE,GAAG,MAAA,CAAO,OAAO,CAAA,EAAG,GAAG,WAAW,CAAA;AAAA,EACxD;AAEA,EAAA,OAAO,MAAA;AACT;ADpEA;AACA;AACE;AACA;AACF,iGAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-G4CKM4EN.js","sourcesContent":[null,"/**\n * Execute code-based data loaders for SDK custom blocks.\n *\n * Code loaders are user-defined async functions that can fetch data\n * from any API (not just whitelisted CMS endpoints). They run\n * server-side during loadPage().\n */\n\nimport type { PageOutline } from '@riverbankcms/blocks';\nimport type { PrefetchContext, ResolvedBlockData } from '@riverbankcms/blocks/system/data';\nimport type { BlockKind } from '../types';\nimport type { DataLoaderContext, DataLoaderOverrides } from './types';\n\n/**\n * Execute code-based data loaders for blocks on a page.\n *\n * Iterates through page blocks and executes any registered loader\n * functions for matching block kinds. Runs all loaders in parallel.\n *\n * @param page - Page outline with blocks to process\n * @param context - Prefetch context (siteId, pageId, previewStage)\n * @param overrides - Map of block kinds to loader functions\n * @returns Resolved data keyed by blockId, then loader key\n *\n * @example\n * ```typescript\n * const codeData = await executeCodeLoaders(page, context, {\n *   'custom.featured-products': {\n *     products: async (ctx) => fetchProducts(ctx.content.categoryId),\n *   },\n * });\n * // codeData: { 'block-123': { products: [...] } }\n * ```\n */\nexport async function executeCodeLoaders(\n  page: PageOutline,\n  context: PrefetchContext,\n  overrides: DataLoaderOverrides,\n): Promise<ResolvedBlockData> {\n  const results: ResolvedBlockData = {};\n  const tasks: Promise<void>[] = [];\n\n  for (const block of page.blocks) {\n    const blockId = block.id;\n    if (!blockId) continue;\n\n    // Look up loaders for this block kind\n    const blockLoaders = overrides[block.kind];\n    if (!blockLoaders) continue;\n\n    // Get block content (prefer draft in preview mode)\n    const content = (\n      (block as { draftContent?: unknown }).draftContent ??\n      (block as { content?: unknown }).content ??\n      {}\n    ) as Record<string, unknown>;\n\n    // Execute each loader for this block\n    for (const [key, loaderFn] of Object.entries(blockLoaders)) {\n      tasks.push(\n        (async () => {\n          try {\n            const loaderContext: DataLoaderContext = {\n              siteId: context.siteId ?? '',\n              pageId: context.pageId ?? '',\n              blockId,\n              blockKind: block.kind as BlockKind,\n              content,\n              previewStage: context.previewStage ?? 'published',\n            };\n\n            const data = await loaderFn(loaderContext);\n\n            if (!results[blockId]) {\n              results[blockId] = {};\n            }\n            results[blockId]![key] = data;\n          } catch (error) {\n            // Log but don't throw - data loading is best-effort\n            // SDK users should handle missing data gracefully in components\n            console.warn('[executeCodeLoaders] Loader failed:', {\n              blockKind: block.kind,\n              loaderKey: key,\n              error,\n            });\n          }\n        })(),\n      );\n    }\n  }\n\n  await Promise.all(tasks);\n  return results;\n}\n\n/**\n * Merge resolved data from config loaders and code loaders.\n *\n * Code loader results take precedence on key conflicts.\n *\n * @param configResults - Data from config-based loaders (CMS endpoints)\n * @param codeResults - Data from code-based loaders (external APIs)\n * @returns Merged data with code results overwriting config on conflicts\n */\nexport function mergeLoaderResults(\n  configResults: ResolvedBlockData,\n  codeResults: ResolvedBlockData,\n): ResolvedBlockData {\n  const merged: ResolvedBlockData = { ...configResults };\n\n  for (const [blockId, loaderData] of Object.entries(codeResults)) {\n    if (!merged[blockId]) {\n      merged[blockId] = {};\n    }\n    // Code loaders take precedence on key conflicts\n    merged[blockId] = { ...merged[blockId], ...loaderData };\n  }\n\n  return merged;\n}\n"]}