@riverbankcms/sdk 0.4.2 → 0.5.0

package/dist/server/config.d.mts

@@ -1,10 +1,248 @@
-import { R as RiverbankSiteConfig, C as ContentConfig } from './types-txWsSxN7.mjs';
-export { m as BlockConfig, B as BlockFieldConfig, j as BlockFieldExtension, k as BlockFieldExtensionsMap, i as BlockFieldOptionsMap, f as ContainerAlignment, e as ContainerMaxWidth, c as ContainerOptionsConfig, l as ContentTypeConfig, E as EntryConfig, F as FieldSelectOption, n as NavigationItemConfig, o as NavigationLinkType, N as NavigationMenuConfig, P as PageConfig, g as SdkThemeConfig, h as SdkThemePalette, a as SectionBackground, b as SectionOptionsConfig, d as SectionSpacing, p as SiteSettingsConfig, S as SiteStyleConfig } from './types-txWsSxN7.mjs';
-export { C as ContentConfigInput, z as ContentConfigOutput, V as ValidatedRiverbankSiteConfig, y as ValidatedSdkCustomBlock, x as blockConfigSchema, k as blockFieldConfigSchema, m as blockFieldExtensionSchema, n as blockFieldExtensionsSchema, l as blockFieldOptionsSchema, d as containerAlignmentSchema, c as containerMaxWidthSchema, f as containerOptionsSchema, o as contentConfigSchema, p as contentTypeConfigSchema, t as entryConfigSchema, j as fieldSelectOptionSchema, v as navigationItemConfigSchema, u as navigationMenuConfigSchema, q as pageConfigSchema, r as riverbankSiteConfigSchema, i as sdkCustomBlockSchema, g as sdkThemeConfigSchema, h as sdkThemePaletteSchema, a as sectionBackgroundSchema, e as sectionOptionsSchema, b as sectionSpacingSchema, w as siteSettingsConfigSchema, s as siteStyleConfigSchema } from './validation-DzvDwwRo.mjs';
+import { C as ContentTypeConfig, E as EntryConfig, R as RiverbankSiteConfig, a as ContentConfig } from './types-BjgZt8xJ.mjs';
+export { m as BlockConfig, B as BlockFieldConfig, k as BlockFieldExtension, l as BlockFieldExtensionsMap, j as BlockFieldOptionsMap, g as ContainerAlignment, f as ContainerMaxWidth, d as ContainerOptionsConfig, F as FieldSelectOption, n as NavigationItemConfig, o as NavigationLinkType, N as NavigationMenuConfig, P as PageConfig, h as SdkThemeConfig, i as SdkThemePalette, b as SectionBackground, c as SectionOptionsConfig, e as SectionSpacing, p as SiteSettingsConfig, S as SiteStyleConfig } from './types-BjgZt8xJ.mjs';
+export { C as ContentConfigInput, z as ContentConfigOutput, V as ValidatedRiverbankSiteConfig, y as ValidatedSdkCustomBlock, x as blockConfigSchema, k as blockFieldConfigSchema, m as blockFieldExtensionSchema, n as blockFieldExtensionsSchema, l as blockFieldOptionsSchema, d as containerAlignmentSchema, c as containerMaxWidthSchema, f as containerOptionsSchema, o as contentConfigSchema, p as contentTypeConfigSchema, t as entryConfigSchema, j as fieldSelectOptionSchema, v as navigationItemConfigSchema, u as navigationMenuConfigSchema, q as pageConfigSchema, r as riverbankSiteConfigSchema, i as sdkCustomBlockSchema, g as sdkThemeConfigSchema, h as sdkThemePaletteSchema, a as sectionBackgroundSchema, e as sectionOptionsSchema, b as sectionSpacingSchema, w as siteSettingsConfigSchema, s as siteStyleConfigSchema } from './validation-BGuRo8P1.mjs';
 export { B as BlockKind, C as CustomBlockKind, S as SYSTEM_BLOCK_KINDS, a as SystemBlockKind } from './blockKinds-B6MWzNWp.mjs';
-export { F as FieldDefinition, S as SdkCustomBlock } from './schema-Bpy9N5ZI.mjs';
+import { F as FieldDefinition, T as TextFieldDefinition, B as BooleanFieldDefinition, N as NumberFieldDefinition, R as RichTextFieldDefinition, M as MediaFieldDefinition, L as LinkFieldDefinition, D as DateFieldDefinition, a as TimeFieldDefinition, b as DateTimeFieldDefinition, c as SlugFieldDefinition, U as UrlFieldDefinition, d as ReferenceFieldDefinition, e as PresetOrCustomFieldDefinition, C as ContentTypeSelectFieldDefinition, f as SelectFieldDefinition, E as EntryPickerFieldDefinition, G as GroupFieldDefinition, g as ModalFieldDefinition, h as RepeaterFieldDefinition, i as TabGroupFieldDefinition } from './schema-Z6-afHJG.mjs';
+export { S as SdkCustomBlock } from './schema-Z6-afHJG.mjs';
+import { T as TipTapNode, M as Media } from './richTextSchema-DURiozvD.mjs';
+import { L as LinkValue } from './link-DjxLyC82.mjs';
+export { C as CustomLinkValue, E as ExternalLinkValue, I as InternalLinkValue } from './link-DjxLyC82.mjs';
 import 'zod';
 
+/**
+ * Type-Safe Content Entries
+ *
+ * This module provides type-safe helpers for defining content types and entries
+ * in SDK site configurations. When used with `as const`, TypeScript can infer
+ * the exact shape of entry data from the content type's field definitions.
+ *
+ * @example
+ * ```typescript
+ * import { defineTypedContentType, createEntry, tiptap } from '@riverbankcms/sdk/config';
+ *
+ * // Define content type with `as const` for type inference
+ * export const testimonialType = defineTypedContentType({
+ *   key: 'testimonial',
+ *   name: 'Testimonial',
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },
+ *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },
+ *   ],
+ * } as const);
+ *
+ * // Create entry with full type safety
+ * const entry = createEntry(testimonialType, {
+ *   identifier: 'testimonial-1',
+ *   data: {
+ *     name: 'John Doe',      // TypeScript knows this is string
+ *     quote: tiptap.paragraph('Great service!'),  // TypeScript knows this is TipTapNode
+ *   },
+ * });
+ * ```
+ */
+
+/**
+ * Infers the data object shape from tabGroup tabs (flattens all tab fields).
+ * TabGroup fields flatten all their tab fields into a single data object.
+ */
+type InferDataFromTabs<Tabs extends readonly {
+    fields: readonly FieldDefinition[];
+}[]> = InferDataFromFields<Tabs[number]['fields']>;
+/**
+ * Maps a field definition to its TypeScript value type.
+ * Uses conditional types to infer the correct type based on field.type.
+ *
+ * Coverage:
+ * - Simple primitives: text, boolean, number
+ * - Complex types: richText (TipTapNode), media (Media | null), link (LinkValue | null)
+ * - Date/time: date, time, datetime (all ISO strings)
+ * - String-value: slug, url, reference, presetOrCustom, contentTypeSelect
+ * - Select: single (string) vs multiple (string[])
+ * - Entry picker: string | null
+ * - Nested: group, modal (nested InferDataFromFields)
+ * - Repeater: monomorphic (array) and polymorphic (discriminated union array)
+ * - TabGroup: flattened fields from all tabs
+ */
+type FieldValueType<F extends FieldDefinition> = F extends TextFieldDefinition ? string : F extends BooleanFieldDefinition ? boolean : F extends NumberFieldDefinition ? number : F extends RichTextFieldDefinition ? TipTapNode : F extends MediaFieldDefinition ? Media | null : F extends LinkFieldDefinition ? LinkValue | null : F extends DateFieldDefinition ? string : F extends TimeFieldDefinition ? string : F extends DateTimeFieldDefinition ? string : F extends SlugFieldDefinition ? string : F extends UrlFieldDefinition ? string : F extends ReferenceFieldDefinition ? string : F extends PresetOrCustomFieldDefinition ? string : F extends ContentTypeSelectFieldDefinition ? string : F extends SelectFieldDefinition & {
+    multiple: true;
+} ? string[] : F extends SelectFieldDefinition ? string : F extends EntryPickerFieldDefinition ? string | null : F extends GroupFieldDefinition & {
+    schema: {
+        fields: infer GF;
+    };
+} ? GF extends readonly FieldDefinition[] ? InferDataFromFields<GF> : never : F extends ModalFieldDefinition & {
+    schema: {
+        fields: infer MF;
+    };
+} ? MF extends readonly FieldDefinition[] ? InferDataFromFields<MF> : never : F extends {
+    type: 'repeater';
+    polymorphic: true;
+} ? unknown[] : F extends RepeaterFieldDefinition & {
+    schema: {
+        fields: infer RF;
+    };
+} ? RF extends readonly FieldDefinition[] ? InferDataFromFields<RF>[] : never : F extends TabGroupFieldDefinition & {
+    tabs: infer T;
+} ? T extends readonly {
+    fields: readonly FieldDefinition[];
+}[] ? InferDataFromTabs<T> : never : unknown;
+/**
+ * Infers the data object shape from an array of field definitions.
+ * Required fields are non-optional, optional fields are `| undefined`.
+ *
+ * @example
+ * ```typescript
+ * const fields = [
+ *   { id: 'name', type: 'text', required: true },
+ *   { id: 'bio', type: 'text', required: false },
+ * ] as const;
+ *
+ * type Data = InferDataFromFields<typeof fields>;
+ * // { name: string; bio: string | undefined }
+ * ```
+ */
+type InferDataFromFields<Fields extends readonly FieldDefinition[]> = {
+    [F in Fields[number] as F['id']]: F extends {
+        required: true;
+    } ? FieldValueType<F> : FieldValueType<F> | undefined;
+};
+/**
+ * A content type definition with preserved field types for type inference.
+ * Extends ContentTypeConfig to ensure all required fields are present.
+ * The generic parameters capture the literal types from `as const`.
+ */
+interface TypedContentType<K extends string = string, F extends readonly FieldDefinition[] = readonly FieldDefinition[]> extends Omit<ContentTypeConfig, 'key' | 'fields'> {
+    key: K;
+    fields: F;
+}
+/**
+ * Define a content type with preserved field types for type inference.
+ *
+ * IMPORTANT: Use `as const` on the config object to enable type inference.
+ * Without `as const`, TypeScript widens literal types and inference won't work.
+ *
+ * @param config - The content type configuration
+ * @returns The same config object with preserved types
+ *
+ * @example
+ * ```typescript
+ * export const testimonialType = defineTypedContentType({
+ *   key: 'testimonial',
+ *   name: 'Testimonial',
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },
+ *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },
+ *   ],
+ * } as const);
+ * ```
+ */
+declare function defineTypedContentType<K extends string, F extends readonly FieldDefinition[]>(config: TypedContentType<K, F>): TypedContentType<K, F>;
+/**
+ * Entry configuration with typed data field.
+ * Used internally by createEntry to enforce type safety.
+ */
+interface TypedEntryConfig<Data extends Record<string, unknown>> {
+    /** Unique identifier for this entry. Required for SDK sync. */
+    identifier: string;
+    /** Title for the entry */
+    title?: string;
+    /** Slug for routable entries */
+    slug?: string;
+    /** Status: 'draft' or 'published' */
+    status?: 'draft' | 'published';
+    /** Summary/description */
+    summary?: string;
+    /** SEO meta title */
+    metaTitle?: string;
+    /** SEO meta description */
+    metaDescription?: string;
+    /** Entry data matching the content type's field definitions */
+    data: Data;
+}
+/**
+ * Create a type-safe content entry for a typed content type.
+ *
+ * The data field is validated against the content type's field definitions.
+ * TypeScript will error if:
+ * - A required field is missing
+ * - A field name is misspelled
+ * - A field value has the wrong type
+ * - An extra field is provided (with strict mode)
+ *
+ * @param contentType - The typed content type definition
+ * @param entry - The entry configuration with typed data
+ * @returns EntryConfig compatible with SDK content configuration
+ *
+ * @example
+ * ```typescript
+ * const entry = createEntry(testimonialType, {
+ *   identifier: 'testimonial-1',
+ *   title: 'John Doe',
+ *   status: 'published',
+ *   data: {
+ *     name: 'John Doe',
+ *     quote: tiptap.paragraph('Great service!'),
+ *   },
+ * });
+ * ```
+ */
+declare function createEntry<K extends string, F extends readonly FieldDefinition[]>(contentType: TypedContentType<K, F>, entry: TypedEntryConfig<InferDataFromFields<F>>): EntryConfig;
+/**
+ * Helpers for creating TipTap document structures.
+ *
+ * Use these helpers when populating richText fields to avoid manually
+ * constructing the TipTap JSON structure.
+ *
+ * @example
+ * ```typescript
+ * // Simple paragraph
+ * const body = tiptap.paragraph('Hello, world!');
+ *
+ * // Empty document
+ * const emptyDoc = tiptap.empty();
+ *
+ * // Complex document
+ * const doc = tiptap.doc([
+ *   tiptap.heading(1, 'Welcome'),
+ *   { type: 'paragraph', content: [{ type: 'text', text: 'Introduction...' }] },
+ * ]);
+ * ```
+ */
+declare const tiptap: {
+    /**
+     * Create an empty TipTap document.
+     *
+     * @returns An empty TipTap document node
+     */
+    empty(): TipTapNode;
+    /**
+     * Create a TipTap document with a single paragraph.
+     *
+     * @param text - The paragraph text content
+     * @returns A TipTap document with one paragraph
+     */
+    paragraph(text: string): TipTapNode;
+    /**
+     * 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: TipTapNode[]): TipTapNode;
+    /**
+     * 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: 1 | 2 | 3 | 4 | 5 | 6, text: string): TipTapNode;
+};
+
 /**
  * SDK Site Configuration
  *
@@ -74,4 +312,4 @@ declare function defineConfig(config: RiverbankSiteConfig): RiverbankSiteConfig;
  */
 declare function defineContentConfig(config: ContentConfig): ContentConfig;
 
-export { ContentConfig, RiverbankSiteConfig, defineConfig, defineContentConfig };
+export { ContentConfig, ContentTypeConfig, EntryConfig, FieldDefinition, type FieldValueType, type InferDataFromFields, LinkValue, Media, RiverbankSiteConfig, TipTapNode, type TypedContentType, type TypedEntryConfig, createEntry, defineConfig, defineContentConfig, defineTypedContentType, tiptap };

package/dist/server/config.d.ts

@@ -1,10 +1,248 @@
-import { R as RiverbankSiteConfig, C as ContentConfig } from './types-CL916r6x.js';
-export { m as BlockConfig, B as BlockFieldConfig, j as BlockFieldExtension, k as BlockFieldExtensionsMap, i as BlockFieldOptionsMap, f as ContainerAlignment, e as ContainerMaxWidth, c as ContainerOptionsConfig, l as ContentTypeConfig, E as EntryConfig, F as FieldSelectOption, n as NavigationItemConfig, o as NavigationLinkType, N as NavigationMenuConfig, P as PageConfig, g as SdkThemeConfig, h as SdkThemePalette, a as SectionBackground, b as SectionOptionsConfig, d as SectionSpacing, p as SiteSettingsConfig, S as SiteStyleConfig } from './types-CL916r6x.js';
-export { C as ContentConfigInput, z as ContentConfigOutput, V as ValidatedRiverbankSiteConfig, y as ValidatedSdkCustomBlock, x as blockConfigSchema, k as blockFieldConfigSchema, m as blockFieldExtensionSchema, n as blockFieldExtensionsSchema, l as blockFieldOptionsSchema, d as containerAlignmentSchema, c as containerMaxWidthSchema, f as containerOptionsSchema, o as contentConfigSchema, p as contentTypeConfigSchema, t as entryConfigSchema, j as fieldSelectOptionSchema, v as navigationItemConfigSchema, u as navigationMenuConfigSchema, q as pageConfigSchema, r as riverbankSiteConfigSchema, i as sdkCustomBlockSchema, g as sdkThemeConfigSchema, h as sdkThemePaletteSchema, a as sectionBackgroundSchema, e as sectionOptionsSchema, b as sectionSpacingSchema, w as siteSettingsConfigSchema, s as siteStyleConfigSchema } from './validation-CoU8uAiu.js';
+import { C as ContentTypeConfig, E as EntryConfig, R as RiverbankSiteConfig, a as ContentConfig } from './types-DLBhEPSt.js';
+export { m as BlockConfig, B as BlockFieldConfig, k as BlockFieldExtension, l as BlockFieldExtensionsMap, j as BlockFieldOptionsMap, g as ContainerAlignment, f as ContainerMaxWidth, d as ContainerOptionsConfig, F as FieldSelectOption, n as NavigationItemConfig, o as NavigationLinkType, N as NavigationMenuConfig, P as PageConfig, h as SdkThemeConfig, i as SdkThemePalette, b as SectionBackground, c as SectionOptionsConfig, e as SectionSpacing, p as SiteSettingsConfig, S as SiteStyleConfig } from './types-DLBhEPSt.js';
+export { C as ContentConfigInput, z as ContentConfigOutput, V as ValidatedRiverbankSiteConfig, y as ValidatedSdkCustomBlock, x as blockConfigSchema, k as blockFieldConfigSchema, m as blockFieldExtensionSchema, n as blockFieldExtensionsSchema, l as blockFieldOptionsSchema, d as containerAlignmentSchema, c as containerMaxWidthSchema, f as containerOptionsSchema, o as contentConfigSchema, p as contentTypeConfigSchema, t as entryConfigSchema, j as fieldSelectOptionSchema, v as navigationItemConfigSchema, u as navigationMenuConfigSchema, q as pageConfigSchema, r as riverbankSiteConfigSchema, i as sdkCustomBlockSchema, g as sdkThemeConfigSchema, h as sdkThemePaletteSchema, a as sectionBackgroundSchema, e as sectionOptionsSchema, b as sectionSpacingSchema, w as siteSettingsConfigSchema, s as siteStyleConfigSchema } from './validation-DU2YE7u5.js';
 export { B as BlockKind, C as CustomBlockKind, S as SYSTEM_BLOCK_KINDS, a as SystemBlockKind } from './blockKinds-B6MWzNWp.js';
-export { F as FieldDefinition, S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
+import { F as FieldDefinition, T as TextFieldDefinition, B as BooleanFieldDefinition, N as NumberFieldDefinition, R as RichTextFieldDefinition, M as MediaFieldDefinition, L as LinkFieldDefinition, D as DateFieldDefinition, a as TimeFieldDefinition, b as DateTimeFieldDefinition, c as SlugFieldDefinition, U as UrlFieldDefinition, d as ReferenceFieldDefinition, e as PresetOrCustomFieldDefinition, C as ContentTypeSelectFieldDefinition, f as SelectFieldDefinition, E as EntryPickerFieldDefinition, G as GroupFieldDefinition, g as ModalFieldDefinition, h as RepeaterFieldDefinition, i as TabGroupFieldDefinition } from './schema-Z6-afHJG.js';
+export { S as SdkCustomBlock } from './schema-Z6-afHJG.js';
+import { T as TipTapNode, M as Media } from './richTextSchema-DURiozvD.js';
+import { L as LinkValue } from './link-DjxLyC82.js';
+export { C as CustomLinkValue, E as ExternalLinkValue, I as InternalLinkValue } from './link-DjxLyC82.js';
 import 'zod';
 
+/**
+ * Type-Safe Content Entries
+ *
+ * This module provides type-safe helpers for defining content types and entries
+ * in SDK site configurations. When used with `as const`, TypeScript can infer
+ * the exact shape of entry data from the content type's field definitions.
+ *
+ * @example
+ * ```typescript
+ * import { defineTypedContentType, createEntry, tiptap } from '@riverbankcms/sdk/config';
+ *
+ * // Define content type with `as const` for type inference
+ * export const testimonialType = defineTypedContentType({
+ *   key: 'testimonial',
+ *   name: 'Testimonial',
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },
+ *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },
+ *   ],
+ * } as const);
+ *
+ * // Create entry with full type safety
+ * const entry = createEntry(testimonialType, {
+ *   identifier: 'testimonial-1',
+ *   data: {
+ *     name: 'John Doe',      // TypeScript knows this is string
+ *     quote: tiptap.paragraph('Great service!'),  // TypeScript knows this is TipTapNode
+ *   },
+ * });
+ * ```
+ */
+
+/**
+ * Infers the data object shape from tabGroup tabs (flattens all tab fields).
+ * TabGroup fields flatten all their tab fields into a single data object.
+ */
+type InferDataFromTabs<Tabs extends readonly {
+    fields: readonly FieldDefinition[];
+}[]> = InferDataFromFields<Tabs[number]['fields']>;
+/**
+ * Maps a field definition to its TypeScript value type.
+ * Uses conditional types to infer the correct type based on field.type.
+ *
+ * Coverage:
+ * - Simple primitives: text, boolean, number
+ * - Complex types: richText (TipTapNode), media (Media | null), link (LinkValue | null)
+ * - Date/time: date, time, datetime (all ISO strings)
+ * - String-value: slug, url, reference, presetOrCustom, contentTypeSelect
+ * - Select: single (string) vs multiple (string[])
+ * - Entry picker: string | null
+ * - Nested: group, modal (nested InferDataFromFields)
+ * - Repeater: monomorphic (array) and polymorphic (discriminated union array)
+ * - TabGroup: flattened fields from all tabs
+ */
+type FieldValueType<F extends FieldDefinition> = F extends TextFieldDefinition ? string : F extends BooleanFieldDefinition ? boolean : F extends NumberFieldDefinition ? number : F extends RichTextFieldDefinition ? TipTapNode : F extends MediaFieldDefinition ? Media | null : F extends LinkFieldDefinition ? LinkValue | null : F extends DateFieldDefinition ? string : F extends TimeFieldDefinition ? string : F extends DateTimeFieldDefinition ? string : F extends SlugFieldDefinition ? string : F extends UrlFieldDefinition ? string : F extends ReferenceFieldDefinition ? string : F extends PresetOrCustomFieldDefinition ? string : F extends ContentTypeSelectFieldDefinition ? string : F extends SelectFieldDefinition & {
+    multiple: true;
+} ? string[] : F extends SelectFieldDefinition ? string : F extends EntryPickerFieldDefinition ? string | null : F extends GroupFieldDefinition & {
+    schema: {
+        fields: infer GF;
+    };
+} ? GF extends readonly FieldDefinition[] ? InferDataFromFields<GF> : never : F extends ModalFieldDefinition & {
+    schema: {
+        fields: infer MF;
+    };
+} ? MF extends readonly FieldDefinition[] ? InferDataFromFields<MF> : never : F extends {
+    type: 'repeater';
+    polymorphic: true;
+} ? unknown[] : F extends RepeaterFieldDefinition & {
+    schema: {
+        fields: infer RF;
+    };
+} ? RF extends readonly FieldDefinition[] ? InferDataFromFields<RF>[] : never : F extends TabGroupFieldDefinition & {
+    tabs: infer T;
+} ? T extends readonly {
+    fields: readonly FieldDefinition[];
+}[] ? InferDataFromTabs<T> : never : unknown;
+/**
+ * Infers the data object shape from an array of field definitions.
+ * Required fields are non-optional, optional fields are `| undefined`.
+ *
+ * @example
+ * ```typescript
+ * const fields = [
+ *   { id: 'name', type: 'text', required: true },
+ *   { id: 'bio', type: 'text', required: false },
+ * ] as const;
+ *
+ * type Data = InferDataFromFields<typeof fields>;
+ * // { name: string; bio: string | undefined }
+ * ```
+ */
+type InferDataFromFields<Fields extends readonly FieldDefinition[]> = {
+    [F in Fields[number] as F['id']]: F extends {
+        required: true;
+    } ? FieldValueType<F> : FieldValueType<F> | undefined;
+};
+/**
+ * A content type definition with preserved field types for type inference.
+ * Extends ContentTypeConfig to ensure all required fields are present.
+ * The generic parameters capture the literal types from `as const`.
+ */
+interface TypedContentType<K extends string = string, F extends readonly FieldDefinition[] = readonly FieldDefinition[]> extends Omit<ContentTypeConfig, 'key' | 'fields'> {
+    key: K;
+    fields: F;
+}
+/**
+ * Define a content type with preserved field types for type inference.
+ *
+ * IMPORTANT: Use `as const` on the config object to enable type inference.
+ * Without `as const`, TypeScript widens literal types and inference won't work.
+ *
+ * @param config - The content type configuration
+ * @returns The same config object with preserved types
+ *
+ * @example
+ * ```typescript
+ * export const testimonialType = defineTypedContentType({
+ *   key: 'testimonial',
+ *   name: 'Testimonial',
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'name', type: 'text', label: 'Name', required: true, multiline: false },
+ *     { id: 'quote', type: 'richText', label: 'Quote', required: true, format: 'html' },
+ *   ],
+ * } as const);
+ * ```
+ */
+declare function defineTypedContentType<K extends string, F extends readonly FieldDefinition[]>(config: TypedContentType<K, F>): TypedContentType<K, F>;
+/**
+ * Entry configuration with typed data field.
+ * Used internally by createEntry to enforce type safety.
+ */
+interface TypedEntryConfig<Data extends Record<string, unknown>> {
+    /** Unique identifier for this entry. Required for SDK sync. */
+    identifier: string;
+    /** Title for the entry */
+    title?: string;
+    /** Slug for routable entries */
+    slug?: string;
+    /** Status: 'draft' or 'published' */
+    status?: 'draft' | 'published';
+    /** Summary/description */
+    summary?: string;
+    /** SEO meta title */
+    metaTitle?: string;
+    /** SEO meta description */
+    metaDescription?: string;
+    /** Entry data matching the content type's field definitions */
+    data: Data;
+}
+/**
+ * Create a type-safe content entry for a typed content type.
+ *
+ * The data field is validated against the content type's field definitions.
+ * TypeScript will error if:
+ * - A required field is missing
+ * - A field name is misspelled
+ * - A field value has the wrong type
+ * - An extra field is provided (with strict mode)
+ *
+ * @param contentType - The typed content type definition
+ * @param entry - The entry configuration with typed data
+ * @returns EntryConfig compatible with SDK content configuration
+ *
+ * @example
+ * ```typescript
+ * const entry = createEntry(testimonialType, {
+ *   identifier: 'testimonial-1',
+ *   title: 'John Doe',
+ *   status: 'published',
+ *   data: {
+ *     name: 'John Doe',
+ *     quote: tiptap.paragraph('Great service!'),
+ *   },
+ * });
+ * ```
+ */
+declare function createEntry<K extends string, F extends readonly FieldDefinition[]>(contentType: TypedContentType<K, F>, entry: TypedEntryConfig<InferDataFromFields<F>>): EntryConfig;
+/**
+ * Helpers for creating TipTap document structures.
+ *
+ * Use these helpers when populating richText fields to avoid manually
+ * constructing the TipTap JSON structure.
+ *
+ * @example
+ * ```typescript
+ * // Simple paragraph
+ * const body = tiptap.paragraph('Hello, world!');
+ *
+ * // Empty document
+ * const emptyDoc = tiptap.empty();
+ *
+ * // Complex document
+ * const doc = tiptap.doc([
+ *   tiptap.heading(1, 'Welcome'),
+ *   { type: 'paragraph', content: [{ type: 'text', text: 'Introduction...' }] },
+ * ]);
+ * ```
+ */
+declare const tiptap: {
+    /**
+     * Create an empty TipTap document.
+     *
+     * @returns An empty TipTap document node
+     */
+    empty(): TipTapNode;
+    /**
+     * Create a TipTap document with a single paragraph.
+     *
+     * @param text - The paragraph text content
+     * @returns A TipTap document with one paragraph
+     */
+    paragraph(text: string): TipTapNode;
+    /**
+     * 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: TipTapNode[]): TipTapNode;
+    /**
+     * 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: 1 | 2 | 3 | 4 | 5 | 6, text: string): TipTapNode;
+};
+
 /**
  * SDK Site Configuration
  *
@@ -74,4 +312,4 @@ declare function defineConfig(config: RiverbankSiteConfig): RiverbankSiteConfig;
  */
 declare function defineContentConfig(config: ContentConfig): ContentConfig;
 
-export { ContentConfig, RiverbankSiteConfig, defineConfig, defineContentConfig };
+export { ContentConfig, ContentTypeConfig, EntryConfig, FieldDefinition, type FieldValueType, type InferDataFromFields, LinkValue, Media, RiverbankSiteConfig, TipTapNode, type TypedContentType, type TypedEntryConfig, createEntry, defineConfig, defineContentConfig, defineTypedContentType, tiptap };

package/dist/server/config.js

@@ -23,15 +23,79 @@
 
 
 
-var _chunk6JBKKV3Gjs = require('./chunk-6JBKKV3G.js');
+var _chunk2KCF2DNKjs = require('./chunk-2KCF2DNK.js');
 
 
 var _chunkGERCMTPQjs = require('./chunk-GERCMTPQ.js');
-require('./chunk-TKMA6D6U.js');
-require('./chunk-HOY77YBF.js');
-require('./chunk-EGTDJ4PL.js');
+require('./chunk-7UPVCT3K.js');
+require('./chunk-RVDS7VSP.js');
+require('./chunk-YYO3RIFO.js');
 require('./chunk-DGUM43GV.js');
 
+// 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;
@@ -67,5 +131,8 @@ function defineContentConfig(config) {
 
 
 
-exports.SYSTEM_BLOCK_KINDS = _chunkGERCMTPQjs.SYSTEM_BLOCK_KINDS; exports.blockConfigSchema = _chunk6JBKKV3Gjs.blockConfigSchema; exports.blockFieldConfigSchema = _chunk6JBKKV3Gjs.blockFieldConfigSchema; exports.blockFieldExtensionSchema = _chunk6JBKKV3Gjs.blockFieldExtensionSchema; exports.blockFieldExtensionsSchema = _chunk6JBKKV3Gjs.blockFieldExtensionsSchema; exports.blockFieldOptionsSchema = _chunk6JBKKV3Gjs.blockFieldOptionsSchema; exports.containerAlignmentSchema = _chunk6JBKKV3Gjs.containerAlignmentSchema; exports.containerMaxWidthSchema = _chunk6JBKKV3Gjs.containerMaxWidthSchema; exports.containerOptionsSchema = _chunk6JBKKV3Gjs.containerOptionsSchema; exports.contentConfigSchema = _chunk6JBKKV3Gjs.contentConfigSchema; exports.contentTypeConfigSchema = _chunk6JBKKV3Gjs.contentTypeConfigSchema; exports.defineConfig = defineConfig; exports.defineContentConfig = defineContentConfig; exports.entryConfigSchema = _chunk6JBKKV3Gjs.entryConfigSchema; exports.fieldSelectOptionSchema = _chunk6JBKKV3Gjs.fieldSelectOptionSchema; exports.navigationItemConfigSchema = _chunk6JBKKV3Gjs.navigationItemConfigSchema; exports.navigationMenuConfigSchema = _chunk6JBKKV3Gjs.navigationMenuConfigSchema; exports.pageConfigSchema = _chunk6JBKKV3Gjs.pageConfigSchema; exports.riverbankSiteConfigSchema = _chunk6JBKKV3Gjs.riverbankSiteConfigSchema; exports.sdkCustomBlockSchema = _chunk6JBKKV3Gjs.sdkCustomBlockSchema; exports.sdkThemeConfigSchema = _chunk6JBKKV3Gjs.sdkThemeConfigSchema; exports.sdkThemePaletteSchema = _chunk6JBKKV3Gjs.sdkThemePaletteSchema; exports.sectionBackgroundSchema = _chunk6JBKKV3Gjs.sectionBackgroundSchema; exports.sectionOptionsSchema = _chunk6JBKKV3Gjs.sectionOptionsSchema; exports.sectionSpacingSchema = _chunk6JBKKV3Gjs.sectionSpacingSchema; exports.siteSettingsConfigSchema = _chunk6JBKKV3Gjs.siteSettingsConfigSchema; exports.siteStyleConfigSchema = _chunk6JBKKV3Gjs.siteStyleConfigSchema;
+
+
+
+exports.SYSTEM_BLOCK_KINDS = _chunkGERCMTPQjs.SYSTEM_BLOCK_KINDS; exports.blockConfigSchema = _chunk2KCF2DNKjs.blockConfigSchema; exports.blockFieldConfigSchema = _chunk2KCF2DNKjs.blockFieldConfigSchema; exports.blockFieldExtensionSchema = _chunk2KCF2DNKjs.blockFieldExtensionSchema; exports.blockFieldExtensionsSchema = _chunk2KCF2DNKjs.blockFieldExtensionsSchema; exports.blockFieldOptionsSchema = _chunk2KCF2DNKjs.blockFieldOptionsSchema; exports.containerAlignmentSchema = _chunk2KCF2DNKjs.containerAlignmentSchema; exports.containerMaxWidthSchema = _chunk2KCF2DNKjs.containerMaxWidthSchema; exports.containerOptionsSchema = _chunk2KCF2DNKjs.containerOptionsSchema; exports.contentConfigSchema = _chunk2KCF2DNKjs.contentConfigSchema; exports.contentTypeConfigSchema = _chunk2KCF2DNKjs.contentTypeConfigSchema; exports.createEntry = createEntry; exports.defineConfig = defineConfig; exports.defineContentConfig = defineContentConfig; exports.defineTypedContentType = defineTypedContentType; exports.entryConfigSchema = _chunk2KCF2DNKjs.entryConfigSchema; exports.fieldSelectOptionSchema = _chunk2KCF2DNKjs.fieldSelectOptionSchema; exports.navigationItemConfigSchema = _chunk2KCF2DNKjs.navigationItemConfigSchema; exports.navigationMenuConfigSchema = _chunk2KCF2DNKjs.navigationMenuConfigSchema; exports.pageConfigSchema = _chunk2KCF2DNKjs.pageConfigSchema; exports.riverbankSiteConfigSchema = _chunk2KCF2DNKjs.riverbankSiteConfigSchema; exports.sdkCustomBlockSchema = _chunk2KCF2DNKjs.sdkCustomBlockSchema; exports.sdkThemeConfigSchema = _chunk2KCF2DNKjs.sdkThemeConfigSchema; exports.sdkThemePaletteSchema = _chunk2KCF2DNKjs.sdkThemePaletteSchema; exports.sectionBackgroundSchema = _chunk2KCF2DNKjs.sectionBackgroundSchema; exports.sectionOptionsSchema = _chunk2KCF2DNKjs.sectionOptionsSchema; exports.sectionSpacingSchema = _chunk2KCF2DNKjs.sectionSpacingSchema; exports.siteSettingsConfigSchema = _chunk2KCF2DNKjs.siteSettingsConfigSchema; exports.siteStyleConfigSchema = _chunk2KCF2DNKjs.siteStyleConfigSchema; exports.tiptap = tiptap;
 //# sourceMappingURL=config.js.map