@hedystia/db 2.0.4 → 2.0.6

package/dist/core/database.cjs

@@ -10,6 +10,10 @@ const require_repository = require("./repository.cjs");
 * @param {DatabaseConfig} config - Database configuration
 * @returns {DatabaseInstance<S>} Database instance with table repositories
 */
+function normalizeMigrations(migrations) {
+	if (Array.isArray(migrations)) return migrations;
+	return Object.values(migrations).filter((v) => v != null && typeof v === "object" && "name" in v && "up" in v && "down" in v);
+}
 function normalizeSchemas(schemas) {
 	if (Array.isArray(schemas)) return schemas;
 	return Object.values(schemas).filter((v) => v != null && typeof v === "object" && v.__table === true);
@@ -47,7 +51,10 @@ function database(config) {
 			});
 			await Promise.all(syncPromises);
 		}
-		if (config.runMigrations && config.migrations && config.migrations.length > 0) await runMigrations(driver, registry, config.migrations);
+		if (config.runMigrations && config.migrations) {
+			const migrations = normalizeMigrations(config.migrations);
+			if (migrations.length > 0) await runMigrations(driver, registry, migrations);
+		}
 	};
 	const repos = /* @__PURE__ */ new Map();
 	for (const schema of schemas) {

package/dist/core/database.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.cjs","names":["SchemaRegistry","DatabaseError","createDriver","CacheManager","TableRepository","MIGRATIONS_TABLE"],"sources":["../../src/core/database.ts"],"sourcesContent":["import { CacheManager } from \"../cache\";\nimport { MIGRATIONS_TABLE } from \"../constants\";\nimport { createDriver } from \"../drivers\";\nimport { DatabaseError } from \"../errors\";\nimport { SchemaRegistry } from \"../schema\";\nimport type {\n  AnyTableDef,\n  ConnectionConfig,\n  DatabaseConfig,\n  DatabaseDriver,\n  DeleteOptions,\n  InferRow,\n  InferSchemas,\n  MigrationDefinition,\n  QueryOptions,\n  RelationQueryMap,\n  ResolveResult,\n  TableMetadata,\n  UpdateOptions,\n  WhereClause,\n} from \"../types\";\nimport { TableRepository } from \"./repository\";\n\ntype TypedTableRepository<S extends readonly AnyTableDef[], T extends AnyTableDef> = {\n  find<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  findMany<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  findFirst<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O> | null>;\n\n  insert(data: Partial<InferRow<T>> | Partial<InferRow<T>>[]): Promise<InferRow<T>>;\n  insertMany(data: Partial<InferRow<T>>[]): Promise<InferRow<T>[]>;\n  update(options: UpdateOptions<InferRow<T>>): Promise<InferRow<T>[]>;\n  delete(options: DeleteOptions<InferRow<T>>): Promise<number>;\n  count(options?: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<number>;\n  exists(options: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<boolean>;\n  upsert(options: {\n    where: WhereClause<InferRow<T>>;\n    create: Partial<InferRow<T>>;\n    update: Partial<InferRow<T>>;\n  }): Promise<InferRow<T>>;\n  truncate(): Promise<void>;\n};\n\ntype ExtractRepos<S> = S extends readonly AnyTableDef[]\n  ? { [T in S[number] as T[\"__name\"]]: TypedTableRepository<S, T> }\n  : S extends Record<string, any>\n    ? {\n        [K in keyof S as S[K] extends AnyTableDef ? K : never]: TypedTableRepository<\n          InferSchemas<S>,\n          Extract<S[K], AnyTableDef>\n        >;\n      }\n    : never;\n\ntype DatabaseInstance<S> = ExtractRepos<S> & {\n  /**\n   * Initialize the database connection, create tables and run migrations\n   * @returns {Promise<void>}\n   */\n  initialize(): Promise<void>;\n  /**\n   * Close the database connection\n   * @returns {Promise<void>}\n   */\n  close(): Promise<void>;\n  /**\n   * Get the underlying database driver\n   * @returns {DatabaseDriver} The database driver\n   */\n  getDriver(): DatabaseDriver;\n  /**\n   * Get the schema registry\n   * @returns {SchemaRegistry} The schema registry\n   */\n  getRegistry(): SchemaRegistry;\n  /**\n   * Get the cache manager\n   * @returns {CacheManager} The cache manager\n   */\n  getCache(): CacheManager;\n  /**\n   * Execute a raw SQL query\n   * @param {string} sql - SQL query\n   * @param {unknown[]} [params] - Query parameters\n   * @returns {Promise<any[]>} Query results\n   */\n  raw(sql: string, params?: unknown[]): Promise<any[]>;\n  /**\n   * Execute within a transaction\n   * @param {() => Promise<T>} fn - Function to execute\n   * @returns {Promise<T>} Result\n   */\n  transaction<T>(fn: () => Promise<T>): Promise<T>;\n};\n\n/**\n * Create a database instance with typed repositories for each schema\n * @param {DatabaseConfig} config - Database configuration\n * @returns {DatabaseInstance<S>} Database instance with table repositories\n */\nfunction normalizeSchemas<S extends readonly AnyTableDef[]>(schemas: any): S {\n  if (Array.isArray(schemas)) {\n    return schemas as any as S;\n  }\n  return Object.values(schemas).filter(\n    (v): v is AnyTableDef => v != null && typeof v === \"object\" && (v as any).__table === true,\n  ) as any;\n}\n\nexport function database<const S extends readonly AnyTableDef[] | Record<string, any>>(\n  config: DatabaseConfig & { schemas: S },\n): DatabaseInstance<S> {\n  const schemas = normalizeSchemas(config.schemas) as any;\n  const registry = new SchemaRegistry();\n  registry.register(schemas);\n\n  const connectionConfig = Array.isArray(config.connection)\n    ? config.connection[0]\n    : config.connection;\n\n  if (!connectionConfig) {\n    throw new DatabaseError(\"Connection config is required\");\n  }\n\n  const driver = createDriver(config.database, connectionConfig as ConnectionConfig);\n  const cache = new CacheManager(config.cache);\n\n  let initialized = false;\n  let initPromise: Promise<void> | null = null;\n\n  const ensureInitialized = async () => {\n    if (initialized) {\n      return;\n    }\n    if (initPromise) {\n      return initPromise;\n    }\n    initPromise = doInit();\n    await initPromise;\n    initialized = true;\n  };\n\n  const doInit = async () => {\n    await driver.connect();\n\n    if (config.syncSchemas) {\n      const allMetadata = driver.getAllTableColumns ? await driver.getAllTableColumns() : null;\n\n      const syncPromises = Array.from(registry.getAllTables()).map(async ([, tableMeta]) => {\n        const existingCols = allMetadata ? allMetadata[tableMeta.name] : null;\n        const exists = allMetadata ? !!existingCols : await driver.tableExists(tableMeta.name);\n\n        if (!exists) {\n          await driver.createTable(tableMeta);\n        } else {\n          const cols = existingCols || (await driver.getTableColumns(tableMeta.name));\n          const existingNames = new Set(cols.map((c) => c.name));\n          const addColumnPromises = tableMeta.columns\n            .filter((colMeta) => !existingNames.has(colMeta.name))\n            .map((colMeta) => driver.addColumn(tableMeta.name, colMeta));\n          await Promise.all(addColumnPromises);\n        }\n      });\n      await Promise.all(syncPromises);\n    }\n\n    if (config.runMigrations && config.migrations && config.migrations.length > 0) {\n      await runMigrations(driver, registry, config.migrations);\n    }\n  };\n\n  const repos = new Map<string, TableRepository<any>>();\n  for (const schema of schemas) {\n    const repo = new TableRepository(schema.__name, driver, cache, registry, schema.__cache);\n    repos.set(schema.__name, repo);\n  }\n\n  const instance: any = {\n    initialize: async () => {\n      await ensureInitialized();\n    },\n    close: async () => {\n      await driver.disconnect();\n      cache.clear();\n      initialized = false;\n      initPromise = null;\n    },\n    getDriver: () => driver,\n    getRegistry: () => registry,\n    getCache: () => cache,\n    raw: async (sql: string, params?: unknown[]) => {\n      await ensureInitialized();\n      return driver.query(sql, params);\n    },\n    transaction: async <T>(fn: () => Promise<T>) => {\n      await ensureInitialized();\n      return driver.transaction(fn);\n    },\n  };\n\n  for (const schema of schemas) {\n    const repo = repos.get(schema.__name)!;\n    const proxy = new Proxy(repo, {\n      get(target, prop, receiver) {\n        const original = Reflect.get(target, prop, receiver);\n        if (typeof original === \"function\") {\n          return async (...args: any[]) => {\n            await ensureInitialized();\n            return original.apply(target, args);\n          };\n        }\n        return original;\n      },\n    });\n    instance[schema.__name] = proxy;\n  }\n\n  return instance as any as DatabaseInstance<S>;\n}\n\nasync function runMigrations(\n  driver: DatabaseDriver,\n  registry: SchemaRegistry,\n  migrations: MigrationDefinition[],\n): Promise<void> {\n  const migrationsTableMeta: TableMetadata = {\n    name: MIGRATIONS_TABLE,\n    columns: [\n      {\n        name: \"id\",\n        type: \"integer\",\n        primaryKey: true,\n        autoIncrement: true,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n      },\n      {\n        name: \"name\",\n        type: \"varchar\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n        length: 255,\n      },\n      {\n        name: \"executed_at\",\n        type: \"datetime\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: false,\n        defaultValue: undefined,\n      },\n    ],\n  };\n\n  const exists = await driver.tableExists(MIGRATIONS_TABLE);\n  if (!exists) {\n    await driver.createTable(migrationsTableMeta);\n  }\n\n  const executed = await driver.query(`SELECT name FROM \\`${MIGRATIONS_TABLE}\\``);\n  const executedNames = new Set(executed.map((r: any) => r.name));\n\n  for (const migration of migrations) {\n    if (executedNames.has(migration.name)) {\n      continue;\n    }\n\n    const ctx = {\n      schema: {\n        createTable: async (tableDef: AnyTableDef) => {\n          const meta = registry.getTable(tableDef.__name);\n          if (meta) {\n            await driver.createTable(meta);\n          }\n        },\n        dropTable: async (name: string) => {\n          await driver.dropTable(name);\n        },\n        addColumn: async (table: string, _name: string, column: any) => {\n          await driver.addColumn(table, column);\n        },\n        dropColumn: async (table: string, name: string) => {\n          await driver.dropColumn(table, name);\n        },\n        renameColumn: async (table: string, oldName: string, newName: string) => {\n          await driver.renameColumn(table, oldName, newName);\n        },\n        addIndex: async () => {},\n        dropIndex: async () => {},\n      },\n      sql: async (query: string, params?: unknown[]) => {\n        return driver.execute(query, params);\n      },\n    };\n\n    await migration.up(ctx);\n\n    await driver.execute(\n      `INSERT INTO \\`${MIGRATIONS_TABLE}\\` (\\`name\\`, \\`executed_at\\`) VALUES (?, ?)`,\n      [migration.name, new Date()],\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"database.cjs","names":["SchemaRegistry","DatabaseError","createDriver","CacheManager","TableRepository","MIGRATIONS_TABLE"],"sources":["../../src/core/database.ts"],"sourcesContent":["import { CacheManager } from \"../cache\";\nimport { MIGRATIONS_TABLE } from \"../constants\";\nimport { createDriver } from \"../drivers\";\nimport { DatabaseError } from \"../errors\";\nimport { SchemaRegistry } from \"../schema\";\nimport type {\n  AnyTableDef,\n  ConnectionConfig,\n  DatabaseConfig,\n  DatabaseDriver,\n  DeleteOptions,\n  InferRow,\n  InferSchemas,\n  MigrationDefinition,\n  QueryOptions,\n  RelationQueryMap,\n  ResolveResult,\n  TableMetadata,\n  UpdateOptions,\n  WhereClause,\n} from \"../types\";\nimport { TableRepository } from \"./repository\";\n\ntype TypedTableRepository<S extends readonly AnyTableDef[], T extends AnyTableDef> = {\n  /**\n   * Find all rows matching the given options\n   * @param options - Filter, sort, paginate, and eagerly load relations\n   * @returns Array of matching rows\n   */\n  find<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  /**\n   * Find all rows matching the given options (alias for {@link find})\n   * @param options - Filter, sort, paginate, and eagerly load relations\n   * @returns Array of matching rows\n   */\n  findMany<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  /**\n   * Find the first row matching the given options\n   * @param options - Filter, sort, and eagerly load relations\n   * @returns The first matching row, or `null` if none found\n   */\n  findFirst<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O> | null>;\n\n  /**\n   * Insert one or more rows into the table\n   * @param data - Row data (or array of row data) to insert\n   * @returns The inserted row\n   */\n  insert(data: Partial<InferRow<T>> | Partial<InferRow<T>>[]): Promise<InferRow<T>>;\n\n  /**\n   * Insert multiple rows into the table\n   * @param data - Array of row data to insert\n   * @returns Array of inserted rows\n   */\n  insertMany(data: Partial<InferRow<T>>[]): Promise<InferRow<T>[]>;\n\n  /**\n   * Update rows matching the where clause\n   * @param options - Where clause and partial data to apply\n   * @returns Array of updated rows\n   */\n  update(options: UpdateOptions<InferRow<T>>): Promise<InferRow<T>[]>;\n\n  /**\n   * Delete rows matching the where clause\n   * @param options - Where clause to select rows for deletion\n   * @returns Number of deleted rows\n   */\n  delete(options: DeleteOptions<InferRow<T>>): Promise<number>;\n\n  /**\n   * Count rows matching the where clause\n   * @param options - Optional where clause to filter rows\n   * @returns Number of matching rows\n   */\n  count(options?: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<number>;\n\n  /**\n   * Check whether at least one row matches the where clause\n   * @param options - Where clause to check\n   * @returns `true` if a matching row exists, `false` otherwise\n   */\n  exists(options: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<boolean>;\n\n  /**\n   * Insert a row if it doesn't exist, or update it if it does\n   * @param options - Where clause to check, data to create, and data to update\n   * @returns The created or updated row\n   */\n  upsert(options: {\n    where: WhereClause<InferRow<T>>;\n    create: Partial<InferRow<T>>;\n    update: Partial<InferRow<T>>;\n  }): Promise<InferRow<T>>;\n\n  /**\n   * Remove all rows from the table\n   * @returns Resolves when the table has been truncated\n   */\n  truncate(): Promise<void>;\n};\n\ntype ExtractRepos<S> = S extends readonly AnyTableDef[]\n  ? { [T in S[number] as T[\"__name\"]]: TypedTableRepository<S, T> }\n  : S extends Record<string, any>\n    ? {\n        [K in keyof S as S[K] extends AnyTableDef ? K : never]: TypedTableRepository<\n          InferSchemas<S>,\n          Extract<S[K], AnyTableDef>\n        >;\n      }\n    : never;\n\ntype DatabaseInstance<S> = ExtractRepos<S> & {\n  /**\n   * Initialize the database connection, create tables and run migrations\n   * @returns {Promise<void>}\n   */\n  initialize(): Promise<void>;\n  /**\n   * Close the database connection\n   * @returns {Promise<void>}\n   */\n  close(): Promise<void>;\n  /**\n   * Get the underlying database driver\n   * @returns {DatabaseDriver} The database driver\n   */\n  getDriver(): DatabaseDriver;\n  /**\n   * Get the schema registry\n   * @returns {SchemaRegistry} The schema registry\n   */\n  getRegistry(): SchemaRegistry;\n  /**\n   * Get the cache manager\n   * @returns {CacheManager} The cache manager\n   */\n  getCache(): CacheManager;\n  /**\n   * Execute a raw SQL query\n   * @param {string} sql - SQL query\n   * @param {unknown[]} [params] - Query parameters\n   * @returns {Promise<any[]>} Query results\n   */\n  raw(sql: string, params?: unknown[]): Promise<any[]>;\n  /**\n   * Execute within a transaction\n   * @param {() => Promise<T>} fn - Function to execute\n   * @returns {Promise<T>} Result\n   */\n  transaction<T>(fn: () => Promise<T>): Promise<T>;\n};\n\n/**\n * Create a database instance with typed repositories for each schema\n * @param {DatabaseConfig} config - Database configuration\n * @returns {DatabaseInstance<S>} Database instance with table repositories\n */\nfunction normalizeMigrations(\n  migrations: MigrationDefinition[] | Record<string, unknown>,\n): MigrationDefinition[] {\n  if (Array.isArray(migrations)) {\n    return migrations;\n  }\n  return Object.values(migrations).filter(\n    (v): v is MigrationDefinition =>\n      v != null && typeof v === \"object\" && \"name\" in v && \"up\" in v && \"down\" in v,\n  );\n}\n\nfunction normalizeSchemas<S extends readonly AnyTableDef[]>(schemas: any): S {\n  if (Array.isArray(schemas)) {\n    return schemas as any as S;\n  }\n  return Object.values(schemas).filter(\n    (v): v is AnyTableDef => v != null && typeof v === \"object\" && (v as any).__table === true,\n  ) as any;\n}\n\nexport function database<const S extends readonly AnyTableDef[] | Record<string, any>>(\n  config: DatabaseConfig & { schemas: S },\n): DatabaseInstance<S> {\n  const schemas = normalizeSchemas(config.schemas) as any;\n  const registry = new SchemaRegistry();\n  registry.register(schemas);\n\n  const connectionConfig = Array.isArray(config.connection)\n    ? config.connection[0]\n    : config.connection;\n\n  if (!connectionConfig) {\n    throw new DatabaseError(\"Connection config is required\");\n  }\n\n  const driver = createDriver(config.database, connectionConfig as ConnectionConfig);\n  const cache = new CacheManager(config.cache);\n\n  let initialized = false;\n  let initPromise: Promise<void> | null = null;\n\n  const ensureInitialized = async () => {\n    if (initialized) {\n      return;\n    }\n    if (initPromise) {\n      return initPromise;\n    }\n    initPromise = doInit();\n    await initPromise;\n    initialized = true;\n  };\n\n  const doInit = async () => {\n    await driver.connect();\n\n    if (config.syncSchemas) {\n      const allMetadata = driver.getAllTableColumns ? await driver.getAllTableColumns() : null;\n\n      const syncPromises = Array.from(registry.getAllTables()).map(async ([, tableMeta]) => {\n        const existingCols = allMetadata ? allMetadata[tableMeta.name] : null;\n        const exists = allMetadata ? !!existingCols : await driver.tableExists(tableMeta.name);\n\n        if (!exists) {\n          await driver.createTable(tableMeta);\n        } else {\n          const cols = existingCols || (await driver.getTableColumns(tableMeta.name));\n          const existingNames = new Set(cols.map((c) => c.name));\n          const addColumnPromises = tableMeta.columns\n            .filter((colMeta) => !existingNames.has(colMeta.name))\n            .map((colMeta) => driver.addColumn(tableMeta.name, colMeta));\n          await Promise.all(addColumnPromises);\n        }\n      });\n      await Promise.all(syncPromises);\n    }\n\n    if (config.runMigrations && config.migrations) {\n      const migrations = normalizeMigrations(config.migrations);\n      if (migrations.length > 0) {\n        await runMigrations(driver, registry, migrations);\n      }\n    }\n  };\n\n  const repos = new Map<string, TableRepository<any>>();\n  for (const schema of schemas) {\n    const repo = new TableRepository(schema.__name, driver, cache, registry, schema.__cache);\n    repos.set(schema.__name, repo);\n  }\n\n  const instance: any = {\n    initialize: async () => {\n      await ensureInitialized();\n    },\n    close: async () => {\n      await driver.disconnect();\n      cache.clear();\n      initialized = false;\n      initPromise = null;\n    },\n    getDriver: () => driver,\n    getRegistry: () => registry,\n    getCache: () => cache,\n    raw: async (sql: string, params?: unknown[]) => {\n      await ensureInitialized();\n      return driver.query(sql, params);\n    },\n    transaction: async <T>(fn: () => Promise<T>) => {\n      await ensureInitialized();\n      return driver.transaction(fn);\n    },\n  };\n\n  for (const schema of schemas) {\n    const repo = repos.get(schema.__name)!;\n    const proxy = new Proxy(repo, {\n      get(target, prop, receiver) {\n        const original = Reflect.get(target, prop, receiver);\n        if (typeof original === \"function\") {\n          return async (...args: any[]) => {\n            await ensureInitialized();\n            return original.apply(target, args);\n          };\n        }\n        return original;\n      },\n    });\n    instance[schema.__name] = proxy;\n  }\n\n  return instance as any as DatabaseInstance<S>;\n}\n\nasync function runMigrations(\n  driver: DatabaseDriver,\n  registry: SchemaRegistry,\n  migrations: MigrationDefinition[],\n): Promise<void> {\n  const migrationsTableMeta: TableMetadata = {\n    name: MIGRATIONS_TABLE,\n    columns: [\n      {\n        name: \"id\",\n        type: \"integer\",\n        primaryKey: true,\n        autoIncrement: true,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n      },\n      {\n        name: \"name\",\n        type: \"varchar\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n        length: 255,\n      },\n      {\n        name: \"executed_at\",\n        type: \"datetime\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: false,\n        defaultValue: undefined,\n      },\n    ],\n  };\n\n  const exists = await driver.tableExists(MIGRATIONS_TABLE);\n  if (!exists) {\n    await driver.createTable(migrationsTableMeta);\n  }\n\n  const executed = await driver.query(`SELECT name FROM \\`${MIGRATIONS_TABLE}\\``);\n  const executedNames = new Set(executed.map((r: any) => r.name));\n\n  for (const migration of migrations) {\n    if (executedNames.has(migration.name)) {\n      continue;\n    }\n\n    const ctx = {\n      schema: {\n        createTable: async (tableDef: AnyTableDef) => {\n          const meta = registry.getTable(tableDef.__name);\n          if (meta) {\n            await driver.createTable(meta);\n          }\n        },\n        dropTable: async (name: string) => {\n          await driver.dropTable(name);\n        },\n        addColumn: async (table: string, _name: string, column: any) => {\n          await driver.addColumn(table, column);\n        },\n        dropColumn: async (table: string, name: string) => {\n          await driver.dropColumn(table, name);\n        },\n        renameColumn: async (table: string, oldName: string, newName: string) => {\n          await driver.renameColumn(table, oldName, newName);\n        },\n        addIndex: async () => {},\n        dropIndex: async () => {},\n      },\n      sql: async (query: string, params?: unknown[]) => {\n        return driver.execute(query, params);\n      },\n    };\n\n    await migration.up(ctx);\n\n    await driver.execute(\n      `INSERT INTO \\`${MIGRATIONS_TABLE}\\` (\\`name\\`, \\`executed_at\\`) VALUES (?, ?)`,\n      [migration.name, new Date()],\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/core/database.d.cts

@@ -4,20 +4,74 @@ import { SchemaRegistry } from "../schema/registry.cjs";
 
 //#region src/core/database.d.ts
 type TypedTableRepository<S extends readonly AnyTableDef[], T extends AnyTableDef> = {
+  /**
+   * Find all rows matching the given options
+   * @param options - Filter, sort, paginate, and eagerly load relations
+   * @returns Array of matching rows
+   */
   find<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(options?: O): Promise<ResolveResult<S, T, O>[]>;
+  /**
+   * Find all rows matching the given options (alias for {@link find})
+   * @param options - Filter, sort, paginate, and eagerly load relations
+   * @returns Array of matching rows
+   */
   findMany<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(options?: O): Promise<ResolveResult<S, T, O>[]>;
+  /**
+   * Find the first row matching the given options
+   * @param options - Filter, sort, and eagerly load relations
+   * @returns The first matching row, or `null` if none found
+   */
   findFirst<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(options?: O): Promise<ResolveResult<S, T, O> | null>;
+  /**
+   * Insert one or more rows into the table
+   * @param data - Row data (or array of row data) to insert
+   * @returns The inserted row
+   */
   insert(data: Partial<InferRow<T>> | Partial<InferRow<T>>[]): Promise<InferRow<T>>;
+  /**
+   * Insert multiple rows into the table
+   * @param data - Array of row data to insert
+   * @returns Array of inserted rows
+   */
   insertMany(data: Partial<InferRow<T>>[]): Promise<InferRow<T>[]>;
+  /**
+   * Update rows matching the where clause
+   * @param options - Where clause and partial data to apply
+   * @returns Array of updated rows
+   */
   update(options: UpdateOptions<InferRow<T>>): Promise<InferRow<T>[]>;
+  /**
+   * Delete rows matching the where clause
+   * @param options - Where clause to select rows for deletion
+   * @returns Number of deleted rows
+   */
   delete(options: DeleteOptions<InferRow<T>>): Promise<number>;
+  /**
+   * Count rows matching the where clause
+   * @param options - Optional where clause to filter rows
+   * @returns Number of matching rows
+   */
   count(options?: Pick<QueryOptions<InferRow<T>>, "where">): Promise<number>;
+  /**
+   * Check whether at least one row matches the where clause
+   * @param options - Where clause to check
+   * @returns `true` if a matching row exists, `false` otherwise
+   */
   exists(options: Pick<QueryOptions<InferRow<T>>, "where">): Promise<boolean>;
+  /**
+   * Insert a row if it doesn't exist, or update it if it does
+   * @param options - Where clause to check, data to create, and data to update
+   * @returns The created or updated row
+   */
   upsert(options: {
     where: WhereClause<InferRow<T>>;
     create: Partial<InferRow<T>>;
     update: Partial<InferRow<T>>;
   }): Promise<InferRow<T>>;
+  /**
+   * Remove all rows from the table
+   * @returns Resolves when the table has been truncated
+   */
   truncate(): Promise<void>;
 };
 type ExtractRepos<S> = S extends readonly AnyTableDef[] ? { [T in S[number] as T["__name"]]: TypedTableRepository<S, T> } : S extends Record<string, any> ? { [K in keyof S as S[K] extends AnyTableDef ? K : never]: TypedTableRepository<InferSchemas<S>, Extract<S[K], AnyTableDef>> } : never;

package/dist/core/database.d.mts

@@ -4,20 +4,74 @@ import { SchemaRegistry } from "../schema/registry.mjs";
 
 //#region src/core/database.d.ts
 type TypedTableRepository<S extends readonly AnyTableDef[], T extends AnyTableDef> = {
+  /**
+   * Find all rows matching the given options
+   * @param options - Filter, sort, paginate, and eagerly load relations
+   * @returns Array of matching rows
+   */
   find<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(options?: O): Promise<ResolveResult<S, T, O>[]>;
+  /**
+   * Find all rows matching the given options (alias for {@link find})
+   * @param options - Filter, sort, paginate, and eagerly load relations
+   * @returns Array of matching rows
+   */
   findMany<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(options?: O): Promise<ResolveResult<S, T, O>[]>;
+  /**
+   * Find the first row matching the given options
+   * @param options - Filter, sort, and eagerly load relations
+   * @returns The first matching row, or `null` if none found
+   */
   findFirst<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(options?: O): Promise<ResolveResult<S, T, O> | null>;
+  /**
+   * Insert one or more rows into the table
+   * @param data - Row data (or array of row data) to insert
+   * @returns The inserted row
+   */
   insert(data: Partial<InferRow<T>> | Partial<InferRow<T>>[]): Promise<InferRow<T>>;
+  /**
+   * Insert multiple rows into the table
+   * @param data - Array of row data to insert
+   * @returns Array of inserted rows
+   */
   insertMany(data: Partial<InferRow<T>>[]): Promise<InferRow<T>[]>;
+  /**
+   * Update rows matching the where clause
+   * @param options - Where clause and partial data to apply
+   * @returns Array of updated rows
+   */
   update(options: UpdateOptions<InferRow<T>>): Promise<InferRow<T>[]>;
+  /**
+   * Delete rows matching the where clause
+   * @param options - Where clause to select rows for deletion
+   * @returns Number of deleted rows
+   */
   delete(options: DeleteOptions<InferRow<T>>): Promise<number>;
+  /**
+   * Count rows matching the where clause
+   * @param options - Optional where clause to filter rows
+   * @returns Number of matching rows
+   */
   count(options?: Pick<QueryOptions<InferRow<T>>, "where">): Promise<number>;
+  /**
+   * Check whether at least one row matches the where clause
+   * @param options - Where clause to check
+   * @returns `true` if a matching row exists, `false` otherwise
+   */
   exists(options: Pick<QueryOptions<InferRow<T>>, "where">): Promise<boolean>;
+  /**
+   * Insert a row if it doesn't exist, or update it if it does
+   * @param options - Where clause to check, data to create, and data to update
+   * @returns The created or updated row
+   */
   upsert(options: {
     where: WhereClause<InferRow<T>>;
     create: Partial<InferRow<T>>;
     update: Partial<InferRow<T>>;
   }): Promise<InferRow<T>>;
+  /**
+   * Remove all rows from the table
+   * @returns Resolves when the table has been truncated
+   */
   truncate(): Promise<void>;
 };
 type ExtractRepos<S> = S extends readonly AnyTableDef[] ? { [T in S[number] as T["__name"]]: TypedTableRepository<S, T> } : S extends Record<string, any> ? { [K in keyof S as S[K] extends AnyTableDef ? K : never]: TypedTableRepository<InferSchemas<S>, Extract<S[K], AnyTableDef>> } : never;

package/dist/core/database.mjs

@@ -11,6 +11,10 @@ init_constants();
 * @param {DatabaseConfig} config - Database configuration
 * @returns {DatabaseInstance<S>} Database instance with table repositories
 */
+function normalizeMigrations(migrations) {
+	if (Array.isArray(migrations)) return migrations;
+	return Object.values(migrations).filter((v) => v != null && typeof v === "object" && "name" in v && "up" in v && "down" in v);
+}
 function normalizeSchemas(schemas) {
 	if (Array.isArray(schemas)) return schemas;
 	return Object.values(schemas).filter((v) => v != null && typeof v === "object" && v.__table === true);
@@ -48,7 +52,10 @@ function database(config) {
 			});
 			await Promise.all(syncPromises);
 		}
-		if (config.runMigrations && config.migrations && config.migrations.length > 0) await runMigrations(driver, registry, config.migrations);
+		if (config.runMigrations && config.migrations) {
+			const migrations = normalizeMigrations(config.migrations);
+			if (migrations.length > 0) await runMigrations(driver, registry, migrations);
+		}
 	};
 	const repos = /* @__PURE__ */ new Map();
 	for (const schema of schemas) {

package/dist/core/database.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database.mjs","names":[],"sources":["../../src/core/database.ts"],"sourcesContent":["import { CacheManager } from \"../cache\";\nimport { MIGRATIONS_TABLE } from \"../constants\";\nimport { createDriver } from \"../drivers\";\nimport { DatabaseError } from \"../errors\";\nimport { SchemaRegistry } from \"../schema\";\nimport type {\n  AnyTableDef,\n  ConnectionConfig,\n  DatabaseConfig,\n  DatabaseDriver,\n  DeleteOptions,\n  InferRow,\n  InferSchemas,\n  MigrationDefinition,\n  QueryOptions,\n  RelationQueryMap,\n  ResolveResult,\n  TableMetadata,\n  UpdateOptions,\n  WhereClause,\n} from \"../types\";\nimport { TableRepository } from \"./repository\";\n\ntype TypedTableRepository<S extends readonly AnyTableDef[], T extends AnyTableDef> = {\n  find<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  findMany<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  findFirst<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O> | null>;\n\n  insert(data: Partial<InferRow<T>> | Partial<InferRow<T>>[]): Promise<InferRow<T>>;\n  insertMany(data: Partial<InferRow<T>>[]): Promise<InferRow<T>[]>;\n  update(options: UpdateOptions<InferRow<T>>): Promise<InferRow<T>[]>;\n  delete(options: DeleteOptions<InferRow<T>>): Promise<number>;\n  count(options?: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<number>;\n  exists(options: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<boolean>;\n  upsert(options: {\n    where: WhereClause<InferRow<T>>;\n    create: Partial<InferRow<T>>;\n    update: Partial<InferRow<T>>;\n  }): Promise<InferRow<T>>;\n  truncate(): Promise<void>;\n};\n\ntype ExtractRepos<S> = S extends readonly AnyTableDef[]\n  ? { [T in S[number] as T[\"__name\"]]: TypedTableRepository<S, T> }\n  : S extends Record<string, any>\n    ? {\n        [K in keyof S as S[K] extends AnyTableDef ? K : never]: TypedTableRepository<\n          InferSchemas<S>,\n          Extract<S[K], AnyTableDef>\n        >;\n      }\n    : never;\n\ntype DatabaseInstance<S> = ExtractRepos<S> & {\n  /**\n   * Initialize the database connection, create tables and run migrations\n   * @returns {Promise<void>}\n   */\n  initialize(): Promise<void>;\n  /**\n   * Close the database connection\n   * @returns {Promise<void>}\n   */\n  close(): Promise<void>;\n  /**\n   * Get the underlying database driver\n   * @returns {DatabaseDriver} The database driver\n   */\n  getDriver(): DatabaseDriver;\n  /**\n   * Get the schema registry\n   * @returns {SchemaRegistry} The schema registry\n   */\n  getRegistry(): SchemaRegistry;\n  /**\n   * Get the cache manager\n   * @returns {CacheManager} The cache manager\n   */\n  getCache(): CacheManager;\n  /**\n   * Execute a raw SQL query\n   * @param {string} sql - SQL query\n   * @param {unknown[]} [params] - Query parameters\n   * @returns {Promise<any[]>} Query results\n   */\n  raw(sql: string, params?: unknown[]): Promise<any[]>;\n  /**\n   * Execute within a transaction\n   * @param {() => Promise<T>} fn - Function to execute\n   * @returns {Promise<T>} Result\n   */\n  transaction<T>(fn: () => Promise<T>): Promise<T>;\n};\n\n/**\n * Create a database instance with typed repositories for each schema\n * @param {DatabaseConfig} config - Database configuration\n * @returns {DatabaseInstance<S>} Database instance with table repositories\n */\nfunction normalizeSchemas<S extends readonly AnyTableDef[]>(schemas: any): S {\n  if (Array.isArray(schemas)) {\n    return schemas as any as S;\n  }\n  return Object.values(schemas).filter(\n    (v): v is AnyTableDef => v != null && typeof v === \"object\" && (v as any).__table === true,\n  ) as any;\n}\n\nexport function database<const S extends readonly AnyTableDef[] | Record<string, any>>(\n  config: DatabaseConfig & { schemas: S },\n): DatabaseInstance<S> {\n  const schemas = normalizeSchemas(config.schemas) as any;\n  const registry = new SchemaRegistry();\n  registry.register(schemas);\n\n  const connectionConfig = Array.isArray(config.connection)\n    ? config.connection[0]\n    : config.connection;\n\n  if (!connectionConfig) {\n    throw new DatabaseError(\"Connection config is required\");\n  }\n\n  const driver = createDriver(config.database, connectionConfig as ConnectionConfig);\n  const cache = new CacheManager(config.cache);\n\n  let initialized = false;\n  let initPromise: Promise<void> | null = null;\n\n  const ensureInitialized = async () => {\n    if (initialized) {\n      return;\n    }\n    if (initPromise) {\n      return initPromise;\n    }\n    initPromise = doInit();\n    await initPromise;\n    initialized = true;\n  };\n\n  const doInit = async () => {\n    await driver.connect();\n\n    if (config.syncSchemas) {\n      const allMetadata = driver.getAllTableColumns ? await driver.getAllTableColumns() : null;\n\n      const syncPromises = Array.from(registry.getAllTables()).map(async ([, tableMeta]) => {\n        const existingCols = allMetadata ? allMetadata[tableMeta.name] : null;\n        const exists = allMetadata ? !!existingCols : await driver.tableExists(tableMeta.name);\n\n        if (!exists) {\n          await driver.createTable(tableMeta);\n        } else {\n          const cols = existingCols || (await driver.getTableColumns(tableMeta.name));\n          const existingNames = new Set(cols.map((c) => c.name));\n          const addColumnPromises = tableMeta.columns\n            .filter((colMeta) => !existingNames.has(colMeta.name))\n            .map((colMeta) => driver.addColumn(tableMeta.name, colMeta));\n          await Promise.all(addColumnPromises);\n        }\n      });\n      await Promise.all(syncPromises);\n    }\n\n    if (config.runMigrations && config.migrations && config.migrations.length > 0) {\n      await runMigrations(driver, registry, config.migrations);\n    }\n  };\n\n  const repos = new Map<string, TableRepository<any>>();\n  for (const schema of schemas) {\n    const repo = new TableRepository(schema.__name, driver, cache, registry, schema.__cache);\n    repos.set(schema.__name, repo);\n  }\n\n  const instance: any = {\n    initialize: async () => {\n      await ensureInitialized();\n    },\n    close: async () => {\n      await driver.disconnect();\n      cache.clear();\n      initialized = false;\n      initPromise = null;\n    },\n    getDriver: () => driver,\n    getRegistry: () => registry,\n    getCache: () => cache,\n    raw: async (sql: string, params?: unknown[]) => {\n      await ensureInitialized();\n      return driver.query(sql, params);\n    },\n    transaction: async <T>(fn: () => Promise<T>) => {\n      await ensureInitialized();\n      return driver.transaction(fn);\n    },\n  };\n\n  for (const schema of schemas) {\n    const repo = repos.get(schema.__name)!;\n    const proxy = new Proxy(repo, {\n      get(target, prop, receiver) {\n        const original = Reflect.get(target, prop, receiver);\n        if (typeof original === \"function\") {\n          return async (...args: any[]) => {\n            await ensureInitialized();\n            return original.apply(target, args);\n          };\n        }\n        return original;\n      },\n    });\n    instance[schema.__name] = proxy;\n  }\n\n  return instance as any as DatabaseInstance<S>;\n}\n\nasync function runMigrations(\n  driver: DatabaseDriver,\n  registry: SchemaRegistry,\n  migrations: MigrationDefinition[],\n): Promise<void> {\n  const migrationsTableMeta: TableMetadata = {\n    name: MIGRATIONS_TABLE,\n    columns: [\n      {\n        name: \"id\",\n        type: \"integer\",\n        primaryKey: true,\n        autoIncrement: true,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n      },\n      {\n        name: \"name\",\n        type: \"varchar\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n        length: 255,\n      },\n      {\n        name: \"executed_at\",\n        type: \"datetime\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: false,\n        defaultValue: undefined,\n      },\n    ],\n  };\n\n  const exists = await driver.tableExists(MIGRATIONS_TABLE);\n  if (!exists) {\n    await driver.createTable(migrationsTableMeta);\n  }\n\n  const executed = await driver.query(`SELECT name FROM \\`${MIGRATIONS_TABLE}\\``);\n  const executedNames = new Set(executed.map((r: any) => r.name));\n\n  for (const migration of migrations) {\n    if (executedNames.has(migration.name)) {\n      continue;\n    }\n\n    const ctx = {\n      schema: {\n        createTable: async (tableDef: AnyTableDef) => {\n          const meta = registry.getTable(tableDef.__name);\n          if (meta) {\n            await driver.createTable(meta);\n          }\n        },\n        dropTable: async (name: string) => {\n          await driver.dropTable(name);\n        },\n        addColumn: async (table: string, _name: string, column: any) => {\n          await driver.addColumn(table, column);\n        },\n        dropColumn: async (table: string, name: string) => {\n          await driver.dropColumn(table, name);\n        },\n        renameColumn: async (table: string, oldName: string, newName: string) => {\n          await driver.renameColumn(table, oldName, newName);\n        },\n        addIndex: async () => {},\n        dropIndex: async () => {},\n      },\n      sql: async (query: string, params?: unknown[]) => {\n        return driver.execute(query, params);\n      },\n    };\n\n    await migration.up(ctx);\n\n    await driver.execute(\n      `INSERT INTO \\`${MIGRATIONS_TABLE}\\` (\\`name\\`, \\`executed_at\\`) VALUES (?, ?)`,\n      [migration.name, new Date()],\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"database.mjs","names":[],"sources":["../../src/core/database.ts"],"sourcesContent":["import { CacheManager } from \"../cache\";\nimport { MIGRATIONS_TABLE } from \"../constants\";\nimport { createDriver } from \"../drivers\";\nimport { DatabaseError } from \"../errors\";\nimport { SchemaRegistry } from \"../schema\";\nimport type {\n  AnyTableDef,\n  ConnectionConfig,\n  DatabaseConfig,\n  DatabaseDriver,\n  DeleteOptions,\n  InferRow,\n  InferSchemas,\n  MigrationDefinition,\n  QueryOptions,\n  RelationQueryMap,\n  ResolveResult,\n  TableMetadata,\n  UpdateOptions,\n  WhereClause,\n} from \"../types\";\nimport { TableRepository } from \"./repository\";\n\ntype TypedTableRepository<S extends readonly AnyTableDef[], T extends AnyTableDef> = {\n  /**\n   * Find all rows matching the given options\n   * @param options - Filter, sort, paginate, and eagerly load relations\n   * @returns Array of matching rows\n   */\n  find<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  /**\n   * Find all rows matching the given options (alias for {@link find})\n   * @param options - Filter, sort, paginate, and eagerly load relations\n   * @returns Array of matching rows\n   */\n  findMany<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O>[]>;\n\n  /**\n   * Find the first row matching the given options\n   * @param options - Filter, sort, and eagerly load relations\n   * @returns The first matching row, or `null` if none found\n   */\n  findFirst<O extends QueryOptions<InferRow<T>, RelationQueryMap<S, T>> = {}>(\n    options?: O,\n  ): Promise<ResolveResult<S, T, O> | null>;\n\n  /**\n   * Insert one or more rows into the table\n   * @param data - Row data (or array of row data) to insert\n   * @returns The inserted row\n   */\n  insert(data: Partial<InferRow<T>> | Partial<InferRow<T>>[]): Promise<InferRow<T>>;\n\n  /**\n   * Insert multiple rows into the table\n   * @param data - Array of row data to insert\n   * @returns Array of inserted rows\n   */\n  insertMany(data: Partial<InferRow<T>>[]): Promise<InferRow<T>[]>;\n\n  /**\n   * Update rows matching the where clause\n   * @param options - Where clause and partial data to apply\n   * @returns Array of updated rows\n   */\n  update(options: UpdateOptions<InferRow<T>>): Promise<InferRow<T>[]>;\n\n  /**\n   * Delete rows matching the where clause\n   * @param options - Where clause to select rows for deletion\n   * @returns Number of deleted rows\n   */\n  delete(options: DeleteOptions<InferRow<T>>): Promise<number>;\n\n  /**\n   * Count rows matching the where clause\n   * @param options - Optional where clause to filter rows\n   * @returns Number of matching rows\n   */\n  count(options?: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<number>;\n\n  /**\n   * Check whether at least one row matches the where clause\n   * @param options - Where clause to check\n   * @returns `true` if a matching row exists, `false` otherwise\n   */\n  exists(options: Pick<QueryOptions<InferRow<T>>, \"where\">): Promise<boolean>;\n\n  /**\n   * Insert a row if it doesn't exist, or update it if it does\n   * @param options - Where clause to check, data to create, and data to update\n   * @returns The created or updated row\n   */\n  upsert(options: {\n    where: WhereClause<InferRow<T>>;\n    create: Partial<InferRow<T>>;\n    update: Partial<InferRow<T>>;\n  }): Promise<InferRow<T>>;\n\n  /**\n   * Remove all rows from the table\n   * @returns Resolves when the table has been truncated\n   */\n  truncate(): Promise<void>;\n};\n\ntype ExtractRepos<S> = S extends readonly AnyTableDef[]\n  ? { [T in S[number] as T[\"__name\"]]: TypedTableRepository<S, T> }\n  : S extends Record<string, any>\n    ? {\n        [K in keyof S as S[K] extends AnyTableDef ? K : never]: TypedTableRepository<\n          InferSchemas<S>,\n          Extract<S[K], AnyTableDef>\n        >;\n      }\n    : never;\n\ntype DatabaseInstance<S> = ExtractRepos<S> & {\n  /**\n   * Initialize the database connection, create tables and run migrations\n   * @returns {Promise<void>}\n   */\n  initialize(): Promise<void>;\n  /**\n   * Close the database connection\n   * @returns {Promise<void>}\n   */\n  close(): Promise<void>;\n  /**\n   * Get the underlying database driver\n   * @returns {DatabaseDriver} The database driver\n   */\n  getDriver(): DatabaseDriver;\n  /**\n   * Get the schema registry\n   * @returns {SchemaRegistry} The schema registry\n   */\n  getRegistry(): SchemaRegistry;\n  /**\n   * Get the cache manager\n   * @returns {CacheManager} The cache manager\n   */\n  getCache(): CacheManager;\n  /**\n   * Execute a raw SQL query\n   * @param {string} sql - SQL query\n   * @param {unknown[]} [params] - Query parameters\n   * @returns {Promise<any[]>} Query results\n   */\n  raw(sql: string, params?: unknown[]): Promise<any[]>;\n  /**\n   * Execute within a transaction\n   * @param {() => Promise<T>} fn - Function to execute\n   * @returns {Promise<T>} Result\n   */\n  transaction<T>(fn: () => Promise<T>): Promise<T>;\n};\n\n/**\n * Create a database instance with typed repositories for each schema\n * @param {DatabaseConfig} config - Database configuration\n * @returns {DatabaseInstance<S>} Database instance with table repositories\n */\nfunction normalizeMigrations(\n  migrations: MigrationDefinition[] | Record<string, unknown>,\n): MigrationDefinition[] {\n  if (Array.isArray(migrations)) {\n    return migrations;\n  }\n  return Object.values(migrations).filter(\n    (v): v is MigrationDefinition =>\n      v != null && typeof v === \"object\" && \"name\" in v && \"up\" in v && \"down\" in v,\n  );\n}\n\nfunction normalizeSchemas<S extends readonly AnyTableDef[]>(schemas: any): S {\n  if (Array.isArray(schemas)) {\n    return schemas as any as S;\n  }\n  return Object.values(schemas).filter(\n    (v): v is AnyTableDef => v != null && typeof v === \"object\" && (v as any).__table === true,\n  ) as any;\n}\n\nexport function database<const S extends readonly AnyTableDef[] | Record<string, any>>(\n  config: DatabaseConfig & { schemas: S },\n): DatabaseInstance<S> {\n  const schemas = normalizeSchemas(config.schemas) as any;\n  const registry = new SchemaRegistry();\n  registry.register(schemas);\n\n  const connectionConfig = Array.isArray(config.connection)\n    ? config.connection[0]\n    : config.connection;\n\n  if (!connectionConfig) {\n    throw new DatabaseError(\"Connection config is required\");\n  }\n\n  const driver = createDriver(config.database, connectionConfig as ConnectionConfig);\n  const cache = new CacheManager(config.cache);\n\n  let initialized = false;\n  let initPromise: Promise<void> | null = null;\n\n  const ensureInitialized = async () => {\n    if (initialized) {\n      return;\n    }\n    if (initPromise) {\n      return initPromise;\n    }\n    initPromise = doInit();\n    await initPromise;\n    initialized = true;\n  };\n\n  const doInit = async () => {\n    await driver.connect();\n\n    if (config.syncSchemas) {\n      const allMetadata = driver.getAllTableColumns ? await driver.getAllTableColumns() : null;\n\n      const syncPromises = Array.from(registry.getAllTables()).map(async ([, tableMeta]) => {\n        const existingCols = allMetadata ? allMetadata[tableMeta.name] : null;\n        const exists = allMetadata ? !!existingCols : await driver.tableExists(tableMeta.name);\n\n        if (!exists) {\n          await driver.createTable(tableMeta);\n        } else {\n          const cols = existingCols || (await driver.getTableColumns(tableMeta.name));\n          const existingNames = new Set(cols.map((c) => c.name));\n          const addColumnPromises = tableMeta.columns\n            .filter((colMeta) => !existingNames.has(colMeta.name))\n            .map((colMeta) => driver.addColumn(tableMeta.name, colMeta));\n          await Promise.all(addColumnPromises);\n        }\n      });\n      await Promise.all(syncPromises);\n    }\n\n    if (config.runMigrations && config.migrations) {\n      const migrations = normalizeMigrations(config.migrations);\n      if (migrations.length > 0) {\n        await runMigrations(driver, registry, migrations);\n      }\n    }\n  };\n\n  const repos = new Map<string, TableRepository<any>>();\n  for (const schema of schemas) {\n    const repo = new TableRepository(schema.__name, driver, cache, registry, schema.__cache);\n    repos.set(schema.__name, repo);\n  }\n\n  const instance: any = {\n    initialize: async () => {\n      await ensureInitialized();\n    },\n    close: async () => {\n      await driver.disconnect();\n      cache.clear();\n      initialized = false;\n      initPromise = null;\n    },\n    getDriver: () => driver,\n    getRegistry: () => registry,\n    getCache: () => cache,\n    raw: async (sql: string, params?: unknown[]) => {\n      await ensureInitialized();\n      return driver.query(sql, params);\n    },\n    transaction: async <T>(fn: () => Promise<T>) => {\n      await ensureInitialized();\n      return driver.transaction(fn);\n    },\n  };\n\n  for (const schema of schemas) {\n    const repo = repos.get(schema.__name)!;\n    const proxy = new Proxy(repo, {\n      get(target, prop, receiver) {\n        const original = Reflect.get(target, prop, receiver);\n        if (typeof original === \"function\") {\n          return async (...args: any[]) => {\n            await ensureInitialized();\n            return original.apply(target, args);\n          };\n        }\n        return original;\n      },\n    });\n    instance[schema.__name] = proxy;\n  }\n\n  return instance as any as DatabaseInstance<S>;\n}\n\nasync function runMigrations(\n  driver: DatabaseDriver,\n  registry: SchemaRegistry,\n  migrations: MigrationDefinition[],\n): Promise<void> {\n  const migrationsTableMeta: TableMetadata = {\n    name: MIGRATIONS_TABLE,\n    columns: [\n      {\n        name: \"id\",\n        type: \"integer\",\n        primaryKey: true,\n        autoIncrement: true,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n      },\n      {\n        name: \"name\",\n        type: \"varchar\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: true,\n        defaultValue: undefined,\n        length: 255,\n      },\n      {\n        name: \"executed_at\",\n        type: \"datetime\",\n        primaryKey: false,\n        autoIncrement: false,\n        notNull: true,\n        unique: false,\n        defaultValue: undefined,\n      },\n    ],\n  };\n\n  const exists = await driver.tableExists(MIGRATIONS_TABLE);\n  if (!exists) {\n    await driver.createTable(migrationsTableMeta);\n  }\n\n  const executed = await driver.query(`SELECT name FROM \\`${MIGRATIONS_TABLE}\\``);\n  const executedNames = new Set(executed.map((r: any) => r.name));\n\n  for (const migration of migrations) {\n    if (executedNames.has(migration.name)) {\n      continue;\n    }\n\n    const ctx = {\n      schema: {\n        createTable: async (tableDef: AnyTableDef) => {\n          const meta = registry.getTable(tableDef.__name);\n          if (meta) {\n            await driver.createTable(meta);\n          }\n        },\n        dropTable: async (name: string) => {\n          await driver.dropTable(name);\n        },\n        addColumn: async (table: string, _name: string, column: any) => {\n          await driver.addColumn(table, column);\n        },\n        dropColumn: async (table: string, name: string) => {\n          await driver.dropColumn(table, name);\n        },\n        renameColumn: async (table: string, oldName: string, newName: string) => {\n          await driver.renameColumn(table, oldName, newName);\n        },\n        addIndex: async () => {},\n        dropIndex: async () => {},\n      },\n      sql: async (query: string, params?: unknown[]) => {\n        return driver.execute(query, params);\n      },\n    };\n\n    await migration.up(ctx);\n\n    await driver.execute(\n      `INSERT INTO \\`${MIGRATIONS_TABLE}\\` (\\`name\\`, \\`executed_at\\`) VALUES (?, ?)`,\n      [migration.name, new Date()],\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/types.d.cts

@@ -101,26 +101,76 @@ type InferInsert<T> = T extends TableDefinition<infer R, any, any> ? { [K in key
 type AutoIncrementKeys<T> = T extends TableDefinition<infer R, any, any> ? keyof R : never;
 /** Extract the updatable type from a table definition (all fields become optional) */
 type InferUpdate<T> = T extends TableDefinition<infer R, any, any> ? Partial<R> : never;
-/** Condition operators for a single column in a WHERE clause */
+/**
+ * Condition operators for a single column in a WHERE clause.
+ *
+ * @example
+ * ```ts
+ * // Exact match
+ * { age: { eq: 25 } }
+ * // Range query
+ * { age: { gte: 18, lte: 65 } }
+ * // Pattern matching
+ * { name: { like: "%alice%" } }
+ * // Set membership
+ * { status: { in: ["active", "pending"] } }
+ * ```
+ */
 interface WhereCondition {
+  /** Equal to — matches rows where the column value equals the given value */
   eq?: unknown;
+  /** Not equal to — matches rows where the column value differs from the given value */
   neq?: unknown;
+  /** Greater than — matches rows where the column value is strictly greater */
   gt?: unknown;
+  /** Greater than or equal to — matches rows where the column value is greater or equal */
   gte?: unknown;
+  /** Less than — matches rows where the column value is strictly less */
   lt?: unknown;
+  /** Less than or equal to — matches rows where the column value is less or equal */
   lte?: unknown;
+  /** SQL LIKE — matches rows where the column value matches the pattern (use `%` as wildcard) */
   like?: string;
+  /** SQL NOT LIKE — matches rows where the column value does not match the pattern */
   notLike?: string;
+  /** IN — matches rows where the column value is one of the given values */
   in?: unknown[];
+  /** NOT IN — matches rows where the column value is not one of the given values */
   notIn?: unknown[];
+  /** IS NULL / IS NOT NULL — when `true`, matches rows where the column is NULL; when `false`, matches non-NULL */
   isNull?: boolean;
+  /** BETWEEN — matches rows where the column value falls within the inclusive range `[min, max]` */
   between?: [unknown, unknown];
 }
-/** Type-safe WHERE clause supporting equality, operators, and logical combinators (OR/AND) */
-type WhereClause<T = Record<string, any>> = { [K in keyof T]?: T[K] | WhereCondition } & {
-  OR?: WhereClause<T>[];
-  AND?: WhereClause<T>[];
-};
+/** Flatten an intersection into a single object type for better autocomplete */
+type Flat<T> = { [K in keyof T]: T[K] } & {};
+/** Column-level filter conditions for a WHERE clause */
+type WhereFields<T> = Flat<{ [K in keyof T]?: T[K] | WhereCondition }>;
+/**
+ * Type-safe WHERE clause supporting equality, operators, and logical combinators (OR/AND).
+ *
+ * @example
+ * ```ts
+ * // Simple equality
+ * { where: { name: "Alice" } }
+ *
+ * // Using operators
+ * { where: { age: { gte: 18 } } }
+ *
+ * // OR — matches rows satisfying at least one condition
+ * { where: { OR: [{ name: "Alice" }, { name: "Bob" }] } }
+ *
+ * // AND — matches rows satisfying all conditions
+ * { where: { AND: [{ age: { gte: 18 } }, { active: true }] } }
+ *
+ * // Combined AND + OR
+ * { where: { AND: [{ age: { gte: 18 } }], OR: [{ name: "Alice" }, { name: "Bob" }] } }
+ * ```
+ */
+type WhereClause<T = Record<string, any>> = Flat<{ [K in keyof T]?: T[K] | WhereCondition } & {
+  /** Logical OR — matches rows satisfying **at least one** of the given conditions */OR?: WhereFields<T>[]; /** Logical AND — matches rows satisfying **all** of the given conditions */
+  AND?: WhereFields<T>[];
+}>;
 /** Options for querying rows — filtering, sorting, pagination, and relation loading */
 interface QueryOptions<T = Record<string, any>, Rel extends Record<string, any> = {}> {
   /** Filter conditions */
@@ -211,8 +261,15 @@ interface DatabaseConfig {
    * schemas: schemas
    */
   schemas: readonly AnyTableDef[] | Record<string, unknown>;
-  /** Migration definitions to run on initialization */
-  migrations?: any[];
+  /**
+   * Migration definitions — either an array of migrations or a module namespace object.
+   * @example
+   * // Array form
+   * migrations: [createUsers, addAge]
+   * // Module namespace form (import * as migrations from "./migrations")
+   * migrations: migrations
+   */
+  migrations?: MigrationDefinition[] | Record<string, unknown>;
   /** Database type and optional driver provider */
   database: DatabaseType;
   /** Connection configuration (or array for future multi-connection support) */
@@ -264,20 +321,31 @@ interface DatabaseDriver {
 }
 /** Generic repository interface providing CRUD operations for a table */
 interface Repository<T extends Record<string, any>> {
+  /** Find all rows matching the given options */
   find(options?: QueryOptions<T>): Promise<T[]>;
+  /** Find all rows matching the given options (alias for {@link find}) */
   findMany(options?: QueryOptions<T>): Promise<T[]>;
+  /** Find the first row matching the given options, or `null` if none found */
   findFirst(options?: QueryOptions<T>): Promise<T | null>;
+  /** Insert one or more rows into the table */
   insert(data: Partial<T> | Partial<T>[]): Promise<T>;
+  /** Insert multiple rows into the table */
   insertMany(data: Partial<T>[]): Promise<T[]>;
+  /** Update rows matching the where clause */
   update(options: UpdateOptions<T>): Promise<T[]>;
+  /** Delete rows matching the where clause */
   delete(options: DeleteOptions<T>): Promise<number>;
+  /** Count rows matching the where clause */
   count(options?: Pick<QueryOptions<T>, "where">): Promise<number>;
+  /** Check whether at least one row matches the where clause */
   exists(options: Pick<QueryOptions<T>, "where">): Promise<boolean>;
+  /** Insert a row if it doesn't exist, or update it if it does */
   upsert(options: {
     where: WhereClause<T>;
     create: Partial<T>;
     update: Partial<T>;
   }): Promise<T>;
+  /** Remove all rows from the table */
   truncate(): Promise<void>;
 }
 type AnyTableDef = TableDefinition<any, any, any, any>;

package/dist/types.d.mts

@@ -101,26 +101,76 @@ type InferInsert<T> = T extends TableDefinition<infer R, any, any> ? { [K in key
 type AutoIncrementKeys<T> = T extends TableDefinition<infer R, any, any> ? keyof R : never;
 /** Extract the updatable type from a table definition (all fields become optional) */
 type InferUpdate<T> = T extends TableDefinition<infer R, any, any> ? Partial<R> : never;
-/** Condition operators for a single column in a WHERE clause */
+/**
+ * Condition operators for a single column in a WHERE clause.
+ *
+ * @example
+ * ```ts
+ * // Exact match
+ * { age: { eq: 25 } }
+ * // Range query
+ * { age: { gte: 18, lte: 65 } }
+ * // Pattern matching
+ * { name: { like: "%alice%" } }
+ * // Set membership
+ * { status: { in: ["active", "pending"] } }
+ * ```
+ */
 interface WhereCondition {
+  /** Equal to — matches rows where the column value equals the given value */
   eq?: unknown;
+  /** Not equal to — matches rows where the column value differs from the given value */
   neq?: unknown;
+  /** Greater than — matches rows where the column value is strictly greater */
   gt?: unknown;
+  /** Greater than or equal to — matches rows where the column value is greater or equal */
   gte?: unknown;
+  /** Less than — matches rows where the column value is strictly less */
   lt?: unknown;
+  /** Less than or equal to — matches rows where the column value is less or equal */
   lte?: unknown;
+  /** SQL LIKE — matches rows where the column value matches the pattern (use `%` as wildcard) */
   like?: string;
+  /** SQL NOT LIKE — matches rows where the column value does not match the pattern */
   notLike?: string;
+  /** IN — matches rows where the column value is one of the given values */
   in?: unknown[];
+  /** NOT IN — matches rows where the column value is not one of the given values */
   notIn?: unknown[];
+  /** IS NULL / IS NOT NULL — when `true`, matches rows where the column is NULL; when `false`, matches non-NULL */
   isNull?: boolean;
+  /** BETWEEN — matches rows where the column value falls within the inclusive range `[min, max]` */
   between?: [unknown, unknown];
 }
-/** Type-safe WHERE clause supporting equality, operators, and logical combinators (OR/AND) */
-type WhereClause<T = Record<string, any>> = { [K in keyof T]?: T[K] | WhereCondition } & {
-  OR?: WhereClause<T>[];
-  AND?: WhereClause<T>[];
-};
+/** Flatten an intersection into a single object type for better autocomplete */
+type Flat<T> = { [K in keyof T]: T[K] } & {};
+/** Column-level filter conditions for a WHERE clause */
+type WhereFields<T> = Flat<{ [K in keyof T]?: T[K] | WhereCondition }>;
+/**
+ * Type-safe WHERE clause supporting equality, operators, and logical combinators (OR/AND).
+ *
+ * @example
+ * ```ts
+ * // Simple equality
+ * { where: { name: "Alice" } }
+ *
+ * // Using operators
+ * { where: { age: { gte: 18 } } }
+ *
+ * // OR — matches rows satisfying at least one condition
+ * { where: { OR: [{ name: "Alice" }, { name: "Bob" }] } }
+ *
+ * // AND — matches rows satisfying all conditions
+ * { where: { AND: [{ age: { gte: 18 } }, { active: true }] } }
+ *
+ * // Combined AND + OR
+ * { where: { AND: [{ age: { gte: 18 } }], OR: [{ name: "Alice" }, { name: "Bob" }] } }
+ * ```
+ */
+type WhereClause<T = Record<string, any>> = Flat<{ [K in keyof T]?: T[K] | WhereCondition } & {
+  /** Logical OR — matches rows satisfying **at least one** of the given conditions */OR?: WhereFields<T>[]; /** Logical AND — matches rows satisfying **all** of the given conditions */
+  AND?: WhereFields<T>[];
+}>;
 /** Options for querying rows — filtering, sorting, pagination, and relation loading */
 interface QueryOptions<T = Record<string, any>, Rel extends Record<string, any> = {}> {
   /** Filter conditions */
@@ -211,8 +261,15 @@ interface DatabaseConfig {
    * schemas: schemas
    */
   schemas: readonly AnyTableDef[] | Record<string, unknown>;
-  /** Migration definitions to run on initialization */
-  migrations?: any[];
+  /**
+   * Migration definitions — either an array of migrations or a module namespace object.
+   * @example
+   * // Array form
+   * migrations: [createUsers, addAge]
+   * // Module namespace form (import * as migrations from "./migrations")
+   * migrations: migrations
+   */
+  migrations?: MigrationDefinition[] | Record<string, unknown>;
   /** Database type and optional driver provider */
   database: DatabaseType;
   /** Connection configuration (or array for future multi-connection support) */
@@ -264,20 +321,31 @@ interface DatabaseDriver {
 }
 /** Generic repository interface providing CRUD operations for a table */
 interface Repository<T extends Record<string, any>> {
+  /** Find all rows matching the given options */
   find(options?: QueryOptions<T>): Promise<T[]>;
+  /** Find all rows matching the given options (alias for {@link find}) */
   findMany(options?: QueryOptions<T>): Promise<T[]>;
+  /** Find the first row matching the given options, or `null` if none found */
   findFirst(options?: QueryOptions<T>): Promise<T | null>;
+  /** Insert one or more rows into the table */
   insert(data: Partial<T> | Partial<T>[]): Promise<T>;
+  /** Insert multiple rows into the table */
   insertMany(data: Partial<T>[]): Promise<T[]>;
+  /** Update rows matching the where clause */
   update(options: UpdateOptions<T>): Promise<T[]>;
+  /** Delete rows matching the where clause */
   delete(options: DeleteOptions<T>): Promise<number>;
+  /** Count rows matching the where clause */
   count(options?: Pick<QueryOptions<T>, "where">): Promise<number>;
+  /** Check whether at least one row matches the where clause */
   exists(options: Pick<QueryOptions<T>, "where">): Promise<boolean>;
+  /** Insert a row if it doesn't exist, or update it if it does */
   upsert(options: {
     where: WhereClause<T>;
     create: Partial<T>;
     update: Partial<T>;
   }): Promise<T>;
+  /** Remove all rows from the table */
   truncate(): Promise<void>;
 }
 type AnyTableDef = TableDefinition<any, any, any, any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hedystia/db",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "Next-gen TypeScript ORM for building type-safe database layers at lightspeed",
   "homepage": "https://docs.hedystia.com",
   "devDependencies": {