@gzl10/osx-cli 4.0.4 → 4.0.6

package/README.md

@@ -51,8 +51,15 @@ osx extract TABLA --tns PROD_DB
 # Multiples tablas
 osx extract TABLA1,TABLA2,TABLA3 --tns PROD_DB
 
-# Guardar en archivo
-osx extract TABLA --tns PROD_DB -o output.json --pretty
+# 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
+osx extract TABLA --tns PROD_DB -o output.json
 
 # Credenciales explicitas
 osx extract TABLA --tns PROD_DB -u USER -p PASS
@@ -64,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 |
@@ -72,7 +96,7 @@ osx extract TABLA --tns PROD_DB --schema OWNER_SCHEMA
 | `-s, --schema` | Schema Oracle (default: mismo que usuario) |
 | `-u, --user` | Usuario (o env: OSX_USER, o ~/.env USER) |
 | `-p, --password` | Password (o env: OSX_PASSWORD, o ~/.env PWD) |
-| `-o, --output` | Fichero salida (default: stdout) |
+| `-o, --output` | Fichero salida (sin nombre: auto, 1 tabla=TABLA.json, N tablas=extractYYYYMMDD.json) |
 | `--pretty` | JSON formateado |
 | `-d, --delay` | Delay entre tablas (ms) |
 

package/dist/{chunk-AI3SXYL3.js → chunk-XHMPD7KT.js}

@@ -88,6 +88,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 +106,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
@@ -126,16 +127,52 @@ var TABLE_CHILDREN = `
     AND ac_child.constraint_type = 'R'
     AND ac_child.status = 'ENABLED'
 `;
+var TABLE_STATS = `
+  SELECT NUM_ROWS as "count", LAST_ANALYZED as "last_update"
+  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) {
+  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
    */
-  async extractTable(schema, tableName) {
+  async extractTable(bbdd, schema, tableName) {
     const [commentRow] = await this.oracle.query(TABLE_COMMENT, {
       schema,
       tableName
@@ -148,21 +185,31 @@ var SchemaExtractor = class {
       schema,
       tableName
     });
+    const [statsRow] = await this.oracle.query(TABLE_STATS, {
+      schema,
+      tableName
+    });
+    const examplesQuery = buildExamplesQuery(schema, tableName, 10);
+    const examples = await this.oracle.query(examplesQuery, {});
     return {
+      bbdd,
       schema,
       name: tableName,
       comment: commentRow?.COMMENTS || "",
       columns,
-      children: childrenRows.map((r) => r.child_table)
+      children: childrenRows.map((r) => r.child_table),
+      count: statsRow?.count ?? 0,
+      lastUpdate: statsRow?.last_update?.toISOString() ?? null,
+      examples
     };
   }
   /**
    * Extrae múltiples tablas con delay opcional entre ellas
    */
-  async extractTables(schema, tableNames, delayMs = 0) {
+  async extractTables(bbdd, schema, tableNames, delayMs = 0) {
     const results = [];
     for (let i = 0; i < tableNames.length; i++) {
-      const table = await this.extractTable(schema, tableNames[i]);
+      const table = await this.extractTable(bbdd, schema, tableNames[i]);
       results.push(table);
       if (delayMs > 0 && i < tableNames.length - 1) {
         await new Promise((r) => setTimeout(r, delayMs));

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   OracleService,
   SchemaExtractor
-} from "./chunk-AI3SXYL3.js";
+} from "./chunk-XHMPD7KT.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,27 +132,69 @@ 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 results = await extractor.extractTables(schema, tableNames, delayMs);
+    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);
-    if (options.output) {
-      writeFileSync(options.output, json, "utf-8");
-      console.error(`Escrito: ${options.output}`);
+    let outputFile;
+    if (options.output === true) {
+      if (tableNames.length === 1) {
+        outputFile = `${tableNames[0]}.json`;
+      } else {
+        const now = /* @__PURE__ */ new Date();
+        const ts = now.toISOString().replace(/[-:T]/g, "").slice(0, 15);
+        outputFile = `extract${ts}.json`;
+      }
+    } else if (typeof options.output === "string") {
+      outputFile = options.output;
+    }
+    if (outputFile) {
+      writeFileSync(outputFile, json, "utf-8");
+      console.error(`Escrito: ${outputFile}`);
     } else {
       console.log(json);
     }
@@ -171,5 +212,5 @@ async function extractCommand(tables, options) {
 var __dirname2 = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync2(join2(__dirname2, "..", "package.json"), "utf-8"));
 program.name("osx").description("Oracle Schema Extractor - Genera JSON compatible con Atlas OriginType=BBDD").version(pkg.version);
-program.command("extract <tables>").description("Extrae esquema de tabla(s) Oracle. Tablas separadas por coma.").option("-t, --tns <alias>", "Alias TNS o Easy Connect (host:port/service)").option("-s, --schema <name>", "Schema Oracle (default: mismo que TNS)").option("-u, --user <user>", "Usuario Oracle (o env: OSX_USER)").option("-p, --password <pass>", "Password Oracle (o env: OSX_PASSWORD)").option("-o, --output <file>", "Fichero de salida (default: stdout)").option("--pretty", "JSON formateado con indentacion").option("-d, --delay <ms>", "Delay entre tablas en ms", "0").action(extractCommand);
+program.command("extract <tables>").description("Extrae esquema de tabla(s) Oracle. Tablas separadas por coma.").option("-t, --tns <alias>", "Alias TNS o Easy Connect (host:port/service)").option("-s, --schema <name>", "Schema Oracle (default: mismo que TNS)").option("-u, --user <user>", "Usuario Oracle (o env: OSX_USER)").option("-p, --password <pass>", "Password Oracle (o env: OSX_PASSWORD)").option("-o, --output [file]", "Fichero de salida (sin nombre: auto)").option("--pretty", "JSON formateado con indentacion").option("-d, --delay <ms>", "Delay entre tablas en ms", "0").action(extractCommand);
 program.parse();

package/dist/index.d.ts

@@ -14,11 +14,15 @@ interface OracleColumn {
  * Esquema de tabla compatible con Atlas OriginType=BBDD
  */
 interface TableSchema {
+    bbdd: string;
     schema: string;
     name: string;
     comment: string;
     columns: OracleColumn[];
     children: string[];
+    count: number;
+    lastUpdate: string | null;
+    examples: Record<string, unknown>[];
 }
 /**
  * Opciones del comando extract
@@ -28,7 +32,7 @@ interface ExtractOptions {
     schema?: string;
     user?: string;
     password?: string;
-    output?: string;
+    output?: string | true;
     pretty?: boolean;
     delay?: string;
 }
@@ -66,14 +70,19 @@ 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
      */
-    extractTable(schema: string, tableName: string): Promise<TableSchema>;
+    extractTable(bbdd: string, schema: string, tableName: string): Promise<TableSchema>;
     /**
      * Extrae múltiples tablas con delay opcional entre ellas
      */
-    extractTables(schema: string, tableNames: string[], delayMs?: number): Promise<TableSchema[]>;
+    extractTables(bbdd: string, schema: string, tableNames: string[], delayMs?: number): Promise<TableSchema[]>;
 }
 
 /**
@@ -83,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-AI3SXYL3.js";
+} from "./chunk-XHMPD7KT.js";
 export {
   OracleService,
   SchemaExtractor,

package/package.json

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