@revealui/contracts 1.0.0

package/dist/database/bridge.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Database Contract Bridge
+ *
+ * Bridges Database types (from @revealui/db) with Contracts (from @revealui/contracts).
+ * Provides type-safe conversion utilities between database entities and contract-validated entities.
+ *
+ * This enables:
+ * - Type-safe conversion from Database types to Contract types
+ * - Runtime validation of database data using Contracts
+ * - Ensuring type safety across the DB -> ORM -> Contracts -> RevealUI layers
+ *
+ * @module @revealui/contracts/database
+ */
+import type { Contract } from '../foundation/contract.js';
+/**
+ * Generic Database type structure
+ * Matches the structure of @revealui/db/types Database type
+ * Used to avoid circular dependency between @revealui/contracts and @revealui/db
+ *
+ * @template T - The database tables structure
+ */
+export type Database<T extends {
+    public: {
+        Tables: Record<string, {
+            Row: unknown;
+            Insert: unknown;
+            Update: unknown;
+        }>;
+    };
+} = {
+    public: {
+        Tables: Record<string, {
+            Row: unknown;
+            Insert: unknown;
+            Update: unknown;
+        }>;
+    };
+}> = T;
+/**
+ * Convert a database row to a contract-validated entity
+ *
+ * @template T - The contract type
+ * @param contract - The contract to validate against
+ * @param dbRow - The database row data
+ * @returns Validated entity matching the contract
+ * @throws If validation fails
+ *
+ * @example
+ * ```typescript
+ * import { UserSchema } from '@revealui/contracts'
+ * import type { Database } from '@revealui/db/types' // Or use Database from this module
+ *
+ * const dbUser: Database['public']['Tables']['users']['Row'] = await db.query.users.findFirst()
+ * const validatedUser = dbRowToContract(UserSchema, dbUser)
+ * // validatedUser is now validated and typed according to UserSchema
+ * ```
+ */
+export declare function dbRowToContract<T>(contract: Contract<T>, dbRow: unknown): T;
+/**
+ * Safely convert a database row to a contract-validated entity
+ *
+ * Returns a result object instead of throwing on validation failure.
+ *
+ * @template T - The contract type
+ * @param contract - The contract to validate against
+ * @param dbRow - The database row data
+ * @returns Validation result with typed data or errors
+ *
+ * @example
+ * ```typescript
+ * const result = safeDbRowToContract(UserSchema, dbUser)
+ * if (result.success) {
+ *   // result.data is fully typed and validated
+ *   console.log(result.data.email)
+ * } else {
+ *   // Handle validation errors
+ *   console.error(result.errors)
+ * }
+ * ```
+ */
+export declare function safeDbRowToContract<T>(contract: Contract<T>, dbRow: unknown): ReturnType<typeof contract.validate>;
+/**
+ * Convert a contract-validated entity to a database insert type
+ *
+ * This ensures that data validated by contracts can be safely inserted into the database.
+ *
+ * @template TInsert - The database insert type
+ * @template TContract - The contract type
+ * @param contractData - The contract-validated data
+ * @returns Data ready for database insertion
+ *
+ * @example
+ * ```typescript
+ * const newUser = createUser({ email: 'user@example.com', name: 'User' })
+ * const dbInsert: Database['public']['Tables']['users']['Insert'] = contractToDbInsert(newUser)
+ * await db.insert(users).values(dbInsert)
+ * ```
+ */
+export declare function contractToDbInsert<TContract, TInsert>(contractData: TContract): TInsert;
+/**
+ * Type guard to check if database row matches a contract
+ *
+ * @template T - The contract type
+ * @param contract - The contract to check against
+ * @param dbRow - The database row to check
+ * @returns True if the row matches the contract
+ */
+export declare function isDbRowMatchingContract<T>(contract: Contract<T>, dbRow: unknown): dbRow is T;
+/**
+ * Extract table name from Database type
+ *
+ * Utility type to extract table names from the Database type structure.
+ */
+export type TableName<T extends Database> = keyof T['public']['Tables'];
+/**
+ * Extract row type for a specific table
+ *
+ * @template T - The Database type
+ * @template N - The table name
+ */
+export type TableRowType<T extends Database, N extends TableName<T>> = T['public']['Tables'][N] extends {
+    Row: infer R;
+} ? R : never;
+/**
+ * Extract insert type for a specific table
+ *
+ * @template T - The Database type
+ * @template N - The table name
+ */
+export type TableInsertType<T extends Database, N extends TableName<T>> = T['public']['Tables'][N] extends {
+    Insert: infer I;
+} ? I : never;
+/**
+ * Extract update type for a specific table
+ *
+ * @template T - The Database type
+ * @template N - The table name
+ */
+export type TableUpdateType<T extends Database, N extends TableName<T>> = T['public']['Tables'][N] extends {
+    Update: infer U;
+} ? U : never;
+/**
+ * Database Contract Registry
+ *
+ * Maps table names to their corresponding contracts.
+ * This enables automatic validation when converting database rows to contract types.
+ */
+export declare class DatabaseContractRegistry {
+    private contracts;
+    /**
+     * Register a contract for a table
+     *
+     * @param tableName - The database table name
+     * @param contract - The contract to use for validation
+     */
+    register<T>(tableName: string, contract: Contract<T>): void;
+    /**
+     * Get a contract for a table
+     *
+     * @param tableName - The database table name
+     * @returns The contract if registered, undefined otherwise
+     */
+    get<T>(tableName: string): Contract<T> | undefined;
+    /**
+     * Validate a database row using its registered contract
+     *
+     * @param tableName - The database table name
+     * @param dbRow - The database row to validate
+     * @returns Validation result
+     */
+    validateRow(tableName: string, dbRow: unknown): ReturnType<Contract<unknown>['validate']> | null;
+}
+/**
+ * Global database contract registry instance
+ */
+export declare const databaseContractRegistry: DatabaseContractRegistry;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/database/bridge.d.ts.map

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

package/dist/database/bridge.js

@@ -0,0 +1,139 @@
+/**
+ * Database Contract Bridge
+ *
+ * Bridges Database types (from @revealui/db) with Contracts (from @revealui/contracts).
+ * Provides type-safe conversion utilities between database entities and contract-validated entities.
+ *
+ * This enables:
+ * - Type-safe conversion from Database types to Contract types
+ * - Runtime validation of database data using Contracts
+ * - Ensuring type safety across the DB -> ORM -> Contracts -> RevealUI layers
+ *
+ * @module @revealui/contracts/database
+ */
+/**
+ * Convert a database row to a contract-validated entity
+ *
+ * @template T - The contract type
+ * @param contract - The contract to validate against
+ * @param dbRow - The database row data
+ * @returns Validated entity matching the contract
+ * @throws If validation fails
+ *
+ * @example
+ * ```typescript
+ * import { UserSchema } from '@revealui/contracts'
+ * import type { Database } from '@revealui/db/types' // Or use Database from this module
+ *
+ * const dbUser: Database['public']['Tables']['users']['Row'] = await db.query.users.findFirst()
+ * const validatedUser = dbRowToContract(UserSchema, dbUser)
+ * // validatedUser is now validated and typed according to UserSchema
+ * ```
+ */
+export function dbRowToContract(contract, dbRow) {
+    return contract.parse(dbRow);
+}
+/**
+ * Safely convert a database row to a contract-validated entity
+ *
+ * Returns a result object instead of throwing on validation failure.
+ *
+ * @template T - The contract type
+ * @param contract - The contract to validate against
+ * @param dbRow - The database row data
+ * @returns Validation result with typed data or errors
+ *
+ * @example
+ * ```typescript
+ * const result = safeDbRowToContract(UserSchema, dbUser)
+ * if (result.success) {
+ *   // result.data is fully typed and validated
+ *   console.log(result.data.email)
+ * } else {
+ *   // Handle validation errors
+ *   console.error(result.errors)
+ * }
+ * ```
+ */
+export function safeDbRowToContract(contract, dbRow) {
+    return contract.validate(dbRow);
+}
+/**
+ * Convert a contract-validated entity to a database insert type
+ *
+ * This ensures that data validated by contracts can be safely inserted into the database.
+ *
+ * @template TInsert - The database insert type
+ * @template TContract - The contract type
+ * @param contractData - The contract-validated data
+ * @returns Data ready for database insertion
+ *
+ * @example
+ * ```typescript
+ * const newUser = createUser({ email: 'user@example.com', name: 'User' })
+ * const dbInsert: Database['public']['Tables']['users']['Insert'] = contractToDbInsert(newUser)
+ * await db.insert(users).values(dbInsert)
+ * ```
+ */
+export function contractToDbInsert(contractData) {
+    // Type assertion - the contract should match the database structure
+    // In practice, contracts and database schemas should be kept in sync
+    return contractData;
+}
+/**
+ * Type guard to check if database row matches a contract
+ *
+ * @template T - The contract type
+ * @param contract - The contract to check against
+ * @param dbRow - The database row to check
+ * @returns True if the row matches the contract
+ */
+export function isDbRowMatchingContract(contract, dbRow) {
+    return contract.isType(dbRow);
+}
+/**
+ * Database Contract Registry
+ *
+ * Maps table names to their corresponding contracts.
+ * This enables automatic validation when converting database rows to contract types.
+ */
+export class DatabaseContractRegistry {
+    contracts = new Map();
+    /**
+     * Register a contract for a table
+     *
+     * @param tableName - The database table name
+     * @param contract - The contract to use for validation
+     */
+    register(tableName, contract) {
+        this.contracts.set(tableName, contract);
+    }
+    /**
+     * Get a contract for a table
+     *
+     * @param tableName - The database table name
+     * @returns The contract if registered, undefined otherwise
+     */
+    get(tableName) {
+        return this.contracts.get(tableName);
+    }
+    /**
+     * Validate a database row using its registered contract
+     *
+     * @param tableName - The database table name
+     * @param dbRow - The database row to validate
+     * @returns Validation result
+     */
+    validateRow(tableName, dbRow) {
+        const contract = this.contracts.get(tableName);
+        if (!contract) {
+            return null;
+        }
+        return contract.validate(dbRow);
+    }
+}
+/**
+ * Global database contract registry instance
+ */
+export const databaseContractRegistry = new DatabaseContractRegistry();
+//# sourceMappingURL=bridge.js.map

package/dist/database/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/database/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA6CH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAI,QAAqB,EAAE,KAAc;IACtE,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAqB,EACrB,KAAc;IAEd,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAqB,YAAuB;IAC5E,oEAAoE;IACpE,qEAAqE;IACrE,OAAO,YAAkC,CAAA;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAI,QAAqB,EAAE,KAAc;IAC9E,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/B,CAAC;AAyDD;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAC3B,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAA;IAExD;;;;;OAKG;IACH,QAAQ,CAAI,SAAiB,EAAE,QAAqB;QAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAA6B,CAAC,CAAA;IAC9D,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAI,SAAiB;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAA4B,CAAA;IACjE,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,SAAiB,EAAE,KAAc;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,wBAAwB,EAAE,CAAA"}

package/dist/database/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @revealui/contracts/database
+ *
+ * Database contract bridges - type-safe conversion between database types and contracts
+ */
+export { contractToDbInsert, DatabaseContractRegistry, databaseContractRegistry, dbRowToContract, isDbRowMatchingContract, safeDbRowToContract, type TableInsertType, type TableName, type TableRowType, type TableUpdateType, } from './bridge.js';
+export { batchContractToDbInsert, batchDbRowsToContract, type ContractToDrizzleInsert, createContractToDbMapper, createDbRowMapper, createTableContractRegistry, type DrizzleToContract, isDbRowAndContract, type TableContractMap, } from './type-bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAA"}

package/dist/database/index.js

@@ -0,0 +1,9 @@
+/**
+ * @revealui/contracts/database
+ *
+ * Database contract bridges - type-safe conversion between database types and contracts
+ */
+// Re-export contractToDbInsert for convenience
+export { contractToDbInsert, DatabaseContractRegistry, databaseContractRegistry, dbRowToContract, isDbRowMatchingContract, safeDbRowToContract, } from './bridge.js';
+export { batchContractToDbInsert, batchDbRowsToContract, createContractToDbMapper, createDbRowMapper, createTableContractRegistry, isDbRowAndContract, } from './type-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+CAA+C;AAC/C,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GAKpB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EAErB,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAE3B,kBAAkB,GAEnB,MAAM,kBAAkB,CAAA"}

package/dist/database/type-bridge.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Type Bridge Utilities
+ *
+ * Provides comprehensive type-safe conversion utilities between:
+ * - Drizzle ORM types (from @revealui/db)
+ * - Contract types (from @revealui/contracts)
+ * - RevealUI types (from @revealui/core)
+ *
+ * This ensures type safety across all layers of the application.
+ *
+ * @module @revealui/contracts/core/contracts/type-bridge
+ */
+import type { Contract, ContractValidationResult } from '../foundation/contract.js';
+/**
+ * Generic Database type structure
+ * Matches the structure of @revealui/db/types Database type
+ * Used to avoid circular dependency between @revealui/contracts and @revealui/db
+ *
+ * @template T - The database tables structure
+ */
+export type Database<T extends {
+    public: {
+        Tables: Record<string, {
+            Row: unknown;
+            Insert: unknown;
+            Update: unknown;
+        }>;
+    };
+} = {
+    public: {
+        Tables: Record<string, {
+            Row: unknown;
+            Insert: unknown;
+            Update: unknown;
+        }>;
+    };
+}> = T;
+/**
+ * Convert Drizzle table type to Contract type
+ *
+ * This is a type-level utility that helps ensure Drizzle types
+ * can be safely converted to Contract types.
+ *
+ * @template TTable - The Drizzle table type
+ * @template TContract - The Contract type
+ */
+export type DrizzleToContract<TTable, TContract> = TTable extends TContract ? TContract : never;
+/**
+ * Convert Contract type to Drizzle insert type
+ *
+ * Ensures contract-validated data can be safely inserted into database.
+ *
+ * @template TContract - The Contract type
+ * @template TInsert - The Drizzle insert type
+ */
+export type ContractToDrizzleInsert<TContract, TInsert> = TContract extends TInsert ? TInsert : never;
+/**
+ * Type-safe mapper function for converting database rows to contract types
+ *
+ * @template TContract - The contract type
+ * @template TDbRow - The database row type
+ * @param contract - The contract to validate against
+ * @param mapper - Optional mapper function to transform the row before validation
+ * @returns A function that converts database rows to contract-validated entities
+ *
+ * @example
+ * ```typescript
+ * const userMapper = createDbRowMapper(UserSchema, (row) => ({
+ *   ...row,
+ *   // Transform if needed
+ * }))
+ *
+ * const dbUser = await db.query.users.findFirst()
+ * const validatedUser = userMapper(dbUser)
+ * ```
+ */
+export declare function createDbRowMapper<TContract, TDbRow = unknown>(contract: Contract<TContract>, mapper?: (row: TDbRow) => unknown): (row: TDbRow) => TContract;
+/**
+ * Type-safe mapper function for converting contract types to database insert types
+ *
+ * @template TContract - The contract type
+ * @template TInsert - The database insert type
+ * @param mapper - Optional mapper function to transform the contract data before insertion
+ * @returns A function that converts contract-validated entities to database insert types
+ *
+ * @example
+ * ```typescript
+ * const insertMapper = createContractToDbMapper<User, Database['public']['Tables']['users']['Insert']>(
+ *   (user) => ({
+ *     ...user,
+ *     // Transform if needed
+ *   })
+ * )
+ *
+ * const newUser = createUser({ email: 'user@example.com', name: 'User' })
+ * const dbInsert = insertMapper(newUser)
+ * await db.insert(users).values(dbInsert)
+ * ```
+ */
+export declare function createContractToDbMapper<TContract, TInsert = TContract>(mapper?: (data: TContract) => TInsert): (data: TContract) => TInsert;
+/**
+ * Batch convert database rows to contract-validated entities
+ *
+ * @template TContract - The contract type
+ * @template TDbRow - The database row type
+ * @param contract - The contract to validate against
+ * @param rows - Array of database rows
+ * @param mapper - Optional mapper function
+ * @returns Array of validated entities
+ */
+export declare function batchDbRowsToContract<TContract, TDbRow = unknown>(contract: Contract<TContract>, rows: TDbRow[], mapper?: (row: TDbRow) => unknown): TContract[];
+/**
+ * Batch convert contract-validated entities to database insert types
+ *
+ * @template TContract - The contract type
+ * @template TInsert - The database insert type
+ * @param entities - Array of contract-validated entities
+ * @param mapper - Optional mapper function
+ * @returns Array of database insert types
+ */
+export declare function batchContractToDbInsert<TContract, TInsert = TContract>(entities: TContract[], mapper?: (data: TContract) => TInsert): TInsert[];
+/**
+ * Type guard to check if a value matches both Drizzle and Contract types
+ *
+ * @template TContract - The contract type
+ * @template TDbRow - The database row type
+ * @param contract - The contract to check against
+ * @param value - The value to check
+ * @returns True if value matches both types
+ */
+export declare function isDbRowAndContract<TContract, TDbRow>(contract: Contract<TContract>, value: unknown): value is TContract & TDbRow;
+/**
+ * Extract contract type from a table name
+ *
+ * Utility type helper for type-safe table-to-contract mapping.
+ *
+ * @template T - The Database type (from @revealui/db/types or compatible structure)
+ */
+export type TableContractMap<T extends Database> = {
+    [K in keyof T['public']['Tables']]?: T['public']['Tables'][K] extends {
+        Row: infer R;
+    } ? Contract<R> : never;
+};
+/**
+ * Create a type-safe table-to-contract registry
+ *
+ * @template T - The Database type
+ * @param map - Map of table names to contracts
+ * @returns Registry with type-safe access
+ *
+ * @example
+ * ```typescript
+ * const registry = createTableContractRegistry<Database>({
+ *   users: UserSchema,
+ *   sites: SiteSchema,
+ * })
+ *
+ * const user = await db.query.users.findFirst()
+ * const validated = registry.validate('users', user)
+ * ```
+ */
+export declare function createTableContractRegistry<T extends Database>(map: TableContractMap<T>): {
+    /**
+     * Validate a database row using its table's contract
+     */
+    validate<K extends keyof T["public"]["Tables"]>(tableName: K, row: T["public"]["Tables"][K] extends {
+        Row: infer R;
+    } ? R : never): T["public"]["Tables"][K] extends {
+        Row: infer R;
+    } ? ContractValidationResult<R> | null : null;
+    /**
+     * Get contract for a table
+     */
+    getContract<K extends keyof T["public"]["Tables"]>(tableName: K): T["public"]["Tables"][K] extends {
+        Row: infer R;
+    } ? Contract<R> | undefined : undefined;
+};
+//# sourceMappingURL=type-bridge.d.ts.map

package/dist/database/type-bridge.d.ts.map

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