@riverbankcms/sdk 0.4.3 → 0.5.1

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/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;AC4EO,SAAS,YAAA,CAAa,MAAA,EAAkD;AAC7E,EAAA,OAAO,MAAA;AACT;AAuCO,SAAS,mBAAA,CAAoB,MAAA,EAAsC;AACxE,EAAA,OAAO,MAAA;AACT;ADhHA;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;AACF,q4DAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/config.js","sourcesContent":[null,"/**\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/**\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

@@ -23,15 +23,79 @@ import {
   sectionSpacingSchema,
   siteSettingsConfigSchema,
   siteStyleConfigSchema
-} from "./chunk-I6K5REFT.mjs";
+} from "./chunk-P4K63SBZ.mjs";
 import {
   SYSTEM_BLOCK_KINDS
 } from "./chunk-D2QLTPUJ.mjs";
-import "./chunk-U2NI3TS3.mjs";
-import "./chunk-7DS4Q3GA.mjs";
-import "./chunk-USQF2XTU.mjs";
+import "./chunk-LNOUXALA.mjs";
+import "./chunk-AEFWG657.mjs";
+import "./chunk-BYBJA6SP.mjs";
 import "./chunk-BJTO5JO5.mjs";
 
+// src/config/typed-entries.ts
+function defineTypedContentType(config) {
+  return config;
+}
+function createEntry(contentType, entry) {
+  return {
+    ...entry,
+    contentType: contentType.key
+  };
+}
+var tiptap = {
+  /**
+   * Create an empty TipTap document.
+   *
+   * @returns An empty TipTap document node
+   */
+  empty() {
+    return { type: "doc", content: [] };
+  },
+  /**
+   * Create a TipTap document with a single paragraph.
+   *
+   * @param text - The paragraph text content
+   * @returns A TipTap document with one paragraph
+   */
+  paragraph(text) {
+    return {
+      type: "doc",
+      content: [
+        {
+          type: "paragraph",
+          content: text ? [{ type: "text", text }] : []
+        }
+      ]
+    };
+  },
+  /**
+   * Create a TipTap document with custom content nodes.
+   *
+   * @param content - Array of TipTap nodes to include in the document
+   * @returns A TipTap document wrapping the content
+   */
+  doc(content) {
+    return { type: "doc", content };
+  },
+  /**
+   * Create a heading node.
+   *
+   * Note: This returns a heading node, not a document. Use with tiptap.doc()
+   * to create a complete document.
+   *
+   * @param level - Heading level (1-6)
+   * @param text - Heading text content
+   * @returns A TipTap heading node
+   */
+  heading(level, text) {
+    return {
+      type: "heading",
+      attrs: { level },
+      content: [{ type: "text", text }]
+    };
+  }
+};
+
 // src/config/index.ts
 function defineConfig(config) {
   return config;
@@ -51,8 +115,10 @@ export {
   containerOptionsSchema,
   contentConfigSchema,
   contentTypeConfigSchema,
+  createEntry,
   defineConfig,
   defineContentConfig,
+  defineTypedContentType,
   entryConfigSchema,
   fieldSelectOptionSchema,
   navigationItemConfigSchema,
@@ -66,6 +132,7 @@ export {
   sectionOptionsSchema,
   sectionSpacingSchema,
   siteSettingsConfigSchema,
-  siteStyleConfigSchema
+  siteStyleConfigSchema,
+  tiptap
 };
 //# sourceMappingURL=config.mjs.map

package/dist/server/config.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/index.ts"],"sourcesContent":["/**\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/**\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8GO,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/core-DsNWrl3o.d.mts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+
+declare const colorTokens: readonly ["background/base", "background/elevated", "surface/base", "surface/subtle", "surface/inverted", "content/primary", "content/secondary", "accent/primary", "accent/secondary", "border/base"];
+declare const typographyTokens: readonly ["display/hero", "display/section", "heading/large", "heading/medium", "heading/small", "body/normal", "body/small", "caption"];
+declare const spacingTokens: readonly ["none", "3xs", "2xs", "xs", "sm", "md", "lg", "xl", "2xl", "3xl"];
+declare const radiusTokens: readonly ["none", "xs", "sm", "md", "lg", "pill", "full"];
+declare const shadowTokens: readonly ["none", "soft", "medium", "strong"];
+type ThemeTokens = {
+    color: Record<(typeof colorTokens)[number], string>;
+    typography: Record<(typeof typographyTokens)[number], {
+        fontSize: string;
+        lineHeight: string;
+        fontWeight?: string;
+    }>;
+    spacing: Record<(typeof spacingTokens)[number], string>;
+    radius: Record<(typeof radiusTokens)[number], string>;
+    shadow: Record<(typeof shadowTokens)[number], string>;
+    palette: Record<string, string>;
+};
+
+type RouteMapEntry = string | {
+    path?: string | null;
+    href?: string | null;
+    url?: string | null;
+    draftPath?: string | null;
+    [key: string]: unknown;
+};
+type RouteMap = Record<string, RouteMapEntry>;
+type TransformContext = {
+    theme: ThemeTokens;
+    locale?: string;
+    routes?: RouteMap;
+};
+type TransformHandler<TOptions = unknown> = (value: unknown, options: TOptions, context: TransformContext) => unknown;
+type TransformDefinition<TOptions = unknown> = {
+    id: string;
+    summary?: string;
+    kind: "formatter" | "collection" | "string" | "html";
+    schema?: z.ZodType<TOptions>;
+    run: TransformHandler<TOptions>;
+};
+type TransformRegistry = Map<string, TransformDefinition<any>>;
+
+export type { RouteMap as R, TransformRegistry as T, ThemeTokens as a };

package/dist/server/core-DsNWrl3o.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+
+declare const colorTokens: readonly ["background/base", "background/elevated", "surface/base", "surface/subtle", "surface/inverted", "content/primary", "content/secondary", "accent/primary", "accent/secondary", "border/base"];
+declare const typographyTokens: readonly ["display/hero", "display/section", "heading/large", "heading/medium", "heading/small", "body/normal", "body/small", "caption"];
+declare const spacingTokens: readonly ["none", "3xs", "2xs", "xs", "sm", "md", "lg", "xl", "2xl", "3xl"];
+declare const radiusTokens: readonly ["none", "xs", "sm", "md", "lg", "pill", "full"];
+declare const shadowTokens: readonly ["none", "soft", "medium", "strong"];
+type ThemeTokens = {
+    color: Record<(typeof colorTokens)[number], string>;
+    typography: Record<(typeof typographyTokens)[number], {
+        fontSize: string;
+        lineHeight: string;
+        fontWeight?: string;
+    }>;
+    spacing: Record<(typeof spacingTokens)[number], string>;
+    radius: Record<(typeof radiusTokens)[number], string>;
+    shadow: Record<(typeof shadowTokens)[number], string>;
+    palette: Record<string, string>;
+};
+
+type RouteMapEntry = string | {
+    path?: string | null;
+    href?: string | null;
+    url?: string | null;
+    draftPath?: string | null;
+    [key: string]: unknown;
+};
+type RouteMap = Record<string, RouteMapEntry>;
+type TransformContext = {
+    theme: ThemeTokens;
+    locale?: string;
+    routes?: RouteMap;
+};
+type TransformHandler<TOptions = unknown> = (value: unknown, options: TOptions, context: TransformContext) => unknown;
+type TransformDefinition<TOptions = unknown> = {
+    id: string;
+    summary?: string;
+    kind: "formatter" | "collection" | "string" | "html";
+    schema?: z.ZodType<TOptions>;
+    run: TransformHandler<TOptions>;
+};
+type TransformRegistry = Map<string, TransformDefinition<any>>;
+
+export type { RouteMap as R, TransformRegistry as T, ThemeTokens as a };

package/dist/server/data.d.mts

@@ -1,11 +1,12 @@
-import { P as PageOutline, S as SdkCustomBlock } from './schema-Bpy9N5ZI.mjs';
+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-CdhKJrB0.mjs';
+import { R as RiverbankClient } from './types-1cLz0vnq.mjs';
 import 'zod';
 import './blockKinds-B6MWzNWp.mjs';
-import './types-BLf-hE50.mjs';
+import './types-Dsu9wsUh.mjs';
 import '@riverbankcms/ai';
+import './link-DjxLyC82.mjs';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 

package/dist/server/data.d.ts

@@ -1,11 +1,12 @@
-import { P as PageOutline, S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
+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-Dj8B3QRb.js';
+import { R as RiverbankClient } from './types-BvcJU7zk.js';
 import 'zod';
 import './blockKinds-B6MWzNWp.js';
-import './types-BWQ-TohG.js';
+import './types-CVykEqXN.js';
 import '@riverbankcms/ai';
+import './link-DjxLyC82.js';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 

package/dist/server/data.js

@@ -5,13 +5,13 @@ var _chunkY7347JMZjs = require('./chunk-Y7347JMZ.js');
 
 
 
-var _chunkHOY77YBFjs = require('./chunk-HOY77YBF.js');
-require('./chunk-EGTDJ4PL.js');
+var _chunkRVDS7VSPjs = require('./chunk-RVDS7VSP.js');
+require('./chunk-YYO3RIFO.js');
 require('./chunk-DGUM43GV.js');
 
 
 
 
 
-exports.SUPPORTED_LOADER_ENDPOINTS = _chunkHOY77YBFjs.SUPPORTED_LOADER_ENDPOINTS; exports.executeCodeLoaders = _chunkY7347JMZjs.executeCodeLoaders; exports.mergeLoaderResults = _chunkY7347JMZjs.mergeLoaderResults; exports.prefetchBlockData = _chunkHOY77YBFjs.prefetchBlockData;
+exports.SUPPORTED_LOADER_ENDPOINTS = _chunkRVDS7VSPjs.SUPPORTED_LOADER_ENDPOINTS; exports.executeCodeLoaders = _chunkY7347JMZjs.executeCodeLoaders; exports.mergeLoaderResults = _chunkY7347JMZjs.mergeLoaderResults; exports.prefetchBlockData = _chunkRVDS7VSPjs.prefetchBlockData;
 //# sourceMappingURL=data.js.map

package/dist/server/data.mjs

@@ -5,8 +5,8 @@ import {
 import {
   SUPPORTED_LOADER_ENDPOINTS,
   prefetchBlockData
-} from "./chunk-7DS4Q3GA.mjs";
-import "./chunk-USQF2XTU.mjs";
+} from "./chunk-AEFWG657.mjs";
+import "./chunk-BYBJA6SP.mjs";
 import "./chunk-BJTO5JO5.mjs";
 export {
   SUPPORTED_LOADER_ENDPOINTS,

package/dist/server/{index-CAwBj3-A.d.ts → index-Bucs6UqG.d.mts}

@@ -1,4 +1,5 @@
-import { a as RiverbankClientConfig, R as RiverbankClient } from './types-Dj8B3QRb.js';
+import { a as RiverbankClientConfig, R as RiverbankClient } from './types-1cLz0vnq.mjs';
+import './schema-Z6-afHJG.mjs';
 
 /**
  * Create a Riverbank CMS client for fetching content

package/dist/server/{index-C6o9LPvq.d.mts → index-Cp7tJuRt.d.ts}

@@ -1,4 +1,5 @@
-import { a as RiverbankClientConfig, R as RiverbankClient } from './types-CdhKJrB0.mjs';
+import { a as RiverbankClientConfig, R as RiverbankClient } from './types-BvcJU7zk.js';
+import './schema-Z6-afHJG.js';
 
 /**
  * Create a Riverbank CMS client for fetching content

package/dist/server/index.d.mts

@@ -1,17 +1,66 @@
-export { c as createRiverbankClient } from './index-C6o9LPvq.mjs';
-export { E as EntriesResponse, c as EntriesResponseWithMeta, b as EntryResponse, P as PageResponse, d as PaginationMeta, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-CdhKJrB0.mjs';
-import { A as APIEndpoints, b as APICallParams } from './types-BLf-hE50.mjs';
-import './schema-Bpy9N5ZI.mjs';
-export { f as ContainerAlignment, e as ContainerMaxWidth, c as ContainerOptionsConfig, R as RiverbankSiteConfig, a as SectionBackground, b as SectionOptionsConfig, d as SectionSpacing, S as SiteStyleConfig } from './types-txWsSxN7.mjs';
+export { c as createRiverbankClient } from './index-Bucs6UqG.mjs';
+export { E as EntriesResponse, c as EntriesResponseWithMeta, b as EntryResponse, P as PageResponse, d as PaginationMeta, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-1cLz0vnq.mjs';
+import { A as APIEndpoints, b as APICallParams } from './types-Dsu9wsUh.mjs';
+import './schema-Z6-afHJG.mjs';
+export { g as ContainerAlignment, f as ContainerMaxWidth, d as ContainerOptionsConfig, R as RiverbankSiteConfig, b as SectionBackground, c as SectionOptionsConfig, e as SectionSpacing, S as SiteStyleConfig } from './types-BjgZt8xJ.mjs';
 export { B as BlockKind, C as CustomBlockKind, S as SYSTEM_BLOCK_KINDS, a as SystemBlockKind } from './blockKinds-B6MWzNWp.mjs';
 import '@riverbankcms/ai';
 import 'zod';
+import './link-DjxLyC82.mjs';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 
+/**
+ * API Response Envelope Types
+ *
+ * Provides standardized response format for all API endpoints:
+ * - Success: { success: true, data, meta }
+ * - Error: { success: false, error: { code, message, requestId, ... } }
+ */
+type ApiVersion = '2025-01-01';
+interface ResponseMeta {
+    requestId: string;
+    timestamp: string;
+    apiVersion: ApiVersion;
+    deprecations?: DeprecationWarning[];
+}
+interface DeprecationWarning {
+    feature: string;
+    message: string;
+    sunsetDate: string;
+    alternative?: string;
+}
+interface ApiResponse<TData> {
+    success: true;
+    data: TData;
+    meta: ResponseMeta;
+}
+type ApiErrorCode = 'auth:unauthenticated' | 'auth:token_expired' | 'auth:token_invalid' | 'auth:forbidden' | 'auth:mfa_required' | 'auth:sudo_required' | 'auth:insufficient_permissions' | 'auth:impersonation_restricted' | 'validation:invalid_input' | 'validation:missing_field' | 'validation:invalid_format' | 'validation:payload_too_large' | 'resource:not_found' | 'resource:already_exists' | 'resource:conflict' | 'resource:gone' | 'rate_limit:exceeded' | 'billing:payment_required' | 'billing:plan_limit_exceeded' | 'server:internal_error' | 'server:unavailable' | 'external:service_error';
+interface FieldError {
+    field: string;
+    code: string;
+    message: string;
+}
+interface ApiError {
+    success: false;
+    error: {
+        code: ApiErrorCode;
+        message: string;
+        requestId: string;
+        timestamp: string;
+        status: number;
+        fieldErrors?: FieldError[];
+    };
+}
+type ApiResult<TData> = ApiResponse<TData> | ApiError;
+
 type EndpointResponse<E extends keyof APIEndpoints> = APIEndpoints[E]['response'];
 type ApiResponseFor<E extends keyof APIEndpoints> = EndpointResponse<E> extends undefined ? void : NonNullable<EndpointResponse<E>>;
-type ApiClient = <E extends keyof APIEndpoints>(params: APICallParams<E>) => Promise<ApiResponseFor<E>>;
+/**
+ * API client that returns typed envelope responses.
+ * Consumers must use isApiSuccess/isApiError type guards or unwrapResponse helper.
+ */
+type ApiClient = <E extends keyof APIEndpoints>(params: APICallParams<E>) => Promise<ApiResult<ApiResponseFor<E>>>;
 
 declare const API_ENDPOINTS: {
     readonly aiContentUpdateChat: {
@@ -186,6 +235,27 @@ declare const API_ENDPOINTS: {
         readonly tags: ["site-{siteId}", "api-keys", "access-logs"];
         readonly responseKind: "json";
     };
+    readonly listManagementKeys: {
+        readonly path: "/sites/{siteId}/api-keys/management";
+        readonly method: "GET";
+        readonly auth: "user";
+        readonly tags: ["site-{siteId}", "api-keys", "management-keys"];
+        readonly responseKind: "json";
+    };
+    readonly createManagementKey: {
+        readonly path: "/sites/{siteId}/api-keys/management";
+        readonly method: "POST";
+        readonly auth: "user";
+        readonly tags: ["site-{siteId}", "api-keys", "management-keys"];
+        readonly responseKind: "json";
+    };
+    readonly revokeManagementKey: {
+        readonly path: "/sites/{siteId}/api-keys/management";
+        readonly method: "DELETE";
+        readonly auth: "user";
+        readonly tags: ["site-{siteId}", "api-keys", "management-keys"];
+        readonly responseKind: "json";
+    };
     readonly getBookingSettings: {
         readonly path: "/sites/{siteId}/bookings/settings";
         readonly method: "GET";
@@ -1435,6 +1505,14 @@ declare const API_ENDPOINTS: {
         readonly auth: "public";
         readonly responseKind: "json";
     };
+    readonly resolveEventOccurrence: {
+        readonly path: "/public/sites/{siteId}/events/occurrences/resolve";
+        readonly method: "GET";
+        readonly revalidate: 60;
+        readonly tags: ["public-events-{siteId}", "event-occurrence"];
+        readonly auth: "public";
+        readonly responseKind: "json";
+    };
     readonly registerForEvent: {
         readonly path: "/public/sites/{siteId}/events/register";
         readonly method: "POST";

package/dist/server/index.d.ts

@@ -1,17 +1,66 @@
-export { c as createRiverbankClient } from './index-CAwBj3-A.js';
-export { E as EntriesResponse, c as EntriesResponseWithMeta, b as EntryResponse, P as PageResponse, d as PaginationMeta, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-Dj8B3QRb.js';
-import { A as APIEndpoints, b as APICallParams } from './types-BWQ-TohG.js';
-import './schema-Bpy9N5ZI.js';
-export { f as ContainerAlignment, e as ContainerMaxWidth, c as ContainerOptionsConfig, R as RiverbankSiteConfig, a as SectionBackground, b as SectionOptionsConfig, d as SectionSpacing, S as SiteStyleConfig } from './types-CL916r6x.js';
+export { c as createRiverbankClient } from './index-Cp7tJuRt.js';
+export { E as EntriesResponse, c as EntriesResponseWithMeta, b as EntryResponse, P as PageResponse, d as PaginationMeta, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-BvcJU7zk.js';
+import { A as APIEndpoints, b as APICallParams } from './types-CVykEqXN.js';
+import './schema-Z6-afHJG.js';
+export { g as ContainerAlignment, f as ContainerMaxWidth, d as ContainerOptionsConfig, R as RiverbankSiteConfig, b as SectionBackground, c as SectionOptionsConfig, e as SectionSpacing, S as SiteStyleConfig } from './types-DLBhEPSt.js';
 export { B as BlockKind, C as CustomBlockKind, S as SYSTEM_BLOCK_KINDS, a as SystemBlockKind } from './blockKinds-B6MWzNWp.js';
 import '@riverbankcms/ai';
 import 'zod';
+import './link-DjxLyC82.js';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 
+/**
+ * API Response Envelope Types
+ *
+ * Provides standardized response format for all API endpoints:
+ * - Success: { success: true, data, meta }
+ * - Error: { success: false, error: { code, message, requestId, ... } }
+ */
+type ApiVersion = '2025-01-01';
+interface ResponseMeta {
+    requestId: string;
+    timestamp: string;
+    apiVersion: ApiVersion;
+    deprecations?: DeprecationWarning[];
+}
+interface DeprecationWarning {
+    feature: string;
+    message: string;
+    sunsetDate: string;
+    alternative?: string;
+}
+interface ApiResponse<TData> {
+    success: true;
+    data: TData;
+    meta: ResponseMeta;
+}
+type ApiErrorCode = 'auth:unauthenticated' | 'auth:token_expired' | 'auth:token_invalid' | 'auth:forbidden' | 'auth:mfa_required' | 'auth:sudo_required' | 'auth:insufficient_permissions' | 'auth:impersonation_restricted' | 'validation:invalid_input' | 'validation:missing_field' | 'validation:invalid_format' | 'validation:payload_too_large' | 'resource:not_found' | 'resource:already_exists' | 'resource:conflict' | 'resource:gone' | 'rate_limit:exceeded' | 'billing:payment_required' | 'billing:plan_limit_exceeded' | 'server:internal_error' | 'server:unavailable' | 'external:service_error';
+interface FieldError {
+    field: string;
+    code: string;
+    message: string;
+}
+interface ApiError {
+    success: false;
+    error: {
+        code: ApiErrorCode;
+        message: string;
+        requestId: string;
+        timestamp: string;
+        status: number;
+        fieldErrors?: FieldError[];
+    };
+}
+type ApiResult<TData> = ApiResponse<TData> | ApiError;
+
 type EndpointResponse<E extends keyof APIEndpoints> = APIEndpoints[E]['response'];
 type ApiResponseFor<E extends keyof APIEndpoints> = EndpointResponse<E> extends undefined ? void : NonNullable<EndpointResponse<E>>;
-type ApiClient = <E extends keyof APIEndpoints>(params: APICallParams<E>) => Promise<ApiResponseFor<E>>;
+/**
+ * API client that returns typed envelope responses.
+ * Consumers must use isApiSuccess/isApiError type guards or unwrapResponse helper.
+ */
+type ApiClient = <E extends keyof APIEndpoints>(params: APICallParams<E>) => Promise<ApiResult<ApiResponseFor<E>>>;
 
 declare const API_ENDPOINTS: {
     readonly aiContentUpdateChat: {
@@ -186,6 +235,27 @@ declare const API_ENDPOINTS: {
         readonly tags: ["site-{siteId}", "api-keys", "access-logs"];
         readonly responseKind: "json";
     };
+    readonly listManagementKeys: {
+        readonly path: "/sites/{siteId}/api-keys/management";
+        readonly method: "GET";
+        readonly auth: "user";
+        readonly tags: ["site-{siteId}", "api-keys", "management-keys"];
+        readonly responseKind: "json";
+    };
+    readonly createManagementKey: {
+        readonly path: "/sites/{siteId}/api-keys/management";
+        readonly method: "POST";
+        readonly auth: "user";
+        readonly tags: ["site-{siteId}", "api-keys", "management-keys"];
+        readonly responseKind: "json";
+    };
+    readonly revokeManagementKey: {
+        readonly path: "/sites/{siteId}/api-keys/management";
+        readonly method: "DELETE";
+        readonly auth: "user";
+        readonly tags: ["site-{siteId}", "api-keys", "management-keys"];
+        readonly responseKind: "json";
+    };
     readonly getBookingSettings: {
         readonly path: "/sites/{siteId}/bookings/settings";
         readonly method: "GET";
@@ -1435,6 +1505,14 @@ declare const API_ENDPOINTS: {
         readonly auth: "public";
         readonly responseKind: "json";
     };
+    readonly resolveEventOccurrence: {
+        readonly path: "/public/sites/{siteId}/events/occurrences/resolve";
+        readonly method: "GET";
+        readonly revalidate: 60;
+        readonly tags: ["public-events-{siteId}", "event-occurrence"];
+        readonly auth: "public";
+        readonly responseKind: "json";
+    };
     readonly registerForEvent: {
         readonly path: "/public/sites/{siteId}/events/register";
         readonly method: "POST";