@revealui/contracts 1.0.0

package/dist/cms/config-contract.js

@@ -0,0 +1,220 @@
+/**
+ * Config Contract
+ *
+ * Unified contract for complete Config (root configuration) that combines:
+ * - TypeScript types (compile-time)
+ * - Zod schemas (runtime validation)
+ * - Validation functions
+ * - Type guards
+ *
+ * This is the single source of truth for Config definitions.
+ *
+ * @module @revealui/contracts/core/contracts/config-contract
+ */
+import { z } from 'zod/v4';
+import { createContract } from '../foundation/contract.js';
+import { CollectionStructureSchema, GlobalStructureSchema } from './structure.js';
+/**
+ * Config structure schema (Zod)
+ * Validates the structure of the root Config object
+ *
+ * Note: This schema validates the STRUCTURE of the config, not function contracts.
+ * Functions (access, hooks, onInit, etc.) are validated by TypeScript at compile time.
+ */
+const ConfigStructureSchema = z
+    .object({
+    // Required
+    secret: z.string().min(1, 'Secret is required'),
+    // Collections and globals
+    collections: z.array(CollectionStructureSchema).optional(),
+    globals: z.array(GlobalStructureSchema).optional(),
+    // Server
+    serverURL: z.union([z.url(), z.literal('')]).optional(),
+    // Admin configuration
+    admin: z
+        .object({
+        user: z.string().optional(),
+        meta: z
+            .object({
+            titleSuffix: z.string().optional(),
+            ogImage: z.string().optional(),
+            favicon: z.string().optional(),
+            icons: z
+                .array(z.object({
+                url: z.string().optional(),
+                sizes: z.string().optional(),
+                type: z.string().optional(),
+                rel: z.string().optional(),
+                fetchPriority: z.enum(['high', 'low', 'auto']).optional(),
+            }))
+                .optional(),
+        })
+            .optional(),
+        importMap: z
+            .object({
+            autoGenerate: z.boolean().optional(),
+            baseDir: z.string().optional(),
+        })
+            .passthrough()
+            .optional(),
+        css: z.string().optional(),
+        scss: z.string().optional(),
+        dateFormat: z.string().optional(),
+        avatar: z.union([z.literal('default'), z.literal('gravatar'), z.unknown()]).optional(),
+        disable: z.boolean().optional(),
+        livePreview: z
+            .object({
+            url: z.union([z.string(), z.unknown()]).optional(), // Function type validated by TypeScript
+            collections: z.array(z.string()).optional(),
+            globals: z.array(z.string()).optional(),
+            breakpoints: z
+                .array(z.object({
+                label: z.string(),
+                name: z.string(),
+                width: z.number(),
+                height: z.number(),
+            }))
+                .optional(),
+        })
+            // Keep passthrough on livePreview for extensibility (documented)
+            .passthrough()
+            .optional(),
+    })
+        // No passthrough on admin root - validate strictly
+        .optional(),
+    // Email configuration
+    email: z
+        .object({
+        fromName: z.string().optional(),
+        fromAddress: z.string().email().optional(),
+    })
+        // No passthrough - validate email config strictly
+        .optional(),
+    // Localization
+    localization: z
+        .union([
+        z.object({
+            locales: z.union([
+                z.array(z.string()),
+                z.array(z.object({
+                    label: z.string(),
+                    code: z.string(),
+                })),
+            ]),
+            defaultLocale: z.string(),
+            fallback: z.boolean().optional(),
+        }),
+        z.literal(false),
+    ])
+        .optional(),
+    // i18n (internationalization)
+    i18n: z
+        .object({
+        locales: z.array(z.string()).optional(),
+        defaultLocale: z.string().optional(),
+        fallback: z.boolean().optional(),
+        supportedLanguages: z.record(z.string(), z.unknown()).optional(),
+    })
+        .optional(),
+    // CORS
+    cors: z
+        .union([
+        z.string(),
+        z.array(z.string()),
+        z.object({
+            origins: z.array(z.string()),
+            headers: z.array(z.string()).optional(),
+        }),
+    ])
+        .optional(),
+    // CSRF
+    csrf: z.array(z.string()).optional(),
+    // Rate limiting
+    rateLimit: z
+        .object({
+        window: z.number().optional(),
+        max: z.number().optional(),
+        trustProxy: z.boolean().optional(),
+        // skip is a function - not validated here
+    })
+        // No passthrough - validate rateLimit config strictly
+        .optional(),
+    // Uploads
+    upload: z
+        .object({
+        limits: z
+            .object({
+            fileSize: z.number().optional(),
+        })
+            .optional(),
+    })
+        .optional(),
+    // Debug
+    debug: z.boolean().optional(),
+    // TypeScript
+    typescript: z
+        .object({
+        outputFile: z.string().optional(),
+        declare: z.boolean().optional(),
+        autoGenerate: z.boolean().optional(),
+    })
+        .optional(),
+    // Telemetry
+    telemetry: z.boolean().optional(),
+    // Hooks - functions are not validated here (TypeScript-only)
+    hooks: z
+        .object({
+    // afterError is an array of functions - not validated here
+    })
+        // No passthrough - validate hooks config strictly
+        .optional(),
+    // onInit, plugins, editor, sharp, db are functions/any - not validated here
+    // These are validated by TypeScript at compile time
+    // Custom properties for extensibility (documented extensibility point)
+    custom: z.record(z.string(), z.unknown()).optional(),
+})
+    .refine((data) => {
+    // At least one collection or global must be present
+    return ((data.collections && data.collections.length > 0) ||
+        (data.globals && data.globals.length > 0));
+}, {
+    message: 'RevealUI config must have at least one collection or global',
+    path: ['collections'],
+});
+/**
+ * Config Contract
+ *
+ * This contract validates Config (root configuration) at runtime
+ * and provides TypeScript types at compile time.
+ *
+ * Note: This is a simplified contract. The full Config type includes
+ * function contracts (access, hooks) which are validated by TypeScript
+ * at compile time, not by Zod at runtime.
+ */
+export const ConfigContract = createContract({
+    name: 'Config',
+    version: '1.0.0',
+    schema: ConfigStructureSchema,
+    description: 'Root configuration contract',
+    docsUrl: 'https://revealui.dev/docs/api-reference/config',
+    tags: ['config', 'root', 'cms'],
+});
+/**
+ * Validate a config structure
+ */
+export function validateConfigStructure(data) {
+    return ConfigContract.validate(data);
+}
+/**
+ * Type guard for config structures
+ */
+export function isConfigStructure(data) {
+    return ConfigContract.isType(data);
+}
+/**
+ * Parse config structure (throws on validation failure)
+ */
+export function parseConfigStructure(data) {
+    return ConfigContract.parse(data);
+}
+//# sourceMappingURL=config-contract.js.map

package/dist/cms/config-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-contract.js","sourceRoot":"","sources":["../../src/cms/config-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAoC,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC5F,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEjF;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,WAAW;IACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC;IAE/C,0BAA0B;IAC1B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IAC1D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IAElD,SAAS;IACT,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAEvD,sBAAsB;IACtB,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC;YACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,KAAK,EAAE,CAAC;iBACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC1B,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;aAC1D,CAAC,CACH;iBACA,QAAQ,EAAE;SACd,CAAC;aACD,QAAQ,EAAE;QACb,SAAS,EAAE,CAAC;aACT,MAAM,CAAC;YACN,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;aACD,WAAW,EAAE;aACb,QAAQ,EAAE;QACb,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;QACtF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,WAAW,EAAE,CAAC;aACX,MAAM,CAAC;YACN,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,wCAAwC;YAC5F,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACvC,WAAW,EAAE,CAAC;iBACX,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,CAAC,CACH;iBACA,QAAQ,EAAE;SACd,CAAC;YACF,iEAAiE;aAChE,WAAW,EAAE;aACb,QAAQ,EAAE;KACd,CAAC;QACF,mDAAmD;SAClD,QAAQ,EAAE;IAEb,sBAAsB;IACtB,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;KAC3C,CAAC;QACF,kDAAkD;SACjD,QAAQ,EAAE;IAEb,eAAe;IACf,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC;QACL,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;gBACf,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBACnB,CAAC,CAAC,KAAK,CACL,CAAC,CAAC,MAAM,CAAC;oBACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;iBACjB,CAAC,CACH;aACF,CAAC;YACF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;YACzB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACjC,CAAC;QACF,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACjB,CAAC;SACD,QAAQ,EAAE;IAEb,8BAA8B;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAChC,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACjE,CAAC;SACD,QAAQ,EAAE;IAEb,OAAO;IACP,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC;QACL,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnB,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACxC,CAAC;KACH,CAAC;SACD,QAAQ,EAAE;IAEb,OAAO;IACP,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpC,gBAAgB;IAChB,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAClC,0CAA0C;KAC3C,CAAC;QACF,sDAAsD;SACrD,QAAQ,EAAE;IAEb,UAAU;IACV,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAChC,CAAC;aACD,QAAQ,EAAE;KACd,CAAC;SACD,QAAQ,EAAE;IAEb,QAAQ;IACR,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAE7B,aAAa;IACb,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACrC,CAAC;SACD,QAAQ,EAAE;IAEb,YAAY;IACZ,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAEjC,6DAA6D;IAC7D,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;IACN,2DAA2D;KAC5D,CAAC;QACF,kDAAkD;SACjD,QAAQ,EAAE;IAEb,4EAA4E;IAC5E,oDAAoD;IAEpD,uEAAuE;IACvE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,oDAAoD;IACpD,OAAO,CACL,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QACjD,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAC1C,CAAA;AACH,CAAC,EACD;IACE,OAAO,EAAE,6DAA6D;IACtE,IAAI,EAAE,CAAC,aAAa,CAAC;CACtB,CACF,CAAA;AAMH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAA8B,cAAc,CAAC;IACtE,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EAAE,6BAA6B;IAC1C,OAAO,EAAE,gDAAgD;IACzD,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC;CAChC,CAAC,CAAA;AAQF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAa;IACnD,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC"}

package/dist/cms/config.d.ts

@@ -0,0 +1,351 @@
+/**
+ * Combined Configuration Types
+ *
+ * These types combine Zod-validated structure with TypeScript function contracts.
+ *
+ * Structure (validated by Zod at runtime):
+ * - Field names, types, constraints
+ * - Admin configuration
+ * - Labels, slugs
+ *
+ * Functions (enforced by TypeScript at compile time):
+ * - Access functions
+ * - Hook functions
+ * - Validation functions
+ * - Condition functions
+ *
+ * @module @revealui/contracts/core/contracts/config
+ */
+import type { AccessFunction, CollectionAccessConfig, CollectionHooksConfig, ConditionFunction, EndpointConfig, FieldAccessConfig, FieldHooksConfig, FieldValidateArgs, FilterOptionsFunction, GlobalAccessConfig, GlobalHooksConfig } from './functions.js';
+import type { CollectionStructure, FieldStructure, GlobalStructure } from './structure.js';
+export type UnknownRecord = Record<string, unknown>;
+type HookFn = (args: UnknownRecord) => unknown;
+type FieldBeforeReadHook = HookFn;
+type LooseFieldAccessConfig = FieldAccessConfig<UnknownRecord, UnknownRecord>;
+type LooseFieldHooksConfig = FieldHooksConfig<unknown, UnknownRecord, UnknownRecord> & {
+    beforeRead?: FieldBeforeReadHook[];
+};
+type LooseCollectionAccessConfig<T = UnknownRecord> = CollectionAccessConfig<T> & {
+    readVersions?: AccessFunction<T>;
+};
+type LooseCollectionHooksConfig<T = UnknownRecord> = CollectionHooksConfig<T> & {
+    afterLogin?: HookFn[];
+    afterLogout?: HookFn[];
+    afterRefresh?: HookFn[];
+    afterMe?: HookFn[];
+    afterForgotPassword?: HookFn[];
+};
+type LooseGlobalHooksConfig = GlobalHooksConfig<UnknownRecord> & {
+    beforeValidate?: HookFn[];
+};
+type LooseFieldValidateArgs = FieldValidateArgs<unknown, UnknownRecord, UnknownRecord>;
+type LooseGlobalAccessConfig = GlobalAccessConfig & {
+    readVersions?: AccessFunction<UnknownRecord>;
+};
+/**
+ * Complete Field type combining structure and functions
+ *
+ * This is a simplified, non-generic Field type that works with any document type.
+ * For typed field definitions, use the TypeScript helper `defineField<T>()`.
+ *
+ * @example
+ * ```typescript
+ * // Basic text field
+ * const titleField: Field = {
+ *   name: 'title',
+ *   type: 'text',
+ *   required: true,
+ * };
+ *
+ * // Field with hooks
+ * const slugField: Field = {
+ *   name: 'slug',
+ *   type: 'text',
+ *   hooks: {
+ *     beforeChange: [({ value, siblingData }) => {
+ *       return value || String(siblingData?.title)?.toLowerCase().replace(/\s+/g, '-');
+ *     }],
+ *   },
+ * };
+ * ```
+ */
+export interface Field extends Omit<FieldStructure, 'fields' | 'blocks' | 'tabs'> {
+    access?: LooseFieldAccessConfig;
+    hooks?: LooseFieldHooksConfig;
+    validate?: (value: unknown, args: LooseFieldValidateArgs) => string | true | Promise<string | true>;
+    condition?: ConditionFunction<UnknownRecord, UnknownRecord>;
+    filterOptions?: FilterOptionsFunction<UnknownRecord>;
+    fields?: Field[];
+    blocks?: unknown[];
+    tabs?: Array<{
+        label: string;
+        name?: string;
+        description?: string;
+        fields: Field[];
+        custom?: Record<string, unknown>;
+    }>;
+    editor?: unknown;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Complete CollectionConfig type combining structure and functions
+ *
+ * Generic over the document type to provide proper type inference for hooks and access functions.
+ * Defaults to UnknownRecord for backward compatibility.
+ *
+ * @template T - The document type for this collection (defaults to UnknownRecord)
+ *
+ * @example
+ * ```typescript
+ * // Without type parameter (backward compatible)
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text', required: true },
+ *     { name: 'slug', type: 'text', required: true },
+ *   ],
+ *   access: {
+ *     read: () => true,
+ *     create: ({ req }) => Boolean(req.user),
+ *   },
+ *   hooks: {
+ *     afterChange: [({ doc }) => {
+ *       // Log the update
+ *       return doc;
+ *     }],
+ *   },
+ * };
+ *
+ * // With type parameter (typed hooks and access functions)
+ * interface Post {
+ *   id: string;
+ *   title: string;
+ *   slug: string;
+ * }
+ *
+ * const Posts: CollectionConfig<Post> = {
+ *   slug: 'posts',
+ *   fields: [...],
+ *   hooks: {
+ *     afterChange: [({ doc }) => {
+ *       // doc is properly typed as Post
+ *       return doc;
+ *     }],
+ *   },
+ * };
+ * ```
+ */
+export interface CollectionConfig<T = UnknownRecord> extends Omit<CollectionStructure, 'fields'> {
+    schemaVersion?: number;
+    fields: Field[];
+    access?: LooseCollectionAccessConfig<T>;
+    hooks?: LooseCollectionHooksConfig<T>;
+    endpoints?: EndpointConfig[] | false;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Complete GlobalConfig type combining structure and functions
+ *
+ * This is a simplified, non-generic GlobalConfig type that works with any document.
+ * For typed global definitions, use the TypeScript helper `defineGlobal<T>()`.
+ *
+ * @example
+ * ```typescript
+ * const Settings: GlobalConfig = {
+ *   slug: 'settings',
+ *   fields: [
+ *     { name: 'siteName', type: 'text', required: true },
+ *     { name: 'siteDescription', type: 'textarea' },
+ *   ],
+ *   access: {
+ *     read: () => true,
+ *     update: ({ req }) => Boolean(req.user),
+ *   },
+ * };
+ * ```
+ */
+export interface GlobalConfig extends Omit<GlobalStructure, 'fields'> {
+    schemaVersion?: number;
+    fields: Field[];
+    access?: LooseGlobalAccessConfig;
+    hooks?: LooseGlobalHooksConfig;
+    endpoints?: EndpointConfig[] | false;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Database adapter configuration (simplified)
+ */
+export interface DatabaseAdapterConfig {
+    pool?: unknown;
+    idType?: 'serial' | 'uuid';
+    custom?: Record<string, unknown>;
+}
+/**
+ * Email configuration
+ */
+export interface EmailConfig {
+    transportOptions?: unknown;
+    fromName?: string;
+    fromAddress?: string;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Admin panel configuration
+ */
+export interface AdminConfig {
+    user?: string;
+    meta?: {
+        titleSuffix?: string;
+        ogImage?: string;
+        favicon?: string;
+        icons?: Array<{
+            url?: string;
+            sizes?: string;
+            type?: string;
+            rel?: string;
+            fetchPriority?: 'high' | 'low' | 'auto';
+        }>;
+    };
+    importMap?: {
+        autoGenerate?: boolean;
+        baseDir?: string;
+        custom?: Record<string, unknown>;
+    };
+    components?: unknown;
+    css?: string;
+    scss?: string;
+    dateFormat?: string;
+    avatar?: string;
+    disable?: boolean;
+    livePreview?: {
+        url?: string | ((args: {
+            data: unknown;
+            locale?: string;
+        }) => string);
+        collections?: string[];
+        globals?: string[];
+        breakpoints?: Array<{
+            label: string;
+            name: string;
+            width: number;
+            height: number;
+        }>;
+        custom?: Record<string, unknown>;
+    };
+    custom?: Record<string, unknown>;
+}
+/**
+ * Localization configuration
+ */
+export interface LocalizationConfig {
+    locales: string[] | Array<{
+        label: string;
+        code: string;
+    }>;
+    defaultLocale: string;
+    fallback?: boolean;
+}
+/**
+ * Complete RevealUI Config type
+ *
+ * This is the root configuration passed to buildConfig()
+ */
+export interface Config {
+    secret: string;
+    collections?: CollectionConfig<any>[];
+    globals?: GlobalConfig[];
+    db?: unknown;
+    serverURL?: string;
+    admin?: AdminConfig;
+    email?: EmailConfig;
+    localization?: LocalizationConfig | false;
+    i18n?: {
+        locales?: string[];
+        defaultLocale?: string;
+        fallback?: boolean;
+        supportedLanguages?: Record<string, unknown>;
+    };
+    cors?: string | string[] | {
+        origins: string[];
+        headers?: string[];
+    };
+    csrf?: string[];
+    rateLimit?: {
+        window?: number;
+        max?: number;
+        trustProxy?: boolean;
+        skip?: (req: unknown) => boolean;
+    };
+    upload?: {
+        limits?: {
+            fileSize?: number;
+        };
+    };
+    debug?: boolean;
+    typescript?: {
+        outputFile?: string;
+        declare?: boolean;
+        autoGenerate?: boolean;
+    };
+    telemetry?: boolean;
+    hooks?: {
+        afterError?: Array<(args: {
+            error: Error;
+            context: unknown;
+        }) => void | Promise<void>>;
+    };
+    onInit?: (revealui: unknown) => unknown;
+    plugins?: unknown[];
+    editor?: unknown;
+    sharp?: unknown;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Sanitized config (after RevealUI processes it)
+ * This is what's available at runtime
+ */
+export interface SanitizedConfig extends Config {
+    collections: CollectionConfig<any>[];
+    globals: GlobalConfig[];
+}
+/**
+ * Typed collection config for advanced type inference
+ * Use this when you need TypeScript to know the document type
+ */
+export interface TypedCollectionConfig<T> extends CollectionConfig {
+    __docType?: T;
+}
+/**
+ * Typed global config for advanced type inference
+ * Use this when you need TypeScript to know the document type
+ */
+export interface TypedGlobalConfig<T> extends GlobalConfig {
+    __docType?: T;
+}
+/**
+ * Helper to create a typed collection config
+ *
+ * @example
+ * ```typescript
+ * interface Post {
+ *   id: string;
+ *   title: string;
+ * }
+ *
+ * const Posts = defineCollection<Post>({
+ *   slug: 'posts',
+ *   fields: [{ name: 'title', type: 'text' }],
+ * });
+ * ```
+ */
+export declare function defineCollection<T = unknown>(config: CollectionConfig): TypedCollectionConfig<T>;
+/**
+ * Helper to create a typed global config
+ */
+export declare function defineGlobal<T = unknown>(config: GlobalConfig): TypedGlobalConfig<T>;
+/**
+ * Helper to create a field
+ */
+export declare function defineField(field: Field): Field;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/cms/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cms/config.ts"],"names":[],"mappings":"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"}

package/dist/cms/config.js

@@ -0,0 +1,50 @@
+/**
+ * Combined Configuration Types
+ *
+ * These types combine Zod-validated structure with TypeScript function contracts.
+ *
+ * Structure (validated by Zod at runtime):
+ * - Field names, types, constraints
+ * - Admin configuration
+ * - Labels, slugs
+ *
+ * Functions (enforced by TypeScript at compile time):
+ * - Access functions
+ * - Hook functions
+ * - Validation functions
+ * - Condition functions
+ *
+ * @module @revealui/contracts/core/contracts/config
+ */
+/**
+ * Helper to create a typed collection config
+ *
+ * @example
+ * ```typescript
+ * interface Post {
+ *   id: string;
+ *   title: string;
+ * }
+ *
+ * const Posts = defineCollection<Post>({
+ *   slug: 'posts',
+ *   fields: [{ name: 'title', type: 'text' }],
+ * });
+ * ```
+ */
+export function defineCollection(config) {
+    return config;
+}
+/**
+ * Helper to create a typed global config
+ */
+export function defineGlobal(config) {
+    return config;
+}
+/**
+ * Helper to create a field
+ */
+export function defineField(field) {
+    return field;
+}
+//# sourceMappingURL=config.js.map

package/dist/cms/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cms/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqaH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAc,MAAwB;IACpE,OAAO,MAAkC,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAc,MAAoB;IAC5D,OAAO,MAA8B,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAA;AACd,CAAC"}