@revealui/contracts 1.0.0

package/dist/cms/compat.d.ts

@@ -0,0 +1,128 @@
+/**
+ * RevealUI CMS Compatibility Layer
+ *
+ * This module provides adapter functions for CMS configuration compatibility.
+ *
+ * Compatibility is enforced through:
+ * 1. Type assertions that fail at compile time if incompatible
+ * 2. Adapter functions for explicit conversions
+ * 3. Documentation of any differences
+ *
+ * @module @revealui/contracts/core/contracts/compat
+ */
+import type { CollectionConfig, Config, GlobalConfig, UnknownRecord } from './config.js';
+/**
+ * Normalize a RevealUI CollectionConfig for CMS compatibility
+ *
+ * This is useful when:
+ * - Passing config to external CMS build functions
+ * - Integrating with plugins that expect standard CMS types
+ *
+ * @example
+ * ```typescript
+ * import { buildConfig } from '@revealui/core';
+ * import { Posts } from './collections/Posts.js';
+
+ * export default buildConfig({
+ *   collections: [toCMSCollectionConfig(Posts)],
+ * });
+ * ```
+ */
+export declare function toCMSCollectionConfig<T = UnknownRecord>(config: CollectionConfig<T>): CollectionConfig<T>;
+/**
+ * Normalize a RevealUI GlobalConfig for CMS compatibility
+ */
+export declare function toCMSGlobalConfig(config: GlobalConfig): GlobalConfig;
+/**
+ * Normalize a full RevealUI Config for CMS compatibility
+ */
+export declare function toCMSConfig(config: Config): Config;
+/**
+ * Import a CMS config and convert to RevealUI config format
+ *
+ * Use this when:
+ * - Consuming configs from external sources
+ * - Migrating existing CMS configs to RevealUI
+ *
+ * @example
+ * ```typescript
+ * // Existing CMS config
+ * const legacyConfig = { slug: 'posts', fields: [...] };
+ *
+ * // Validate and convert to RevealUI config
+ * const revealConfig = fromCMSCollectionConfig(legacyConfig);
+ * ```
+ */
+export declare function fromCMSCollectionConfig(config: CollectionConfig): CollectionConfig;
+/**
+ * Convert CMS GlobalConfig to RevealUI GlobalConfig
+ */
+export declare function fromCMSGlobalConfig(config: GlobalConfig): GlobalConfig;
+/**
+ * RevealUI-specific extensions that can be added to configs
+ *
+ * These are RevealUI-exclusive features beyond standard CMS types.
+ */
+export interface RevealUIExtensions {
+    /** Enable AI-assisted content features */
+    aiEnabled?: boolean;
+    /** Dual representation for human and agent interfaces */
+    dualRepresentation?: {
+        human: {
+            label: string;
+            description?: string;
+            helpText?: string;
+        };
+        agent: {
+            semanticType: string;
+            capabilities: string[];
+            constraints?: Record<string, unknown>;
+            actions?: Array<{
+                name: string;
+                description: string;
+                parameters?: Record<string, unknown>;
+            }>;
+        };
+    };
+    /** Custom metadata for the collection/global */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Collection config with RevealUI extensions
+ *
+ * Use this type when you want to access RevealUI-specific features.
+ */
+export interface RevealUICollectionConfig extends CollectionConfig {
+    revealui?: RevealUIExtensions;
+}
+/**
+ * Global config with RevealUI extensions
+ */
+export interface RevealUIGlobalConfig extends GlobalConfig {
+    revealui?: RevealUIExtensions;
+}
+/**
+ * Check if a config has RevealUI extensions
+ */
+export declare function hasRevealUIExtensions(config: CollectionConfig | GlobalConfig): boolean;
+/**
+ * Extract RevealUI extensions from a config
+ */
+export declare function getRevealUIExtensions(config: CollectionConfig | GlobalConfig): RevealUIExtensions | undefined;
+/**
+ * Validate a collection/global slug
+ *
+ * Slugs must:
+ * - Start with a lowercase letter
+ * - Contain only lowercase letters, numbers, and hyphens
+ */
+export declare function isValidSlug(slug: string): boolean;
+/**
+ * Convert a string to a valid slug
+ */
+export declare function toSlug(input: string): string;
+/**
+ * Validate slug and throw if invalid
+ */
+export declare function assertValidSlug(slug: string, context: string): void;
+//# sourceMappingURL=compat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../src/cms/compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMxF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,aAAa,EACrD,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,gBAAgB,CAAC,CAAC,CAAC,CAOrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAEpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAclD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAIlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAEtE;AAMD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB,yDAAyD;IACzD,kBAAkB,CAAC,EAAE;QACnB,KAAK,EAAE;YACL,KAAK,EAAE,MAAM,CAAA;YACb,WAAW,CAAC,EAAE,MAAM,CAAA;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;SAClB,CAAA;QACD,KAAK,EAAE;YACL,YAAY,EAAE,MAAM,CAAA;YACpB,YAAY,EAAE,MAAM,EAAE,CAAA;YACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACrC,OAAO,CAAC,EAAE,KAAK,CAAC;gBACd,IAAI,EAAE,MAAM,CAAA;gBACZ,WAAW,EAAE,MAAM,CAAA;gBACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aACrC,CAAC,CAAA;SACH,CAAA;KACF,CAAA;IAED,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,GAAG,OAAO,CAKtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,GAAG,YAAY,GACtC,kBAAkB,GAAG,SAAS,CAKhC;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASnE"}

package/dist/cms/compat.js

@@ -0,0 +1,141 @@
+/**
+ * RevealUI CMS Compatibility Layer
+ *
+ * This module provides adapter functions for CMS configuration compatibility.
+ *
+ * Compatibility is enforced through:
+ * 1. Type assertions that fail at compile time if incompatible
+ * 2. Adapter functions for explicit conversions
+ * 3. Documentation of any differences
+ *
+ * @module @revealui/contracts/core/contracts/compat
+ */
+// ============================================
+// ADAPTER FUNCTIONS
+// ============================================
+/**
+ * Normalize a RevealUI CollectionConfig for CMS compatibility
+ *
+ * This is useful when:
+ * - Passing config to external CMS build functions
+ * - Integrating with plugins that expect standard CMS types
+ *
+ * @example
+ * ```typescript
+ * import { buildConfig } from '@revealui/core';
+ * import { Posts } from './collections/Posts.js';
+
+ * export default buildConfig({
+ *   collections: [toCMSCollectionConfig(Posts)],
+ * });
+ * ```
+ */
+export function toCMSCollectionConfig(config) {
+    // Currently a pass-through since RevealUI configs are CMS-compatible
+    // This function exists for:
+    // 1. Explicit conversion intent
+    // 2. Future compatibility shims
+    // 3. Stripping RevealUI-specific properties if needed
+    return config;
+}
+/**
+ * Normalize a RevealUI GlobalConfig for CMS compatibility
+ */
+export function toCMSGlobalConfig(config) {
+    return config;
+}
+/**
+ * Normalize a full RevealUI Config for CMS compatibility
+ */
+export function toCMSConfig(config) {
+    const result = {
+        secret: config.secret,
+        ...(config.collections
+            ? { collections: config.collections.map((c) => toCMSCollectionConfig(c)) }
+            : {}),
+        ...(config.globals ? { globals: config.globals.map((g) => toCMSGlobalConfig(g)) } : {}),
+        ...(config.db ? { db: config.db } : {}),
+        ...(config.serverURL ? { serverURL: config.serverURL } : {}),
+        ...(config.admin ? { admin: config.admin } : {}),
+        ...(config.custom ? { custom: config.custom } : {}),
+    };
+    return result;
+}
+/**
+ * Import a CMS config and convert to RevealUI config format
+ *
+ * Use this when:
+ * - Consuming configs from external sources
+ * - Migrating existing CMS configs to RevealUI
+ *
+ * @example
+ * ```typescript
+ * // Existing CMS config
+ * const legacyConfig = { slug: 'posts', fields: [...] };
+ *
+ * // Validate and convert to RevealUI config
+ * const revealConfig = fromCMSCollectionConfig(legacyConfig);
+ * ```
+ */
+export function fromCMSCollectionConfig(config) {
+    // CMS configs should be compatible by design
+    // Add any RevealUI defaults or transformations here
+    return config;
+}
+/**
+ * Convert CMS GlobalConfig to RevealUI GlobalConfig
+ */
+export function fromCMSGlobalConfig(config) {
+    return config;
+}
+/**
+ * Check if a config has RevealUI extensions
+ */
+export function hasRevealUIExtensions(config) {
+    return ('revealui' in config &&
+        config.revealui !== undefined);
+}
+/**
+ * Extract RevealUI extensions from a config
+ */
+export function getRevealUIExtensions(config) {
+    if (hasRevealUIExtensions(config)) {
+        return config.revealui;
+    }
+    return undefined;
+}
+// ============================================
+// SLUG UTILITIES
+// ============================================
+/**
+ * Validate a collection/global slug
+ *
+ * Slugs must:
+ * - Start with a lowercase letter
+ * - Contain only lowercase letters, numbers, and hyphens
+ */
+export function isValidSlug(slug) {
+    return /^[a-z][a-z0-9-]*$/.test(slug);
+}
+/**
+ * Convert a string to a valid slug
+ */
+export function toSlug(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/^([^a-z])/, 'x-$1'); // Ensure starts with letter
+}
+/**
+ * Validate slug and throw if invalid
+ */
+export function assertValidSlug(slug, context) {
+    if (!isValidSlug(slug)) {
+        throw new Error(`Invalid slug "${slug}" in ${context}. ` +
+            `Slugs must start with a lowercase letter and contain only ` +
+            `lowercase letters, numbers, and hyphens. ` +
+            `Suggested: "${toSlug(slug)}"`);
+    }
+}
+//# sourceMappingURL=compat.js.map

package/dist/cms/compat.js.map

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

package/dist/cms/config-contract.d.ts

@@ -0,0 +1,278 @@
+/**
+ * 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 { type Contract, type ContractType } from '../foundation/contract.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.
+ */
+declare const ConfigStructureSchema: z.ZodObject<{
+    secret: z.ZodString;
+    collections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        labels: z.ZodOptional<z.ZodObject<{
+            singular: z.ZodString;
+            plural: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        fields: z.ZodArray<z.ZodType<import("./structure.js").FieldStructure, unknown, z.core.$ZodTypeInternals<import("./structure.js").FieldStructure, unknown>>>;
+        timestamps: z.ZodOptional<z.ZodBoolean>;
+        admin: z.ZodOptional<z.ZodObject<{
+            useAsTitle: z.ZodOptional<z.ZodString>;
+            defaultColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            group: z.ZodOptional<z.ZodString>;
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+            preview: z.ZodOptional<z.ZodUnknown>;
+            livePreview: z.ZodOptional<z.ZodObject<{
+                url: z.ZodOptional<z.ZodUnknown>;
+                breakpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                defaultLimit: z.ZodOptional<z.ZodNumber>;
+                limits: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>>;
+            listSearchableFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            enableRichTextLink: z.ZodOptional<z.ZodBoolean>;
+            enableRichTextRelationship: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        versions: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            maxPerDoc: z.ZodOptional<z.ZodNumber>;
+            drafts: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                autosave: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                    interval: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>]>>;
+                validate: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>]>>;
+        upload: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            staticURL: z.ZodOptional<z.ZodString>;
+            staticDir: z.ZodOptional<z.ZodString>;
+            mimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            filesRequiredOnCreate: z.ZodOptional<z.ZodBoolean>;
+            imageSizes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                position: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    center: "center";
+                    right: "right";
+                    centre: "centre";
+                    top: "top";
+                    bottom: "bottom";
+                    entropy: "entropy";
+                    attention: "attention";
+                }>>;
+                fit: z.ZodOptional<z.ZodEnum<{
+                    fill: "fill";
+                    cover: "cover";
+                    contain: "contain";
+                    inside: "inside";
+                    outside: "outside";
+                }>>;
+            }, z.core.$strip>>>;
+            adminThumbnail: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>;
+            focalPoint: z.ZodOptional<z.ZodBoolean>;
+            crop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+        auth: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            tokenExpiration: z.ZodOptional<z.ZodNumber>;
+            verify: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                generateEmailHTML: z.ZodOptional<z.ZodUnknown>;
+                generateEmailSubject: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$strip>]>>;
+            maxLoginAttempts: z.ZodOptional<z.ZodNumber>;
+            lockTime: z.ZodOptional<z.ZodNumber>;
+            useAPIKey: z.ZodOptional<z.ZodBoolean>;
+            depth: z.ZodOptional<z.ZodNumber>;
+            cookies: z.ZodOptional<z.ZodObject<{
+                secure: z.ZodOptional<z.ZodBoolean>;
+                sameSite: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+                    none: "none";
+                    strict: "strict";
+                    lax: "lax";
+                }>, z.ZodBoolean]>>;
+                domain: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            forgotPassword: z.ZodOptional<z.ZodObject<{
+                generateEmailHTML: z.ZodOptional<z.ZodUnknown>;
+                generateEmailSubject: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$strip>>;
+            disableLocalStrategy: z.ZodOptional<z.ZodBoolean>;
+            strategies: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        }, z.core.$strip>]>>;
+        typescript: z.ZodOptional<z.ZodObject<{
+            interface: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        dbName: z.ZodOptional<z.ZodString>;
+        defaultSort: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    globals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        labels: z.ZodOptional<z.ZodObject<{
+            singular: z.ZodString;
+            plural: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        fields: z.ZodArray<z.ZodType<import("./structure.js").FieldStructure, unknown, z.core.$ZodTypeInternals<import("./structure.js").FieldStructure, unknown>>>;
+        admin: z.ZodOptional<z.ZodObject<{
+            group: z.ZodOptional<z.ZodString>;
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+            preview: z.ZodOptional<z.ZodUnknown>;
+            livePreview: z.ZodOptional<z.ZodObject<{
+                url: z.ZodOptional<z.ZodUnknown>;
+                breakpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>>;
+        versions: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            maxPerDoc: z.ZodOptional<z.ZodNumber>;
+            drafts: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                autosave: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                    interval: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>]>>;
+                validate: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>]>>;
+        typescript: z.ZodOptional<z.ZodObject<{
+            interface: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        dbName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    serverURL: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
+    admin: z.ZodOptional<z.ZodObject<{
+        user: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodObject<{
+            titleSuffix: z.ZodOptional<z.ZodString>;
+            ogImage: z.ZodOptional<z.ZodString>;
+            favicon: z.ZodOptional<z.ZodString>;
+            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                sizes: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodString>;
+                rel: z.ZodOptional<z.ZodString>;
+                fetchPriority: z.ZodOptional<z.ZodEnum<{
+                    auto: "auto";
+                    high: "high";
+                    low: "low";
+                }>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        importMap: z.ZodOptional<z.ZodObject<{
+            autoGenerate: z.ZodOptional<z.ZodBoolean>;
+            baseDir: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        css: z.ZodOptional<z.ZodString>;
+        scss: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"default">, z.ZodLiteral<"gravatar">, z.ZodUnknown]>>;
+        disable: z.ZodOptional<z.ZodBoolean>;
+        livePreview: z.ZodOptional<z.ZodObject<{
+            url: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>;
+            collections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            globals: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            breakpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                name: z.ZodString;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>>;
+    email: z.ZodOptional<z.ZodObject<{
+        fromName: z.ZodOptional<z.ZodString>;
+        fromAddress: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    localization: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        locales: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strip>>]>;
+        defaultLocale: z.ZodString;
+        fallback: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodLiteral<false>]>>;
+    i18n: z.ZodOptional<z.ZodObject<{
+        locales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        defaultLocale: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodOptional<z.ZodBoolean>;
+        supportedLanguages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    cors: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+        origins: z.ZodArray<z.ZodString>;
+        headers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>]>>;
+    csrf: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        window: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        trustProxy: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    upload: z.ZodOptional<z.ZodObject<{
+        limits: z.ZodOptional<z.ZodObject<{
+            fileSize: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    typescript: z.ZodOptional<z.ZodObject<{
+        outputFile: z.ZodOptional<z.ZodString>;
+        declare: z.ZodOptional<z.ZodBoolean>;
+        autoGenerate: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    telemetry: z.ZodOptional<z.ZodBoolean>;
+    hooks: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type ConfigStructure = z.infer<typeof ConfigStructureSchema>;
+/**
+ * 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 declare const ConfigContract: Contract<ConfigStructure>;
+/**
+ * Type for Config structure
+ * Extracted from the ConfigContract
+ */
+export type ConfigContractType = ContractType<typeof ConfigContract>;
+/**
+ * Validate a config structure
+ */
+export declare function validateConfigStructure(data: unknown): ReturnType<typeof ConfigContract.validate>;
+/**
+ * Type guard for config structures
+ */
+export declare function isConfigStructure(data: unknown): data is ConfigContractType;
+/**
+ * Parse config structure (throws on validation failure)
+ */
+export declare function parseConfigStructure(data: unknown): ConfigContractType;
+export {};
+//# sourceMappingURL=config-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-contract.d.ts","sourceRoot":"","sources":["../../src/cms/config-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAkB,MAAM,2BAA2B,CAAA;AAG5F;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0LxB,CAAA;AAIH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,eAAe,CAOnD,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAA;AAEpE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,QAAQ,CAAC,CAEjG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAE3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAEtE"}