@revealui/contracts 1.0.0

package/dist/cms/errors.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Configuration Validation Errors
+ *
+ * Provides detailed error reporting for config validation failures.
+ * Errors include:
+ * - Specific field paths that failed
+ * - Human-readable error messages
+ * - Links to documentation
+ *
+ * @module @revealui/contracts/core/contracts/errors
+ */
+import type { ZodError, ZodIssue } from 'zod/v4';
+/**
+ * Configuration validation error with detailed diagnostics
+ */
+export declare class ConfigValidationError extends Error {
+    /** All validation issues found */
+    readonly issues: ZodIssue[];
+    /** Type of configuration being validated */
+    readonly configType: 'collection' | 'global' | 'field' | 'config';
+    /** Name/slug of the config (if available) */
+    readonly configName?: string;
+    /** The original Zod error */
+    readonly zodError: ZodError;
+    constructor(error: ZodError, configType: 'collection' | 'global' | 'field' | 'config', configName?: string);
+    /**
+     * Format error message with all issues
+     */
+    static formatMessage(error: ZodError, configType: string, configName?: string): string;
+    /**
+     * Get documentation URL for config type
+     */
+    static getDocsUrl(configType: string): string;
+    /**
+     * Get a specific issue by path
+     */
+    getIssue(path: string): ZodIssue | undefined;
+    /**
+     * Get all issues for a specific path prefix
+     */
+    getIssuesForPath(pathPrefix: string): ZodIssue[];
+    /**
+     * Check if a specific field has an error
+     */
+    hasFieldError(fieldName: string): boolean;
+    /**
+     * Get error messages as a simple array of strings
+     */
+    getMessages(): string[];
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        configType: string;
+        configName?: string;
+        issues: Array<{
+            path: (string | number)[];
+            message: string;
+            code: string;
+        }>;
+    };
+}
+/**
+ * Result type for validation operations
+ */
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: ConfigValidationError;
+};
+/**
+ * Validate data against a Zod schema with detailed error reporting
+ *
+ * @param schema - Zod schema to validate against
+ * @param data - Data to validate
+ * @param configType - Type of config for error messages
+ * @param configName - Optional name/slug for error messages
+ * @returns Validated data
+ * @throws {ConfigValidationError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = validateWithErrors(
+ *   CollectionStructureSchema,
+ *   userInput,
+ *   'collection',
+ *   userInput.slug
+ * );
+ * ```
+ */
+export declare function validateWithErrors<T>(schema: {
+    safeParse: (data: unknown) => {
+        success: boolean;
+        data?: T;
+        error?: ZodError;
+    };
+}, data: unknown, configType: 'collection' | 'global' | 'field' | 'config', configName?: string): T;
+/**
+ * Safe validation that returns a result object instead of throwing
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidate(CollectionStructureSchema, userInput, 'collection');
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.error.getMessages());
+ * }
+ * ```
+ */
+export declare function safeValidate<T>(schema: {
+    safeParse: (data: unknown) => {
+        success: boolean;
+        data?: T;
+        error?: ZodError;
+    };
+}, data: unknown, configType: 'collection' | 'global' | 'field' | 'config', configName?: string): ValidationResult<T>;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cms/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEhD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,kCAAkC;IAClC,SAAgB,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClC,4CAA4C;IAC5C,SAAgB,UAAU,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;IACxE,6CAA6C;IAC7C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnC,6BAA6B;IAC7B,SAAgB,QAAQ,EAAE,QAAQ,CAAA;gBAGhC,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACxD,UAAU,CAAC,EAAE,MAAM;IAkBrB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBtF;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAc7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI5C;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIhD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAOvB;;OAEG;IACH,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;YACzB,OAAO,EAAE,MAAM,CAAA;YACf,IAAI,EAAE,MAAM,CAAA;SACb,CAAC,CAAA;KACH;CAaF;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE;IACN,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAC5B,OAAO,EAAE,OAAO,CAAA;QAChB,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,KAAK,CAAC,EAAE,QAAQ,CAAA;KACjB,CAAA;CACF,EACD,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACxD,UAAU,CAAC,EAAE,MAAM,GAClB,CAAC,CAQH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE;IACN,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAC5B,OAAO,EAAE,OAAO,CAAA;QAChB,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,KAAK,CAAC,EAAE,QAAQ,CAAA;KACjB,CAAA;CACF,EACD,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACxD,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAAC,CAAC,CAAC,CAWrB"}

package/dist/cms/errors.js

@@ -0,0 +1,163 @@
+/**
+ * Configuration Validation Errors
+ *
+ * Provides detailed error reporting for config validation failures.
+ * Errors include:
+ * - Specific field paths that failed
+ * - Human-readable error messages
+ * - Links to documentation
+ *
+ * @module @revealui/contracts/core/contracts/errors
+ */
+/**
+ * Configuration validation error with detailed diagnostics
+ */
+export class ConfigValidationError extends Error {
+    /** All validation issues found */
+    issues;
+    /** Type of configuration being validated */
+    configType;
+    /** Name/slug of the config (if available) */
+    configName;
+    /** The original Zod error */
+    zodError;
+    constructor(error, configType, configName) {
+        const message = ConfigValidationError.formatMessage(error, configType, configName);
+        super(message);
+        this.name = 'ConfigValidationError';
+        this.issues = error.issues;
+        this.configType = configType;
+        if (configName !== undefined) {
+            this.configName = configName;
+        }
+        this.zodError = error;
+        // Maintains proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ConfigValidationError);
+        }
+    }
+    /**
+     * Format error message with all issues
+     */
+    static formatMessage(error, configType, configName) {
+        const header = configName
+            ? `Invalid ${configType} configuration "${configName}":`
+            : `Invalid ${configType} configuration:`;
+        const issueLines = error.issues.map((issue, i) => {
+            const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+            return `  ${i + 1}. [${path}] ${issue.message}`;
+        });
+        const docsUrl = ConfigValidationError.getDocsUrl(configType);
+        return [header, '', ...issueLines, '', `See ${docsUrl} for valid configuration options.`].join('\n');
+    }
+    /**
+     * Get documentation URL for config type
+     */
+    static getDocsUrl(configType) {
+        const baseUrl = 'https://revealui.dev/docs';
+        switch (configType) {
+            case 'collection':
+                return `${baseUrl}/api-reference/collections`;
+            case 'global':
+                return `${baseUrl}/api-reference/globals`;
+            case 'field':
+                return `${baseUrl}/api-reference/fields`;
+            default:
+                return `${baseUrl}/api-reference/config`;
+        }
+    }
+    /**
+     * Get a specific issue by path
+     */
+    getIssue(path) {
+        return this.issues.find((issue) => issue.path.join('.') === path);
+    }
+    /**
+     * Get all issues for a specific path prefix
+     */
+    getIssuesForPath(pathPrefix) {
+        return this.issues.filter((issue) => issue.path.join('.').startsWith(pathPrefix));
+    }
+    /**
+     * Check if a specific field has an error
+     */
+    hasFieldError(fieldName) {
+        return this.issues.some((issue) => issue.path.includes(fieldName));
+    }
+    /**
+     * Get error messages as a simple array of strings
+     */
+    getMessages() {
+        return this.issues.map((issue) => {
+            const path = issue.path.length > 0 ? `[${issue.path.join('.')}] ` : '';
+            return `${path}${issue.message}`;
+        });
+    }
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            configType: this.configType,
+            ...(this.configName && { configName: this.configName }),
+            issues: this.issues.map((issue) => ({
+                path: issue.path,
+                message: issue.message,
+                code: issue.code,
+            })),
+        };
+    }
+}
+/**
+ * Validate data against a Zod schema with detailed error reporting
+ *
+ * @param schema - Zod schema to validate against
+ * @param data - Data to validate
+ * @param configType - Type of config for error messages
+ * @param configName - Optional name/slug for error messages
+ * @returns Validated data
+ * @throws {ConfigValidationError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = validateWithErrors(
+ *   CollectionStructureSchema,
+ *   userInput,
+ *   'collection',
+ *   userInput.slug
+ * );
+ * ```
+ */
+export function validateWithErrors(schema, data, configType, configName) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        throw new ConfigValidationError(result.error, configType, configName);
+    }
+    return result.data;
+}
+/**
+ * Safe validation that returns a result object instead of throwing
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidate(CollectionStructureSchema, userInput, 'collection');
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.error.getMessages());
+ * }
+ * ```
+ */
+export function safeValidate(schema, data, configType, configName) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        return {
+            success: false,
+            error: new ConfigValidationError(result.error, configType, configName),
+        };
+    }
+    return { success: true, data: result.data };
+}
+//# sourceMappingURL=errors.js.map

package/dist/cms/errors.js.map

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

package/dist/cms/extensibility.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Extensibility Contracts
+ *
+ * Contracts for extending the CMS type system with:
+ * - Custom field types (from plugins)
+ * - Plugin field extensions
+ * - Custom validation rules
+ *
+ * @module @revealui/contracts/core/contracts/extensibility
+ */
+import { z } from 'zod/v4';
+import type { CollectionConfig, Field } from './config.js';
+/**
+ * Configuration for a custom field type
+ */
+export interface CustomFieldTypeConfig {
+    /** Zod schema for validating field config (optional) */
+    schema?: z.ZodType<unknown>;
+    /** Default value for this field type */
+    defaultValue?: unknown;
+    /** Custom validation function for field values */
+    validate?: (value: unknown) => boolean | string;
+    /** Description for documentation */
+    description?: string;
+    /** Whether this field can have nested fields */
+    hasNestedFields?: boolean;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Registry of custom field types
+ */
+export interface CustomFieldTypeRegistry {
+    [typeName: string]: CustomFieldTypeConfig;
+}
+/**
+ * Register a custom field type
+ *
+ * Call this from plugins to add new field types.
+ *
+ * @example
+ * ```typescript
+ * // In your plugin
+ * registerCustomFieldType('color-picker', {
+ *   description: 'A color picker field',
+ *   defaultValue: '#000000',
+ *   validate: (value) => {
+ *     if (typeof value !== 'string') return 'Color must be a string';
+ *     if (!/^#[0-9a-f]{6}$/i.test(value)) return 'Invalid hex color';
+ *     return true;
+ *   },
+ * });
+ * ```
+ */
+export declare function registerCustomFieldType(typeName: string, config: CustomFieldTypeConfig): void;
+/**
+ * Get a registered custom field type
+ */
+export declare function getCustomFieldType(typeName: string): CustomFieldTypeConfig | undefined;
+/**
+ * Get all registered custom field types
+ */
+export declare function getCustomFieldTypes(): CustomFieldTypeRegistry;
+/**
+ * Unregister a custom field type (mainly for testing)
+ */
+export declare function unregisterCustomFieldType(typeName: string): void;
+/**
+ * Clear all custom field types (mainly for testing)
+ */
+export declare function clearCustomFieldTypes(): void;
+/**
+ * Built-in field types in RevealUI CMS
+ */
+export declare const BUILTIN_FIELD_TYPES: readonly ["text", "textarea", "number", "email", "password", "code", "date", "checkbox", "select", "radio", "relationship", "upload", "array", "blocks", "group", "row", "collapsible", "tabs", "richText", "json", "point", "ui"];
+export type BuiltinFieldType = (typeof BUILTIN_FIELD_TYPES)[number];
+/**
+ * Check if a field type is valid (built-in or custom)
+ */
+export declare function isValidFieldType(type: string): boolean;
+/**
+ * Get all valid field types (built-in + custom)
+ */
+export declare function getValidFieldTypes(): string[];
+/**
+ * Extended field type schema that includes custom types
+ *
+ * Use this schema when validating field configs that may include
+ * custom field types from plugins.
+ */
+export declare const ExtendedFieldTypeSchema: z.ZodString;
+/**
+ * Plugin field extension configuration
+ *
+ * Allows plugins to add fields to collections.
+ */
+export interface PluginFieldExtension {
+    /** Plugin name (for debugging and conflict resolution) */
+    pluginName: string;
+    /** Priority for ordering when multiple plugins add fields (higher = later) */
+    priority?: number;
+    /** Fields to add to ALL collections */
+    globalFields?: Field[];
+    /** Fields to add to specific collections (by slug) */
+    collectionFields?: Record<string, Field[]>;
+    /** Custom field type definitions provided by this plugin */
+    customFieldTypes?: Array<{
+        name: string;
+        config: CustomFieldTypeConfig;
+    }>;
+    /** Hook to modify collection config before finalization */
+    beforeFinalize?: (config: CollectionConfig) => CollectionConfig;
+}
+/**
+ * Register a plugin field extension
+ *
+ * @example
+ * ```typescript
+ * registerPluginExtension({
+ *   pluginName: 'seo-plugin',
+ *   globalFields: [
+ *     { name: 'metaTitle', type: 'text', admin: { position: 'sidebar' } },
+ *     { name: 'metaDescription', type: 'textarea' },
+ *   ],
+ *   collectionFields: {
+ *     posts: [
+ *       { name: 'canonicalUrl', type: 'text' },
+ *     ],
+ *   },
+ * });
+ * ```
+ */
+export declare function registerPluginExtension(extension: PluginFieldExtension): void;
+/**
+ * Get all registered plugin extensions
+ */
+export declare function getPluginExtensions(): PluginFieldExtension[];
+/**
+ * Clear all plugin extensions (mainly for testing)
+ */
+export declare function clearPluginExtensions(): void;
+/**
+ * Apply plugin field extensions to a collection config
+ *
+ * This is called during config finalization to add plugin-provided fields.
+ *
+ * @param config - The base collection config
+ * @returns The config with plugin fields added
+ */
+export declare function applyPluginExtensions(config: CollectionConfig): CollectionConfig;
+/**
+ * Custom validation rule configuration
+ */
+export interface CustomValidationRule {
+    /** Rule name (for error messages) */
+    name: string;
+    /** Validation function */
+    validate: (value: unknown, options?: unknown) => boolean | string;
+    /** Default error message */
+    message?: string;
+    /** Description for documentation */
+    description?: string;
+}
+/**
+ * Registry of custom validation rules
+ */
+export interface ValidationRuleRegistry {
+    [ruleName: string]: CustomValidationRule;
+}
+/**
+ * Register a custom validation rule
+ *
+ * @example
+ * ```typescript
+ * registerValidationRule({
+ *   name: 'slug-format',
+ *   validate: (value) => {
+ *     if (typeof value !== 'string') return 'Must be a string';
+ *     if (!/^[a-z0-9-]+$/.test(value)) {
+ *       return 'Slug must contain only lowercase letters, numbers, and hyphens';
+ *     }
+ *     return true;
+ *   },
+ *   description: 'Validates URL-safe slug format',
+ * });
+ * ```
+ */
+export declare function registerValidationRule(rule: CustomValidationRule): void;
+/**
+ * Get a validation rule by name
+ */
+export declare function getValidationRule(name: string): CustomValidationRule | undefined;
+/**
+ * Get all registered validation rules
+ */
+export declare function getValidationRules(): ValidationRuleRegistry;
+/**
+ * Run a validation rule against a value
+ */
+export declare function runValidationRule(ruleName: string, value: unknown, options?: unknown): boolean | string;
+/**
+ * Merge field arrays, handling conflicts by name
+ *
+ * Later fields override earlier fields with the same name.
+ */
+export declare function mergeFields(base: Field[], additions: Field[]): Field[];
+/**
+ * Deep merge two collection configs
+ */
+export declare function mergeCollectionConfigs(base: CollectionConfig, overrides: Partial<CollectionConfig>): CollectionConfig;
+//# sourceMappingURL=extensibility.d.ts.map

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

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