@asaidimu/anansi 1.3.3 → 1.4.1

package/index.d.cts

@@ -1,33 +1,129 @@
+import * as _faker_js_faker from '@faker-js/faker';
 import { Faker } from '@faker-js/faker';
 import { QueryDSL, QueryFilter } from '@asaidimu/query';
 import { StandardSchemaV1 } from '@standard-schema/spec';
-import { z } from 'zod';
+import LightningFS from '@isomorphic-git/lightning-fs';
 
 /**
- * Schema-related interfaces
+ * hints.ts
+ *
+ * Defines type hints for generating form input controls based on schema field definitions.
+ * Each hint type corresponds to a specific input control, providing metadata for code generation.
+ */
+/**
+ * Hints for generating a file input control.
+ */
+type FileHint = {
+    type: "file";
+    label?: string;
+    embed?: boolean;
+    mimes?: string | string[];
+    size?: {
+        max?: number;
+        min?: number;
+    };
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+};
+/**
+ * Hints for generating a text-based input control.
+ */
+type TextHint = {
+    type: "text" | "email" | "tel" | "url" | "textarea";
+    label?: string;
+    placeholder?: string;
+};
+/**
+ * Hints for generating a secret input control (e.g., passwords, API keys).
+ */
+type SecretHint = {
+    type: "secret";
+    label?: string;
+    placeholder?: string;
+    password?: boolean;
+};
+/**
+ * Hints for generating a number-based input control.
+ */
+type NumberHint = {
+    type: "number" | "range";
+    label?: string;
+    step?: number;
+};
+/**
+ * Hints for generating a boolean input control.
+ */
+type BooleanHint = {
+    type: "checkbox" | "radio";
+    label?: string;
+    radioLabels?: {
+        true: string;
+        false: string;
+    };
+};
+/**
+ * Hints for generating an enum input control.
+ */
+type EnumHint = {
+    type: "select" | "radio";
+    label?: string;
+};
+/**
+ * Hints for generating an array input control.
+ */
+type ArrayHint = {
+    type: "list";
+    label?: string;
+    itemHint?: {
+        type: string;
+    };
+};
+/**
+ * Hints for generating a set input control.
+ */
+type SetHint = {
+    type: "tags";
+    label?: string;
+    itemHint?: {
+        type: string;
+    };
+};
+/**
+ * Hints for generating an object input control.
+ */
+type ObjectHint = {
+    type: "group";
+    label?: string;
+    collapsible?: boolean;
+};
+/**
+ * Hints for generating a dynamic input control.
+ */
+type DynamicHint = {
+    type: "text";
+    label?: string;
+};
+/**
+ * Union type for all possible input hints.
  */
+type InputHint = FileHint | TextHint | SecretHint | NumberHint | BooleanHint | EnumHint | ArrayHint | SetHint | ObjectHint | DynamicHint;
 
 /**
- * Logical operators for constraints and partial indexes.
+ * Logical operators for combining constraints or index conditions.
  */
 type LogicalOperator = "and" | "or" | "not" | "nor" | "xor";
 /**
  * Basic field types supported by the schema system.
  */
-type FieldType = "string" | "number" | "boolean" | "array" | "object" | "dynamic";
+type FieldType = "string" | "number" | "boolean" | "array" | "set" | "enum" | "object" | "record" | "dynamic";
 /**
  * Index types for optimizing different query patterns.
  */
 type IndexType = "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
 /**
- * Defines a predicate function for data validation.
- * @template T The type of the data object.
- * @template K The type of the field being validated.
- * @param {object} params - The parameters for the predicate.
- * @param {T} params.data - The data object being validated.
- * @param {keyof T} params.field - The field being validated.
- * @param {ConstraintParameters<K>} params.arguments - The constraint parameters.
- * @returns {boolean} True if the data is valid, false otherwise.
+ * Defines a predicate function for data validation, mapped to a PredicateMap at runtime.
  */
 type Predicate = <T, K extends FieldType = any>(params: {
     data: T;
@@ -35,21 +131,24 @@ type Predicate = <T, K extends FieldType = any>(params: {
     arguments: PredicateParameters<K>;
 }) => boolean;
 /**
- * A map of constraint names to predicate functions.
- * @template T The type of the data object.
+ * A map of predicate names to their validation functions, implemented by the runtime environment.
  */
 type PredicateMap = Record<string, Predicate>;
+/**
+ * A map of function names to generic functions, used elsewhere in the system.
+ */
 type FunctionMap = Record<string, Function>;
-/** @deprecated */
+/** @deprecated Use PredicateMap instead. */
 type ConstraintsMap = Record<string, Predicate>;
 /**
- * Supported constraint names.
- * @template T The type of the constraints map.
+ * Names of supported predicates, derived from a PredicateMap.
  */
 type PredicateName<T extends PredicateMap = any> = keyof T;
 /**
- * Constraint parameters based on field type.
- * @template T The field type.
+ * Parameters for predicates, tailored to each field type.
+ */
+/**
+ * Parameters for predicates, tailored to each field type.
  */
 type PredicateParameters<T extends FieldType> = T extends "string" ? string | string[] | RegExp | {
     field: string;
@@ -58,146 +157,125 @@ type PredicateParameters<T extends FieldType> = T extends "string" ? string | st
     scale?: number;
 } | {
     field: string;
-} : T extends "boolean" ? boolean : T extends "array" ? number | {
+} : T extends "boolean" ? boolean : T extends "array" | "set" ? number | {
     minItems: number;
     maxItems: number;
 } : T extends "object" ? {
     schema: Record<string, unknown>;
-} : never;
-/** @deprecated */
+} : T extends "record" ? Record<string, unknown> : T extends "dynamic" ? any : never;
+/** @deprecated Use PredicateParameters instead. */
 type ConstraintParameters<T extends FieldType> = PredicateParameters<T>;
 /**
- * Defines a constraint on a field.
- * @template T The field type.
+ * Defines a constraint on a field or schema, using a predicate for validation.
  */
 type Constraint<T extends FieldType> = {
     type?: "schema";
-    /** The predicate function for the constraint */
     predicate: string;
-    /** The field the constraint applies to */
     field?: keyof any;
-    /** The parameters for the constraint. */
     parameters?: PredicateParameters<T>;
-    /** The name of the constraint. */
     name: string;
-    /** A description of the constraint. */
     description?: string;
-    /** A custom error message for the constraint. */
     errorMessage?: string;
 };
 /**
- * Group of constraint rules with a logical operator.
- * @template T The field type.
+ * Groups multiple constraints with a logical operator for complex validation logic.
  */
 interface ConstraintGroup<T extends FieldType> {
-    /** The name of the constraint. */
     name: string;
-    /** The logical operator for the group (AND or OR). */
     operator: LogicalOperator;
-    /** The rules in the group, which can be constraints or other constraint groups. */
     rules: Array<Constraint<T> | ConstraintGroup<T>>;
 }
 /**
- * Definition of a field within the schema.
- * @template T The type of the field.
+ * Collection of constraints or groups applied at the schema or nested level.
+ */
+type SchemaConstraint<T extends FieldType> = Array<Constraint<T> | ConstraintGroup<T>>;
+/**
+ * Defines a field within a schema, including its type, constraints, and nesting.
  */
 interface FieldDefinition<T> {
-    /** The name of the field. */
     name: string;
-    /** The type of the field. */
     type: FieldType;
-    /** Whether the field is required. */
     required?: boolean;
-    /** The constraints on the field. */
     constraints?: Constraint<any>[];
-    /** The default value of the field. */
     default?: T;
-    /** The type of items in an array field. */
+    values?: Array<unknown>;
     itemsType?: FieldType;
-    /** The schema for nested objects. */
-    nestedSchema?: Record<string, FieldDefinition<any>>;
-    /** Whether the field is deprecated. */
+    /** Reference to a nested schema (mini-SchemaDefinition) with optional overrides. */
+    nestedSchema?: {
+        id: string;
+        constraints?: SchemaConstraint<any>;
+        indexes?: IndexDefinition[];
+    };
     deprecated?: boolean;
-    /** A reference to another schema and field. */
     reference?: {
         schema: string;
         field: string;
     };
-    /** A description of the field. */
     description?: string;
-    /** Whether the field is unique. */
     unique?: boolean;
+    hint?: {
+        input: InputHint;
+    };
 }
 /**
- * Condition for partial indexes.
+ * Condition for partial indexes, allowing conditional indexing based on field values.
  */
 interface PartialIndexCondition {
-    /** The logical operator for the condition. */
     operator: LogicalOperator;
-    /** The field to which condition applies. */
     field: string;
-    /** The value to compare against (optional). */
     value?: any;
-    /** Nested conditions (optional). */
     conditions?: PartialIndexCondition[];
 }
 /**
- * Definition of an index.
+ * Defines an index for optimizing queries or enforcing uniqueness.
  */
 interface IndexDefinition {
-    /** The fields included in the index. */
     fields: string[];
-    /** The type of the index. */
     type: IndexType;
-    /** Whether the index is unique. */
     unique?: boolean;
-    /** A partial index condition. */
     partial?: PartialIndexCondition;
-    /** A description of the index. */
     description?: string;
-    /** Sorting order for the index */
     order?: "asc" | "desc";
-    /** A name for the index. */
     name: string;
 }
 /**
- * Schema constraint definition.
- * @template T The field type.
+ * A mini-schema definition for reusable nested structures within a larger schema.
+ * Mirrors SchemaDefinition but omits top-level-only properties like version and migrations.
  */
-type SchemaConstraint<T extends FieldType> = Array<Constraint<T> | ConstraintGroup<T>>;
+interface NestedSchemaDefinition {
+    name: string;
+    description?: string;
+    fields: Record<string, FieldDefinition<any>>;
+    indexes?: IndexDefinition[];
+    constraints?: SchemaConstraint<any>;
+    metadata?: Record<string, any>;
+}
 /**
- * Complete schema definition.
+ * Defines a complete schema, intended as an atomic unit within a larger domain model.
  */
 interface SchemaDefinition {
-    /** The name of the schema. */
     name: string;
-    /** The version of the schema. */
     version: string;
-    /** A description of the schema. */
     description?: string;
-    /** The field definitions in the schema. */
     fields: Record<string, FieldDefinition<any>>;
-    /** The indexes defined for the schema. */
+    /** Reusable nested schema definitions, now as mini-SchemaDefinitions. */
+    nestedSchemas: Record<string, NestedSchemaDefinition>;
     indexes?: IndexDefinition[];
-    /** The constraints defined for the schema. */
     constraints?: SchemaConstraint<any>;
-    /** Metadata associated with the schema. */
     metadata?: Record<string, any>;
-    /** Dependencies of the schema. */
+    /** @deprecated Use dependencies in DomainModel instead. */
     dependencies?: string[];
-    /** Migrations associated with the schema. */
     migrations?: Array<Migration<any>>;
-    /** A Mock associated with the schema. */
-    mock?: <T>(faker: Faker) => Generator<T, void, unknown>;
+    mock?: <T>(faker: typeof _faker_js_faker) => Generator<T, void, unknown>;
 }
 /**
- * Defines a change that can be made to a schema.
- * @template T The type of the field being changed.
+ * Defines a change that can be made to a schema during migration.
+ * Updated to support the new NestedSchemaDefinition structure.
  */
 type SchemaChange<T> = {
     type: "modifyProperty";
-    id: keyof Omit<SchemaDefinition, "fields" | "indexes" | "constraints">;
-    changes: Partial<Omit<SchemaDefinition, "fields" | "indexes" | "constraints">>;
+    id: keyof Omit<SchemaDefinition, "fields" | "indexes" | "constraints" | "nestedSchemas">;
+    changes: Partial<Omit<SchemaDefinition, "fields" | "indexes" | "constraints" | "nestedSchemas">>;
 } | {
     type: "addField";
     id: string;
@@ -209,6 +287,11 @@ type SchemaChange<T> = {
     type: "modifyField";
     id: string;
     changes: Partial<FieldDefinition<T>>;
+    nestedSchemaChanges?: {
+        id?: string;
+        constraints?: SchemaConstraint<any>;
+        indexes?: IndexDefinition[];
+    };
 } | {
     type: "addIndex";
     definition: IndexDefinition;
@@ -232,61 +315,49 @@ type SchemaChange<T> = {
 } | {
     type: "deprecateField";
     id: string;
+} | {
+    type: "addNestedSchema";
+    id: string;
+    definition: NestedSchemaDefinition;
+} | {
+    type: "removeNestedSchema";
+    id: string;
+} | {
+    type: "modifyNestedSchema";
+    id: string;
+    changes: Partial<NestedSchemaDefinition>;
 };
 /**
- * Defines a transform function for data migration.
- * @template Initial The initial data type.
- * @template Next The transformed data type.
- * @param {Initial} data - The initial data.
- * @returns {Next | Promise<Next>} The transformed data or a promise that resolves to the transformed data.
+ * Defines a transform function for data migration between schema versions.
  */
 type TransformFunction<Initial, Next> = (data: Initial) => Next | Promise<Next>;
 /**
- * Represents a pair of transformations for data migration (forward and backward).
- * @template Initial The initial data type.
- * @template Next The transformed data type.
+ * Represents a pair of transformations for bidirectional data migration.
  */
 interface DataTransform<Initial, Next> {
-    /** The forward transformation function. */
     forward: TransformFunction<Initial, Next>;
-    /** The backward transformation function. */
     backward: TransformFunction<Next, Initial>;
 }
 /**
- * Defines a migration, which consists of a series of schema changes and data transforms.
- * Each migration is a set of atomic changes that can be applied in a single operation.
- * @template T The type of the data being migrated.
+ * Defines a migration, consisting of schema changes and data transforms.
  */
 interface Migration<T> {
-    /** A unique identifier for the migration. */
     id: string;
-    /** the schema version for which this migration is applicable */
     schemaVersion: string;
-    /** A list of schema changes to be applied in the migration. */
     changes: SchemaChange<T>[];
-    /** A description of what the migration does. */
     description: string;
-    /** The current status of the migration. */
     status: "pending" | "applied" | "failed";
-    /** An optional list of schema changes to revert the migration. */
     rollback?: SchemaChange<T>[];
-    /**
-     * A checksum/string/url representing the js file exporting
-     * the data transforms for this migration.
-     * Each transform file exports a `DataTransform` object.
-     */
     transform: string | DataTransform<any, any>;
-    /** A timestamp for when the migration was created (in ISO 8601 format). */
     createdAt: string;
-    /** @deprecated An optional list of migration IDs that must be applied before this one. */
+    /** @deprecated Use dependencies in DomainModel instead. */
     dependencies?: string[];
-    /**
-     * A checksum to ensure the integrity of the migration.
-     * This is the hash of the stringified/minified version of this object,
-     * excluding the `checksum` field itself (to avoid circular dependencies).
-     */
     checksum: string;
 }
+/**
+ * Generator type for mock data functions (used with Faker).
+ */
+type Generator<T, TReturn, TNext> = Iterator<T, TReturn, TNext>;
 
 /**
  * Defines the interface for a migration engine.
@@ -570,6 +641,23 @@ interface SchemaMigrationHelper {
      * @param changes The changes to apply to the constraint.
      */
     modifyConstraint(constraintName: string, changes: Partial<Constraint<any>>): void;
+    /**
+     * Adds a new nested schema to the schema.
+     * @param {string} schemaId - The ID of the nested schema to add.
+     * @param {NestedSchemaDefinition} nestedDefinition - The definition of the nested schema to add.
+     */
+    addNestedSchema(schemaId: string, nestedDefinition: NestedSchemaDefinition): void;
+    /**
+     * Removes a nested schema from the schema.
+     * @param {string} schemaId - The ID of the nested schema to remove.
+     */
+    removeNestedSchema(schemaId: string): void;
+    /**
+     * Modifies an existing nested schema in the schema.
+     * @param {string} schemaId - The ID of the nested schema to modify.
+     * @param {Partial<NestedSchemaDefinition>} changes - The changes to apply to the nested schema.
+     */
+    modifyNestedSchema(schemaId: string, changes: Partial<NestedSchemaDefinition>): void;
     /**
      * Returns the list of changes made through this helper.
      * @returns An array of schema changes.
@@ -795,45 +883,307 @@ type RegistryLock = {
     updated: string;
     hashes: [filepath: string, filehash: string][];
 };
-interface SchemaRegistry {
-    /** Initialize a new registry */
+interface SchemaRegistryInterface {
+    /** Initializes the repository **/
     init(): Promise<void>;
-    /** Clone an existing registry from a remote source */
-    clone(): Promise<void>;
     /** Create a new schema version */
-    create(schema: SchemaDefinition): Promise<void>;
+    create(_: {
+        schema: SchemaDefinition;
+    }): Promise<void>;
     /** Update an existing schema version */
-    update(schema: SchemaDefinition): Promise<void>;
+    update(_: {
+        schema: SchemaDefinition;
+    }): Promise<void>;
     /** Delete a schema and its associated branch */
-    delete(name: string): Promise<void>;
+    delete(_: {
+        name: string;
+    }): Promise<void>;
     /** List all schemas with their latest version */
     list(): Promise<{
         name: string;
         version: string;
     }[]>;
     /** Retrieve schema definition for a specific version (or latest if no version is provided) */
-    schema(name: string, version?: string, migrations?: boolean): Promise<SchemaDefinition | null>;
+    schema(_: {
+        name: string;
+        version?: string;
+        migrations?: boolean;
+    }): Promise<SchemaDefinition | null>;
     /** Get schema statistics (returns the full SchemaIndex) */
-    stats(schema?: string): Promise<SchemaIndex | RegistryMetadata>;
+    stats(_: {
+        schema?: string;
+    }): Promise<SchemaIndex | RegistryMetadata>;
     /** Regenerate index & lockfile, then push changes */
     sync(): Promise<void>;
-    /** Retrieve all predicate names required by a specific schema version (or latest if no version is provided) */
-    predicates(name: string, version?: string): Promise<string[]>;
     /** Retrieve all migrations for a specific schema version (or latest if no version is provided) */
-    migrations(name: string, version?: string): Promise<Array<Migration<any>>>;
+    migrations(_: {
+        name: string;
+        version?: string;
+    }): Promise<Array<Migration<any>>>;
     /** Retrieve the full history of a schema */
-    history(name: string): Promise<SchemaDefinition[]>;
+    history(_: {
+        name: string;
+    }): Promise<SchemaDefinition[]>;
 }
 
 /**
- * Creates and returns a new SchemaRegistry instance.
- * @returns {Promise<SchemaRegistry>} A promise that resolves to the SchemaRegistry instance.
+ * Interface for interacting with a remotely hosted repository (e.g., GitHub, GitLab).
  */
-declare function createRegistry(credentials: {
-    username: string;
-    password: string;
-    repository: string;
-}, dir?: string, proxy?: string): Promise<SchemaRegistry>;
+interface RemoteRepository {
+    /**
+     * Creates a new repository on the remote service.
+     * @param options.name - The name of the repository.
+     * @param options.private - Whether the repository should be private (default: false).
+     * @returns A promise resolving to the repository's authenticated URL (e.g., "https://username:token@github.com/username/repo.git").
+     * @param options
+     */
+    create(options: {
+        name: string;
+        private?: boolean;
+    }): Promise<RemoteRepository>;
+    /**
+     * Checks if a repository exists on the remote service.
+     * @param options - Repository lookup details.
+     * @param options.name - The name of the repository.
+     * @returns A promise resolving to true if the repository exists, false otherwise.
+     */
+    exists({ name }: {
+        name: string;
+    }): Promise<boolean>;
+    /**
+     * Deletes a repository on the remote service.
+     */
+    remove(): Promise<void>;
+    /**
+     * Returns a properly formatted authenticated URL for a specific repository.
+     * @returns A string representing the auth-enabled URL (e.g., "https://username:token@github.com/username/repo.git").
+     */
+    authURL(): string;
+    /**
+     * Returns the plain URL to this repository.
+     * @returns A string representing the repository URL (e.g., "https://github.com/username/repo.git").
+     * @throws RemoteRepositoryError if no repository is set.
+     */
+    url(): string;
+    credentials(): {
+        username: string;
+        password: string;
+    };
+}
+
+declare function createGitSchemaRegistry(rootDir?: string, options?: {
+    remote?: RemoteRepository;
+    mainBranch?: string;
+    createRemote?: boolean;
+    author?: {
+        name: string;
+        email: string;
+    };
+    proxy?: string;
+    cacheTtl?: number;
+}): Promise<SchemaRegistryInterface>;
+
+/**
+ * Implementation of a schema registry using an in-memory LightningFS.
+ * Combines refined filesystem management with original serialization for functions and mocks.
+ */
+declare class SchemaRegistry implements SchemaRegistryInterface {
+    /** In-memory filesystem instance for storing registry data. */
+    fs: LightningFS;
+    /** Promise-based API for asynchronous filesystem operations. */
+    fsp: LightningFS.PromisifiedFS;
+    /** Root directory path in the filesystem (e.g., '/registry'). */
+    rootDir: string;
+    /**
+     * Constructs a new SchemaRegistryImpl instance.
+     * @param rootDir - The root directory for the registry (defaults to '/registry').
+     */
+    constructor(rootDir?: string);
+    /**
+     * Ensures the registry is initialized with base files if they don't exist.
+     * Implements refined conditional initialization for idempotency.
+     */
+    init(): Promise<void>;
+    /**
+     * Creates a new schema in the registry.
+     * @param params - Object containing the schema definition.
+     * @throws Error if schema name or version is missing, or if schema already exists.
+     */
+    create({ schema }: {
+        schema: SchemaDefinition;
+    }): Promise<void>;
+    /**
+     * Updates an existing schema in the registry.
+     * @param params - Object containing the updated schema definition.
+     * @throws Error if schema name or version is missing, or if schema doesn't exist.
+     */
+    update({ schema }: {
+        schema: SchemaDefinition;
+    }): Promise<void>;
+    /**
+     * Saves a schema (create or update) with serialization and metadata updates.
+     * @param schema - The schema definition to save.
+     * @param action - Whether this is a create or update operation.
+     * @private - Internal method to reduce duplication in create/update.
+     */
+    private saveSchema;
+    /**
+     * Deletes a schema and all its associated data from the registry.
+     * Implements refined full filesystem cleanup.
+     * @param params - Object containing the schema name to delete.
+     * @throws Error if schema doesn't exist.
+     */
+    delete({ name }: {
+        name: string;
+    }): Promise<void>;
+    /**
+     * Lists all schemas in the registry with their latest versions.
+     * @returns Array of schema names and versions.
+     */
+    list(): Promise<{
+        name: string;
+        version: string;
+    }[]>;
+    /**
+     * Retrieves a schema definition, optionally with a specific version and migrations.
+     * Incorporates original serialization for mocks.
+     * @param params - Object with schema name, optional version, and migrations flag.
+     * @returns Schema definition or null if not found.
+     */
+    schema({ name, version, migrations, }: {
+        name: string;
+        version?: string;
+        migrations?: boolean;
+    }): Promise<SchemaDefinition | null>;
+    /**
+     * Retrieves statistics for a specific schema or the entire registry.
+     * @param params - Optional schema name to get SchemaIndex instead of RegistryMetadata.
+     * @returns SchemaIndex or RegistryMetadata.
+     * @throws Error if specific schema stats requested but schema not found.
+     */
+    stats({ schema, }: {
+        schema?: string;
+    }): Promise<SchemaIndex | RegistryMetadata>;
+    /**
+     * Synchronizes the registry by updating the lockfile with current file hashes.
+     * Implements refined sync behavior.
+     */
+    sync(): Promise<void>;
+    /**
+     * Retrieves migrations for a schema up to a specified version.
+     * Incorporates original serialization for migration transforms.
+     * @param params - Object with schema name and optional version.
+     * @returns Array of migrations, sorted by version.
+     */
+    migrations({ name, version, }: {
+        name: string;
+        version?: string;
+    }): Promise<Array<Migration<any>>>;
+    /**
+     * Retrieves the version history of a schema.
+     * Incorporates original serialization for mocks and migrations.
+     * @param params - Object with schema name.
+     * @returns Array of schema definitions for each version.
+     */
+    history({ name }: {
+        name: string;
+    }): Promise<SchemaDefinition[]>;
+    /**
+     * Processes and stores migrations with serialization of transforms.
+     * Adopts original's approach to handling executable transforms.
+     * @param schemaDir - Directory path for the schema.
+     * @param schema - Schema definition containing migrations.
+     * @returns Array of migration metadata.
+     * @private
+     */
+    private processAndStoreMigrations;
+    /**
+     * Serializes a schema definition, handling mocks as per original.
+     * @param schema - Schema definition to serialize.
+     * @returns JSON string of serialized schema.
+     * @private
+     */
+    private serializeSchema;
+    /**
+     * Deserializes a schema content object, restoring mocks as per original.
+     * @param schemaContent - Raw schema content from JSON.
+     * @returns Deserialized schema definition.
+     * @private
+     */
+    private deserializeSchema;
+    /**
+     * Deserializes a migration content object, restoring transforms as per original.
+     * @param content - Raw migration content from JSON.
+     * @returns Deserialized migration object.
+     * @private
+     */
+    private deserializeMigration;
+    /**
+     * Writes the schema file to the filesystem.
+     * @param schemaDir - Directory path for the schema.
+     * @param content - Serialized schema content.
+     * @returns Path to the written schema file.
+     * @private
+     */
+    private writeSchemaFile;
+    /**
+     * Updates the schema index with new version history and migrations.
+     * @param schemaDir - Directory path for the schema.
+     * @param schema - Schema definition being saved.
+     * @param schemaHash - Hash of the schema content.
+     * @param migrations - Processed migration metadata.
+     * @param action - Whether this is a create or update operation.
+     * @private
+     */
+    private updateIndex;
+    /**
+     * Updates the registry metadata with schema information.
+     * @param schema - Schema definition being saved.
+     * @param action - Whether this is a create or update operation.
+     * @private
+     */
+    private updateRegistryMetadata;
+    /**
+     * Reads the registry metadata from the filesystem.
+     * @returns Parsed RegistryMetadata object.
+     * @private
+     */
+    private readRegistryMetadata;
+    /**
+     * Writes the registry metadata to the filesystem.
+     * @param metadata - RegistryMetadata object to write.
+     * @private
+     */
+    private writeRegistryMetadata;
+    /**
+     * Reads the schema index from the filesystem.
+     * @param name - Name of the schema.
+     * @returns Parsed SchemaIndex object.
+     * @throws Error if schema index not found.
+     * @private
+     */
+    private readSchemaIndex;
+    /**
+     * Checks if a file exists in the filesystem.
+     * @param path - Path to check.
+     * @returns True if file exists, false otherwise.
+     * @private
+     */
+    fileExists(path: string): Promise<boolean>;
+    /**
+     * Recursively removes a directory and its contents.
+     * @param path - Directory path to remove.
+     * @private
+     */
+    private rmdirRecursive;
+    /**
+     * Lists all files recursively in a directory.
+     * @param path - Directory path to scan.
+     * @returns Array of file paths.
+     * @private
+     */
+    private listFilesRecursive;
+}
 
 /**
  * @fileoverview Provides a MigrationEngine class that handles schema migrations,
@@ -1062,765 +1412,10 @@ declare class MigrationEngine {
  * Helper for building schema migrations with forward and rollback changes.
  * @template T The type of data associated with the schema.
  * @param {Readonly<SchemaDefinition>} schema - The original schema to base the migration on.
- * @returns {Object} An object with methods to build migration changes and retrieve the changes.
+ * @returns {SchemaMigrationHelper} An object with methods to build migration changes and retrieve the changes.
  */
 declare const createSchemaMigrationHelper: <T>(schema: Readonly<SchemaDefinition>) => SchemaMigrationHelper;
 
-declare const MigrationSchema: z.ZodObject<{
-    id: z.ZodString;
-    schemaVersion: z.ZodString;
-    changes: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"addField">;
-        id: z.ZodString;
-        definition: any;
-    }, "strip", z.ZodTypeAny, {
-        type: "addField";
-        id: string;
-        definition?: any;
-    }, {
-        type: "addField";
-        id: string;
-        definition?: any;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"removeField">;
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: "removeField";
-        id: string;
-    }, {
-        type: "removeField";
-        id: string;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"modifyField">;
-        id: z.ZodString;
-        changes: any;
-    }, "strip", z.ZodTypeAny, {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    }, {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"addIndex">;
-        definition: z.ZodObject<{
-            fields: z.ZodArray<z.ZodString, "many">;
-            type: z.ZodEnum<["normal", "unique", "btree", "hash", "spatial", "fulltext", "gi", "expression", "composite"]>;
-            unique: z.ZodOptional<z.ZodBoolean>;
-            partial: z.ZodOptional<z.ZodType<any, z.ZodTypeDef, any>>;
-            description: z.ZodOptional<z.ZodString>;
-            order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
-            name: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }, {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }, {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"removeIndex">;
-        name: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "removeIndex";
-    }, {
-        name: string;
-        type: "removeIndex";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"modifyIndex">;
-        name: z.ZodString;
-        changes: z.ZodObject<{
-            fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            type: z.ZodOptional<z.ZodEnum<["normal", "unique", "btree", "hash", "spatial", "fulltext", "gi", "expression", "composite"]>>;
-            unique: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
-            partial: z.ZodOptional<z.ZodOptional<z.ZodType<any, z.ZodTypeDef, any>>>;
-            description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            order: z.ZodOptional<z.ZodOptional<z.ZodEnum<["asc", "desc"]>>>;
-            name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }, {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }, {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"addConstraint">;
-        constraint: z.ZodUnion<[z.ZodObject<{
-            type: z.ZodOptional<z.ZodString>;
-            name: z.ZodString;
-            predicate: z.ZodOptional<z.ZodString>;
-            parameters: z.ZodOptional<z.ZodType<(params: any) => boolean, z.ZodTypeDef, (params: any) => boolean>>;
-            description: z.ZodOptional<z.ZodString>;
-            field: z.ZodOptional<z.ZodString>;
-            errorMessage: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }, {
-            name: string;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }>, any]>;
-    }, "strip", z.ZodTypeAny, {
-        type: "addConstraint";
-        constraint?: any;
-    }, {
-        type: "addConstraint";
-        constraint?: any;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"removeConstraint">;
-        name: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "removeConstraint";
-    }, {
-        name: string;
-        type: "removeConstraint";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"modifyConstraint">;
-        name: z.ZodString;
-        changes: z.ZodObject<{
-            type: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            name: z.ZodOptional<z.ZodString>;
-            predicate: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            parameters: z.ZodOptional<z.ZodOptional<z.ZodType<(params: any) => boolean, z.ZodTypeDef, (params: any) => boolean>>>;
-            description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            field: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            errorMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }, {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    }, {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"deprecateField">;
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: "deprecateField";
-        id: string;
-    }, {
-        type: "deprecateField";
-        id: string;
-    }>]>, "many">;
-    description: z.ZodString;
-    status: z.ZodEnum<["pending", "applied", "failed"]>;
-    rollback: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"addField">;
-        id: z.ZodString;
-        definition: any;
-    }, "strip", z.ZodTypeAny, {
-        type: "addField";
-        id: string;
-        definition?: any;
-    }, {
-        type: "addField";
-        id: string;
-        definition?: any;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"removeField">;
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: "removeField";
-        id: string;
-    }, {
-        type: "removeField";
-        id: string;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"modifyField">;
-        id: z.ZodString;
-        changes: any;
-    }, "strip", z.ZodTypeAny, {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    }, {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"addIndex">;
-        definition: z.ZodObject<{
-            fields: z.ZodArray<z.ZodString, "many">;
-            type: z.ZodEnum<["normal", "unique", "btree", "hash", "spatial", "fulltext", "gi", "expression", "composite"]>;
-            unique: z.ZodOptional<z.ZodBoolean>;
-            partial: z.ZodOptional<z.ZodType<any, z.ZodTypeDef, any>>;
-            description: z.ZodOptional<z.ZodString>;
-            order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
-            name: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }, {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }, {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"removeIndex">;
-        name: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "removeIndex";
-    }, {
-        name: string;
-        type: "removeIndex";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"modifyIndex">;
-        name: z.ZodString;
-        changes: z.ZodObject<{
-            fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            type: z.ZodOptional<z.ZodEnum<["normal", "unique", "btree", "hash", "spatial", "fulltext", "gi", "expression", "composite"]>>;
-            unique: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
-            partial: z.ZodOptional<z.ZodOptional<z.ZodType<any, z.ZodTypeDef, any>>>;
-            description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            order: z.ZodOptional<z.ZodOptional<z.ZodEnum<["asc", "desc"]>>>;
-            name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }, {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }, {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"addConstraint">;
-        constraint: z.ZodUnion<[z.ZodObject<{
-            type: z.ZodOptional<z.ZodString>;
-            name: z.ZodString;
-            predicate: z.ZodOptional<z.ZodString>;
-            parameters: z.ZodOptional<z.ZodType<(params: any) => boolean, z.ZodTypeDef, (params: any) => boolean>>;
-            description: z.ZodOptional<z.ZodString>;
-            field: z.ZodOptional<z.ZodString>;
-            errorMessage: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }, {
-            name: string;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }>, any]>;
-    }, "strip", z.ZodTypeAny, {
-        type: "addConstraint";
-        constraint?: any;
-    }, {
-        type: "addConstraint";
-        constraint?: any;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"removeConstraint">;
-        name: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "removeConstraint";
-    }, {
-        name: string;
-        type: "removeConstraint";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"modifyConstraint">;
-        name: z.ZodString;
-        changes: z.ZodObject<{
-            type: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            name: z.ZodOptional<z.ZodString>;
-            predicate: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            parameters: z.ZodOptional<z.ZodOptional<z.ZodType<(params: any) => boolean, z.ZodTypeDef, (params: any) => boolean>>>;
-            description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            field: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            errorMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }, {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    }, {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"deprecateField">;
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: "deprecateField";
-        id: string;
-    }, {
-        type: "deprecateField";
-        id: string;
-    }>]>, "many">>;
-    transform: z.ZodUnknown;
-    createdAt: z.ZodString;
-    checksum: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    description: string;
-    changes: ({
-        type: "addField";
-        id: string;
-        definition?: any;
-    } | {
-        type: "removeField";
-        id: string;
-    } | {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    } | {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        name: string;
-        type: "removeIndex";
-    } | {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        type: "addConstraint";
-        constraint?: any;
-    } | {
-        name: string;
-        type: "removeConstraint";
-    } | {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    } | {
-        type: "deprecateField";
-        id: string;
-    })[];
-    status: "pending" | "applied" | "failed";
-    id: string;
-    schemaVersion: string;
-    createdAt: string;
-    rollback?: ({
-        type: "addField";
-        id: string;
-        definition?: any;
-    } | {
-        type: "removeField";
-        id: string;
-    } | {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    } | {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        name: string;
-        type: "removeIndex";
-    } | {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        type: "addConstraint";
-        constraint?: any;
-    } | {
-        name: string;
-        type: "removeConstraint";
-    } | {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    } | {
-        type: "deprecateField";
-        id: string;
-    })[] | undefined;
-    transform?: unknown;
-    checksum?: string | undefined;
-}, {
-    description: string;
-    changes: ({
-        type: "addField";
-        id: string;
-        definition?: any;
-    } | {
-        type: "removeField";
-        id: string;
-    } | {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    } | {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        name: string;
-        type: "removeIndex";
-    } | {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        type: "addConstraint";
-        constraint?: any;
-    } | {
-        name: string;
-        type: "removeConstraint";
-    } | {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    } | {
-        type: "deprecateField";
-        id: string;
-    })[];
-    status: "pending" | "applied" | "failed";
-    id: string;
-    schemaVersion: string;
-    createdAt: string;
-    rollback?: ({
-        type: "addField";
-        id: string;
-        definition?: any;
-    } | {
-        type: "removeField";
-        id: string;
-    } | {
-        type: "modifyField";
-        id: string;
-        changes?: any;
-    } | {
-        type: "addIndex";
-        definition: {
-            fields: string[];
-            type: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite";
-            unique?: boolean | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        name: string;
-        type: "removeIndex";
-    } | {
-        name: string;
-        type: "modifyIndex";
-        changes: {
-            unique?: boolean | undefined;
-            fields?: string[] | undefined;
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: "normal" | "unique" | "btree" | "hash" | "spatial" | "fulltext" | "gi" | "expression" | "composite" | undefined;
-            partial?: any;
-            order?: "asc" | "desc" | undefined;
-        };
-    } | {
-        type: "addConstraint";
-        constraint?: any;
-    } | {
-        name: string;
-        type: "removeConstraint";
-    } | {
-        name: string;
-        type: "modifyConstraint";
-        changes: {
-            name?: string | undefined;
-            description?: string | undefined;
-            type?: string | undefined;
-            predicate?: string | undefined;
-            field?: string | undefined;
-            parameters?: ((params: any) => boolean) | undefined;
-            errorMessage?: string | undefined;
-        };
-    } | {
-        type: "deprecateField";
-        id: string;
-    })[] | undefined;
-    transform?: unknown;
-    checksum?: string | undefined;
-}>;
 declare function validateMigration<T>(change: any): change is Migration<T>;
 declare function validateSchemaChange<T>(change: any): change is SchemaChange<T>;
 declare function validateSchemaDefinition(schema: any): schema is SchemaDefinition;
@@ -1845,28 +1440,26 @@ declare function deepMerge<T extends object>(target: T, update: Partial<T>): T;
 /**
  * Converts a SchemaDefinition to TypeScript type definitions
  *
- * This function analyzes a schema definition and generates appropriate TypeScript
- * type declarations. It handles nested objects, arrays, references, and all primitive types
- * defined in the schema system.
+ * Analyzes a schema definition and generates TypeScript type declarations for the main schema,
+ * nested schemas, and union types for enum-like constraints. Uses capitalized field.name for field names,
+ * capitalized nestedSchema.name for type names, and ignores UUID keys. Handles required/optional fields,
+ * union types, primitives, arrays, sets, references, and nested structures with strict type safety.
  *
- * @param {SchemaDefinition} schema - The schema definition to convert to TypeScript types
- * @param {boolean} [includeComments=true] - Whether to include JSDoc comments from schema descriptions
- * @param {boolean} [exportTypes=true] - Whether to export the generated types
- * @returns {string} TypeScript type definitions as a string
+ * @param schema - The schema definition to convert
+ * @param includeComments - Whether to include JSDoc comments (default: true)
+ * @param exportTypes - Whether to export the generated types (default: true)
+ * @returns TypeScript type definitions as a string
  */
 declare function schemaToTypes(schema: SchemaDefinition, includeComments?: boolean, exportTypes?: boolean): string;
 /**
  * Generates a TypeScript interface for validating schema data
- *
- * This function creates a validation interface with methods that
- * correspond to the schema constraints.
- *
- * @param {SchemaDefinition} schema - The schema definition
- * @param {boolean} [exportType=true] - Whether to export the generated interface
- * @returns {string} TypeScript interface definition for validation
  */
 declare function generateValidationInterface(schema: SchemaDefinition, exportType?: boolean): string;
 
+/**
+ * Serializes constraint parameters for error messages, handling special types like RegExp.
+ */
+declare function serializeParams(params: any): string;
 /**
  * Creates a Standard Schema validator that conforms to the StandardSchemaV1 interface.
  * The validator uses a closure pattern to maintain internal state and avoid prop drilling.
@@ -1914,4 +1507,4 @@ declare function docgen(schema: SchemaDefinition, options?: {
     faker?: Faker;
 }): string;
 
-export { type Constraint, type ConstraintGroup, type ConstraintParameters, type ConstraintsMap, type DataTransform, type FieldDefinition, type FieldType, type FunctionMap, type IndexDefinition, type IndexType, JsonPatchError, type LogicalOperator, type Migration, MigrationEngine, type MigrationEngineInterface, MigrationError, MigrationErrorCode, type MigrationMetadata, MigrationSchema, type PartialIndexCondition, type PatchOperation, type Persistence, type PersistenceCollection, type PersistenceEvent, type PersistenceEventType, type PersistenceTransaction, type Predicate, type PredicateMap, type PredicateName, type PredicateParameters, type RegistryLock, type RegistryMetadata, type Schema, type SchemaChange, type SchemaConstraint, type SchemaDefinition, type SchemaEvent, type SchemaEventType, type SchemaIndex, type SchemaMetadata, type SchemaMigrationHelper, type SchemaRegistry, type SchemaVersion, type TransformFunction, applyPatch, calculateNextVersion, compareSemanticVersions, createPatch, createRegistry, createSchemaMigrationHelper, createStandardSchemaValidator, deepMerge, docgen, generateSHA256Hash, generateValidationInterface, normalizePath, schemaChangeToPatch, schemaToTypes, sortSemanticVars, validate, validateMigration, validateSchemaChange, validateSchemaDefinition };
+export { type Constraint, type ConstraintGroup, type ConstraintParameters, type ConstraintsMap, type DataTransform, type FieldDefinition, type FieldType, type FunctionMap, type IndexDefinition, type IndexType, JsonPatchError, type LogicalOperator, type Migration, MigrationEngine, type MigrationEngineInterface, MigrationError, MigrationErrorCode, type MigrationMetadata, type NestedSchemaDefinition, type PartialIndexCondition, type PatchOperation, type Persistence, type PersistenceCollection, type PersistenceEvent, type PersistenceEventType, type PersistenceTransaction, type Predicate, type PredicateMap, type PredicateName, type PredicateParameters, type RegistryLock, type RegistryMetadata, type RemoteRepository, type Schema, type SchemaChange, type SchemaConstraint, type SchemaDefinition, type SchemaEvent, type SchemaEventType, type SchemaIndex, type SchemaMetadata, type SchemaMigrationHelper, SchemaRegistry, type SchemaRegistryInterface, type SchemaVersion, type TransformFunction, applyPatch, calculateNextVersion, compareSemanticVersions, createGitSchemaRegistry, createPatch, createSchemaMigrationHelper, createStandardSchemaValidator, deepMerge, docgen, generateSHA256Hash, generateValidationInterface, normalizePath, schemaChangeToPatch, schemaToTypes, serializeParams, sortSemanticVars, validate, validateMigration, validateSchemaChange, validateSchemaDefinition };