@warlock.js/cascade 5.22.0 → 5.23.0

package/esm/utils/connect-to-database.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connect-to-database.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/connect-to-database.ts"],"sourcesContent":["import { type DriverContract, type TransactionContext } from \"../contracts\";\nimport { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\nimport { MongoDbDriver } from \"../drivers/mongodb/mongodb-driver\";\nimport { PostgresDriver } from \"../drivers/postgres\";\nimport type { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from \"../types\";\n\n/**\n * Supported database driver types.\n */\nexport type DatabaseDriver = \"mongodb\" | \"postgres\" | \"mysql\";\n\n/**\n * Default model configuration options.\n *\n * These settings will be applied to all models using this data source,\n * unless overridden by individual model static properties.\n *\n * This is a re-export of Partial<ModelDefaults> for backward compatibility\n * and to provide clearer naming in the connection config context.\n *\n * The full hierarchy is:\n * 1. Model static property (highest priority)\n * 2. Database config modelDefaults (this type)\n * 3. Driver defaults (e.g., snake_case for PostgreSQL, camelCase for MongoDB)\n * 4. Framework defaults (fallback values)\n *\n * @see ModelDefaults for complete type definition and documentation\n */\nexport type ModelDefaultConfig = Partial<ModelDefaults>;\n\n/**\n * Connection options for establishing a database connection.\n *\n * Generic type that separates concerns:\n * - Shared config (driver, name, database, connection details)\n * - Driver options (cascade-next driver-specific settings)\n * - Client options (native database client settings)\n * - Model options (default model behaviors)\n *\n * @template TDriverOptions - Driver-specific options (e.g., MongoDriverOptions)\n * @template TClientOptions - Native client options (e.g., MongoClientOptions from mongodb package)\n *\n * @example\n * ```typescript\n * // MongoDB\n * import type { MongoClientOptions } from \"mongodb\";\n * import type { MongoDriverOptions } from \"@warlock.js/cascade\";\n *\n * const config: ConnectionOptions<MongoDriverOptions, MongoClientOptions> = {\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *     counterCollection: \"counters\",\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * };\n * ```\n */\nexport type ConnectionOptions<TDriverOptions = any, TClientOptions = any> = {\n  // ============================================================================\n  // SHARED CONFIGURATION (Framework-level)\n  // ============================================================================\n\n  /**\n   * Database driver to use.\n   * @default \"mongodb\"\n   */\n  driver?: DatabaseDriver;\n\n  /**\n   * Unique name for this data source.\n   * Used for registration in DataSourceRegistry.\n   * @default \"default\"\n   */\n  name?: string;\n\n  /**\n   * Whether this should be the default data source.\n   * @default true\n   */\n  isDefault?: boolean;\n\n  /**\n   * Database name (required).\n   */\n  database: string;\n\n  /**\n   * Enable database operation logging (queries, execution time, parameters).\n   * Highly recommended to keep this disabled in production to prevent sensitive data leakage.\n   *\n   * @default false\n   */\n  logging?: boolean;\n\n  // ============================================================================\n  // CONNECTION DETAILS (Shared across drivers)\n  // ============================================================================\n\n  /**\n   * Database connection URI.\n   * Alternative to specifying host/port separately.\n   *\n   * @example \"mongodb://localhost:27017/mydb\"\n   * @example \"postgresql://user:pass@localhost:5432/mydb\"\n   */\n  uri?: string;\n\n  /**\n   * Database host.\n   * @default \"localhost\"\n   */\n  host?: string;\n\n  /**\n   * Database port.\n   * @default 27017 (MongoDB), 5432 (PostgreSQL)\n   */\n  port?: number;\n\n  /**\n   * Database username for authentication.\n   */\n  username?: string;\n\n  /**\n   * Database password for authentication.\n   */\n  password?: string;\n\n  /**\n   * Authentication source database.\n   * Typically \"admin\" for MongoDB.\n   */\n  authSource?: string;\n\n  // ============================================================================\n  // DRIVER OPTIONS (Package-level, driver-specific)\n  // ============================================================================\n\n  /**\n   * Driver-specific options.\n   *\n   * For MongoDB: { autoGenerateId, counterCollection, transactionOptions }\n   * For PostgreSQL: { schema, ... }\n   */\n  driverOptions?: TDriverOptions;\n\n  // ============================================================================\n  // CLIENT OPTIONS (Native database client library)\n  // ============================================================================\n\n  /**\n   * Native database client options.\n   *\n   * For MongoDB: MongoClientOptions from 'mongodb' package\n   * For PostgreSQL: PoolConfig from 'pg' package\n   */\n  clientOptions?: TClientOptions;\n\n  // ============================================================================\n  // MODEL OPTIONS (Model defaults)\n  // ============================================================================\n\n  /**\n   * Default model configuration for all models using this data source.\n   *\n   * These settings override driver defaults but are overridden by\n   * individual model static properties.\n   *\n   * **Configuration Hierarchy (highest to lowest):**\n   * 1. Model static property - `User.createdAtColumn = \"creation_date\"`\n   * 2. **modelOptions (this)** - Database-wide overrides\n   * 3. Driver defaults - PostgreSQL: snake_case, MongoDB: camelCase\n   * 4. Framework defaults - Fallback values\n   *\n   * @example\n   * ```typescript\n   * // PostgreSQL database with custom settings\n   * {\n   *   driver: \"postgres\",\n   *   modelOptions: {\n   *     // Override PostgreSQL default (snake_case) to use camelCase\n   *     namingConvention: \"camelCase\",\n   *     createdAtColumn: \"createdAt\",\n   *     updatedAtColumn: \"updatedAt\",\n   *\n   *     // ID generation settings (for MongoDB)\n   *     randomIncrement: true,\n   *     initialId: 1000,\n   *\n   *     // Deletion settings\n   *     deleteStrategy: \"soft\",\n   *     trashTable: \"archive\", // All models use same trash table\n   *   }\n   * }\n   *\n   * // MongoDB database with defaults\n   * {\n   *   driver: \"mongodb\",\n   *   modelOptions: {\n   *     // MongoDB already uses camelCase by default\n   *     randomIncrement: true,\n   *     initialId: 10000,\n   *     deleteStrategy: \"trash\", // Use RecycleBin\n   *   }\n   * }\n   * ```\n   */\n  modelOptions?: ModelDefaultConfig;\n\n  /**\n   * Migration-level defaults (UUID strategy, etc.).\n   *\n   * These defaults override driver migration defaults but can be\n   * overridden by individual migration calls.\n   *\n   * @default undefined (uses driver defaults)\n   *\n   * @example\n   * ```typescript\n   * migrationDefaults: {\n   *   uuidStrategy: \"v7\", // Use UUID v7 for all migrations\n   * }\n   * ```\n   */\n  migrationOptions?: MigrationDefaults;\n\n  /**\n   * Defaults for relation conventions — foreign-key suffix and pivot-table\n   * naming order. Controls how `@BelongsTo` / `@HasOne` / `@HasMany` /\n   * `@BelongsToMany` infer column / table names when none are explicitly\n   * configured on the decorator.\n   *\n   * @default undefined (uses framework defaults: `\"_id\"` suffix + alphabetical pivot)\n   *\n   * @example\n   * ```typescript\n   * relationOptions: {\n   *   foreignKeySuffix: \"_id\",\n   *   pivotTableNamingOrder: \"alphabetical\",\n   * }\n   * ```\n   */\n  relationOptions?: RelationDefaults;\n\n  // ============================================================================\n  // DATA SOURCE DEFAULTS\n  // ============================================================================\n\n  /**\n   * Default delete strategy for models using this data source.\n   *\n   * - MongoDB: Typically `\"trash\"` (uses RecycleBin collection)\n   * - PostgreSQL: Typically `\"permanent\"` or `\"soft\"`\n   *\n   * Can be overridden by model static property or destroy() options.\n   *\n   * @default undefined (falls back to \"permanent\")\n   */\n  defaultDeleteStrategy?: DeleteStrategy;\n\n  /**\n   * Default trash table/collection name for \"trash\" delete strategy.\n   *\n   * - MongoDB: Typically `\"RecycleBin\"`\n   * - If not set, defaults to `{table}Trash` pattern\n   *\n   * Can be overridden by Model.trashTable static property.\n   *\n   * @default undefined (uses {table}Trash pattern)\n   */\n  defaultTrashTable?: string;\n\n  // ============================================================================\n  // MIGRATION OPTIONS\n  // ============================================================================\n\n  /**\n   * Migration configuration options.\n   */\n  migrations?: {\n    /**\n     * Whether to wrap migrations in database transactions.\n     *\n     * Overrides driver defaults:\n     * - PostgreSQL default: `true` (DDL is transactional)\n     * - MongoDB default: `false` (DDL cannot be transactional)\n     *\n     * Individual migrations can override this with their own `transactional` property.\n     *\n     * @default undefined (uses driver default)\n     */\n    transactional?: boolean;\n\n    /**\n     * Name of the migrations tracking table/collection.\n     *\n     * @default \"_migrations\"\n     */\n    table?: string;\n  };\n};\n\n/**\n * Connect to a database and register the data source.\n *\n * This is a high-level utility function that simplifies database connection\n * for small to medium projects. It handles driver instantiation, connection,\n * data source creation, and automatic registration.\n *\n * **Supported Drivers:**\n * - `mongodb` (default) - MongoDB driver with optional auto ID generation\n * - `postgres` - PostgreSQL driver (not yet implemented)\n * - `mysql` - MySQL driver (not yet implemented)\n *\n * **Features:**\n * - Automatic driver instantiation based on driver name\n * - Connection establishment and error handling\n * - DataSource creation and registration\n * - Support for MongoDB-specific features (ID generation, transactions)\n *\n * @param options - Connection configuration options\n * @returns A connected and registered DataSource instance\n * @throws {Error} If connection fails or driver is not implemented\n *\n * @example\n * ```typescript\n * // MongoDB with new structure\n * const dataSource = await connectToDatabase({\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * });\n * ```\n */\nexport async function connectToDatabase<TDriverOptions = any, TClientOptions = any>(\n  options: ConnectionOptions<TDriverOptions, TClientOptions>,\n): Promise<DataSource> {\n  // Default values\n  const driverType = options.driver ?? \"mongodb\";\n  const dataSourceName = options.name ?? \"default\";\n  const isDefault = options.isDefault ?? !dataSourceRegistry.hasDefault();\n\n  // Create driver based on type\n  let driver: DriverContract;\n\n  switch (driverType) {\n    case \"mongodb\": {\n      driver = new MongoDbDriver(\n        {\n          database: options.database,\n          uri: options.uri,\n          host: options.host,\n          port: options.port,\n          username: options.username,\n          password: options.password,\n          authSource: options.authSource,\n          logging: options.logging,\n          clientOptions: options.clientOptions as any,\n        },\n        options.driverOptions as any,\n      );\n      break;\n    }\n\n    case \"postgres\": {\n      driver = new PostgresDriver({\n        database: options.database,\n        connectionString: options.uri,\n        host: options.host,\n        port: options.port ?? 5432,\n        user: options.username,\n        password: options.password,\n        logging: options.logging,\n        // Spread any additional client options (pool settings, SSL, etc.)\n        ...(options.clientOptions as object),\n      });\n      break;\n    }\n\n    case \"mysql\":\n      throw new Error(\"MySQL driver is not yet implemented. Coming soon!\");\n\n    default:\n      throw new Error(\n        `Unknown driver: \"${driverType}\". Supported drivers: mongodb, postgres, mysql`,\n      );\n  }\n\n  // Create data source\n  const dataSource = new DataSource({\n    name: dataSourceName,\n    driver,\n    isDefault,\n    defaultDeleteStrategy: options.defaultDeleteStrategy,\n    defaultTrashTable: options.defaultTrashTable,\n    modelDefaults: options.modelOptions,\n    migrationDefaults: options.migrationOptions,\n    relationDefaults: options.relationOptions,\n    migrations: options.migrations,\n  });\n\n  // Register data source\n  const registeredSource = dataSourceRegistry.register(dataSource, {\n    explicitDefault: options.isDefault === true,\n  });\n\n  // Connect to the database\n  try {\n    await driver.connect();\n  } catch (error) {\n    // Do not leave a dead source registered as the default\n    dataSourceRegistry.unregister(registeredSource);\n\n    throw new Error(\n      `Failed to connect to ${driverType} database: ${error instanceof Error ? error.message : String(error)}`,\n      { cause: error },\n    );\n  }\n\n  return dataSource;\n}\n\n/**\n * Get current driver instance.\n *\n * @example\n * ```typescript\n * const driver = getDatabaseDriver();\n *\n * // Pass type to return Postgres driver type\n * const pgDriver = getDatabaseDriver<PostgresDriver>();\n * ```\n */\nexport function getDatabaseDriver<T extends DriverContract = any>(): T {\n  const driver = dataSourceRegistry.get().driver;\n\n  return driver as unknown as T;\n}\n\n/**\n * Perform database transaction(s)\n * Shorthand to `dataSourceRegister.get().driver.transaction\n */\nexport async function transaction<T = any>(\n  fn: (ctx: TransactionContext) => Promise<T>,\n  options?: Record<string, unknown>,\n): Promise<T> {\n  return getDatabaseDriver().transaction(fn, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuWA,eAAsB,kBACpB,SACqB;CAErB,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,iBAAiB,QAAQ,QAAQ;CACvC,MAAM,YAAY,QAAQ,aAAa,CAAC,mBAAmB,WAAW;CAGtE,IAAI;CAEJ,QAAQ,YAAR;EACE,KAAK;GACH,SAAS,IAAI,cACX;IACE,UAAU,QAAQ;IAClB,KAAK,QAAQ;IACb,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,UAAU,QAAQ;IAClB,YAAY,QAAQ;IACpB,SAAS,QAAQ;IACjB,eAAe,QAAQ;GACzB,GACA,QAAQ,aACV;GACA;EAGF,KAAK;GACH,SAAS,IAAI,eAAe;IAC1B,UAAU,QAAQ;IAClB,kBAAkB,QAAQ;IAC1B,MAAM,QAAQ;IACd,MAAM,QAAQ,QAAQ;IACtB,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,SAAS,QAAQ;IAEjB,GAAI,QAAQ;GACd,CAAC;GACD;EAGF,KAAK,SACH,MAAM,IAAI,MAAM,mDAAmD;EAErE,SACE,MAAM,IAAI,MACR,oBAAoB,WAAW,+CACjC;CACJ;CAGA,MAAM,aAAa,IAAI,WAAW;EAChC,MAAM;EACN;EACA;EACA,uBAAuB,QAAQ;EAC/B,mBAAmB,QAAQ;EAC3B,eAAe,QAAQ;EACvB,mBAAmB,QAAQ;EAC3B,kBAAkB,QAAQ;EAC1B,YAAY,QAAQ;CACtB,CAAC;CAGD,MAAM,mBAAmB,mBAAmB,SAAS,YAAY,EAC/D,iBAAiB,QAAQ,cAAc,KACzC,CAAC;CAGD,IAAI;EACF,MAAM,OAAO,QAAQ;CACvB,SAAS,OAAO;EAEd,mBAAmB,WAAW,gBAAgB;EAE9C,MAAM,IAAI,MACR,wBAAwB,WAAW,aAAa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KACrG,EAAE,OAAO,MAAM,CACjB;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,oBAAuD;CAGrE,OAFe,mBAAmB,IAAI,CAAC,CAAC;AAG1C;;;;;AAMA,eAAsB,YACpB,IACA,SACY;CACZ,OAAO,kBAAkB,CAAC,CAAC,YAAY,IAAI,OAAO;AACpD"}
+{"version":3,"file":"connect-to-database.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/connect-to-database.ts"],"sourcesContent":["import { type DriverContract, type TransactionContext } from \"../contracts\";\nimport { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\nimport { MongoDbDriver } from \"../drivers/mongodb/mongodb-driver\";\nimport { PostgresDriver, type PostgresPoolConfig } from \"../drivers/postgres\";\nimport type { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from \"../types\";\n\n/**\n * Supported database driver types.\n */\nexport type DatabaseDriver = \"mongodb\" | \"postgres\" | \"mysql\";\n\n/**\n * Default model configuration options.\n *\n * These settings will be applied to all models using this data source,\n * unless overridden by individual model static properties.\n *\n * This is a re-export of Partial<ModelDefaults> for backward compatibility\n * and to provide clearer naming in the connection config context.\n *\n * The full hierarchy is:\n * 1. Model static property (highest priority)\n * 2. Database config modelDefaults (this type)\n * 3. Driver defaults (e.g., snake_case for PostgreSQL, camelCase for MongoDB)\n * 4. Framework defaults (fallback values)\n *\n * @see ModelDefaults for complete type definition and documentation\n */\nexport type ModelDefaultConfig = Partial<ModelDefaults>;\n\n/**\n * Connection options for establishing a database connection.\n *\n * Generic type that separates concerns:\n * - Shared config (driver, name, database, connection details)\n * - Driver options (cascade-next driver-specific settings)\n * - Client options (native database client settings)\n * - Model options (default model behaviors)\n *\n * @template TDriverOptions - Driver-specific options (e.g., MongoDriverOptions)\n * @template TClientOptions - Native client options (e.g., MongoClientOptions from mongodb package)\n *\n * @example\n * ```typescript\n * // MongoDB\n * import type { MongoClientOptions } from \"mongodb\";\n * import type { MongoDriverOptions } from \"@warlock.js/cascade\";\n *\n * const config: ConnectionOptions<MongoDriverOptions, MongoClientOptions> = {\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *     counterCollection: \"counters\",\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * };\n * ```\n */\nexport type ConnectionOptions<TDriverOptions = any, TClientOptions = any> = {\n  // ============================================================================\n  // SHARED CONFIGURATION (Framework-level)\n  // ============================================================================\n\n  /**\n   * Database driver to use.\n   * @default \"mongodb\"\n   */\n  driver?: DatabaseDriver;\n\n  /**\n   * Unique name for this data source.\n   * Used for registration in DataSourceRegistry.\n   * @default \"default\"\n   */\n  name?: string;\n\n  /**\n   * Whether this should be the default data source.\n   * @default true\n   */\n  isDefault?: boolean;\n\n  /**\n   * Database name (required).\n   */\n  database: string;\n\n  /**\n   * Enable database operation logging (queries, execution time, parameters).\n   * Highly recommended to keep this disabled in production to prevent sensitive data leakage.\n   *\n   * @default false\n   */\n  logging?: boolean;\n\n  // ============================================================================\n  // CONNECTION DETAILS (Shared across drivers)\n  // ============================================================================\n\n  /**\n   * Database connection URI.\n   * Alternative to specifying host/port separately.\n   *\n   * @example \"mongodb://localhost:27017/mydb\"\n   * @example \"postgresql://user:pass@localhost:5432/mydb\"\n   */\n  uri?: string;\n\n  /**\n   * Database host.\n   * @default \"localhost\"\n   */\n  host?: string;\n\n  /**\n   * Database port.\n   * @default 27017 (MongoDB), 5432 (PostgreSQL)\n   */\n  port?: number;\n\n  /**\n   * Database username for authentication.\n   */\n  username?: string;\n\n  /**\n   * Database password for authentication.\n   */\n  password?: string;\n\n  /**\n   * Authentication source database.\n   * Typically \"admin\" for MongoDB.\n   */\n  authSource?: string;\n\n  // ============================================================================\n  // DRIVER OPTIONS (Package-level, driver-specific)\n  // ============================================================================\n\n  /**\n   * Driver-specific options.\n   *\n   * For MongoDB: { autoGenerateId, counterCollection, transactionOptions }\n   * For PostgreSQL: { schema, ... }\n   */\n  driverOptions?: TDriverOptions;\n\n  // ============================================================================\n  // CLIENT OPTIONS (Native database client library)\n  // ============================================================================\n\n  /**\n   * Native database client options.\n   *\n   * For MongoDB: MongoClientOptions from 'mongodb' package\n   * For PostgreSQL: PoolConfig from 'pg' package\n   */\n  clientOptions?: TClientOptions;\n\n  // ============================================================================\n  // MODEL OPTIONS (Model defaults)\n  // ============================================================================\n\n  /**\n   * Default model configuration for all models using this data source.\n   *\n   * These settings override driver defaults but are overridden by\n   * individual model static properties.\n   *\n   * **Configuration Hierarchy (highest to lowest):**\n   * 1. Model static property - `User.createdAtColumn = \"creation_date\"`\n   * 2. **modelOptions (this)** - Database-wide overrides\n   * 3. Driver defaults - PostgreSQL: snake_case, MongoDB: camelCase\n   * 4. Framework defaults - Fallback values\n   *\n   * @example\n   * ```typescript\n   * // PostgreSQL database with custom settings\n   * {\n   *   driver: \"postgres\",\n   *   modelOptions: {\n   *     // Override PostgreSQL default (snake_case) to use camelCase\n   *     namingConvention: \"camelCase\",\n   *     createdAtColumn: \"createdAt\",\n   *     updatedAtColumn: \"updatedAt\",\n   *\n   *     // ID generation settings (for MongoDB)\n   *     randomIncrement: true,\n   *     initialId: 1000,\n   *\n   *     // Deletion settings\n   *     deleteStrategy: \"soft\",\n   *     trashTable: \"archive\", // All models use same trash table\n   *   }\n   * }\n   *\n   * // MongoDB database with defaults\n   * {\n   *   driver: \"mongodb\",\n   *   modelOptions: {\n   *     // MongoDB already uses camelCase by default\n   *     randomIncrement: true,\n   *     initialId: 10000,\n   *     deleteStrategy: \"trash\", // Use RecycleBin\n   *   }\n   * }\n   * ```\n   */\n  modelOptions?: ModelDefaultConfig;\n\n  /**\n   * Migration-level defaults (UUID strategy, etc.).\n   *\n   * These defaults override driver migration defaults but can be\n   * overridden by individual migration calls.\n   *\n   * @default undefined (uses driver defaults)\n   *\n   * @example\n   * ```typescript\n   * migrationDefaults: {\n   *   uuidStrategy: \"v7\", // Use UUID v7 for all migrations\n   * }\n   * ```\n   */\n  migrationOptions?: MigrationDefaults;\n\n  /**\n   * Defaults for relation conventions — foreign-key suffix and pivot-table\n   * naming order. Controls how `@BelongsTo` / `@HasOne` / `@HasMany` /\n   * `@BelongsToMany` infer column / table names when none are explicitly\n   * configured on the decorator.\n   *\n   * @default undefined (uses framework defaults: `\"_id\"` suffix + alphabetical pivot)\n   *\n   * @example\n   * ```typescript\n   * relationOptions: {\n   *   foreignKeySuffix: \"_id\",\n   *   pivotTableNamingOrder: \"alphabetical\",\n   * }\n   * ```\n   */\n  relationOptions?: RelationDefaults;\n\n  // ============================================================================\n  // DATA SOURCE DEFAULTS\n  // ============================================================================\n\n  /**\n   * Default delete strategy for models using this data source.\n   *\n   * - MongoDB: Typically `\"trash\"` (uses RecycleBin collection)\n   * - PostgreSQL: Typically `\"permanent\"` or `\"soft\"`\n   *\n   * Can be overridden by model static property or destroy() options.\n   *\n   * @default undefined (falls back to \"permanent\")\n   */\n  defaultDeleteStrategy?: DeleteStrategy;\n\n  /**\n   * Default trash table/collection name for \"trash\" delete strategy.\n   *\n   * - MongoDB: Typically `\"RecycleBin\"`\n   * - If not set, defaults to `{table}Trash` pattern\n   *\n   * Can be overridden by Model.trashTable static property.\n   *\n   * @default undefined (uses {table}Trash pattern)\n   */\n  defaultTrashTable?: string;\n\n  // ============================================================================\n  // MIGRATION OPTIONS\n  // ============================================================================\n\n  /**\n   * Migration configuration options.\n   */\n  migrations?: {\n    /**\n     * Whether to wrap migrations in database transactions.\n     *\n     * Overrides driver defaults:\n     * - PostgreSQL default: `true` (DDL is transactional)\n     * - MongoDB default: `false` (DDL cannot be transactional)\n     *\n     * Individual migrations can override this with their own `transactional` property.\n     *\n     * @default undefined (uses driver default)\n     */\n    transactional?: boolean;\n\n    /**\n     * Name of the migrations tracking table/collection.\n     *\n     * @default \"_migrations\"\n     */\n    table?: string;\n  };\n};\n\n/**\n * Connect to a database and register the data source.\n *\n * This is a high-level utility function that simplifies database connection\n * for small to medium projects. It handles driver instantiation, connection,\n * data source creation, and automatic registration.\n *\n * **Supported Drivers:**\n * - `mongodb` (default) - MongoDB driver with optional auto ID generation\n * - `postgres` - PostgreSQL driver (not yet implemented)\n * - `mysql` - MySQL driver (not yet implemented)\n *\n * **Features:**\n * - Automatic driver instantiation based on driver name\n * - Connection establishment and error handling\n * - DataSource creation and registration\n * - Support for MongoDB-specific features (ID generation, transactions)\n *\n * @param options - Connection configuration options\n * @returns A connected and registered DataSource instance\n * @throws {Error} If connection fails or driver is not implemented\n *\n * @example\n * ```typescript\n * // MongoDB with new structure\n * const dataSource = await connectToDatabase({\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * });\n * ```\n */\nexport async function connectToDatabase<TDriverOptions = any, TClientOptions = any>(\n  options: ConnectionOptions<TDriverOptions, TClientOptions>,\n): Promise<DataSource> {\n  // Default values\n  const driverType = options.driver ?? \"mongodb\";\n  const dataSourceName = options.name ?? \"default\";\n  const isDefault = options.isDefault ?? !dataSourceRegistry.hasDefault();\n\n  // Create driver based on type\n  let driver: DriverContract;\n\n  switch (driverType) {\n    case \"mongodb\": {\n      driver = new MongoDbDriver(\n        {\n          database: options.database,\n          uri: options.uri,\n          host: options.host,\n          port: options.port,\n          username: options.username,\n          password: options.password,\n          authSource: options.authSource,\n          logging: options.logging,\n          clientOptions: options.clientOptions as any,\n        },\n        options.driverOptions as any,\n      );\n      break;\n    }\n\n    case \"postgres\": {\n      driver = new PostgresDriver({\n        database: options.database,\n        connectionString: options.uri,\n        host: options.host,\n        port: options.port ?? 5432,\n        user: options.username,\n        password: options.password,\n        logging: options.logging,\n        // Cascade-side Postgres options (e.g. `naming: \"snake_case\"`).\n        ...pickPostgresDriverOptions(options.driverOptions),\n        // Spread any additional client options (pool settings, SSL, etc.)\n        ...(options.clientOptions as object),\n      });\n      break;\n    }\n\n    case \"mysql\":\n      throw new Error(\"MySQL driver is not yet implemented. Coming soon!\");\n\n    default:\n      throw new Error(\n        `Unknown driver: \"${driverType}\". Supported drivers: mongodb, postgres, mysql`,\n      );\n  }\n\n  // Create data source\n  const dataSource = new DataSource({\n    name: dataSourceName,\n    driver,\n    isDefault,\n    defaultDeleteStrategy: options.defaultDeleteStrategy,\n    defaultTrashTable: options.defaultTrashTable,\n    modelDefaults: options.modelOptions,\n    migrationDefaults: options.migrationOptions,\n    relationDefaults: options.relationOptions,\n    migrations: options.migrations,\n  });\n\n  // Register data source\n  const registeredSource = dataSourceRegistry.register(dataSource, {\n    explicitDefault: options.isDefault === true,\n  });\n\n  // Connect to the database\n  try {\n    await driver.connect();\n  } catch (error) {\n    // Do not leave a dead source registered as the default\n    dataSourceRegistry.unregister(registeredSource);\n\n    throw new Error(\n      `Failed to connect to ${driverType} database: ${error instanceof Error ? error.message : String(error)}`,\n      { cause: error },\n    );\n  }\n\n  return dataSource;\n}\n\n/**\n * Get current driver instance.\n *\n * @example\n * ```typescript\n * const driver = getDatabaseDriver();\n *\n * // Pass type to return Postgres driver type\n * const pgDriver = getDatabaseDriver<PostgresDriver>();\n * ```\n */\nexport function getDatabaseDriver<T extends DriverContract = any>(): T {\n  const driver = dataSourceRegistry.get().driver;\n\n  return driver as unknown as T;\n}\n\n/**\n * Perform database transaction(s)\n * Shorthand to `dataSourceRegister.get().driver.transaction\n */\nexport async function transaction<T = any>(\n  fn: (ctx: TransactionContext) => Promise<T>,\n  options?: Record<string, unknown>,\n): Promise<T> {\n  return getDatabaseDriver().transaction(fn, options);\n}\n\n/** The Cascade-side Postgres driver options `driverOptions` may carry. */\nfunction pickPostgresDriverOptions(driverOptions: unknown): Pick<PostgresPoolConfig, \"naming\"> {\n  const naming = (driverOptions as { naming?: PostgresPoolConfig[\"naming\"] } | undefined)?.naming;\n\n  return naming === undefined ? {} : { naming };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuWA,eAAsB,kBACpB,SACqB;CAErB,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,iBAAiB,QAAQ,QAAQ;CACvC,MAAM,YAAY,QAAQ,aAAa,CAAC,mBAAmB,WAAW;CAGtE,IAAI;CAEJ,QAAQ,YAAR;EACE,KAAK;GACH,SAAS,IAAI,cACX;IACE,UAAU,QAAQ;IAClB,KAAK,QAAQ;IACb,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,UAAU,QAAQ;IAClB,YAAY,QAAQ;IACpB,SAAS,QAAQ;IACjB,eAAe,QAAQ;GACzB,GACA,QAAQ,aACV;GACA;EAGF,KAAK;GACH,SAAS,IAAI,eAAe;IAC1B,UAAU,QAAQ;IAClB,kBAAkB,QAAQ;IAC1B,MAAM,QAAQ;IACd,MAAM,QAAQ,QAAQ;IACtB,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,SAAS,QAAQ;IAEjB,GAAG,0BAA0B,QAAQ,aAAa;IAElD,GAAI,QAAQ;GACd,CAAC;GACD;EAGF,KAAK,SACH,MAAM,IAAI,MAAM,mDAAmD;EAErE,SACE,MAAM,IAAI,MACR,oBAAoB,WAAW,+CACjC;CACJ;CAGA,MAAM,aAAa,IAAI,WAAW;EAChC,MAAM;EACN;EACA;EACA,uBAAuB,QAAQ;EAC/B,mBAAmB,QAAQ;EAC3B,eAAe,QAAQ;EACvB,mBAAmB,QAAQ;EAC3B,kBAAkB,QAAQ;EAC1B,YAAY,QAAQ;CACtB,CAAC;CAGD,MAAM,mBAAmB,mBAAmB,SAAS,YAAY,EAC/D,iBAAiB,QAAQ,cAAc,KACzC,CAAC;CAGD,IAAI;EACF,MAAM,OAAO,QAAQ;CACvB,SAAS,OAAO;EAEd,mBAAmB,WAAW,gBAAgB;EAE9C,MAAM,IAAI,MACR,wBAAwB,WAAW,aAAa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KACrG,EAAE,OAAO,MAAM,CACjB;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,oBAAuD;CAGrE,OAFe,mBAAmB,IAAI,CAAC,CAAC;AAG1C;;;;;AAMA,eAAsB,YACpB,IACA,SACY;CACZ,OAAO,kBAAkB,CAAC,CAAC,YAAY,IAAI,OAAO;AACpD;;AAGA,SAAS,0BAA0B,eAA4D;CAC7F,MAAM,SAAU,eAAyE;CAEzF,OAAO,WAAW,SAAY,CAAC,IAAI,EAAE,OAAO;AAC9C"}

package/esm/validation/plugins/database-rules-plugin.d.mts

@@ -14,12 +14,20 @@ declare module "@warlock.js/seal" {
     }): this;
   }
   interface StringValidator {
-    unique: ScalarValidator["unique"];
-    exists: ScalarValidator["exists"];
+    unique(model: ChildModel<Model> | string, optionsList?: Partial<UniqueRuleOptions> & {
+      errorMessage?: string;
+    }): this;
+    exists(model: ChildModel<Model> | string, optionsList?: Partial<ExistsRuleOptions> & {
+      errorMessage?: string;
+    }): this;
   }
   interface NumberValidator {
-    unique: ScalarValidator["unique"];
-    exists: ScalarValidator["exists"];
+    unique(model: ChildModel<Model> | string, optionsList?: Partial<UniqueRuleOptions> & {
+      errorMessage?: string;
+    }): this;
+    exists(model: ChildModel<Model> | string, optionsList?: Partial<ExistsRuleOptions> & {
+      errorMessage?: string;
+    }): this;
   }
 }
 /**

package/esm/validation/plugins/database-rules-plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-rules-plugin.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/database-rules-plugin.ts"],"mappings":";;;;;YAmBY,eAAA;IAYgB;IAVxB,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;IAmBI;IAdR,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAKI,eAAA;IACR,MAAA,EAAQ,eAAA;IACR,MAAA,EAAQ,eAAA;EAAA;EAAA,UAGA,eAAA;IACR,MAAA,EAAQ,eAAA;IACR,MAAA,EAAQ,eAAA;EAAA;AAAA"}
+{"version":3,"file":"database-rules-plugin.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/database-rules-plugin.ts"],"mappings":";;;;;YAmBY,eAAA;IAYgB;IAVxB,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;IAgBoB;IAXxB,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAKI,eAAA;IACR,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;IAGJ,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAKI,eAAA;IACR,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;IAGJ,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;EAAA;AAAA"}

package/esm/validation/plugins/database-rules-plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-rules-plugin.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/database-rules-plugin.ts"],"sourcesContent":["/**\n * Database Rules Plugin\n *\n * Injects the `.unique()` and `.exists()` method-chain entries onto Seal's\n * scalar validators. These are the Cascade-owned, DB-aware validation rules.\n *\n * Request-aware variants (`uniqueExceptCurrentUser`, etc.) live in\n * `@warlock.js/core` because they depend on the HTTP request store, which\n * Cascade has no business knowing about.\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { NumberValidator, ScalarValidator, StringValidator } from \"@warlock.js/seal\";\nimport type { ChildModel, Model } from \"../../model/model\";\nimport { existsRule } from \"../rules/exists-rule\";\nimport { uniqueRule } from \"../rules/unique-rule\";\nimport type { ExistsRuleOptions, UniqueRuleOptions } from \"../types\";\n\ndeclare module \"@warlock.js/seal\" {\n  interface ScalarValidator {\n    /** Value must be unique in database */\n    unique(\n      model: ChildModel<Model> | string,\n      optionsList?: Partial<UniqueRuleOptions> & {\n        errorMessage?: string;\n      },\n    ): this;\n\n    /** Value must exist in database */\n    exists(\n      model: ChildModel<Model> | string,\n      optionsList?: Partial<ExistsRuleOptions> & {\n        errorMessage?: string;\n      },\n    ): this;\n  }\n\n  interface StringValidator {\n    unique: ScalarValidator[\"unique\"];\n    exists: ScalarValidator[\"exists\"];\n  }\n\n  interface NumberValidator {\n    unique: ScalarValidator[\"unique\"];\n    exists: ScalarValidator[\"exists\"];\n  }\n}\n\n/**\n * Cascade's database-rules plugin for Seal.\n */\nexport const databaseRulesPlugin: SealPlugin = {\n  name: \"cascade-database-rules\",\n  version: \"1.0.0\",\n  description: \"Adds unique() and exists() database validation methods to Seal scalar validators\",\n\n  install() {\n    Object.assign(ScalarValidator.prototype, {\n      unique(\n        this: ScalarValidator,\n        model: ChildModel<Model> | string,\n        optionsList?: Partial<UniqueRuleOptions> & {\n          errorMessage?: string;\n        },\n      ) {\n        const { errorMessage, ...options } = optionsList || {};\n\n        return this.addRule(uniqueRule, errorMessage, {\n          Model: model,\n          ...options,\n        });\n      },\n\n      exists(\n        this: ScalarValidator,\n        model: ChildModel<Model> | string,\n        optionsList?: Partial<ExistsRuleOptions> & {\n          errorMessage?: string;\n        },\n      ) {\n        const { errorMessage, ...options } = optionsList || {};\n\n        return this.addRule(existsRule, errorMessage, {\n          Model: model,\n          ...options,\n        });\n      },\n    });\n\n    Object.assign(StringValidator.prototype, {\n      unique: ScalarValidator.prototype.unique,\n      exists: ScalarValidator.prototype.exists,\n    });\n\n    Object.assign(NumberValidator.prototype, {\n      unique: ScalarValidator.prototype.unique,\n      exists: ScalarValidator.prototype.exists,\n    });\n  },\n};\n"],"mappings":";;;;;;;;AAmDA,MAAa,sBAAkC;CAC7C,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EACR,OAAO,OAAO,gBAAgB,WAAW;GACvC,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;GAEA,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;EACF,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;CACH;AACF"}
+{"version":3,"file":"database-rules-plugin.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/database-rules-plugin.ts"],"sourcesContent":["/**\r\n * Database Rules Plugin\r\n *\r\n * Injects the `.unique()` and `.exists()` method-chain entries onto Seal's\r\n * scalar validators. These are the Cascade-owned, DB-aware validation rules.\r\n *\r\n * Request-aware variants (`uniqueExceptCurrentUser`, etc.) live in\r\n * `@warlock.js/core` because they depend on the HTTP request store, which\r\n * Cascade has no business knowing about.\r\n */\r\n\r\nimport type { SealPlugin } from \"@warlock.js/seal\";\r\nimport { NumberValidator, ScalarValidator, StringValidator } from \"@warlock.js/seal\";\r\nimport type { ChildModel, Model } from \"../../model/model\";\r\nimport { existsRule } from \"../rules/exists-rule\";\r\nimport { uniqueRule } from \"../rules/unique-rule\";\r\nimport type { ExistsRuleOptions, UniqueRuleOptions } from \"../types\";\r\n\r\ndeclare module \"@warlock.js/seal\" {\r\n  interface ScalarValidator {\r\n    /** Value must be unique in database */\r\n    unique(\r\n      model: ChildModel<Model> | string,\r\n      optionsList?: Partial<UniqueRuleOptions> & {\r\n        errorMessage?: string;\r\n      },\r\n    ): this;\r\n\r\n    /** Value must exist in database */\r\n    exists(\r\n      model: ChildModel<Model> | string,\r\n      optionsList?: Partial<ExistsRuleOptions> & {\r\n        errorMessage?: string;\r\n      },\r\n    ): this;\r\n  }\r\n\r\n  interface StringValidator {\r\n    unique(\r\n      model: ChildModel<Model> | string,\r\n      optionsList?: Partial<UniqueRuleOptions> & {\r\n        errorMessage?: string;\r\n      },\r\n    ): this;\r\n    exists(\r\n      model: ChildModel<Model> | string,\r\n      optionsList?: Partial<ExistsRuleOptions> & {\r\n        errorMessage?: string;\r\n      },\r\n    ): this;\r\n  }\r\n\r\n  interface NumberValidator {\r\n    unique(\r\n      model: ChildModel<Model> | string,\r\n      optionsList?: Partial<UniqueRuleOptions> & {\r\n        errorMessage?: string;\r\n      },\r\n    ): this;\r\n    exists(\r\n      model: ChildModel<Model> | string,\r\n      optionsList?: Partial<ExistsRuleOptions> & {\r\n        errorMessage?: string;\r\n      },\r\n    ): this;\r\n  }\r\n}\r\n\r\n/**\r\n * Cascade's database-rules plugin for Seal.\r\n */\r\nexport const databaseRulesPlugin: SealPlugin = {\r\n  name: \"cascade-database-rules\",\r\n  version: \"1.0.0\",\r\n  description: \"Adds unique() and exists() database validation methods to Seal scalar validators\",\r\n\r\n  install() {\r\n    Object.assign(ScalarValidator.prototype, {\r\n      unique(\r\n        this: ScalarValidator,\r\n        model: ChildModel<Model> | string,\r\n        optionsList?: Partial<UniqueRuleOptions> & {\r\n          errorMessage?: string;\r\n        },\r\n      ) {\r\n        const { errorMessage, ...options } = optionsList || {};\r\n\r\n        return this.addRule(uniqueRule, errorMessage, {\r\n          Model: model,\r\n          ...options,\r\n        });\r\n      },\r\n\r\n      exists(\r\n        this: ScalarValidator,\r\n        model: ChildModel<Model> | string,\r\n        optionsList?: Partial<ExistsRuleOptions> & {\r\n          errorMessage?: string;\r\n        },\r\n      ) {\r\n        const { errorMessage, ...options } = optionsList || {};\r\n\r\n        return this.addRule(existsRule, errorMessage, {\r\n          Model: model,\r\n          ...options,\r\n        });\r\n      },\r\n    });\r\n\r\n    Object.assign(StringValidator.prototype, {\r\n      unique: ScalarValidator.prototype.unique,\r\n      exists: ScalarValidator.prototype.exists,\r\n    });\r\n\r\n    Object.assign(NumberValidator.prototype, {\r\n      unique: ScalarValidator.prototype.unique,\r\n      exists: ScalarValidator.prototype.exists,\r\n    });\r\n  },\r\n};\r\n"],"mappings":";;;;;;;;AAuEA,MAAa,sBAAkC;CAC7C,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EACR,OAAO,OAAO,gBAAgB,WAAW;GACvC,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;GAEA,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;EACF,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;CACH;AACF"}

package/package.json

@@ -13,10 +13,10 @@
     "@mongez/events": "^2.2.8",
     "@mongez/reinforcements": "^4.0.2",
     "@mongez/supportive-is": "^2.1.5",
-    "@warlock.js/context": "5.22.0",
-    "@warlock.js/logger": "5.22.0",
-    "@warlock.js/scheduler": "5.22.0",
-    "@warlock.js/seal": "5.22.0",
+    "@warlock.js/context": "5.23.0",
+    "@warlock.js/logger": "5.23.0",
+    "@warlock.js/scheduler": "5.23.0",
+    "@warlock.js/seal": "5.23.0",
     "citty": "^0.2.2",
     "fast-glob": "^3.3.3"
   },
@@ -52,7 +52,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.22.0",
+  "version": "5.23.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",