@db-bridge/core 1.1.5 → 1.2.0

package/dist/index.js

@@ -48,6 +48,227 @@ var ISOLATION_LEVELS = {
   SERIALIZABLE: "SERIALIZABLE"
 };
 
+// src/types/TypeGenerator.ts
+var SQL_TYPE_MAP = {
+  // Integers
+  tinyint: "number",
+  smallint: "number",
+  mediumint: "number",
+  int: "number",
+  integer: "number",
+  bigint: "number",
+  // Floats
+  float: "number",
+  double: "number",
+  decimal: "number",
+  numeric: "number",
+  real: "number",
+  // Strings
+  char: "string",
+  varchar: "string",
+  tinytext: "string",
+  text: "string",
+  mediumtext: "string",
+  longtext: "string",
+  enum: "string",
+  set: "string",
+  // Binary
+  binary: "Buffer",
+  varbinary: "Buffer",
+  tinyblob: "Buffer",
+  blob: "Buffer",
+  mediumblob: "Buffer",
+  longblob: "Buffer",
+  // Date/Time
+  date: "Date",
+  datetime: "Date",
+  timestamp: "Date",
+  time: "string",
+  year: "number",
+  // Boolean
+  boolean: "boolean",
+  bool: "boolean",
+  // JSON
+  json: "Record<string, unknown>",
+  jsonb: "Record<string, unknown>",
+  // UUID (PostgreSQL)
+  uuid: "string",
+  // Arrays (PostgreSQL)
+  array: "unknown[]"
+};
+var TypeGenerator = class {
+  constructor(adapter, dialect) {
+    this.adapter = adapter;
+    this.dialect = dialect;
+  }
+  /**
+   * Generate TypeScript interfaces from database schema
+   */
+  async generate(options = {}) {
+    const tables = await this.getTables(options);
+    const output = [];
+    if (options.header) {
+      output.push(options.header);
+      output.push("");
+    } else {
+      output.push("/**");
+      output.push(" * Auto-generated TypeScript types from database schema");
+      output.push(` * Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
+      output.push(" * DO NOT EDIT - This file is auto-generated");
+      output.push(" */");
+      output.push("");
+    }
+    for (const table of tables) {
+      const tableInfo = await this.getTableInfo(table);
+      const interfaceCode = this.generateInterface(tableInfo, options);
+      output.push(interfaceCode);
+      output.push("");
+    }
+    return output.join("\n");
+  }
+  /**
+   * Get list of tables from database
+   */
+  async getTables(options) {
+    let tables;
+    if (this.dialect === "mysql") {
+      const result = await this.adapter.query(
+        `SELECT table_name FROM information_schema.tables
+         WHERE table_schema = DATABASE() AND table_type = 'BASE TABLE'`
+      );
+      tables = result.rows.map((r) => r["table_name"] || r["TABLE_NAME"]).filter((t) => t !== null && t !== void 0);
+    } else {
+      const result = await this.adapter.query(
+        `SELECT table_name FROM information_schema.tables
+         WHERE table_schema = 'public' AND table_type = 'BASE TABLE'`
+      );
+      tables = result.rows.map((r) => r["table_name"] || r["TABLE_NAME"]).filter((t) => t !== null && t !== void 0);
+    }
+    if (options.tables && options.tables.length > 0) {
+      tables = tables.filter((t) => options.tables.includes(t));
+    }
+    if (options.exclude && options.exclude.length > 0) {
+      tables = tables.filter((t) => !options.exclude.includes(t));
+    }
+    tables = tables.filter((t) => !t.startsWith("db_migrations") && !t.startsWith("db_bridge"));
+    return tables.sort();
+  }
+  /**
+   * Get column information for a table
+   */
+  async getTableInfo(tableName) {
+    let columns;
+    if (this.dialect === "mysql") {
+      columns = await this.getMySQLColumns(tableName);
+    } else {
+      columns = await this.getPostgreSQLColumns(tableName);
+    }
+    return { name: tableName, columns };
+  }
+  /**
+   * Get MySQL column information
+   */
+  async getMySQLColumns(tableName) {
+    const result = await this.adapter.query(`SHOW FULL COLUMNS FROM \`${tableName}\``);
+    return result.rows.map((row) => ({
+      name: row.Field,
+      type: this.parseColumnType(row.Type),
+      nullable: row.Null === "YES",
+      defaultValue: row.Default,
+      isPrimary: row.Key === "PRI",
+      isAutoIncrement: row.Extra.includes("auto_increment"),
+      comment: row.Comment || void 0
+    }));
+  }
+  /**
+   * Get PostgreSQL column information
+   */
+  async getPostgreSQLColumns(tableName) {
+    const result = await this.adapter.query(
+      `
+      SELECT
+        c.column_name,
+        c.data_type,
+        c.is_nullable,
+        c.column_default,
+        c.is_identity,
+        pgd.description
+      FROM information_schema.columns c
+      LEFT JOIN pg_catalog.pg_statio_all_tables st ON c.table_name = st.relname
+      LEFT JOIN pg_catalog.pg_description pgd ON pgd.objoid = st.relid
+        AND pgd.objsubid = c.ordinal_position
+      WHERE c.table_name = $1
+      ORDER BY c.ordinal_position
+    `,
+      [tableName]
+    );
+    return result.rows.map((row) => ({
+      name: row.column_name,
+      type: row.data_type,
+      nullable: row.is_nullable === "YES",
+      defaultValue: row.column_default,
+      isPrimary: false,
+      // Would need additional query
+      isAutoIncrement: row.is_identity === "YES" || (row.column_default?.includes("nextval") ?? false),
+      comment: row.description
+    }));
+  }
+  /**
+   * Parse column type (extract base type from full type string)
+   */
+  parseColumnType(fullType) {
+    const baseType = fullType.toLowerCase().replace(/\(.*\)/, "").trim();
+    return baseType.replace(" unsigned", "");
+  }
+  /**
+   * Map SQL type to TypeScript type
+   */
+  mapType(sqlType, nullable) {
+    const baseType = this.parseColumnType(sqlType);
+    if (sqlType.toLowerCase().includes("tinyint(1)")) {
+      return nullable ? "boolean | null" : "boolean";
+    }
+    const tsType = SQL_TYPE_MAP[baseType] || "unknown";
+    return nullable ? `${tsType} | null` : tsType;
+  }
+  /**
+   * Generate TypeScript interface for a table
+   */
+  generateInterface(table, options) {
+    const lines = [];
+    const interfaceName = this.toInterfaceName(table.name);
+    if (options.includeComments) {
+      lines.push("/**");
+      lines.push(` * ${interfaceName} - ${table.name} table`);
+      lines.push(" */");
+    }
+    lines.push(`export interface ${interfaceName} {`);
+    for (const column of table.columns) {
+      const propertyName = options.camelCase ? this.toCamelCase(column.name) : column.name;
+      const tsType = this.mapType(column.type, column.nullable);
+      const optional = options.optionalNullable && column.nullable ? "?" : "";
+      if (options.includeComments && column.comment) {
+        lines.push(`  /** ${column.comment} */`);
+      }
+      lines.push(`  ${propertyName}${optional}: ${tsType};`);
+    }
+    lines.push("}");
+    return lines.join("\n");
+  }
+  /**
+   * Convert table name to PascalCase interface name
+   */
+  toInterfaceName(tableName) {
+    return tableName.split("_").map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
+  }
+  /**
+   * Convert snake_case to camelCase
+   */
+  toCamelCase(name) {
+    return name.replaceAll(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+  }
+};
+
 // src/types/index.ts
 var IsolationLevel = /* @__PURE__ */ ((IsolationLevel2) => {
   IsolationLevel2["READ_UNCOMMITTED"] = "READ UNCOMMITTED";
@@ -2109,7 +2330,7 @@ var MigrationRunner = class {
     };
   }
 };
-var MIGRATION_PATTERN = /^(\d{14})_(.+)\.(ts|js|mjs)$/;
+var MIGRATION_PATTERN = /^(?:([_a-z]+)_)?(\d{14})_(.+)\.(ts|js|mjs)$/;
 var MigrationLoader = class {
   directory;
   extensions;
@@ -2136,12 +2357,13 @@ var MigrationLoader = class {
         if (!match) {
           continue;
         }
-        const [, timestamp, description] = match;
+        const [, prefix, timestamp, description] = match;
         files.push({
           name: basename(entry.name, ext),
           path: join(this.directory, entry.name),
           timestamp,
-          description: description.replaceAll("_", " ")
+          description: description.replaceAll("_", " "),
+          prefix
         });
       }
       files.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
@@ -2218,8 +2440,10 @@ var MigrationLoader = class {
   }
   /**
    * Generate a new migration filename
+   * @param description - Migration description
+   * @param prefix - Optional prefix (e.g., 'auth' -> auth_20250119_xxx.ts)
    */
-  static generateFilename(description) {
+  static generateFilename(description, prefix) {
     const now = /* @__PURE__ */ new Date();
     const timestamp = [
       now.getFullYear(),
@@ -2230,7 +2454,8 @@ var MigrationLoader = class {
       String(now.getSeconds()).padStart(2, "0")
     ].join("");
     const sanitizedDescription = description.toLowerCase().replaceAll(/[^\da-z]+/g, "_").replaceAll(/^_+|_+$/g, "");
-    return `${timestamp}_${sanitizedDescription}.ts`;
+    const sanitizedPrefix = prefix ? prefix.toLowerCase().replaceAll(/[^\da-z]+/g, "_").replaceAll(/^_+|_+$/g, "") : null;
+    return sanitizedPrefix ? `${sanitizedPrefix}_${timestamp}_${sanitizedDescription}.ts` : `${timestamp}_${sanitizedDescription}.ts`;
   }
   /**
    * Get migration template content
@@ -3710,8 +3935,11 @@ var ForeignKeyChain = class {
 var SchemaBuilder = class {
   dialectInstance;
   adapter;
+  collectMode;
+  collectedStatements = [];
   constructor(options) {
     this.adapter = options.adapter;
+    this.collectMode = options.collectMode ?? false;
     switch (options.dialect) {
       case "mysql": {
         this.dialectInstance = new MySQLDialect();
@@ -3817,6 +4045,14 @@ var SchemaBuilder = class {
    * Execute SQL statement
    */
   async execute(sql2, params) {
+    if (this.collectMode) {
+      let statement = sql2;
+      if (params && params.length > 0) {
+        statement += ` -- params: ${JSON.stringify(params)}`;
+      }
+      this.collectedStatements.push(statement);
+      return;
+    }
     if (this.adapter) {
       await this.adapter.execute(sql2, params);
     } else {
@@ -3826,6 +4062,18 @@ var SchemaBuilder = class {
       }
     }
   }
+  /**
+   * Get collected SQL statements (only in collectMode)
+   */
+  getCollectedStatements() {
+    return [...this.collectedStatements];
+  }
+  /**
+   * Clear collected SQL statements
+   */
+  clearCollectedStatements() {
+    this.collectedStatements = [];
+  }
   /**
    * Execute SQL query
    */
@@ -4281,7 +4529,23 @@ var FileMigrationRunner = class {
     const action = direction === "up" ? "Running" : "Rolling back";
     this.options.logger.info(`${action}: ${migration.name}`);
     if (this.options.dryRun) {
-      this.options.logger.info(`DRY RUN: Would ${direction} ${migration.name}`);
+      const schema = new SchemaBuilder({
+        dialect: this.options.dialect,
+        collectMode: true
+      });
+      await migration[direction](schema);
+      const statements = schema.getCollectedStatements();
+      if (statements.length > 0) {
+        this.options.logger.info(`DRY RUN: ${direction.toUpperCase()} ${migration.name}`);
+        this.options.logger.info("SQL statements that would be executed:");
+        for (const sql2 of statements) {
+          this.options.logger.info(`  ${sql2}`);
+        }
+      } else {
+        this.options.logger.info(
+          `DRY RUN: ${direction.toUpperCase()} ${migration.name} (no SQL statements)`
+        );
+      }
       return;
     }
     const transaction = migration.transactional ? await this.adapter.beginTransaction() : null;
@@ -4477,20 +4741,61 @@ var ExpandContractHelper = class {
 function createExpandContractHelper(adapter, schema) {
   return new ExpandContractHelper(adapter, schema);
 }
+var DEFAULT_PRIORITY = 100;
 var SeederLoader = class {
   constructor(directory) {
     this.directory = directory;
   }
   /**
-   * Load all seeder files from directory
+   * Load all seeder files from directory (sorted by priority/dependencies)
    */
   async loadAll() {
     const files = await readdir(this.directory);
-    const seederFiles = files.filter((f) => /\.(ts|js|mjs)$/.test(f) && !f.endsWith(".d.ts")).sort().map((f) => ({
+    const seederPaths = files.filter((f) => /\.(ts|js|mjs)$/.test(f) && !f.endsWith(".d.ts")).map((f) => ({
       name: this.getSeederName(f),
       path: resolve(this.directory, f)
     }));
-    return seederFiles;
+    const seederFiles = [];
+    for (const file of seederPaths) {
+      const seeder = await this.load(file.path);
+      seederFiles.push({
+        name: file.name,
+        path: file.path,
+        priority: seeder.priority ?? DEFAULT_PRIORITY,
+        depends: seeder.depends
+      });
+    }
+    return this.sortByDependencies(seederFiles);
+  }
+  /**
+   * Sort seeders by dependencies (topological sort) then by priority
+   */
+  sortByDependencies(files) {
+    const fileMap = new Map(files.map((f) => [f.name, f]));
+    const visited = /* @__PURE__ */ new Set();
+    const result = [];
+    const visit = (file) => {
+      if (visited.has(file.name)) {
+        return;
+      }
+      visited.add(file.name);
+      if (file.depends) {
+        for (const dep of file.depends) {
+          const depFile = fileMap.get(dep) || fileMap.get(`${dep}_seeder`);
+          if (depFile) {
+            visit(depFile);
+          }
+        }
+      }
+      result.push(file);
+    };
+    const sortedByPriority = [...files].sort(
+      (a, b) => (a.priority ?? DEFAULT_PRIORITY) - (b.priority ?? DEFAULT_PRIORITY)
+    );
+    for (const file of sortedByPriority) {
+      visit(file);
+    }
+    return result;
   }
   /**
    * Load a specific seeder by path
@@ -4512,10 +4817,13 @@ var SeederLoader = class {
   }
   /**
    * Generate a new seeder filename
+   * @param name - Seeder name
+   * @param prefix - Optional prefix (e.g., 'auth' -> auth_users_seeder.ts)
    */
-  static generateFilename(name) {
+  static generateFilename(name, prefix) {
     const snakeName = name.replaceAll(/([a-z])([A-Z])/g, "$1_$2").replaceAll(/[\s-]+/g, "_").toLowerCase();
-    return `${snakeName}_seeder.ts`;
+    const sanitizedPrefix = prefix ? prefix.toLowerCase().replaceAll(/[^\da-z]+/g, "_").replaceAll(/^_+|_+$/g, "") : null;
+    return sanitizedPrefix ? `${sanitizedPrefix}_${snakeName}_seeder.ts` : `${snakeName}_seeder.ts`;
   }
   /**
    * Get seeder template
@@ -4529,10 +4837,16 @@ var SeederLoader = class {
 import type { Seeder, DatabaseAdapter } from '@db-bridge/core';
 
 export default {
+  // Priority: lower runs first (default: 100)
+  // priority: 10,
+
+  // Dependencies: seeders that must run before this one
+  // depends: ['users'],
+
   async run(adapter: DatabaseAdapter): Promise<void> {
     // Insert seed data
     // await adapter.execute(\`
-    //   INSERT INTO users (name, email) VALUES
+    //   INSERT INTO ${name} (name, email) VALUES
     //   ('John Doe', 'john@example.com'),
     //   ('Jane Doe', 'jane@example.com')
     // \`);
@@ -10324,6 +10638,6 @@ var DBBridge3 = class _DBBridge {
   }
 };
 
-export { ANALYSIS_DEFAULTS, AlterTableBuilder, BaseAdapter, BaseQueryBuilder, BaseTransaction, CACHE_DEFAULTS, CONNECTION_DEFAULTS, CRYPTO_DEFAULTS, CacheAPI, CacheError, CacheKeyGenerator, CacheManager, CacheableQuery, CachedAdapter, CachedDBBridge, DBBridge as Client, ColumnBuilder, ConnectionError, CryptoAlgorithms, CryptoProvider, DBBridge2 as DBBridge, DBBridgeError, DBBridge3 as DBBridgeFactory, DEFAULT_POOL_CONFIG, DEFAULT_TIMEOUTS, DURATION_BUCKETS, DatabaseError, DefaultCacheStrategy, DeleteBuilder, DialectFactory, ExpandContractHelper, FileMigrationRunner, ForeignKeyBuilder, ForeignKeyChain, HEALTH_DEFAULTS, HealthChecker, ISOLATION_LEVELS, InsertBuilder, IsolationLevel, LOGGING_DEFAULTS, MetricsCollector, MiddlewareChain, MigrationLoader, MigrationLock, MigrationRunner, ModularCacheManager, ModularPerformanceMonitor, MySQLDialect2 as MySQLDialect, NotImplementedError, POOL_DEFAULTS, POOL_DEFAULTS_LEGACY, PerformanceMonitor, PoolExhaustedError, PostgreSQLDialect2 as PostgreSQLDialect, QUERY_DEFAULTS, QueryContext, QueryError, QueryTimeoutError, RETRY_DEFAULTS, SIZE_UNITS, SQLDialect, SchemaBuilder, MySQLDialect as SchemaMySQLDialect, PostgreSQLDialect as SchemaPostgreSQLDialect, SeederLoader, SeederRunner, SelectBuilder, SmartCacheStrategy, TIME_UNITS, TableBuilder, TimeoutError, TransactionError, UpdateBuilder, ValidationError, WhereBuilder, avg, cacheKey, chunk, composeMiddleware, compress, count, createAdapter, createCacheInvalidationMiddleware, createCacheKeyPattern, createCacheMiddleware, createCachedAdapter, createCircuitBreakerMiddleware, createDeadlineMiddleware, createExpandContractHelper, createLoggingMiddleware, createMetricsMiddleware, createModularQueryBuilder, createQueryState, createRetryMiddleware, createTimeoutMiddleware, crypto, cursorPaginate, decompress, encryptRow, exists, generateCacheKey, generateUUID, getCompressionRatio, isCompressed, isDeleteResult, isInsertResult, isSelectResult, isUpdateResult, max, min, paginate, parseCacheKey, processDataForEncryption, processResultsForDecryption, registerAdapterFactory, retry, sanitizeCacheKey, shouldCompress, sql, sum, validateColumnName, validateConnectionConfig, validateSQL, validateTableName, whereBetweenDates, whereDate, whereDay, whereLastDays, whereMonth, whereToday, whereYear, whereYesterday, withTimeout };
+export { ANALYSIS_DEFAULTS, AlterTableBuilder, BaseAdapter, BaseQueryBuilder, BaseTransaction, CACHE_DEFAULTS, CONNECTION_DEFAULTS, CRYPTO_DEFAULTS, CacheAPI, CacheError, CacheKeyGenerator, CacheManager, CacheableQuery, CachedAdapter, CachedDBBridge, DBBridge as Client, ColumnBuilder, ConnectionError, CryptoAlgorithms, CryptoProvider, DBBridge2 as DBBridge, DBBridgeError, DBBridge3 as DBBridgeFactory, DEFAULT_POOL_CONFIG, DEFAULT_TIMEOUTS, DURATION_BUCKETS, DatabaseError, DefaultCacheStrategy, DeleteBuilder, DialectFactory, ExpandContractHelper, FileMigrationRunner, ForeignKeyBuilder, ForeignKeyChain, HEALTH_DEFAULTS, HealthChecker, ISOLATION_LEVELS, InsertBuilder, IsolationLevel, LOGGING_DEFAULTS, MetricsCollector, MiddlewareChain, MigrationLoader, MigrationLock, MigrationRunner, ModularCacheManager, ModularPerformanceMonitor, MySQLDialect2 as MySQLDialect, NotImplementedError, POOL_DEFAULTS, POOL_DEFAULTS_LEGACY, PerformanceMonitor, PoolExhaustedError, PostgreSQLDialect2 as PostgreSQLDialect, QUERY_DEFAULTS, QueryContext, QueryError, QueryTimeoutError, RETRY_DEFAULTS, SIZE_UNITS, SQLDialect, SchemaBuilder, MySQLDialect as SchemaMySQLDialect, PostgreSQLDialect as SchemaPostgreSQLDialect, SeederLoader, SeederRunner, SelectBuilder, SmartCacheStrategy, TIME_UNITS, TableBuilder, TimeoutError, TransactionError, TypeGenerator, UpdateBuilder, ValidationError, WhereBuilder, avg, cacheKey, chunk, composeMiddleware, compress, count, createAdapter, createCacheInvalidationMiddleware, createCacheKeyPattern, createCacheMiddleware, createCachedAdapter, createCircuitBreakerMiddleware, createDeadlineMiddleware, createExpandContractHelper, createLoggingMiddleware, createMetricsMiddleware, createModularQueryBuilder, createQueryState, createRetryMiddleware, createTimeoutMiddleware, crypto, cursorPaginate, decompress, encryptRow, exists, generateCacheKey, generateUUID, getCompressionRatio, isCompressed, isDeleteResult, isInsertResult, isSelectResult, isUpdateResult, max, min, paginate, parseCacheKey, processDataForEncryption, processResultsForDecryption, registerAdapterFactory, retry, sanitizeCacheKey, shouldCompress, sql, sum, validateColumnName, validateConnectionConfig, validateSQL, validateTableName, whereBetweenDates, whereDate, whereDay, whereLastDays, whereMonth, whereToday, whereYear, whereYesterday, withTimeout };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map