@gzl10/osx-cli 4.0.5 → 4.0.7

package/README.md

@@ -51,7 +51,11 @@ osx extract TABLA --tns PROD_DB
 # Multiples tablas
 osx extract TABLA1,TABLA2,TABLA3 --tns PROD_DB
 
-# Guardar en archivo (nombre auto: TABLA.json)
+# Wildcards: * (multiples caracteres), ? (un caracter)
+osx extract "D21*" --tns PROD_DB -o --pretty
+osx extract "A200?100" --tns PROD_DB -o
+
+# Guardar en archivo (nombre auto: TABLA.json o extractYYYYMMDD.json)
 osx extract TABLA --tns PROD_DB -o --pretty
 
 # Guardar con nombre especifico
@@ -67,6 +71,23 @@ osx extract TABLA --tns "servidor:1521/servicio" -u USER -p PASS
 osx extract TABLA --tns PROD_DB --schema OWNER_SCHEMA
 ```
 
+### Wildcards
+
+Los wildcards permiten extraer multiples tablas con un patron:
+
+- `*` - coincide con cualquier cantidad de caracteres
+- `?` - coincide con un solo caracter
+
+Cuando se usan wildcards, se aplica automaticamente un delay de 100ms entre tablas para no saturar la base de datos. Puedes ajustarlo con `-d`.
+
+```bash
+# Todas las tablas que empiezan por D21
+osx extract "D21*" --tns PROD_DB -o --pretty
+
+# Con delay personalizado (500ms)
+osx extract "D21*" --tns PROD_DB -o --pretty -d 500
+```
+
 ## Opciones
 
 | Opcion | Descripcion |

package/dist/{chunk-R65IT4N7.js → chunk-Q7WNFJU6.js}

@@ -49,6 +49,9 @@ var OracleService = class {
    * Conecta a Oracle usando TNS
    */
   async connect(config) {
+    if (!process.env.NLS_LANG) {
+      process.env.NLS_LANG = "SPANISH_SPAIN.AL32UTF8";
+    }
     initThickMode();
     this.connection = await oracledb.getConnection({
       user: config.user,
@@ -88,6 +91,16 @@ var TABLE_COMMENT = `
   WHERE owner = :schema AND table_name = :tableName
 `;
 var TABLE_COLUMNS = `
+  WITH PK_COLUMNS AS (
+    SELECT acc.COLUMN_NAME
+    FROM ALL_CONSTRAINTS ac
+    JOIN ALL_CONS_COLUMNS acc
+      ON ac.CONSTRAINT_NAME = acc.CONSTRAINT_NAME
+      AND ac.OWNER = acc.OWNER
+    WHERE ac.CONSTRAINT_TYPE = 'P'
+      AND ac.OWNER = :schema
+      AND ac.TABLE_NAME = :tableName
+  )
   SELECT
     COLS.COLUMN_NAME as "column_name",
     DESCRIP.COMMENTS as "comment",
@@ -96,28 +109,19 @@ var TABLE_COLUMNS = `
     COLS.DATA_PRECISION as "data_precision",
     COLS.NULLABLE as "nullable",
     CASE WHEN PK.COLUMN_NAME IS NOT NULL THEN 'Y' ELSE 'N' END AS "is_pk"
-  FROM SYS.ALL_TAB_COLUMNS COLS
-  JOIN SYS.ALL_COL_COMMENTS DESCRIP
+  FROM ALL_TAB_COLUMNS COLS
+  JOIN ALL_COL_COMMENTS DESCRIP
     ON DESCRIP.OWNER = COLS.OWNER
     AND DESCRIP.TABLE_NAME = COLS.TABLE_NAME
     AND DESCRIP.COLUMN_NAME = COLS.COLUMN_NAME
-  LEFT JOIN (
-    SELECT acc.COLUMN_NAME
-    FROM ALL_CONSTRAINTS ac
-    JOIN ALL_CONS_COLUMNS acc
-      ON ac.OWNER = acc.OWNER
-      AND ac.CONSTRAINT_NAME = acc.CONSTRAINT_NAME
-    WHERE ac.CONSTRAINT_TYPE = 'P'
-      AND ac.OWNER = :schema
-      AND acc.TABLE_NAME = :tableName
-  ) PK ON PK.COLUMN_NAME = COLS.COLUMN_NAME
+  LEFT JOIN PK_COLUMNS PK ON PK.COLUMN_NAME = COLS.COLUMN_NAME
   WHERE COLS.OWNER = :schema AND COLS.TABLE_NAME = :tableName
   ORDER BY COLS.COLUMN_ID
 `;
 var TABLE_CHILDREN = `
   SELECT DISTINCT ac_child.table_name AS "child_table"
-  FROM all_constraints ac_parent
-  JOIN all_constraints ac_child
+  FROM ALL_CONSTRAINTS ac_parent
+  JOIN ALL_CONSTRAINTS ac_child
     ON ac_parent.constraint_name = ac_child.r_constraint_name
     AND ac_parent.owner = ac_child.r_owner
   WHERE ac_parent.owner = :schema
@@ -131,15 +135,43 @@ var TABLE_STATS = `
   FROM ALL_TABLES
   WHERE OWNER = :schema AND TABLE_NAME = :tableName
 `;
+var ORACLE_IDENTIFIER_REGEX = /^[A-Z][A-Z0-9_#$]{0,127}$/i;
+function validateOracleIdentifier(name, type) {
+  if (!ORACLE_IDENTIFIER_REGEX.test(name)) {
+    throw new Error(`Nombre de ${type} inv\xE1lido: ${name}`);
+  }
+}
 function buildExamplesQuery(schema, tableName, limit = 10) {
-  return `SELECT * FROM ${schema}.${tableName} ORDER BY ROWID DESC FETCH FIRST ${limit} ROWS ONLY`;
+  validateOracleIdentifier(schema, "schema");
+  validateOracleIdentifier(tableName, "tabla");
+  const safeLimit = Math.min(Math.max(1, limit), 100);
+  return `SELECT * FROM ${schema}.${tableName} FETCH FIRST ${safeLimit} ROWS ONLY`;
 }
+var LIST_TABLES = `
+  SELECT TABLE_NAME as "table_name"
+  FROM ALL_TABLES
+  WHERE OWNER = :schema
+    AND TABLE_NAME LIKE :pattern
+  ORDER BY TABLE_NAME
+`;
 
 // src/services/SchemaExtractor.ts
 var SchemaExtractor = class {
   constructor(oracle) {
     this.oracle = oracle;
   }
+  /**
+   * Lista tablas que coinciden con un patrón
+   * Convierte wildcards: * → %, ? → _
+   */
+  async listTables(schema, pattern) {
+    const sqlPattern = pattern.replace(/\*/g, "%").replace(/\?/g, "_");
+    const rows = await this.oracle.query(LIST_TABLES, {
+      schema,
+      pattern: sqlPattern
+    });
+    return rows.map((r) => r.table_name);
+  }
   /**
    * Extrae el esquema completo de una tabla
    */

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   OracleService,
   SchemaExtractor
-} from "./chunk-R65IT4N7.js";
+} from "./chunk-Q7WNFJU6.js";
 
 // src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";
@@ -120,7 +120,6 @@ async function extractCommand(tables, options) {
   const homeEnv = loadHomeEnv();
   const user = options.user || process.env.OSX_USER || homeEnv.user;
   const password = options.password || process.env.OSX_PASSWORD || homeEnv.password;
-  const schema = options.schema || user?.toUpperCase();
   if (!options.tns) {
     console.error(
       '\n\u274C Error: Debes especificar el TNS o conexi\xF3n\n\nUso:\n  osx extract <TABLA> --tns <ALIAS>        # Usa tnsnames.ora\n  osx extract <TABLA> --tns host:port/sid  # Easy Connect\n\nEjemplos:\n  osx extract D0001 --tns MDI1\n  osx extract D0001 --tns "BDMDI1:1523/MDI1"\n'
@@ -133,21 +132,51 @@ async function extractCommand(tables, options) {
     );
     process.exit(1);
   }
+  const schema = options.schema || user.toUpperCase();
   setupTnsAdmin();
   const oracle = new OracleService();
   try {
     console.error(`Conectando a ${options.tns}...`);
     await oracle.connect({ tns: options.tns, user, password });
-    const tableNames = tables.split(",").map((t) => t.trim().toUpperCase()).filter(Boolean);
-    if (tableNames.length === 0) {
+    const tablePatterns = tables.split(",").map((t) => t.trim().toUpperCase()).filter(Boolean);
+    if (tablePatterns.length === 0) {
       console.error(
-        "\n\u274C Error: No se especificaron tablas a extraer\n\nUso: osx extract <TABLA> [--tns ALIAS]\n\nEjemplos:\n  osx extract D0001 --tns TRON_LD\n  osx extract D0001,D0002,D0003 --tns TRON_LD\n"
+        '\n\u274C Error: No se especificaron tablas a extraer\n\nUso: osx extract <TABLA> [--tns ALIAS]\n\nEjemplos:\n  osx extract D0001 --tns TRON_LD\n  osx extract D0001,D0002,D0003 --tns TRON_LD\n  osx extract "D21*" --tns TRON_LD     # Wildcards\n'
       );
       process.exit(1);
     }
-    console.error(`Extrayendo ${tableNames.length} tabla(s) de ${schema}...`);
     const extractor = new SchemaExtractor(oracle);
-    const delayMs = options.delay ? parseInt(options.delay, 10) : 0;
+    const hasWildcards = tablePatterns.some((p) => p.includes("*") || p.includes("?"));
+    let tableNames = [];
+    if (hasWildcards) {
+      console.error(`Buscando tablas en ${schema}...`);
+      for (const pattern of tablePatterns) {
+        if (pattern.includes("*") || pattern.includes("?")) {
+          const matched = await extractor.listTables(schema, pattern);
+          if (matched.length === 0) {
+            console.error(`  \u26A0\uFE0F  No se encontraron tablas para: ${pattern}`);
+          } else {
+            console.error(`  \u2713 ${pattern} \u2192 ${matched.length} tabla(s)`);
+            tableNames.push(...matched);
+          }
+        } else {
+          tableNames.push(pattern);
+        }
+      }
+      tableNames = [...new Set(tableNames)].sort();
+      if (tableNames.length === 0) {
+        console.error("\n\u274C Error: No se encontraron tablas que coincidan con los patrones\n");
+        process.exit(1);
+      }
+      console.error(`
+Tablas a extraer (${tableNames.length}):`);
+      tableNames.forEach((t) => console.error(`  - ${t}`));
+      console.error("");
+    } else {
+      tableNames = tablePatterns;
+    }
+    console.error(`Extrayendo ${tableNames.length} tabla(s) de ${schema}...`);
+    const delayMs = options.delay ? parseInt(options.delay, 10) : hasWildcards ? 100 : 0;
     const results = await extractor.extractTables(options.tns, schema, tableNames, delayMs);
     const output = results.length === 1 ? results[0] : results;
     const json = options.pretty ? JSON.stringify(output, null, 2) : JSON.stringify(output);

package/dist/index.d.ts

@@ -70,6 +70,11 @@ declare class OracleService {
 declare class SchemaExtractor {
     private oracle;
     constructor(oracle: OracleService);
+    /**
+     * Lista tablas que coinciden con un patrón
+     * Convierte wildcards: * → %, ? → _
+     */
+    listTables(schema: string, pattern: string): Promise<string[]>;
     /**
      * Extrae el esquema completo de una tabla
      */
@@ -87,11 +92,12 @@ declare const TABLE_COMMENT = "\n  SELECT comments\n  FROM ALL_TAB_COMMENTS\n  W
 /**
  * Query para obtener las columnas de una tabla con sus metadatos
  * Incluye: nombre, comentario, tipo de dato, nullable, si es PK
+ * Usa CTE para evaluar la subquery de PK una sola vez
  */
-declare const TABLE_COLUMNS = "\n  SELECT\n    COLS.COLUMN_NAME as \"column_name\",\n    DESCRIP.COMMENTS as \"comment\",\n    COLS.DATA_TYPE as \"data_type\",\n    COLS.DATA_LENGTH as \"data_length\",\n    COLS.DATA_PRECISION as \"data_precision\",\n    COLS.NULLABLE as \"nullable\",\n    CASE WHEN PK.COLUMN_NAME IS NOT NULL THEN 'Y' ELSE 'N' END AS \"is_pk\"\n  FROM SYS.ALL_TAB_COLUMNS COLS\n  JOIN SYS.ALL_COL_COMMENTS DESCRIP\n    ON DESCRIP.OWNER = COLS.OWNER\n    AND DESCRIP.TABLE_NAME = COLS.TABLE_NAME\n    AND DESCRIP.COLUMN_NAME = COLS.COLUMN_NAME\n  LEFT JOIN (\n    SELECT acc.COLUMN_NAME\n    FROM ALL_CONSTRAINTS ac\n    JOIN ALL_CONS_COLUMNS acc\n      ON ac.OWNER = acc.OWNER\n      AND ac.CONSTRAINT_NAME = acc.CONSTRAINT_NAME\n    WHERE ac.CONSTRAINT_TYPE = 'P'\n      AND ac.OWNER = :schema\n      AND acc.TABLE_NAME = :tableName\n  ) PK ON PK.COLUMN_NAME = COLS.COLUMN_NAME\n  WHERE COLS.OWNER = :schema AND COLS.TABLE_NAME = :tableName\n  ORDER BY COLS.COLUMN_ID\n";
+declare const TABLE_COLUMNS = "\n  WITH PK_COLUMNS AS (\n    SELECT acc.COLUMN_NAME\n    FROM ALL_CONSTRAINTS ac\n    JOIN ALL_CONS_COLUMNS acc\n      ON ac.CONSTRAINT_NAME = acc.CONSTRAINT_NAME\n      AND ac.OWNER = acc.OWNER\n    WHERE ac.CONSTRAINT_TYPE = 'P'\n      AND ac.OWNER = :schema\n      AND ac.TABLE_NAME = :tableName\n  )\n  SELECT\n    COLS.COLUMN_NAME as \"column_name\",\n    DESCRIP.COMMENTS as \"comment\",\n    COLS.DATA_TYPE as \"data_type\",\n    COLS.DATA_LENGTH as \"data_length\",\n    COLS.DATA_PRECISION as \"data_precision\",\n    COLS.NULLABLE as \"nullable\",\n    CASE WHEN PK.COLUMN_NAME IS NOT NULL THEN 'Y' ELSE 'N' END AS \"is_pk\"\n  FROM ALL_TAB_COLUMNS COLS\n  JOIN ALL_COL_COMMENTS DESCRIP\n    ON DESCRIP.OWNER = COLS.OWNER\n    AND DESCRIP.TABLE_NAME = COLS.TABLE_NAME\n    AND DESCRIP.COLUMN_NAME = COLS.COLUMN_NAME\n  LEFT JOIN PK_COLUMNS PK ON PK.COLUMN_NAME = COLS.COLUMN_NAME\n  WHERE COLS.OWNER = :schema AND COLS.TABLE_NAME = :tableName\n  ORDER BY COLS.COLUMN_ID\n";
 /**
  * Query para obtener las tablas hijas (que tienen FK hacia esta tabla)
  */
-declare const TABLE_CHILDREN = "\n  SELECT DISTINCT ac_child.table_name AS \"child_table\"\n  FROM all_constraints ac_parent\n  JOIN all_constraints ac_child\n    ON ac_parent.constraint_name = ac_child.r_constraint_name\n    AND ac_parent.owner = ac_child.r_owner\n  WHERE ac_parent.owner = :schema\n    AND ac_parent.table_name = :tableName\n    AND ac_parent.constraint_type = 'P'\n    AND ac_child.constraint_type = 'R'\n    AND ac_child.status = 'ENABLED'\n";
+declare const TABLE_CHILDREN = "\n  SELECT DISTINCT ac_child.table_name AS \"child_table\"\n  FROM ALL_CONSTRAINTS ac_parent\n  JOIN ALL_CONSTRAINTS ac_child\n    ON ac_parent.constraint_name = ac_child.r_constraint_name\n    AND ac_parent.owner = ac_child.r_owner\n  WHERE ac_parent.owner = :schema\n    AND ac_parent.table_name = :tableName\n    AND ac_parent.constraint_type = 'P'\n    AND ac_child.constraint_type = 'R'\n    AND ac_child.status = 'ENABLED'\n";
 
 export { type ExtractOptions, type OracleColumn, type OracleConfig, OracleService, SchemaExtractor, TABLE_CHILDREN, TABLE_COLUMNS, TABLE_COMMENT, type TableSchema };

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   TABLE_CHILDREN,
   TABLE_COLUMNS,
   TABLE_COMMENT
-} from "./chunk-R65IT4N7.js";
+} from "./chunk-Q7WNFJU6.js";
 export {
   OracleService,
   SchemaExtractor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gzl10/osx-cli",
-  "version": "4.0.5",
+  "version": "4.0.7",
   "description": "Oracle Schema Extractor CLI - Genera JSON compatible con Atlas OriginType=BBDD",
   "type": "module",
   "bin": {