@revealui/contracts 1.0.0

package/dist/api/auth.js

@@ -0,0 +1,84 @@
+/**
+ * Authentication API Contracts
+ *
+ * Validation contracts for authentication endpoints
+ */
+import { z } from 'zod/v4';
+import { createContract } from '../foundation/contract.js';
+/**
+ * Sign-up request validation
+ *
+ * Validates user registration data with:
+ * - Email format validation and sanitization
+ * - Password strength requirements (min 8 chars)
+ * - Name validation and sanitization
+ */
+export const SignUpRequestSchema = z.object({
+    email: z
+        .string()
+        .min(1, 'Email is required')
+        .email('Invalid email format')
+        .transform((email) => email.toLowerCase().trim()),
+    password: z.string().min(8, 'Password must be at least 8 characters long'),
+    name: z
+        .string()
+        .min(1, 'Name is required')
+        .max(100, 'Name must be less than 100 characters')
+        .transform((name) => name
+        .replace(/<[^>]*>/g, '')
+        .trim()
+        .replace(/\s+/g, ' ')),
+});
+export const SignUpRequestContract = createContract({
+    name: 'SignUpRequest',
+    version: '1',
+    description: 'Validates user sign-up request data',
+    schema: SignUpRequestSchema,
+});
+/**
+ * Sign-in request validation
+ */
+export const SignInRequestSchema = z.object({
+    email: z
+        .string()
+        .min(1, 'Email is required')
+        .email('Invalid email format')
+        .transform((email) => email.toLowerCase().trim()),
+    password: z.string().min(1, 'Password is required'),
+});
+export const SignInRequestContract = createContract({
+    name: 'SignInRequest',
+    version: '1',
+    description: 'Validates user sign-in request data',
+    schema: SignInRequestSchema,
+});
+/**
+ * Password reset request validation
+ */
+export const PasswordResetRequestSchema = z.object({
+    email: z
+        .string()
+        .min(1, 'Email is required')
+        .email('Invalid email format')
+        .transform((email) => email.toLowerCase().trim()),
+});
+export const PasswordResetRequestContract = createContract({
+    name: 'PasswordResetRequest',
+    version: '1',
+    description: 'Validates password reset request data',
+    schema: PasswordResetRequestSchema,
+});
+/**
+ * Password reset with token validation
+ */
+export const PasswordResetTokenSchema = z.object({
+    token: z.string().min(1, 'Token is required'),
+    password: z.string().min(8, 'Password must be at least 8 characters long'),
+});
+export const PasswordResetTokenContract = createContract({
+    name: 'PasswordResetToken',
+    version: '1',
+    description: 'Validates password reset with token data',
+    schema: PasswordResetTokenSchema,
+});
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC3B,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IAC1E,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;SAC1B,GAAG,CAAC,GAAG,EAAE,uCAAuC,CAAC;SACjD,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAClB,IAAI;SACD,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CACxB;CACJ,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;IAClD,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,qCAAqC;IAClD,MAAM,EAAE,mBAAmB;CAC5B,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC3B,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;CACpD,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;IAClD,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,qCAAqC;IAClD,MAAM,EAAE,mBAAmB;CAC5B,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC3B,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;CACpD,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,4BAA4B,GAAG,cAAc,CAAC;IACzD,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,uCAAuC;IACpD,MAAM,EAAE,0BAA0B;CACnC,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;CAC3E,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;IACvD,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,0CAA0C;IACvD,MAAM,EAAE,wBAAwB;CACjC,CAAC,CAAA"}

package/dist/api/chat.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Chat API Contracts
+ *
+ * Validation contracts for chat/AI endpoints
+ */
+import { z } from 'zod/v4';
+/**
+ * Chat message schema
+ */
+export declare const ChatMessageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        system: "system";
+        user: "user";
+        assistant: "assistant";
+    }>;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type ChatMessage = z.infer<typeof ChatMessageSchema>;
+/**
+ * Chat request validation
+ *
+ * Validates chat request with:
+ * - Non-empty array of messages
+ * - Each message has role and content
+ * - Last message must be from user
+ * - Last message content max 4000 characters
+ */
+export declare const ChatRequestSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            system: "system";
+            user: "user";
+            assistant: "assistant";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ChatRequest = z.infer<typeof ChatRequestSchema>;
+export declare const ChatRequestContract: import("../index.js").Contract<{
+    messages: {
+        role: "system" | "user" | "assistant";
+        content: string;
+    }[];
+}>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/api/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/api/chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;iBAG5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;iBAiC3B,CAAA;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAA"}

package/dist/api/chat.js

@@ -0,0 +1,55 @@
+/**
+ * Chat API Contracts
+ *
+ * Validation contracts for chat/AI endpoints
+ */
+import { z } from 'zod/v4';
+import { createContract } from '../foundation/contract.js';
+/**
+ * Chat message schema
+ */
+export const ChatMessageSchema = z.object({
+    role: z.enum(['user', 'assistant', 'system']),
+    content: z.string().min(1, 'Message content cannot be empty'),
+});
+/**
+ * Chat request validation
+ *
+ * Validates chat request with:
+ * - Non-empty array of messages
+ * - Each message has role and content
+ * - Last message must be from user
+ * - Last message content max 4000 characters
+ */
+export const ChatRequestSchema = z
+    .object({
+    messages: z.array(ChatMessageSchema).min(1, 'Messages must be a non-empty array'),
+})
+    .refine((data) => {
+    const lastMessage = data.messages[data.messages.length - 1];
+    return lastMessage?.role === 'user';
+}, {
+    message: 'Last message must be from user',
+    path: ['messages'],
+})
+    .refine((data) => {
+    const lastMessage = data.messages[data.messages.length - 1];
+    return lastMessage && lastMessage.content.trim().length > 0;
+}, {
+    message: 'Message content must be a non-empty string',
+    path: ['messages'],
+})
+    .refine((data) => {
+    const lastMessage = data.messages[data.messages.length - 1];
+    return lastMessage && lastMessage.content.length <= 4000;
+}, {
+    message: 'Message too long (max 4000 characters)',
+    path: ['messages'],
+});
+export const ChatRequestContract = createContract({
+    name: 'ChatRequest',
+    version: '1',
+    description: 'Validates chat request with messages',
+    schema: ChatRequestSchema,
+});
+//# sourceMappingURL=chat.js.map

package/dist/api/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/api/chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;CAC9D,CAAC,CAAA;AAIF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,oCAAoC,CAAC;CAClF,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC3D,OAAO,WAAW,EAAE,IAAI,KAAK,MAAM,CAAA;AACrC,CAAC,EACD;IACE,OAAO,EAAE,gCAAgC;IACzC,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CACF;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC3D,OAAO,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAA;AAC7D,CAAC,EACD;IACE,OAAO,EAAE,4CAA4C;IACrD,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CACF;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC3D,OAAO,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAA;AAC1D,CAAC,EACD;IACE,OAAO,EAAE,wCAAwC;IACjD,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CACF,CAAA;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;IAChD,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,sCAAsC;IACnD,MAAM,EAAE,iBAAiB;CAC1B,CAAC,CAAA"}

package/dist/api/gdpr.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GDPR API Contracts
+ *
+ * Validation contracts for GDPR/privacy endpoints (data export, deletion)
+ */
+import { z } from 'zod/v4';
+/**
+ * GDPR Data Export Request validation
+ *
+ * Validates data export request with userId OR email (at least one required)
+ */
+export declare const GDPRExportRequestSchema: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GDPRExportRequest = z.infer<typeof GDPRExportRequestSchema>;
+export declare const GDPRExportRequestContract: import("../index.js").Contract<{
+    userId?: string | undefined;
+    email?: string | undefined;
+}>;
+/**
+ * GDPR Data Deletion Request validation
+ *
+ * Validates data deletion request with:
+ * - userId OR email (at least one required)
+ * - confirmation must equal "DELETE" (security measure)
+ */
+export declare const GDPRDeleteRequestSchema: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    confirmation: z.ZodLiteral<"DELETE">;
+}, z.core.$strip>;
+export type GDPRDeleteRequest = z.infer<typeof GDPRDeleteRequestSchema>;
+export declare const GDPRDeleteRequestContract: import("../index.js").Contract<{
+    confirmation: "DELETE";
+    userId?: string | undefined;
+    email?: string | undefined;
+}>;
+//# sourceMappingURL=gdpr.d.ts.map

package/dist/api/gdpr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdpr.d.ts","sourceRoot":"","sources":["../../src/api/gdpr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;iBAQhC,CAAA;AAEJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,yBAAyB;;;EAKpC,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;iBAWhC,CAAA;AAEJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,yBAAyB;;;;EAKpC,CAAA"}

package/dist/api/gdpr.js

@@ -0,0 +1,53 @@
+/**
+ * GDPR API Contracts
+ *
+ * Validation contracts for GDPR/privacy endpoints (data export, deletion)
+ */
+import { z } from 'zod/v4';
+import { createContract } from '../foundation/contract.js';
+/**
+ * GDPR Data Export Request validation
+ *
+ * Validates data export request with userId OR email (at least one required)
+ */
+export const GDPRExportRequestSchema = z
+    .object({
+    userId: z.string().optional(),
+    email: z.string().email('Invalid email format').optional(),
+})
+    .refine((data) => data.userId || data.email, {
+    message: 'Either userId or email must be provided',
+    path: ['body'],
+});
+export const GDPRExportRequestContract = createContract({
+    name: 'GDPRExportRequest',
+    version: '1',
+    description: 'Validates GDPR data export request',
+    schema: GDPRExportRequestSchema,
+});
+/**
+ * GDPR Data Deletion Request validation
+ *
+ * Validates data deletion request with:
+ * - userId OR email (at least one required)
+ * - confirmation must equal "DELETE" (security measure)
+ */
+export const GDPRDeleteRequestSchema = z
+    .object({
+    userId: z.string().optional(),
+    email: z.string().email('Invalid email format').optional(),
+    confirmation: z.literal('DELETE', {
+        message: "Please confirm deletion by sending 'DELETE' in the confirmation field",
+    }),
+})
+    .refine((data) => data.userId || data.email, {
+    message: 'Either userId or email must be provided',
+    path: ['body'],
+});
+export const GDPRDeleteRequestContract = createContract({
+    name: 'GDPRDeleteRequest',
+    version: '1',
+    description: 'Validates GDPR data deletion request with confirmation',
+    schema: GDPRDeleteRequestSchema,
+});
+//# sourceMappingURL=gdpr.js.map

package/dist/api/gdpr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdpr.js","sourceRoot":"","sources":["../../src/api/gdpr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE;IAC3C,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,CAAC,MAAM,CAAC;CACf,CAAC,CAAA;AAIJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;IACtD,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,oCAAoC;IACjD,MAAM,EAAE,uBAAuB;CAChC,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAC1D,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;QAChC,OAAO,EAAE,uEAAuE;KACjF,CAAC;CACH,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE;IAC3C,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,CAAC,MAAM,CAAC;CACf,CAAC,CAAA;AAIJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;IACtD,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,wDAAwD;IACrE,MAAM,EAAE,uBAAuB;CAChC,CAAC,CAAA"}

package/dist/cms/collection.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Collection Contract
+ *
+ * Unified contract for Collection configurations that combines:
+ * - TypeScript types (compile-time)
+ * - Zod schemas (runtime validation)
+ * - Validation functions
+ * - Type guards
+ *
+ * This is the single source of truth for Collection definitions.
+ *
+ * @module @revealui/contracts/core/contracts/collection
+ */
+import { type Contract, type ContractType } from '../foundation/contract.js';
+import type { CollectionConfig, Field } from './config.js';
+import { type AuthConfig, type CollectionStructure, type UploadConfig } from './structure.js';
+/**
+ * Collection Contract
+ *
+ * This contract validates Collection configurations at runtime
+ * and provides TypeScript types at compile time.
+ *
+ * @example
+ * ```typescript
+ * const PostsContract = CollectionContract
+ *
+ * // Validate a collection config
+ * const result = PostsContract.validate(userInput)
+ * if (result.success) {
+ *   // result.data is fully typed as CollectionConfig
+ *   console.log(result.data.slug)
+ * }
+ *
+ * // Type guard
+ * if (PostsContract.isType(unknownData)) {
+ *   // unknownData is now typed as CollectionConfig
+ *   console.log(unknownData.slug)
+ * }
+ * ```
+ */
+export declare const CollectionContract: Contract<CollectionStructure>;
+/**
+ * Type for Collection configuration
+ * Extracted from the CollectionContract
+ */
+export type CollectionContractType = ContractType<typeof CollectionContract>;
+/**
+ * Validate a collection configuration
+ *
+ * @param data - Unknown data to validate
+ * @returns Validation result with typed CollectionConfig on success
+ *
+ * @example
+ * ```typescript
+ * const result = validateCollection(userInput)
+ * if (result.success) {
+ *   const collection = result.data
+ *   // collection is fully typed
+ * }
+ * ```
+ */
+export declare function validateCollection(data: unknown): ReturnType<typeof CollectionContract.validate>;
+/**
+ * Type guard for collection configurations
+ *
+ * @param data - Unknown data to check
+ * @returns True if data is a valid collection config
+ *
+ * @example
+ * ```typescript
+ * if (isCollectionConfig(unknownData)) {
+ *   // unknownData is now typed as CollectionConfig
+ *   console.log(unknownData.slug)
+ * }
+ * ```
+ */
+export declare function isCollectionConfig(data: unknown): data is CollectionContractType;
+/**
+ * Parse collection configuration (throws on validation failure)
+ *
+ * @param data - Unknown data to parse
+ * @returns Validated CollectionConfig
+ * @throws ZodError if validation fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const collection = parseCollection(userInput)
+ *   // collection is fully typed
+ * } catch (error) {
+ *   // Handle validation error
+ * }
+ * ```
+ */
+export declare function parseCollection(data: unknown): CollectionContractType;
+/**
+ * Creates a basic collection config with defaults
+ */
+export declare function createCollectionConfig(slug: string, fields: Field[], options?: Partial<Omit<CollectionConfig, 'slug' | 'fields'>>): CollectionConfig;
+/**
+ * Creates an auth-enabled collection config
+ */
+export declare function createAuthCollectionConfig(slug: string, fields: Field[], authOptions?: AuthConfig, options?: Partial<Omit<CollectionConfig, 'slug' | 'fields' | 'auth'>>): CollectionConfig;
+/**
+ * Creates an upload-enabled collection config
+ */
+export declare function createUploadCollectionConfig(slug: string, fields: Field[], uploadOptions?: UploadConfig, options?: Partial<Omit<CollectionConfig, 'slug' | 'fields' | 'upload'>>): CollectionConfig;
+//# sourceMappingURL=collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/cms/collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAkB,MAAM,2BAA2B,CAAA;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,mBAAmB,EAExB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,mBAAmB,CAO3D,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE5E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAEhG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,sBAAsB,CAEhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB,CAErE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,GAC3D,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,EAAE,EACf,WAAW,CAAC,EAAE,UAAU,EACxB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,GACpE,gBAAgB,CASlB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,CAAC,EAAE,YAAY,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,GACtE,gBAAgB,CASlB"}

package/dist/cms/collection.js

@@ -0,0 +1,144 @@
+/**
+ * Collection Contract
+ *
+ * Unified contract for Collection configurations that combines:
+ * - TypeScript types (compile-time)
+ * - Zod schemas (runtime validation)
+ * - Validation functions
+ * - Type guards
+ *
+ * This is the single source of truth for Collection definitions.
+ *
+ * @module @revealui/contracts/core/contracts/collection
+ */
+import { createContract } from '../foundation/contract.js';
+import { COLLECTION_SCHEMA_VERSION, CollectionStructureSchema, } from './structure.js';
+/**
+ * Collection Contract
+ *
+ * This contract validates Collection configurations at runtime
+ * and provides TypeScript types at compile time.
+ *
+ * @example
+ * ```typescript
+ * const PostsContract = CollectionContract
+ *
+ * // Validate a collection config
+ * const result = PostsContract.validate(userInput)
+ * if (result.success) {
+ *   // result.data is fully typed as CollectionConfig
+ *   console.log(result.data.slug)
+ * }
+ *
+ * // Type guard
+ * if (PostsContract.isType(unknownData)) {
+ *   // unknownData is now typed as CollectionConfig
+ *   console.log(unknownData.slug)
+ * }
+ * ```
+ */
+export const CollectionContract = createContract({
+    name: 'Collection',
+    version: '1.0.0',
+    schema: CollectionStructureSchema,
+    description: 'Collection configuration contract',
+    docsUrl: 'https://revealui.dev/docs/api-reference/collections',
+    tags: ['collection', 'config', 'cms'],
+});
+/**
+ * Validate a collection configuration
+ *
+ * @param data - Unknown data to validate
+ * @returns Validation result with typed CollectionConfig on success
+ *
+ * @example
+ * ```typescript
+ * const result = validateCollection(userInput)
+ * if (result.success) {
+ *   const collection = result.data
+ *   // collection is fully typed
+ * }
+ * ```
+ */
+export function validateCollection(data) {
+    return CollectionContract.validate(data);
+}
+/**
+ * Type guard for collection configurations
+ *
+ * @param data - Unknown data to check
+ * @returns True if data is a valid collection config
+ *
+ * @example
+ * ```typescript
+ * if (isCollectionConfig(unknownData)) {
+ *   // unknownData is now typed as CollectionConfig
+ *   console.log(unknownData.slug)
+ * }
+ * ```
+ */
+export function isCollectionConfig(data) {
+    return CollectionContract.isType(data);
+}
+/**
+ * Parse collection configuration (throws on validation failure)
+ *
+ * @param data - Unknown data to parse
+ * @returns Validated CollectionConfig
+ * @throws ZodError if validation fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const collection = parseCollection(userInput)
+ *   // collection is fully typed
+ * } catch (error) {
+ *   // Handle validation error
+ * }
+ * ```
+ */
+export function parseCollection(data) {
+    return CollectionContract.parse(data);
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Creates a basic collection config with defaults
+ */
+export function createCollectionConfig(slug, fields, options) {
+    return {
+        schemaVersion: COLLECTION_SCHEMA_VERSION,
+        slug,
+        fields,
+        timestamps: true,
+        ...options,
+    };
+}
+/**
+ * Creates an auth-enabled collection config
+ */
+export function createAuthCollectionConfig(slug, fields, authOptions, options) {
+    return {
+        schemaVersion: COLLECTION_SCHEMA_VERSION,
+        slug,
+        fields: [{ name: 'email', type: 'email', required: true, unique: true }, ...fields],
+        auth: authOptions ?? {},
+        timestamps: true,
+        ...options,
+    };
+}
+/**
+ * Creates an upload-enabled collection config
+ */
+export function createUploadCollectionConfig(slug, fields, uploadOptions, options) {
+    return {
+        schemaVersion: COLLECTION_SCHEMA_VERSION,
+        slug,
+        fields,
+        upload: uploadOptions ?? {},
+        timestamps: true,
+        ...options,
+    };
+}
+//# sourceMappingURL=collection.js.map

package/dist/cms/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/cms/collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAoC,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE5F,OAAO,EAEL,yBAAyB,EAEzB,yBAAyB,GAE1B,MAAM,gBAAgB,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkC,cAAc,CAAC;IAC9E,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,yBAAyB;IACjC,WAAW,EAAE,mCAAmC;IAChD,OAAO,EAAE,qDAAqD;IAC9D,IAAI,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC;CACtC,CAAC,CAAA;AAQF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,MAAe,EACf,OAA4D;IAE5D,OAAO;QACL,aAAa,EAAE,yBAAyB;QACxC,IAAI;QACJ,MAAM;QACN,UAAU,EAAE,IAAI;QAChB,GAAG,OAAO;KACX,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,MAAe,EACf,WAAwB,EACxB,OAAqE;IAErE,OAAO;QACL,aAAa,EAAE,yBAAyB;QACxC,IAAI;QACJ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC;QACnF,IAAI,EAAE,WAAW,IAAI,EAAE;QACvB,UAAU,EAAE,IAAI;QAChB,GAAG,OAAO;KACX,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAY,EACZ,MAAe,EACf,aAA4B,EAC5B,OAAuE;IAEvE,OAAO;QACL,aAAa,EAAE,yBAAyB;QACxC,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,aAAa,IAAI,EAAE;QAC3B,UAAU,EAAE,IAAI;QAChB,GAAG,OAAO;KACX,CAAA;AACH,CAAC"}