@riverbankcms/sdk 0.7.2 → 0.7.3

package/dist/server/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/config.js","../../src/config/typed-entries.ts","../../src/config/index.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACA;AC+KO,SAAS,sBAAA,CAGd,MAAA,EAAwD;AACxD,EAAA,OAAO,MAAA;AACT;AAwDO,SAAS,WAAA,CAId,WAAA,EACA,KAAA,EACa;AACb,EAAA,OAAO;AAAA,IACL,GAAG,KAAA;AAAA,IACH,WAAA,EAAa,WAAA,CAAY;AAAA,EAC3B,CAAA;AACF;AA2BO,IAAM,OAAA,EAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,KAAA,CAAA,EAAoB;AAClB,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,OAAA,EAAS,CAAC,EAAE,CAAA;AAAA,EACpC,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAA,CAAU,IAAA,EAA0B;AAClC,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,KAAA;AAAA,MACN,OAAA,EAAS;AAAA,QACP;AAAA,UACE,IAAA,EAAM,WAAA;AAAA,UACN,OAAA,EAAS,KAAA,EAAO,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAC,EAAA,EAAI,CAAC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF,CAAA;AAAA,EACF,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,GAAA,CAAI,OAAA,EAAmC;AACrC,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,QAAQ,CAAA;AAAA,EAChC,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAA,CAAQ,KAAA,EAA8B,IAAA,EAA0B;AAC9D,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,SAAA;AAAA,MACN,KAAA,EAAO,EAAE,MAAM,CAAA;AAAA,MACf,OAAA,EAAS,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAC;AAAA,IAClC,CAAA;AAAA,EACF;AACF,CAAA;AD1QA;AACA;AEkCO,SAAS,YAAA,CAAa,MAAA,EAAkD;AAC7E,EAAA,OAAO,MAAA;AACT;AAuCO,SAAS,mBAAA,CAAoB,MAAA,EAAsC;AACxE,EAAA,OAAO,MAAA;AACT;AFtEA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,0/DAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/config.js","sourcesContent":[null,"/**\n * Type-Safe Content Entries\n *\n * This module provides type-safe helpers for defining content types and entries\n * in SDK site configurations. When used with `as const`, TypeScript can infer\n * the exact shape of entry data from the content type's field definitions.\n *\n * @example\n * ```typescript\n * import { defineTypedContentType, createEntry, tiptap } from '@riverbankcms/sdk/config';\n *\n * // Define content type with `as const` for type inference\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n *\n * // Create entry with full type safety\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   data: {\n *     name: 'John Doe',      // TypeScript knows this is string\n *     quote: tiptap.paragraph('Great service!'),  // TypeScript knows this is TipTapNode\n *   },\n * });\n * ```\n */\n\nimport type {\n  FieldDefinition,\n  TextFieldDefinition,\n  RichTextFieldDefinition,\n  MediaFieldDefinition,\n  BooleanFieldDefinition,\n  NumberFieldDefinition,\n  DateFieldDefinition,\n  TimeFieldDefinition,\n  DateTimeFieldDefinition,\n  SlugFieldDefinition,\n  UrlFieldDefinition,\n  LinkFieldDefinition,\n  SelectFieldDefinition,\n  ReferenceFieldDefinition,\n  RepeaterFieldDefinition,\n  GroupFieldDefinition,\n  ModalFieldDefinition,\n  TabGroupFieldDefinition,\n  PresetOrCustomFieldDefinition,\n  ContentTypeSelectFieldDefinition,\n  EntryPickerFieldDefinition,\n  TipTapNode,\n  Media,\n  LinkValue,\n} from '@riverbankcms/blocks';\nimport type { ContentTypeConfig, EntryConfig } from './content-types';\n\n// Re-export value types for convenience\nexport type { TipTapNode, Media, LinkValue } from '@riverbankcms/blocks';\nexport type {\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from '@riverbankcms/blocks';\n\n// =============================================================================\n// Type Infrastructure\n// =============================================================================\n\n/**\n * Infers the data object shape from tabGroup tabs (flattens all tab fields).\n * TabGroup fields flatten all their tab fields into a single data object.\n */\ntype InferDataFromTabs<Tabs extends readonly { fields: readonly FieldDefinition[] }[]> =\n  InferDataFromFields<Tabs[number]['fields']>;\n\n// NOTE: Polymorphic repeater type inference would require a helper like this,\n// but TypeScript's mapped types don't distribute correctly over union keys\n// when nested inside conditional types. Left as documentation for future work.\n// type PolymorphicItemData<K, IT> = K extends string\n//   ? K extends keyof IT\n//     ? IT[K] extends { fields: infer F extends readonly FieldDefinition[] }\n//       ? { _type: K } & InferDataFromFields<F>\n//       : never\n//     : never\n//   : never;\n\n/**\n * Maps a field definition to its TypeScript value type.\n * Uses conditional types to infer the correct type based on field.type.\n *\n * Coverage:\n * - Simple primitives: text, boolean, number\n * - Complex types: richText (TipTapNode), media (Media | null), link (LinkValue | null)\n * - Date/time: date, time, datetime (all ISO strings)\n * - String-value: slug, url, reference, presetOrCustom, contentTypeSelect\n * - Select: single (string) vs multiple (string[])\n * - Entry picker: string | null\n * - Nested: group, modal (nested InferDataFromFields)\n * - Repeater: monomorphic (array) and polymorphic (discriminated union array)\n * - TabGroup: flattened fields from all tabs\n */\nexport type FieldValueType<F extends FieldDefinition> =\n  // Simple primitives - use specific field types for better inference\n  F extends TextFieldDefinition ? string :\n  F extends BooleanFieldDefinition ? boolean :\n  F extends NumberFieldDefinition ? number :\n  // Complex types\n  F extends RichTextFieldDefinition ? TipTapNode :\n  F extends MediaFieldDefinition ? Media | null :\n  F extends LinkFieldDefinition ? LinkValue | null :\n  // Date/time types (all stored as ISO strings)\n  F extends DateFieldDefinition ? string :\n  F extends TimeFieldDefinition ? string :\n  F extends DateTimeFieldDefinition ? string :\n  // String-value types\n  F extends SlugFieldDefinition ? string :\n  F extends UrlFieldDefinition ? string :\n  F extends ReferenceFieldDefinition ? string :\n  F extends PresetOrCustomFieldDefinition ? string :\n  F extends ContentTypeSelectFieldDefinition ? string :\n  // Select: check multiple flag first (more specific match)\n  F extends SelectFieldDefinition & { multiple: true } ? string[] :\n  F extends SelectFieldDefinition ? string :\n  // Entry picker\n  F extends EntryPickerFieldDefinition ? string | null :\n  // Nested types (group, modal)\n  F extends GroupFieldDefinition & { schema: { fields: infer GF } } ?\n    GF extends readonly FieldDefinition[] ? InferDataFromFields<GF> : never :\n  F extends ModalFieldDefinition & { schema: { fields: infer MF } } ?\n    MF extends readonly FieldDefinition[] ? InferDataFromFields<MF> : never :\n  // Repeater types (polymorphic first - more specific, then monomorphic)\n  // TODO: Polymorphic repeaters need more complex type distribution.\n  // For now, return unknown[] - the runtime data is still correct.\n  F extends { type: 'repeater'; polymorphic: true } ? unknown[] :\n  F extends RepeaterFieldDefinition & { schema: { fields: infer RF } } ?\n    RF extends readonly FieldDefinition[] ? InferDataFromFields<RF>[] : never :\n  // TabGroup (flattens all tab fields)\n  F extends TabGroupFieldDefinition & { tabs: infer T } ?\n    T extends readonly { fields: readonly FieldDefinition[] }[] ?\n      InferDataFromTabs<T> : never :\n  // Fallback for unknown types\n  unknown;\n\n/**\n * Infers the data object shape from an array of field definitions.\n * Required fields are non-optional, optional fields are `| undefined`.\n *\n * @example\n * ```typescript\n * const fields = [\n *   { id: 'name', type: 'text', required: true },\n *   { id: 'bio', type: 'text', required: false },\n * ] as const;\n *\n * type Data = InferDataFromFields<typeof fields>;\n * // { name: string; bio: string | undefined }\n * ```\n */\nexport type InferDataFromFields<Fields extends readonly FieldDefinition[]> = {\n  [F in Fields[number] as F['id']]: F extends { required: true }\n    ? FieldValueType<F>\n    : FieldValueType<F> | undefined;\n};\n\n// =============================================================================\n// TypedContentType\n// =============================================================================\n\n/**\n * A content type definition with preserved field types for type inference.\n * Extends ContentTypeConfig to ensure all required fields are present.\n * The generic parameters capture the literal types from `as const`.\n */\nexport interface TypedContentType<\n  K extends string = string,\n  F extends readonly FieldDefinition[] = readonly FieldDefinition[]\n> extends Omit<ContentTypeConfig, 'key' | 'fields'> {\n  key: K;\n  fields: F;\n}\n\n/**\n * Define a content type with preserved field types for type inference.\n *\n * IMPORTANT: Use `as const` on the config object to enable type inference.\n * Without `as const`, TypeScript widens literal types and inference won't work.\n *\n * @param config - The content type configuration\n * @returns The same config object with preserved types\n *\n * @example\n * ```typescript\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n * ```\n */\nexport function defineTypedContentType<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(config: TypedContentType<K, F>): TypedContentType<K, F> {\n  return config;\n}\n\n// =============================================================================\n// TypedEntryConfig and createEntry\n// =============================================================================\n\n/**\n * Entry configuration with typed data field.\n * Used internally by createEntry to enforce type safety.\n */\nexport interface TypedEntryConfig<Data extends Record<string, unknown>> {\n  /** Unique identifier for this entry. Required for SDK sync. */\n  identifier: string;\n  /** Title for the entry */\n  title?: string;\n  /** Slug for routable entries */\n  slug?: string;\n  /** Status: 'draft' or 'published' */\n  status?: 'draft' | 'published';\n  /** Summary/description */\n  summary?: string;\n  /** SEO meta title */\n  metaTitle?: string;\n  /** SEO meta description */\n  metaDescription?: string;\n  /** Entry data matching the content type's field definitions */\n  data: Data;\n}\n\n/**\n * Create a type-safe content entry for a typed content type.\n *\n * The data field is validated against the content type's field definitions.\n * TypeScript will error if:\n * - A required field is missing\n * - A field name is misspelled\n * - A field value has the wrong type\n * - An extra field is provided (with strict mode)\n *\n * @param contentType - The typed content type definition\n * @param entry - The entry configuration with typed data\n * @returns EntryConfig compatible with SDK content configuration\n *\n * @example\n * ```typescript\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   title: 'John Doe',\n *   status: 'published',\n *   data: {\n *     name: 'John Doe',\n *     quote: tiptap.paragraph('Great service!'),\n *   },\n * });\n * ```\n */\nexport function createEntry<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(\n  contentType: TypedContentType<K, F>,\n  entry: TypedEntryConfig<InferDataFromFields<F>>\n): EntryConfig {\n  return {\n    ...entry,\n    contentType: contentType.key,\n  };\n}\n\n// =============================================================================\n// TipTap Helpers\n// =============================================================================\n\n/**\n * Helpers for creating TipTap document structures.\n *\n * Use these helpers when populating richText fields to avoid manually\n * constructing the TipTap JSON structure.\n *\n * @example\n * ```typescript\n * // Simple paragraph\n * const body = tiptap.paragraph('Hello, world!');\n *\n * // Empty document\n * const emptyDoc = tiptap.empty();\n *\n * // Complex document\n * const doc = tiptap.doc([\n *   tiptap.heading(1, 'Welcome'),\n *   { type: 'paragraph', content: [{ type: 'text', text: 'Introduction...' }] },\n * ]);\n * ```\n */\nexport const tiptap = {\n  /**\n   * Create an empty TipTap document.\n   *\n   * @returns An empty TipTap document node\n   */\n  empty(): TipTapNode {\n    return { type: 'doc', content: [] };\n  },\n\n  /**\n   * Create a TipTap document with a single paragraph.\n   *\n   * @param text - The paragraph text content\n   * @returns A TipTap document with one paragraph\n   */\n  paragraph(text: string): TipTapNode {\n    return {\n      type: 'doc',\n      content: [\n        {\n          type: 'paragraph',\n          content: text ? [{ type: 'text', text }] : [],\n        },\n      ],\n    };\n  },\n\n  /**\n   * Create a TipTap document with custom content nodes.\n   *\n   * @param content - Array of TipTap nodes to include in the document\n   * @returns A TipTap document wrapping the content\n   */\n  doc(content: TipTapNode[]): TipTapNode {\n    return { type: 'doc', content };\n  },\n\n  /**\n   * Create a heading node.\n   *\n   * Note: This returns a heading node, not a document. Use with tiptap.doc()\n   * to create a complete document.\n   *\n   * @param level - Heading level (1-6)\n   * @param text - Heading text content\n   * @returns A TipTap heading node\n   */\n  heading(level: 1 | 2 | 3 | 4 | 5 | 6, text: string): TipTapNode {\n    return {\n      type: 'heading',\n      attrs: { level },\n      content: [{ type: 'text', text }],\n    };\n  },\n};\n","/**\n * SDK Site Configuration\n *\n * Types and utilities for defining site-level configuration\n * that SDK sites expose to the dashboard.\n */\n\nimport type { RiverbankSiteConfig, ContentConfig } from './types';\n\n// Types\nexport type {\n  RiverbankSiteConfig,\n  SiteStyleConfig,\n  SectionBackground,\n  SectionOptionsConfig,\n  ContainerOptionsConfig,\n  SectionSpacing,\n  ContainerMaxWidth,\n  ContainerAlignment,\n  SdkThemeConfig,\n  SdkThemePalette,\n  SdkCustomBlock,\n  FieldSelectOption,\n  BlockFieldConfig,\n  BlockFieldOptionsMap,\n  BlockFieldExtension,\n  BlockFieldExtensionsMap,\n  FieldDefinition,\n  // Content scaffolding types\n  ContentConfig,\n  ContentTypeConfig,\n  PageConfig,\n  EntryConfig,\n  BlockConfig,\n  NavigationMenuConfig,\n  NavigationItemConfig,\n  NavigationLinkType,\n  SiteSettingsConfig,\n} from './types';\n\n// Validation schemas\nexport {\n  riverbankSiteConfigSchema,\n  siteStyleConfigSchema,\n  sectionBackgroundSchema,\n  sectionSpacingSchema,\n  containerMaxWidthSchema,\n  containerAlignmentSchema,\n  sectionOptionsSchema,\n  containerOptionsSchema,\n  sdkThemeConfigSchema,\n  sdkThemePaletteSchema,\n  sdkCustomBlockSchema,\n  fieldSelectOptionSchema,\n  blockFieldConfigSchema,\n  blockFieldOptionsSchema,\n  blockFieldExtensionSchema,\n  blockFieldExtensionsSchema,\n  // Content scaffolding schemas\n  contentConfigSchema,\n} from './validation';\n\n// Content validation schemas for more granular use\nexport {\n  contentTypeConfigSchema,\n  pageConfigSchema,\n  entryConfigSchema,\n  navigationMenuConfigSchema,\n  navigationItemConfigSchema,\n  siteSettingsConfigSchema,\n  blockConfigSchema,\n} from './content-validation';\n\nexport type {\n  ValidatedRiverbankSiteConfig,\n  ValidatedSdkCustomBlock,\n  ContentConfigInput,\n  ContentConfigOutput,\n} from './validation';\n\n// Block kind types (single source of truth from @riverbankcms/blocks)\nexport {\n  SYSTEM_BLOCK_KINDS,\n  type SystemBlockKind,\n  type CustomBlockKind,\n  type BlockKind,\n} from '../types';\n\n// Type-safe content entry helpers\nexport {\n  defineTypedContentType,\n  createEntry,\n  tiptap,\n  type TypedContentType,\n  type TypedEntryConfig,\n  type InferDataFromFields,\n  type FieldValueType,\n} from './typed-entries';\n\n// Re-export value types for convenience when building entry data\nexport type {\n  TipTapNode,\n  Media,\n  LinkValue,\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from './typed-entries';\n\n/**\n * Helper function to define a Builder site configuration with type checking.\n *\n * @example\n * ```typescript\n * import { defineConfig } from '@riverbankcms/sdk/config';\n *\n * export default defineConfig({\n *   siteId: '123e4567-e89b-12d3-a456-426614174000',\n *   theme: {\n *     palette: {\n *       primary: '#6d28d9',\n *     },\n *   },\n *   styles: {\n *     sectionBackgrounds: [\n *       { id: 'primary', label: 'Purple', token: 'primary' },\n *     ],\n *   },\n * });\n * ```\n */\nexport function defineConfig(config: RiverbankSiteConfig): RiverbankSiteConfig {\n  return config;\n}\n\n/**\n * Helper function to define content scaffolding configuration with type checking.\n *\n * This can be used to define content configuration in a separate file,\n * which is then imported into riverbank.config.ts.\n *\n * @example\n * ```typescript\n * // content.config.ts\n * import { defineContentConfig } from '@riverbankcms/sdk/config';\n *\n * export const contentConfig = defineContentConfig({\n *   contentTypes: [\n *     {\n *       key: 'testimonial',\n *       name: 'Testimonial',\n *       hasPages: false,\n *       fields: [\n *         { id: 'quote', type: 'richText', label: 'Quote', required: true },\n *       ],\n *     },\n *   ],\n *   pages: [\n *     { identifier: 'home', title: 'Home', path: '/' },\n *   ],\n * });\n *\n * // riverbank.config.ts\n * import { defineConfig } from '@riverbankcms/sdk/config';\n * import { contentConfig } from './content.config';\n *\n * export default defineConfig({\n *   siteId: '...',\n *   content: contentConfig,\n * });\n * ```\n */\nexport function defineContentConfig(config: ContentConfig): ContentConfig {\n  return config;\n}\n"]}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/config.js","../../src/config/typed-entries.ts","../../src/config/index.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACA;AC8KO,SAAS,sBAAA,CAGd,MAAA,EAAwD;AACxD,EAAA,OAAO,MAAA;AACT;AAwDO,SAAS,WAAA,CAId,WAAA,EACA,KAAA,EACa;AACb,EAAA,OAAO;AAAA,IACL,GAAG,KAAA;AAAA,IACH,WAAA,EAAa,WAAA,CAAY;AAAA,EAC3B,CAAA;AACF;AA2BO,IAAM,OAAA,EAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,KAAA,CAAA,EAAoB;AAClB,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,OAAA,EAAS,CAAC,EAAE,CAAA;AAAA,EACpC,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAA,CAAU,IAAA,EAA0B;AAClC,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,KAAA;AAAA,MACN,OAAA,EAAS;AAAA,QACP;AAAA,UACE,IAAA,EAAM,WAAA;AAAA,UACN,OAAA,EAAS,KAAA,EAAO,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAC,EAAA,EAAI,CAAC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF,CAAA;AAAA,EACF,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,GAAA,CAAI,OAAA,EAAmC;AACrC,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,EAAO,QAAQ,CAAA;AAAA,EAChC,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAA,CAAQ,KAAA,EAA8B,IAAA,EAA0B;AAC9D,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,SAAA;AAAA,MACN,KAAA,EAAO,EAAE,MAAM,CAAA;AAAA,MACf,OAAA,EAAS,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAC;AAAA,IAClC,CAAA;AAAA,EACF;AACF,CAAA;ADzQA;AACA;AEiCO,SAAS,YAAA,CAAa,MAAA,EAAkD;AAC7E,EAAA,OAAO,MAAA;AACT;AAuCO,SAAS,mBAAA,CAAoB,MAAA,EAAsC;AACxE,EAAA,OAAO,MAAA;AACT;AFrEA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,0/DAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/config.js","sourcesContent":[null,"/**\n * Type-Safe Content Entries\n *\n * This module provides type-safe helpers for defining content types and entries\n * in SDK site configurations. When used with `as const`, TypeScript can infer\n * the exact shape of entry data from the content type's field definitions.\n *\n * @example\n * ```typescript\n * import { defineTypedContentType, createEntry, tiptap } from '@riverbankcms/sdk/config';\n *\n * // Define content type with `as const` for type inference\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n *\n * // Create entry with full type safety\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   data: {\n *     name: 'John Doe',      // TypeScript knows this is string\n *     quote: tiptap.paragraph('Great service!'),  // TypeScript knows this is TipTapNode\n *   },\n * });\n * ```\n */\n\nimport type {\n  FieldDefinition,\n  TextFieldDefinition,\n  RichTextFieldDefinition,\n  MediaFieldDefinition,\n  BooleanFieldDefinition,\n  NumberFieldDefinition,\n  DateFieldDefinition,\n  TimeFieldDefinition,\n  DateTimeFieldDefinition,\n  SlugFieldDefinition,\n  UrlFieldDefinition,\n  LinkFieldDefinition,\n  SelectFieldDefinition,\n  ReferenceFieldDefinition,\n  RepeaterFieldDefinition,\n  GroupFieldDefinition,\n  ModalFieldDefinition,\n  TabGroupFieldDefinition,\n  PresetOrCustomFieldDefinition,\n  ContentTypeSelectFieldDefinition,\n  EntryPickerFieldDefinition,\n  TipTapNode,\n  Media,\n  LinkValue,\n} from '@riverbankcms/blocks';\nimport type { ContentTypeConfig, EntryConfig } from './content-types';\n\n// Re-export value types for convenience\nexport type { TipTapNode, Media, LinkValue } from '@riverbankcms/blocks';\nexport type {\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from '@riverbankcms/blocks';\n\n// =============================================================================\n// Type Infrastructure\n// =============================================================================\n\n/**\n * Infers the data object shape from tabGroup tabs (flattens all tab fields).\n * TabGroup fields flatten all their tab fields into a single data object.\n */\ntype InferDataFromTabs<Tabs extends readonly { fields: readonly FieldDefinition[] }[]> =\n  InferDataFromFields<Tabs[number]['fields']>;\n\n// NOTE: Polymorphic repeater type inference would require a helper like this,\n// but TypeScript's mapped types don't distribute correctly over union keys\n// when nested inside conditional types. Left as documentation for future work.\n// type PolymorphicItemData<K, IT> = K extends string\n//   ? K extends keyof IT\n//     ? IT[K] extends { fields: infer F extends readonly FieldDefinition[] }\n//       ? { _type: K } & InferDataFromFields<F>\n//       : never\n//     : never\n//   : never;\n\n/**\n * Maps a field definition to its TypeScript value type.\n * Uses conditional types to infer the correct type based on field.type.\n *\n * Coverage:\n * - Simple primitives: text, boolean, number\n * - Complex types: richText (TipTapNode), media (Media | null), link (LinkValue | null)\n * - Date/time: date, time, datetime (all ISO strings)\n * - String-value: slug, url, reference, presetOrCustom, contentTypeSelect\n * - Select: single (string) vs multiple (string[])\n * - Entry picker: string | null\n * - Nested: group, modal (nested InferDataFromFields)\n * - Repeater: monomorphic (array) and polymorphic (discriminated union array)\n * - TabGroup: flattened fields from all tabs\n */\nexport type FieldValueType<F extends FieldDefinition> =\n  // Simple primitives - use specific field types for better inference\n  F extends TextFieldDefinition ? string :\n  F extends BooleanFieldDefinition ? boolean :\n  F extends NumberFieldDefinition ? number :\n  // Complex types\n  F extends RichTextFieldDefinition ? TipTapNode :\n  F extends MediaFieldDefinition ? Media | null :\n  F extends LinkFieldDefinition ? LinkValue | null :\n  // Date/time types (all stored as ISO strings)\n  F extends DateFieldDefinition ? string :\n  F extends TimeFieldDefinition ? string :\n  F extends DateTimeFieldDefinition ? string :\n  // String-value types\n  F extends SlugFieldDefinition ? string :\n  F extends UrlFieldDefinition ? string :\n  F extends ReferenceFieldDefinition ? string :\n  F extends PresetOrCustomFieldDefinition ? string :\n  F extends ContentTypeSelectFieldDefinition ? string :\n  // Select: check multiple flag first (more specific match)\n  F extends SelectFieldDefinition & { multiple: true } ? string[] :\n  F extends SelectFieldDefinition ? string :\n  // Entry picker\n  F extends EntryPickerFieldDefinition ? string | null :\n  // Nested types (group, modal)\n  F extends GroupFieldDefinition & { schema: { fields: infer GF } } ?\n    GF extends readonly FieldDefinition[] ? InferDataFromFields<GF> : never :\n  F extends ModalFieldDefinition & { schema: { fields: infer MF } } ?\n    MF extends readonly FieldDefinition[] ? InferDataFromFields<MF> : never :\n  // Repeater types (polymorphic first - more specific, then monomorphic)\n  // TODO: Polymorphic repeaters need more complex type distribution.\n  // For now, return unknown[] - the runtime data is still correct.\n  F extends { type: 'repeater'; polymorphic: true } ? unknown[] :\n  F extends RepeaterFieldDefinition & { schema: { fields: infer RF } } ?\n    RF extends readonly FieldDefinition[] ? InferDataFromFields<RF>[] : never :\n  // TabGroup (flattens all tab fields)\n  F extends TabGroupFieldDefinition & { tabs: infer T } ?\n    T extends readonly { fields: readonly FieldDefinition[] }[] ?\n      InferDataFromTabs<T> : never :\n  // Fallback for unknown types\n  unknown;\n\n/**\n * Infers the data object shape from an array of field definitions.\n * Required fields are non-optional, optional fields are `| undefined`.\n *\n * @example\n * ```typescript\n * const fields = [\n *   { id: 'name', type: 'text', required: true },\n *   { id: 'bio', type: 'text', required: false },\n * ] as const;\n *\n * type Data = InferDataFromFields<typeof fields>;\n * // { name: string; bio: string | undefined }\n * ```\n */\nexport type InferDataFromFields<Fields extends readonly FieldDefinition[]> = {\n  [F in Fields[number] as F['id']]: F extends { required: true }\n    ? FieldValueType<F>\n    : FieldValueType<F> | undefined;\n};\n\n// =============================================================================\n// TypedContentType\n// =============================================================================\n\n/**\n * A content type definition with preserved field types for type inference.\n * Extends ContentTypeConfig to ensure all required fields are present.\n * The generic parameters capture the literal types from `as const`.\n */\nexport interface TypedContentType<\n  K extends string = string,\n  F extends readonly FieldDefinition[] = readonly FieldDefinition[]\n> extends Omit<ContentTypeConfig, 'key' | 'fields'> {\n  key: K;\n  fields: F;\n}\n\n/**\n * Define a content type with preserved field types for type inference.\n *\n * IMPORTANT: Use `as const` on the config object to enable type inference.\n * Without `as const`, TypeScript widens literal types and inference won't work.\n *\n * @param config - The content type configuration\n * @returns The same config object with preserved types\n *\n * @example\n * ```typescript\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n * ```\n */\nexport function defineTypedContentType<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(config: TypedContentType<K, F>): TypedContentType<K, F> {\n  return config;\n}\n\n// =============================================================================\n// TypedEntryConfig and createEntry\n// =============================================================================\n\n/**\n * Entry configuration with typed data field.\n * Used internally by createEntry to enforce type safety.\n */\nexport interface TypedEntryConfig<Data extends Record<string, unknown>> {\n  /** Unique identifier for this entry. Required for SDK sync. */\n  identifier: string;\n  /** Title for the entry */\n  title?: string;\n  /** Slug for routable entries */\n  slug?: string;\n  /** Status: 'draft' or 'published' */\n  status?: 'draft' | 'published';\n  /** Summary/description */\n  summary?: string;\n  /** SEO meta title */\n  metaTitle?: string;\n  /** SEO meta description */\n  metaDescription?: string;\n  /** Entry data matching the content type's field definitions */\n  data: Data;\n}\n\n/**\n * Create a type-safe content entry for a typed content type.\n *\n * The data field is validated against the content type's field definitions.\n * TypeScript will error if:\n * - A required field is missing\n * - A field name is misspelled\n * - A field value has the wrong type\n * - An extra field is provided (with strict mode)\n *\n * @param contentType - The typed content type definition\n * @param entry - The entry configuration with typed data\n * @returns EntryConfig compatible with SDK content configuration\n *\n * @example\n * ```typescript\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   title: 'John Doe',\n *   status: 'published',\n *   data: {\n *     name: 'John Doe',\n *     quote: tiptap.paragraph('Great service!'),\n *   },\n * });\n * ```\n */\nexport function createEntry<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(\n  contentType: TypedContentType<K, F>,\n  entry: TypedEntryConfig<InferDataFromFields<F>>\n): EntryConfig {\n  return {\n    ...entry,\n    contentType: contentType.key,\n  };\n}\n\n// =============================================================================\n// TipTap Helpers\n// =============================================================================\n\n/**\n * Helpers for creating TipTap document structures.\n *\n * Use these helpers when populating richText fields to avoid manually\n * constructing the TipTap JSON structure.\n *\n * @example\n * ```typescript\n * // Simple paragraph\n * const body = tiptap.paragraph('Hello, world!');\n *\n * // Empty document\n * const emptyDoc = tiptap.empty();\n *\n * // Complex document\n * const doc = tiptap.doc([\n *   tiptap.heading(1, 'Welcome'),\n *   { type: 'paragraph', content: [{ type: 'text', text: 'Introduction...' }] },\n * ]);\n * ```\n */\nexport const tiptap = {\n  /**\n   * Create an empty TipTap document.\n   *\n   * @returns An empty TipTap document node\n   */\n  empty(): TipTapNode {\n    return { type: 'doc', content: [] };\n  },\n\n  /**\n   * Create a TipTap document with a single paragraph.\n   *\n   * @param text - The paragraph text content\n   * @returns A TipTap document with one paragraph\n   */\n  paragraph(text: string): TipTapNode {\n    return {\n      type: 'doc',\n      content: [\n        {\n          type: 'paragraph',\n          content: text ? [{ type: 'text', text }] : [],\n        },\n      ],\n    };\n  },\n\n  /**\n   * Create a TipTap document with custom content nodes.\n   *\n   * @param content - Array of TipTap nodes to include in the document\n   * @returns A TipTap document wrapping the content\n   */\n  doc(content: TipTapNode[]): TipTapNode {\n    return { type: 'doc', content };\n  },\n\n  /**\n   * Create a heading node.\n   *\n   * Note: This returns a heading node, not a document. Use with tiptap.doc()\n   * to create a complete document.\n   *\n   * @param level - Heading level (1-6)\n   * @param text - Heading text content\n   * @returns A TipTap heading node\n   */\n  heading(level: 1 | 2 | 3 | 4 | 5 | 6, text: string): TipTapNode {\n    return {\n      type: 'heading',\n      attrs: { level },\n      content: [{ type: 'text', text }],\n    };\n  },\n};\n","/**\n * SDK Site Configuration\n *\n * Types and utilities for defining site-level configuration\n * that SDK sites expose to the dashboard.\n */\n\nimport type { RiverbankSiteConfig, ContentConfig } from './types';\n\n// Types\nexport type {\n  RiverbankSiteConfig,\n  SiteStyleConfig,\n  SectionBackground,\n  SectionOptionsConfig,\n  ContainerOptionsConfig,\n  SectionSpacing,\n  ContainerMaxWidth,\n  ContainerAlignment,\n  SdkThemeConfig,\n  SdkThemePalette,\n  SdkCustomBlock,\n  FieldSelectOption,\n  BlockFieldConfig,\n  BlockFieldOptionsMap,\n  BlockFieldExtension,\n  BlockFieldExtensionsMap,\n  FieldDefinition,\n  // Content scaffolding types\n  ContentConfig,\n  ContentTypeConfig,\n  PageConfig,\n  EntryConfig,\n  BlockConfig,\n  NavigationMenuConfig,\n  NavigationItemConfig,\n  NavigationLinkType,\n  SiteSettingsConfig,\n} from './types';\n\n// Validation schemas\nexport {\n  riverbankSiteConfigSchema,\n  siteStyleConfigSchema,\n  sectionBackgroundSchema,\n  sectionSpacingSchema,\n  containerMaxWidthSchema,\n  containerAlignmentSchema,\n  sectionOptionsSchema,\n  containerOptionsSchema,\n  sdkThemeConfigSchema,\n  sdkThemePaletteSchema,\n  sdkCustomBlockSchema,\n  fieldSelectOptionSchema,\n  blockFieldConfigSchema,\n  blockFieldOptionsSchema,\n  blockFieldExtensionSchema,\n  blockFieldExtensionsSchema,\n  // Content scaffolding schemas\n  contentConfigSchema,\n} from './validation';\n\n// Content validation schemas for more granular use\nexport {\n  contentTypeConfigSchema,\n  pageConfigSchema,\n  entryConfigSchema,\n  navigationMenuConfigSchema,\n  navigationItemConfigSchema,\n  siteSettingsConfigSchema,\n  blockConfigSchema,\n} from './content-validation';\n\nexport type {\n  ValidatedRiverbankSiteConfig,\n  ValidatedSdkCustomBlock,\n  ContentConfigInput,\n  ContentConfigOutput,\n} from './validation';\n\n// Block kind types (single source of truth from @riverbankcms/blocks)\nexport {\n  SYSTEM_BLOCK_KINDS,\n  type SystemBlockKind,\n  type CustomBlockKind,\n  type BlockKind,\n} from '../types';\n\n// Type-safe content entry helpers\nexport {\n  defineTypedContentType,\n  createEntry,\n  tiptap,\n  type TypedContentType,\n  type TypedEntryConfig,\n  type InferDataFromFields,\n  type FieldValueType,\n} from './typed-entries';\n\n// Re-export value types for convenience when building entry data\nexport type {\n  TipTapNode,\n  Media,\n  LinkValue,\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from './typed-entries';\n\n/**\n * Helper function to define a Builder site configuration with type checking.\n *\n * @example\n * ```typescript\n * import { defineConfig } from '@riverbankcms/sdk/config';\n *\n * export default defineConfig({\n *   siteId: '123e4567-e89b-12d3-a456-426614174000',\n *   theme: {\n *     palette: {\n *       primary: '#6d28d9',\n *     },\n *   },\n *   styles: {\n *     sectionBackgrounds: [\n *       { id: 'primary', label: 'Purple', token: 'primary' },\n *     ],\n *   },\n * });\n * ```\n */\nexport function defineConfig(config: RiverbankSiteConfig): RiverbankSiteConfig {\n  return config;\n}\n\n/**\n * Helper function to define content scaffolding configuration with type checking.\n *\n * This can be used to define content configuration in a separate file,\n * which is then imported into riverbank.config.ts.\n *\n * @example\n * ```typescript\n * // content.config.ts\n * import { defineContentConfig } from '@riverbankcms/sdk/config';\n *\n * export const contentConfig = defineContentConfig({\n *   contentTypes: [\n *     {\n *       key: 'testimonial',\n *       name: 'Testimonial',\n *       hasPages: false,\n *       fields: [\n *         { id: 'quote', type: 'richText', label: 'Quote', required: true },\n *       ],\n *     },\n *   ],\n *   pages: [\n *     { identifier: 'home', title: 'Home', path: '/' },\n *   ],\n * });\n *\n * // riverbank.config.ts\n * import { defineConfig } from '@riverbankcms/sdk/config';\n * import { contentConfig } from './content.config';\n *\n * export default defineConfig({\n *   siteId: '...',\n *   content: contentConfig,\n * });\n * ```\n */\nexport function defineContentConfig(config: ContentConfig): ContentConfig {\n  return config;\n}\n"]}

package/dist/server/config.mjs

@@ -30,6 +30,7 @@ import {
 import "./chunk-LNOUXALA.mjs";
 import "./chunk-AEFWG657.mjs";
 import "./chunk-BYBJA6SP.mjs";
+import "./chunk-NFEGQTCC.mjs";
 
 // src/config/typed-entries.ts
 function defineTypedContentType(config) {

package/dist/server/config.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/typed-entries.ts","../../src/config/index.ts"],"sourcesContent":["/**\n * Type-Safe Content Entries\n *\n * This module provides type-safe helpers for defining content types and entries\n * in SDK site configurations. When used with `as const`, TypeScript can infer\n * the exact shape of entry data from the content type's field definitions.\n *\n * @example\n * ```typescript\n * import { defineTypedContentType, createEntry, tiptap } from '@riverbankcms/sdk/config';\n *\n * // Define content type with `as const` for type inference\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n *\n * // Create entry with full type safety\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   data: {\n *     name: 'John Doe',      // TypeScript knows this is string\n *     quote: tiptap.paragraph('Great service!'),  // TypeScript knows this is TipTapNode\n *   },\n * });\n * ```\n */\n\nimport type {\n  FieldDefinition,\n  TextFieldDefinition,\n  RichTextFieldDefinition,\n  MediaFieldDefinition,\n  BooleanFieldDefinition,\n  NumberFieldDefinition,\n  DateFieldDefinition,\n  TimeFieldDefinition,\n  DateTimeFieldDefinition,\n  SlugFieldDefinition,\n  UrlFieldDefinition,\n  LinkFieldDefinition,\n  SelectFieldDefinition,\n  ReferenceFieldDefinition,\n  RepeaterFieldDefinition,\n  GroupFieldDefinition,\n  ModalFieldDefinition,\n  TabGroupFieldDefinition,\n  PresetOrCustomFieldDefinition,\n  ContentTypeSelectFieldDefinition,\n  EntryPickerFieldDefinition,\n  TipTapNode,\n  Media,\n  LinkValue,\n} from '@riverbankcms/blocks';\nimport type { ContentTypeConfig, EntryConfig } from './content-types';\n\n// Re-export value types for convenience\nexport type { TipTapNode, Media, LinkValue } from '@riverbankcms/blocks';\nexport type {\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from '@riverbankcms/blocks';\n\n// =============================================================================\n// Type Infrastructure\n// =============================================================================\n\n/**\n * Infers the data object shape from tabGroup tabs (flattens all tab fields).\n * TabGroup fields flatten all their tab fields into a single data object.\n */\ntype InferDataFromTabs<Tabs extends readonly { fields: readonly FieldDefinition[] }[]> =\n  InferDataFromFields<Tabs[number]['fields']>;\n\n// NOTE: Polymorphic repeater type inference would require a helper like this,\n// but TypeScript's mapped types don't distribute correctly over union keys\n// when nested inside conditional types. Left as documentation for future work.\n// type PolymorphicItemData<K, IT> = K extends string\n//   ? K extends keyof IT\n//     ? IT[K] extends { fields: infer F extends readonly FieldDefinition[] }\n//       ? { _type: K } & InferDataFromFields<F>\n//       : never\n//     : never\n//   : never;\n\n/**\n * Maps a field definition to its TypeScript value type.\n * Uses conditional types to infer the correct type based on field.type.\n *\n * Coverage:\n * - Simple primitives: text, boolean, number\n * - Complex types: richText (TipTapNode), media (Media | null), link (LinkValue | null)\n * - Date/time: date, time, datetime (all ISO strings)\n * - String-value: slug, url, reference, presetOrCustom, contentTypeSelect\n * - Select: single (string) vs multiple (string[])\n * - Entry picker: string | null\n * - Nested: group, modal (nested InferDataFromFields)\n * - Repeater: monomorphic (array) and polymorphic (discriminated union array)\n * - TabGroup: flattened fields from all tabs\n */\nexport type FieldValueType<F extends FieldDefinition> =\n  // Simple primitives - use specific field types for better inference\n  F extends TextFieldDefinition ? string :\n  F extends BooleanFieldDefinition ? boolean :\n  F extends NumberFieldDefinition ? number :\n  // Complex types\n  F extends RichTextFieldDefinition ? TipTapNode :\n  F extends MediaFieldDefinition ? Media | null :\n  F extends LinkFieldDefinition ? LinkValue | null :\n  // Date/time types (all stored as ISO strings)\n  F extends DateFieldDefinition ? string :\n  F extends TimeFieldDefinition ? string :\n  F extends DateTimeFieldDefinition ? string :\n  // String-value types\n  F extends SlugFieldDefinition ? string :\n  F extends UrlFieldDefinition ? string :\n  F extends ReferenceFieldDefinition ? string :\n  F extends PresetOrCustomFieldDefinition ? string :\n  F extends ContentTypeSelectFieldDefinition ? string :\n  // Select: check multiple flag first (more specific match)\n  F extends SelectFieldDefinition & { multiple: true } ? string[] :\n  F extends SelectFieldDefinition ? string :\n  // Entry picker\n  F extends EntryPickerFieldDefinition ? string | null :\n  // Nested types (group, modal)\n  F extends GroupFieldDefinition & { schema: { fields: infer GF } } ?\n    GF extends readonly FieldDefinition[] ? InferDataFromFields<GF> : never :\n  F extends ModalFieldDefinition & { schema: { fields: infer MF } } ?\n    MF extends readonly FieldDefinition[] ? InferDataFromFields<MF> : never :\n  // Repeater types (polymorphic first - more specific, then monomorphic)\n  // TODO: Polymorphic repeaters need more complex type distribution.\n  // For now, return unknown[] - the runtime data is still correct.\n  F extends { type: 'repeater'; polymorphic: true } ? unknown[] :\n  F extends RepeaterFieldDefinition & { schema: { fields: infer RF } } ?\n    RF extends readonly FieldDefinition[] ? InferDataFromFields<RF>[] : never :\n  // TabGroup (flattens all tab fields)\n  F extends TabGroupFieldDefinition & { tabs: infer T } ?\n    T extends readonly { fields: readonly FieldDefinition[] }[] ?\n      InferDataFromTabs<T> : never :\n  // Fallback for unknown types\n  unknown;\n\n/**\n * Infers the data object shape from an array of field definitions.\n * Required fields are non-optional, optional fields are `| undefined`.\n *\n * @example\n * ```typescript\n * const fields = [\n *   { id: 'name', type: 'text', required: true },\n *   { id: 'bio', type: 'text', required: false },\n * ] as const;\n *\n * type Data = InferDataFromFields<typeof fields>;\n * // { name: string; bio: string | undefined }\n * ```\n */\nexport type InferDataFromFields<Fields extends readonly FieldDefinition[]> = {\n  [F in Fields[number] as F['id']]: F extends { required: true }\n    ? FieldValueType<F>\n    : FieldValueType<F> | undefined;\n};\n\n// =============================================================================\n// TypedContentType\n// =============================================================================\n\n/**\n * A content type definition with preserved field types for type inference.\n * Extends ContentTypeConfig to ensure all required fields are present.\n * The generic parameters capture the literal types from `as const`.\n */\nexport interface TypedContentType<\n  K extends string = string,\n  F extends readonly FieldDefinition[] = readonly FieldDefinition[]\n> extends Omit<ContentTypeConfig, 'key' | 'fields'> {\n  key: K;\n  fields: F;\n}\n\n/**\n * Define a content type with preserved field types for type inference.\n *\n * IMPORTANT: Use `as const` on the config object to enable type inference.\n * Without `as const`, TypeScript widens literal types and inference won't work.\n *\n * @param config - The content type configuration\n * @returns The same config object with preserved types\n *\n * @example\n * ```typescript\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n * ```\n */\nexport function defineTypedContentType<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(config: TypedContentType<K, F>): TypedContentType<K, F> {\n  return config;\n}\n\n// =============================================================================\n// TypedEntryConfig and createEntry\n// =============================================================================\n\n/**\n * Entry configuration with typed data field.\n * Used internally by createEntry to enforce type safety.\n */\nexport interface TypedEntryConfig<Data extends Record<string, unknown>> {\n  /** Unique identifier for this entry. Required for SDK sync. */\n  identifier: string;\n  /** Title for the entry */\n  title?: string;\n  /** Slug for routable entries */\n  slug?: string;\n  /** Status: 'draft' or 'published' */\n  status?: 'draft' | 'published';\n  /** Summary/description */\n  summary?: string;\n  /** SEO meta title */\n  metaTitle?: string;\n  /** SEO meta description */\n  metaDescription?: string;\n  /** Entry data matching the content type's field definitions */\n  data: Data;\n}\n\n/**\n * Create a type-safe content entry for a typed content type.\n *\n * The data field is validated against the content type's field definitions.\n * TypeScript will error if:\n * - A required field is missing\n * - A field name is misspelled\n * - A field value has the wrong type\n * - An extra field is provided (with strict mode)\n *\n * @param contentType - The typed content type definition\n * @param entry - The entry configuration with typed data\n * @returns EntryConfig compatible with SDK content configuration\n *\n * @example\n * ```typescript\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   title: 'John Doe',\n *   status: 'published',\n *   data: {\n *     name: 'John Doe',\n *     quote: tiptap.paragraph('Great service!'),\n *   },\n * });\n * ```\n */\nexport function createEntry<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(\n  contentType: TypedContentType<K, F>,\n  entry: TypedEntryConfig<InferDataFromFields<F>>\n): EntryConfig {\n  return {\n    ...entry,\n    contentType: contentType.key,\n  };\n}\n\n// =============================================================================\n// TipTap Helpers\n// =============================================================================\n\n/**\n * Helpers for creating TipTap document structures.\n *\n * Use these helpers when populating richText fields to avoid manually\n * constructing the TipTap JSON structure.\n *\n * @example\n * ```typescript\n * // Simple paragraph\n * const body = tiptap.paragraph('Hello, world!');\n *\n * // Empty document\n * const emptyDoc = tiptap.empty();\n *\n * // Complex document\n * const doc = tiptap.doc([\n *   tiptap.heading(1, 'Welcome'),\n *   { type: 'paragraph', content: [{ type: 'text', text: 'Introduction...' }] },\n * ]);\n * ```\n */\nexport const tiptap = {\n  /**\n   * Create an empty TipTap document.\n   *\n   * @returns An empty TipTap document node\n   */\n  empty(): TipTapNode {\n    return { type: 'doc', content: [] };\n  },\n\n  /**\n   * Create a TipTap document with a single paragraph.\n   *\n   * @param text - The paragraph text content\n   * @returns A TipTap document with one paragraph\n   */\n  paragraph(text: string): TipTapNode {\n    return {\n      type: 'doc',\n      content: [\n        {\n          type: 'paragraph',\n          content: text ? [{ type: 'text', text }] : [],\n        },\n      ],\n    };\n  },\n\n  /**\n   * Create a TipTap document with custom content nodes.\n   *\n   * @param content - Array of TipTap nodes to include in the document\n   * @returns A TipTap document wrapping the content\n   */\n  doc(content: TipTapNode[]): TipTapNode {\n    return { type: 'doc', content };\n  },\n\n  /**\n   * Create a heading node.\n   *\n   * Note: This returns a heading node, not a document. Use with tiptap.doc()\n   * to create a complete document.\n   *\n   * @param level - Heading level (1-6)\n   * @param text - Heading text content\n   * @returns A TipTap heading node\n   */\n  heading(level: 1 | 2 | 3 | 4 | 5 | 6, text: string): TipTapNode {\n    return {\n      type: 'heading',\n      attrs: { level },\n      content: [{ type: 'text', text }],\n    };\n  },\n};\n","/**\n * SDK Site Configuration\n *\n * Types and utilities for defining site-level configuration\n * that SDK sites expose to the dashboard.\n */\n\nimport type { RiverbankSiteConfig, ContentConfig } from './types';\n\n// Types\nexport type {\n  RiverbankSiteConfig,\n  SiteStyleConfig,\n  SectionBackground,\n  SectionOptionsConfig,\n  ContainerOptionsConfig,\n  SectionSpacing,\n  ContainerMaxWidth,\n  ContainerAlignment,\n  SdkThemeConfig,\n  SdkThemePalette,\n  SdkCustomBlock,\n  FieldSelectOption,\n  BlockFieldConfig,\n  BlockFieldOptionsMap,\n  BlockFieldExtension,\n  BlockFieldExtensionsMap,\n  FieldDefinition,\n  // Content scaffolding types\n  ContentConfig,\n  ContentTypeConfig,\n  PageConfig,\n  EntryConfig,\n  BlockConfig,\n  NavigationMenuConfig,\n  NavigationItemConfig,\n  NavigationLinkType,\n  SiteSettingsConfig,\n} from './types';\n\n// Validation schemas\nexport {\n  riverbankSiteConfigSchema,\n  siteStyleConfigSchema,\n  sectionBackgroundSchema,\n  sectionSpacingSchema,\n  containerMaxWidthSchema,\n  containerAlignmentSchema,\n  sectionOptionsSchema,\n  containerOptionsSchema,\n  sdkThemeConfigSchema,\n  sdkThemePaletteSchema,\n  sdkCustomBlockSchema,\n  fieldSelectOptionSchema,\n  blockFieldConfigSchema,\n  blockFieldOptionsSchema,\n  blockFieldExtensionSchema,\n  blockFieldExtensionsSchema,\n  // Content scaffolding schemas\n  contentConfigSchema,\n} from './validation';\n\n// Content validation schemas for more granular use\nexport {\n  contentTypeConfigSchema,\n  pageConfigSchema,\n  entryConfigSchema,\n  navigationMenuConfigSchema,\n  navigationItemConfigSchema,\n  siteSettingsConfigSchema,\n  blockConfigSchema,\n} from './content-validation';\n\nexport type {\n  ValidatedRiverbankSiteConfig,\n  ValidatedSdkCustomBlock,\n  ContentConfigInput,\n  ContentConfigOutput,\n} from './validation';\n\n// Block kind types (single source of truth from @riverbankcms/blocks)\nexport {\n  SYSTEM_BLOCK_KINDS,\n  type SystemBlockKind,\n  type CustomBlockKind,\n  type BlockKind,\n} from '../types';\n\n// Type-safe content entry helpers\nexport {\n  defineTypedContentType,\n  createEntry,\n  tiptap,\n  type TypedContentType,\n  type TypedEntryConfig,\n  type InferDataFromFields,\n  type FieldValueType,\n} from './typed-entries';\n\n// Re-export value types for convenience when building entry data\nexport type {\n  TipTapNode,\n  Media,\n  LinkValue,\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from './typed-entries';\n\n/**\n * Helper function to define a Builder site configuration with type checking.\n *\n * @example\n * ```typescript\n * import { defineConfig } from '@riverbankcms/sdk/config';\n *\n * export default defineConfig({\n *   siteId: '123e4567-e89b-12d3-a456-426614174000',\n *   theme: {\n *     palette: {\n *       primary: '#6d28d9',\n *     },\n *   },\n *   styles: {\n *     sectionBackgrounds: [\n *       { id: 'primary', label: 'Purple', token: 'primary' },\n *     ],\n *   },\n * });\n * ```\n */\nexport function defineConfig(config: RiverbankSiteConfig): RiverbankSiteConfig {\n  return config;\n}\n\n/**\n * Helper function to define content scaffolding configuration with type checking.\n *\n * This can be used to define content configuration in a separate file,\n * which is then imported into riverbank.config.ts.\n *\n * @example\n * ```typescript\n * // content.config.ts\n * import { defineContentConfig } from '@riverbankcms/sdk/config';\n *\n * export const contentConfig = defineContentConfig({\n *   contentTypes: [\n *     {\n *       key: 'testimonial',\n *       name: 'Testimonial',\n *       hasPages: false,\n *       fields: [\n *         { id: 'quote', type: 'richText', label: 'Quote', required: true },\n *       ],\n *     },\n *   ],\n *   pages: [\n *     { identifier: 'home', title: 'Home', path: '/' },\n *   ],\n * });\n *\n * // riverbank.config.ts\n * import { defineConfig } from '@riverbankcms/sdk/config';\n * import { contentConfig } from './content.config';\n *\n * export default defineConfig({\n *   siteId: '...',\n *   content: contentConfig,\n * });\n * ```\n */\nexport function defineContentConfig(config: ContentConfig): ContentConfig {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgNO,SAAS,uBAGd,QAAwD;AACxD,SAAO;AACT;AAwDO,SAAS,YAId,aACA,OACa;AACb,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,YAAY;AAAA,EAC3B;AACF;AA2BO,IAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,QAAoB;AAClB,WAAO,EAAE,MAAM,OAAO,SAAS,CAAC,EAAE;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,MAA0B;AAClC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS;AAAA,QACP;AAAA,UACE,MAAM;AAAA,UACN,SAAS,OAAO,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,IAAI,CAAC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,SAAmC;AACrC,WAAO,EAAE,MAAM,OAAO,QAAQ;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,QAAQ,OAA8B,MAA0B;AAC9D,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO,EAAE,MAAM;AAAA,MACf,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;AAAA,IAClC;AAAA,EACF;AACF;;;ACvOO,SAAS,aAAa,QAAkD;AAC7E,SAAO;AACT;AAuCO,SAAS,oBAAoB,QAAsC;AACxE,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/config/typed-entries.ts","../../src/config/index.ts"],"sourcesContent":["/**\n * Type-Safe Content Entries\n *\n * This module provides type-safe helpers for defining content types and entries\n * in SDK site configurations. When used with `as const`, TypeScript can infer\n * the exact shape of entry data from the content type's field definitions.\n *\n * @example\n * ```typescript\n * import { defineTypedContentType, createEntry, tiptap } from '@riverbankcms/sdk/config';\n *\n * // Define content type with `as const` for type inference\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n *\n * // Create entry with full type safety\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   data: {\n *     name: 'John Doe',      // TypeScript knows this is string\n *     quote: tiptap.paragraph('Great service!'),  // TypeScript knows this is TipTapNode\n *   },\n * });\n * ```\n */\n\nimport type {\n  FieldDefinition,\n  TextFieldDefinition,\n  RichTextFieldDefinition,\n  MediaFieldDefinition,\n  BooleanFieldDefinition,\n  NumberFieldDefinition,\n  DateFieldDefinition,\n  TimeFieldDefinition,\n  DateTimeFieldDefinition,\n  SlugFieldDefinition,\n  UrlFieldDefinition,\n  LinkFieldDefinition,\n  SelectFieldDefinition,\n  ReferenceFieldDefinition,\n  RepeaterFieldDefinition,\n  GroupFieldDefinition,\n  ModalFieldDefinition,\n  TabGroupFieldDefinition,\n  PresetOrCustomFieldDefinition,\n  ContentTypeSelectFieldDefinition,\n  EntryPickerFieldDefinition,\n  TipTapNode,\n  Media,\n  LinkValue,\n} from '@riverbankcms/blocks';\nimport type { ContentTypeConfig, EntryConfig } from './content-types';\n\n// Re-export value types for convenience\nexport type { TipTapNode, Media, LinkValue } from '@riverbankcms/blocks';\nexport type {\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from '@riverbankcms/blocks';\n\n// =============================================================================\n// Type Infrastructure\n// =============================================================================\n\n/**\n * Infers the data object shape from tabGroup tabs (flattens all tab fields).\n * TabGroup fields flatten all their tab fields into a single data object.\n */\ntype InferDataFromTabs<Tabs extends readonly { fields: readonly FieldDefinition[] }[]> =\n  InferDataFromFields<Tabs[number]['fields']>;\n\n// NOTE: Polymorphic repeater type inference would require a helper like this,\n// but TypeScript's mapped types don't distribute correctly over union keys\n// when nested inside conditional types. Left as documentation for future work.\n// type PolymorphicItemData<K, IT> = K extends string\n//   ? K extends keyof IT\n//     ? IT[K] extends { fields: infer F extends readonly FieldDefinition[] }\n//       ? { _type: K } & InferDataFromFields<F>\n//       : never\n//     : never\n//   : never;\n\n/**\n * Maps a field definition to its TypeScript value type.\n * Uses conditional types to infer the correct type based on field.type.\n *\n * Coverage:\n * - Simple primitives: text, boolean, number\n * - Complex types: richText (TipTapNode), media (Media | null), link (LinkValue | null)\n * - Date/time: date, time, datetime (all ISO strings)\n * - String-value: slug, url, reference, presetOrCustom, contentTypeSelect\n * - Select: single (string) vs multiple (string[])\n * - Entry picker: string | null\n * - Nested: group, modal (nested InferDataFromFields)\n * - Repeater: monomorphic (array) and polymorphic (discriminated union array)\n * - TabGroup: flattened fields from all tabs\n */\nexport type FieldValueType<F extends FieldDefinition> =\n  // Simple primitives - use specific field types for better inference\n  F extends TextFieldDefinition ? string :\n  F extends BooleanFieldDefinition ? boolean :\n  F extends NumberFieldDefinition ? number :\n  // Complex types\n  F extends RichTextFieldDefinition ? TipTapNode :\n  F extends MediaFieldDefinition ? Media | null :\n  F extends LinkFieldDefinition ? LinkValue | null :\n  // Date/time types (all stored as ISO strings)\n  F extends DateFieldDefinition ? string :\n  F extends TimeFieldDefinition ? string :\n  F extends DateTimeFieldDefinition ? string :\n  // String-value types\n  F extends SlugFieldDefinition ? string :\n  F extends UrlFieldDefinition ? string :\n  F extends ReferenceFieldDefinition ? string :\n  F extends PresetOrCustomFieldDefinition ? string :\n  F extends ContentTypeSelectFieldDefinition ? string :\n  // Select: check multiple flag first (more specific match)\n  F extends SelectFieldDefinition & { multiple: true } ? string[] :\n  F extends SelectFieldDefinition ? string :\n  // Entry picker\n  F extends EntryPickerFieldDefinition ? string | null :\n  // Nested types (group, modal)\n  F extends GroupFieldDefinition & { schema: { fields: infer GF } } ?\n    GF extends readonly FieldDefinition[] ? InferDataFromFields<GF> : never :\n  F extends ModalFieldDefinition & { schema: { fields: infer MF } } ?\n    MF extends readonly FieldDefinition[] ? InferDataFromFields<MF> : never :\n  // Repeater types (polymorphic first - more specific, then monomorphic)\n  // TODO: Polymorphic repeaters need more complex type distribution.\n  // For now, return unknown[] - the runtime data is still correct.\n  F extends { type: 'repeater'; polymorphic: true } ? unknown[] :\n  F extends RepeaterFieldDefinition & { schema: { fields: infer RF } } ?\n    RF extends readonly FieldDefinition[] ? InferDataFromFields<RF>[] : never :\n  // TabGroup (flattens all tab fields)\n  F extends TabGroupFieldDefinition & { tabs: infer T } ?\n    T extends readonly { fields: readonly FieldDefinition[] }[] ?\n      InferDataFromTabs<T> : never :\n  // Fallback for unknown types\n  unknown;\n\n/**\n * Infers the data object shape from an array of field definitions.\n * Required fields are non-optional, optional fields are `| undefined`.\n *\n * @example\n * ```typescript\n * const fields = [\n *   { id: 'name', type: 'text', required: true },\n *   { id: 'bio', type: 'text', required: false },\n * ] as const;\n *\n * type Data = InferDataFromFields<typeof fields>;\n * // { name: string; bio: string | undefined }\n * ```\n */\nexport type InferDataFromFields<Fields extends readonly FieldDefinition[]> = {\n  [F in Fields[number] as F['id']]: F extends { required: true }\n    ? FieldValueType<F>\n    : FieldValueType<F> | undefined;\n};\n\n// =============================================================================\n// TypedContentType\n// =============================================================================\n\n/**\n * A content type definition with preserved field types for type inference.\n * Extends ContentTypeConfig to ensure all required fields are present.\n * The generic parameters capture the literal types from `as const`.\n */\nexport interface TypedContentType<\n  K extends string = string,\n  F extends readonly FieldDefinition[] = readonly FieldDefinition[]\n> extends Omit<ContentTypeConfig, 'key' | 'fields'> {\n  key: K;\n  fields: F;\n}\n\n/**\n * Define a content type with preserved field types for type inference.\n *\n * IMPORTANT: Use `as const` on the config object to enable type inference.\n * Without `as const`, TypeScript widens literal types and inference won't work.\n *\n * @param config - The content type configuration\n * @returns The same config object with preserved types\n *\n * @example\n * ```typescript\n * export const testimonialType = defineTypedContentType({\n *   key: 'testimonial',\n *   name: 'Testimonial',\n *   hasPages: false,\n *   fields: [\n *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },\n *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },\n *   ],\n * } as const);\n * ```\n */\nexport function defineTypedContentType<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(config: TypedContentType<K, F>): TypedContentType<K, F> {\n  return config;\n}\n\n// =============================================================================\n// TypedEntryConfig and createEntry\n// =============================================================================\n\n/**\n * Entry configuration with typed data field.\n * Used internally by createEntry to enforce type safety.\n */\nexport interface TypedEntryConfig<Data extends Record<string, unknown>> {\n  /** Unique identifier for this entry. Required for SDK sync. */\n  identifier: string;\n  /** Title for the entry */\n  title?: string;\n  /** Slug for routable entries */\n  slug?: string;\n  /** Status: 'draft' or 'published' */\n  status?: 'draft' | 'published';\n  /** Summary/description */\n  summary?: string;\n  /** SEO meta title */\n  metaTitle?: string;\n  /** SEO meta description */\n  metaDescription?: string;\n  /** Entry data matching the content type's field definitions */\n  data: Data;\n}\n\n/**\n * Create a type-safe content entry for a typed content type.\n *\n * The data field is validated against the content type's field definitions.\n * TypeScript will error if:\n * - A required field is missing\n * - A field name is misspelled\n * - A field value has the wrong type\n * - An extra field is provided (with strict mode)\n *\n * @param contentType - The typed content type definition\n * @param entry - The entry configuration with typed data\n * @returns EntryConfig compatible with SDK content configuration\n *\n * @example\n * ```typescript\n * const entry = createEntry(testimonialType, {\n *   identifier: 'testimonial-1',\n *   title: 'John Doe',\n *   status: 'published',\n *   data: {\n *     name: 'John Doe',\n *     quote: tiptap.paragraph('Great service!'),\n *   },\n * });\n * ```\n */\nexport function createEntry<\n  K extends string,\n  F extends readonly FieldDefinition[]\n>(\n  contentType: TypedContentType<K, F>,\n  entry: TypedEntryConfig<InferDataFromFields<F>>\n): EntryConfig {\n  return {\n    ...entry,\n    contentType: contentType.key,\n  };\n}\n\n// =============================================================================\n// TipTap Helpers\n// =============================================================================\n\n/**\n * Helpers for creating TipTap document structures.\n *\n * Use these helpers when populating richText fields to avoid manually\n * constructing the TipTap JSON structure.\n *\n * @example\n * ```typescript\n * // Simple paragraph\n * const body = tiptap.paragraph('Hello, world!');\n *\n * // Empty document\n * const emptyDoc = tiptap.empty();\n *\n * // Complex document\n * const doc = tiptap.doc([\n *   tiptap.heading(1, 'Welcome'),\n *   { type: 'paragraph', content: [{ type: 'text', text: 'Introduction...' }] },\n * ]);\n * ```\n */\nexport const tiptap = {\n  /**\n   * Create an empty TipTap document.\n   *\n   * @returns An empty TipTap document node\n   */\n  empty(): TipTapNode {\n    return { type: 'doc', content: [] };\n  },\n\n  /**\n   * Create a TipTap document with a single paragraph.\n   *\n   * @param text - The paragraph text content\n   * @returns A TipTap document with one paragraph\n   */\n  paragraph(text: string): TipTapNode {\n    return {\n      type: 'doc',\n      content: [\n        {\n          type: 'paragraph',\n          content: text ? [{ type: 'text', text }] : [],\n        },\n      ],\n    };\n  },\n\n  /**\n   * Create a TipTap document with custom content nodes.\n   *\n   * @param content - Array of TipTap nodes to include in the document\n   * @returns A TipTap document wrapping the content\n   */\n  doc(content: TipTapNode[]): TipTapNode {\n    return { type: 'doc', content };\n  },\n\n  /**\n   * Create a heading node.\n   *\n   * Note: This returns a heading node, not a document. Use with tiptap.doc()\n   * to create a complete document.\n   *\n   * @param level - Heading level (1-6)\n   * @param text - Heading text content\n   * @returns A TipTap heading node\n   */\n  heading(level: 1 | 2 | 3 | 4 | 5 | 6, text: string): TipTapNode {\n    return {\n      type: 'heading',\n      attrs: { level },\n      content: [{ type: 'text', text }],\n    };\n  },\n};\n","/**\n * SDK Site Configuration\n *\n * Types and utilities for defining site-level configuration\n * that SDK sites expose to the dashboard.\n */\n\nimport type { RiverbankSiteConfig, ContentConfig } from './types';\n\n// Types\nexport type {\n  RiverbankSiteConfig,\n  SiteStyleConfig,\n  SectionBackground,\n  SectionOptionsConfig,\n  ContainerOptionsConfig,\n  SectionSpacing,\n  ContainerMaxWidth,\n  ContainerAlignment,\n  SdkThemeConfig,\n  SdkThemePalette,\n  SdkCustomBlock,\n  FieldSelectOption,\n  BlockFieldConfig,\n  BlockFieldOptionsMap,\n  BlockFieldExtension,\n  BlockFieldExtensionsMap,\n  FieldDefinition,\n  // Content scaffolding types\n  ContentConfig,\n  ContentTypeConfig,\n  PageConfig,\n  EntryConfig,\n  BlockConfig,\n  NavigationMenuConfig,\n  NavigationItemConfig,\n  NavigationLinkType,\n  SiteSettingsConfig,\n} from './types';\n\n// Validation schemas\nexport {\n  riverbankSiteConfigSchema,\n  siteStyleConfigSchema,\n  sectionBackgroundSchema,\n  sectionSpacingSchema,\n  containerMaxWidthSchema,\n  containerAlignmentSchema,\n  sectionOptionsSchema,\n  containerOptionsSchema,\n  sdkThemeConfigSchema,\n  sdkThemePaletteSchema,\n  sdkCustomBlockSchema,\n  fieldSelectOptionSchema,\n  blockFieldConfigSchema,\n  blockFieldOptionsSchema,\n  blockFieldExtensionSchema,\n  blockFieldExtensionsSchema,\n  // Content scaffolding schemas\n  contentConfigSchema,\n} from './validation';\n\n// Content validation schemas for more granular use\nexport {\n  contentTypeConfigSchema,\n  pageConfigSchema,\n  entryConfigSchema,\n  navigationMenuConfigSchema,\n  navigationItemConfigSchema,\n  siteSettingsConfigSchema,\n  blockConfigSchema,\n} from './content-validation';\n\nexport type {\n  ValidatedRiverbankSiteConfig,\n  ValidatedSdkCustomBlock,\n  ContentConfigInput,\n  ContentConfigOutput,\n} from './validation';\n\n// Block kind types (single source of truth from @riverbankcms/blocks)\nexport {\n  SYSTEM_BLOCK_KINDS,\n  type SystemBlockKind,\n  type CustomBlockKind,\n  type BlockKind,\n} from '../types';\n\n// Type-safe content entry helpers\nexport {\n  defineTypedContentType,\n  createEntry,\n  tiptap,\n  type TypedContentType,\n  type TypedEntryConfig,\n  type InferDataFromFields,\n  type FieldValueType,\n} from './typed-entries';\n\n// Re-export value types for convenience when building entry data\nexport type {\n  TipTapNode,\n  Media,\n  LinkValue,\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n} from './typed-entries';\n\n/**\n * Helper function to define a Builder site configuration with type checking.\n *\n * @example\n * ```typescript\n * import { defineConfig } from '@riverbankcms/sdk/config';\n *\n * export default defineConfig({\n *   siteId: '123e4567-e89b-12d3-a456-426614174000',\n *   theme: {\n *     palette: {\n *       primary: '#6d28d9',\n *     },\n *   },\n *   styles: {\n *     sectionBackgrounds: [\n *       { id: 'primary', label: 'Purple', token: 'primary' },\n *     ],\n *   },\n * });\n * ```\n */\nexport function defineConfig(config: RiverbankSiteConfig): RiverbankSiteConfig {\n  return config;\n}\n\n/**\n * Helper function to define content scaffolding configuration with type checking.\n *\n * This can be used to define content configuration in a separate file,\n * which is then imported into riverbank.config.ts.\n *\n * @example\n * ```typescript\n * // content.config.ts\n * import { defineContentConfig } from '@riverbankcms/sdk/config';\n *\n * export const contentConfig = defineContentConfig({\n *   contentTypes: [\n *     {\n *       key: 'testimonial',\n *       name: 'Testimonial',\n *       hasPages: false,\n *       fields: [\n *         { id: 'quote', type: 'richText', label: 'Quote', required: true },\n *       ],\n *     },\n *   ],\n *   pages: [\n *     { identifier: 'home', title: 'Home', path: '/' },\n *   ],\n * });\n *\n * // riverbank.config.ts\n * import { defineConfig } from '@riverbankcms/sdk/config';\n * import { contentConfig } from './content.config';\n *\n * export default defineConfig({\n *   siteId: '...',\n *   content: contentConfig,\n * });\n * ```\n */\nexport function defineContentConfig(config: ContentConfig): ContentConfig {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgNO,SAAS,uBAGd,QAAwD;AACxD,SAAO;AACT;AAwDO,SAAS,YAId,aACA,OACa;AACb,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,YAAY;AAAA,EAC3B;AACF;AA2BO,IAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,QAAoB;AAClB,WAAO,EAAE,MAAM,OAAO,SAAS,CAAC,EAAE;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,MAA0B;AAClC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS;AAAA,QACP;AAAA,UACE,MAAM;AAAA,UACN,SAAS,OAAO,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,IAAI,CAAC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,SAAmC;AACrC,WAAO,EAAE,MAAM,OAAO,QAAQ;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,QAAQ,OAA8B,MAA0B;AAC9D,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO,EAAE,MAAM;AAAA,MACf,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;AAAA,IAClC;AAAA,EACF;AACF;;;ACvOO,SAAS,aAAa,QAAkD;AAC7E,SAAO;AACT;AAuCO,SAAS,oBAAoB,QAAsC;AACxE,SAAO;AACT;","names":[]}

package/dist/server/data.d.mts

@@ -1,10 +1,10 @@
 import { P as PageOutline, S as SdkCustomBlock } from './schema-Z6-afHJG.mjs';
 import { P as PrefetchContext, R as ResolvedBlockData, D as DataLoaderOverrides } from './types-CbagRQ_7.mjs';
 export { B as BlockLoaderMap, a as DataLoaderContext, b as DataLoaderFn } from './types-CbagRQ_7.mjs';
-import { R as RiverbankClient } from './types-MF2AWoKv.mjs';
+import { R as RiverbankClient } from './types-C-LShyIg.mjs';
 import 'zod';
 import './blockKinds-B6MWzNWp.mjs';
-import './types-Dsu9wsUh.mjs';
+import './types-BSV6Vc-P.mjs';
 import '@riverbankcms/ai';
 import './link-DjxLyC82.mjs';
 import '@riverbankcms/media-storage-supabase';

package/dist/server/data.d.ts

@@ -1,10 +1,10 @@
 import { P as PageOutline, S as SdkCustomBlock } from './schema-Z6-afHJG.js';
 import { P as PrefetchContext, R as ResolvedBlockData, D as DataLoaderOverrides } from './types-DuQCNVV0.js';
 export { B as BlockLoaderMap, a as DataLoaderContext, b as DataLoaderFn } from './types-DuQCNVV0.js';
-import { R as RiverbankClient } from './types-DnkRh0UL.js';
+import { R as RiverbankClient } from './types-BRQyLrQU.js';
 import 'zod';
 import './blockKinds-B6MWzNWp.js';
-import './types-CVykEqXN.js';
+import './types-Dt98DeYa.js';
 import '@riverbankcms/ai';
 import './link-DjxLyC82.js';
 import '@riverbankcms/media-storage-supabase';

package/dist/server/data.js

@@ -7,6 +7,7 @@ var _chunkY7347JMZjs = require('./chunk-Y7347JMZ.js');
 
 var _chunkRVDS7VSPjs = require('./chunk-RVDS7VSP.js');
 require('./chunk-YYO3RIFO.js');
+require('./chunk-4CV4JOE5.js');
 
 
 

package/dist/server/data.js.map

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

package/dist/server/data.mjs

@@ -7,6 +7,7 @@ import {
   prefetchBlockData
 } from "./chunk-AEFWG657.mjs";
 import "./chunk-BYBJA6SP.mjs";
+import "./chunk-NFEGQTCC.mjs";
 export {
   SUPPORTED_LOADER_ENDPOINTS,
   executeCodeLoaders,

package/dist/server/env.d.mts

@@ -1,15 +1,56 @@
 /**
  * Environment detection utilities for SDK
  *
- * Provides helpers for detecting preview mode and other environment states.
+ * Provides helpers for detecting preview mode and auto-selecting the correct API key.
+ *
+ * @example
+ * ```ts
+ * import { getRiverbankEnv } from '@riverbankcms/sdk/env';
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ *
+ * const env = getRiverbankEnv();
+ * const client = createRiverbankClient({
+ *   apiKey: env.apiKey,
+ *   baseUrl: env.baseUrl,
+ * });
+ * ```
+ */
+/**
+ * Environment target: 'local' for development, 'remote' for production
+ */
+type RiverbankEnvTarget = 'local' | 'remote';
+/**
+ * Runtime environment configuration
  */
+interface RiverbankEnvConfig {
+    /** The detected environment target */
+    target: RiverbankEnvTarget;
+    /** Whether preview mode is enabled */
+    previewMode: boolean;
+    /** Site ID */
+    siteId: string;
+    /** Dashboard/API base URL */
+    baseUrl: string;
+    /** The auto-selected API key (preview or content key based on mode) */
+    apiKey: string;
+    /** The type of key being used */
+    keyType: 'preview' | 'content';
+}
+/**
+ * Error thrown when required environment variables are missing
+ */
+declare class RiverbankEnvError extends Error {
+    readonly missingVars: string[];
+    constructor(message: string, missingVars: string[]);
+}
 /**
  * Detects if the current environment is in preview mode.
  *
  * Precedence:
- * 1. RIVERBANK_PREVIEW env var (explicit override) - 'true' or 'false'
- * 2. VERCEL_ENV === 'preview' (Vercel preview deployments)
- * 3. Default: false (production behavior)
+ * 1. RIVERBANK_PREVIEW_MODE env var (explicit override) - 'true' or 'false'
+ * 2. RIVERBANK_PREVIEW env var (legacy) - 'true' or 'false'
+ * 3. VERCEL_ENV === 'preview' (Vercel preview deployments)
+ * 4. Default: false (production behavior)
  *
  * In preview mode:
  * - Draft content is visible
@@ -19,5 +60,50 @@
  * @returns true if in preview mode, false otherwise
  */
 declare function isPreviewMode(): boolean;
+/**
+ * Get the current environment target.
+ *
+ * This is a convenience function for checking `RIVERBANK_ENV`.
+ *
+ * @returns 'local' or 'remote'
+ */
+declare function getRiverbankTarget(): RiverbankEnvTarget;
+/**
+ * Get runtime environment configuration with automatic API key selection.
+ *
+ * This helper reads environment variables and automatically selects the correct
+ * API key based on the current environment and preview mode:
+ *
+ * - When `RIVERBANK_PREVIEW_MODE=true`: Uses preview API key (bld_preview_sk_...)
+ * - When `RIVERBANK_PREVIEW_MODE=false` (default): Uses content API key (bld_live_sk_...)
+ *
+ * Environment variable patterns:
+ * - `RIVERBANK_ENV`: 'local' (default) or 'remote'
+ * - `RIVERBANK_PREVIEW_MODE`: 'true' or 'false' (default)
+ * - `RIVERBANK_{LOCAL|REMOTE}_SITE_ID`: Site ID
+ * - `RIVERBANK_{LOCAL|REMOTE}_DASHBOARD_URL`: Dashboard URL
+ * - `RIVERBANK_{LOCAL|REMOTE}_API_KEY`: Content/live API key
+ * - `RIVERBANK_{LOCAL|REMOTE}_PREVIEW_API_KEY`: Preview API key
+ *
+ * @returns Environment configuration with auto-selected API key
+ * @throws {RiverbankEnvError} If required environment variables are missing
+ *
+ * @example
+ * ```ts
+ * // lib/builder-client.ts
+ * import { getRiverbankEnv } from '@riverbankcms/sdk/env';
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ *
+ * const env = getRiverbankEnv();
+ *
+ * export const client = createRiverbankClient({
+ *   apiKey: env.apiKey,
+ *   baseUrl: env.baseUrl,
+ * });
+ *
+ * export const siteId = env.siteId;
+ * ```
+ */
+declare function getRiverbankEnv(): RiverbankEnvConfig;
 
-export { isPreviewMode };
+export { type RiverbankEnvConfig, RiverbankEnvError, type RiverbankEnvTarget, getRiverbankEnv, getRiverbankTarget, isPreviewMode };

package/dist/server/env.d.ts

@@ -1,15 +1,56 @@
 /**
  * Environment detection utilities for SDK
  *
- * Provides helpers for detecting preview mode and other environment states.
+ * Provides helpers for detecting preview mode and auto-selecting the correct API key.
+ *
+ * @example
+ * ```ts
+ * import { getRiverbankEnv } from '@riverbankcms/sdk/env';
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ *
+ * const env = getRiverbankEnv();
+ * const client = createRiverbankClient({
+ *   apiKey: env.apiKey,
+ *   baseUrl: env.baseUrl,
+ * });
+ * ```
+ */
+/**
+ * Environment target: 'local' for development, 'remote' for production
+ */
+type RiverbankEnvTarget = 'local' | 'remote';
+/**
+ * Runtime environment configuration
  */
+interface RiverbankEnvConfig {
+    /** The detected environment target */
+    target: RiverbankEnvTarget;
+    /** Whether preview mode is enabled */
+    previewMode: boolean;
+    /** Site ID */
+    siteId: string;
+    /** Dashboard/API base URL */
+    baseUrl: string;
+    /** The auto-selected API key (preview or content key based on mode) */
+    apiKey: string;
+    /** The type of key being used */
+    keyType: 'preview' | 'content';
+}
+/**
+ * Error thrown when required environment variables are missing
+ */
+declare class RiverbankEnvError extends Error {
+    readonly missingVars: string[];
+    constructor(message: string, missingVars: string[]);
+}
 /**
  * Detects if the current environment is in preview mode.
  *
  * Precedence:
- * 1. RIVERBANK_PREVIEW env var (explicit override) - 'true' or 'false'
- * 2. VERCEL_ENV === 'preview' (Vercel preview deployments)
- * 3. Default: false (production behavior)
+ * 1. RIVERBANK_PREVIEW_MODE env var (explicit override) - 'true' or 'false'
+ * 2. RIVERBANK_PREVIEW env var (legacy) - 'true' or 'false'
+ * 3. VERCEL_ENV === 'preview' (Vercel preview deployments)
+ * 4. Default: false (production behavior)
  *
  * In preview mode:
  * - Draft content is visible
@@ -19,5 +60,50 @@
  * @returns true if in preview mode, false otherwise
  */
 declare function isPreviewMode(): boolean;
+/**
+ * Get the current environment target.
+ *
+ * This is a convenience function for checking `RIVERBANK_ENV`.
+ *
+ * @returns 'local' or 'remote'
+ */
+declare function getRiverbankTarget(): RiverbankEnvTarget;
+/**
+ * Get runtime environment configuration with automatic API key selection.
+ *
+ * This helper reads environment variables and automatically selects the correct
+ * API key based on the current environment and preview mode:
+ *
+ * - When `RIVERBANK_PREVIEW_MODE=true`: Uses preview API key (bld_preview_sk_...)
+ * - When `RIVERBANK_PREVIEW_MODE=false` (default): Uses content API key (bld_live_sk_...)
+ *
+ * Environment variable patterns:
+ * - `RIVERBANK_ENV`: 'local' (default) or 'remote'
+ * - `RIVERBANK_PREVIEW_MODE`: 'true' or 'false' (default)
+ * - `RIVERBANK_{LOCAL|REMOTE}_SITE_ID`: Site ID
+ * - `RIVERBANK_{LOCAL|REMOTE}_DASHBOARD_URL`: Dashboard URL
+ * - `RIVERBANK_{LOCAL|REMOTE}_API_KEY`: Content/live API key
+ * - `RIVERBANK_{LOCAL|REMOTE}_PREVIEW_API_KEY`: Preview API key
+ *
+ * @returns Environment configuration with auto-selected API key
+ * @throws {RiverbankEnvError} If required environment variables are missing
+ *
+ * @example
+ * ```ts
+ * // lib/builder-client.ts
+ * import { getRiverbankEnv } from '@riverbankcms/sdk/env';
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ *
+ * const env = getRiverbankEnv();
+ *
+ * export const client = createRiverbankClient({
+ *   apiKey: env.apiKey,
+ *   baseUrl: env.baseUrl,
+ * });
+ *
+ * export const siteId = env.siteId;
+ * ```
+ */
+declare function getRiverbankEnv(): RiverbankEnvConfig;
 
-export { isPreviewMode };
+export { type RiverbankEnvConfig, RiverbankEnvError, type RiverbankEnvTarget, getRiverbankEnv, getRiverbankTarget, isPreviewMode };

package/dist/server/env.js

@@ -1,7 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkWYNEYDXOjs = require('./chunk-WYNEYDXO.js');
 
 
-exports.isPreviewMode = _chunkWYNEYDXOjs.isPreviewMode;
+
+var _chunk2IZ6S225js = require('./chunk-2IZ6S225.js');
+require('./chunk-4CV4JOE5.js');
+
+
+
+
+
+exports.RiverbankEnvError = _chunk2IZ6S225js.RiverbankEnvError; exports.getRiverbankEnv = _chunk2IZ6S225js.getRiverbankEnv; exports.getRiverbankTarget = _chunk2IZ6S225js.getRiverbankTarget; exports.isPreviewMode = _chunk2IZ6S225js.isPreviewMode;
 //# sourceMappingURL=env.js.map

package/dist/server/env.js.map

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

package/dist/server/env.mjs

@@ -1,7 +1,14 @@
 import {
+  RiverbankEnvError,
+  getRiverbankEnv,
+  getRiverbankTarget,
   isPreviewMode
-} from "./chunk-LQUKXIW7.mjs";
+} from "./chunk-PPHZV6YD.mjs";
+import "./chunk-NFEGQTCC.mjs";
 export {
+  RiverbankEnvError,
+  getRiverbankEnv,
+  getRiverbankTarget,
   isPreviewMode
 };
 //# sourceMappingURL=env.mjs.map

package/dist/server/{index-BL66CU6d.d.mts → index--Oyunk_B.d.mts}

@@ -1,5 +1,5 @@
-import { a as LoadPageResult } from './loadPage-CxlYLe5K.mjs';
-import { S as SiteResponse } from './types-MF2AWoKv.mjs';
+import { a as LoadPageResult } from './loadPage-BucnLHmE.mjs';
+import { S as SiteResponse } from './types-C-LShyIg.mjs';
 
 /**
  * Metadata generation helper for Next.js pages

package/dist/server/{index-CJk9iQQW.d.ts → index-C9Ra8dza.d.ts}

@@ -1,5 +1,5 @@
-import { a as LoadPageResult } from './loadPage-i2r-X5b9.js';
-import { S as SiteResponse } from './types-DnkRh0UL.js';
+import { a as LoadPageResult } from './loadPage-BmYJCe_V.js';
+import { S as SiteResponse } from './types-BRQyLrQU.js';
 
 /**
  * Metadata generation helper for Next.js pages

package/dist/server/{index-Bkva0WAj.d.mts → index-Clm3skz_.d.mts}

@@ -1,4 +1,4 @@
-import { a as RiverbankClientConfig, R as RiverbankClient } from './types-MF2AWoKv.mjs';
+import { a as RiverbankClientConfig, R as RiverbankClient } from './types-C-LShyIg.mjs';
 import './schema-Z6-afHJG.mjs';
 
 /**

package/dist/server/{index-CSBWKA3r.d.ts → index-DLvNddi-.d.ts}

@@ -1,4 +1,4 @@
-import { a as RiverbankClientConfig, R as RiverbankClient } from './types-DnkRh0UL.js';
+import { a as RiverbankClientConfig, R as RiverbankClient } from './types-BRQyLrQU.js';
 import './schema-Z6-afHJG.js';
 
 /**