@gzl10/osx-cli 4.0.3 → 4.0.5

package/README.md

@@ -8,49 +8,88 @@ CLI para extraer esquemas de tablas Oracle y generar JSON compatible con Atlas.
 npm install -g @gzl10/osx-cli
 ```
 
+### Windows: Configurar PATH
+
+Agregar `%APPDATA%\npm` al PATH del sistema, o ejecutar antes de usar:
+
+```powershell
+$env:PATH += ";$env:APPDATA\npm"
+```
+
+## Configuracion Rapida
+
+Crea estos archivos en tu home (`~` o `%USERPROFILE%`):
+
+**~/.env** - Credenciales Oracle:
+
+```ini
+USER=tu_usuario
+PWD=tu_password
+```
+
+**~/tnsnames.ora** - Conexiones Oracle:
+
+```text
+PROD_DB=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=servidor)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)))
+```
+
+## Oracle Instant Client
+
+Requerido para bases de datos con autenticacion moderna. El CLI lo detecta automaticamente en:
+
+- **Windows:** `C:\oracle\instantclient_*`
+- **Linux/macOS:** `/opt/oracle/instantclient_*`
+
+[Descargar Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html)
+
 ## Uso
 
 ```bash
-# Una tabla
-osx extract CUSTOMERS --tns PROD_DB -u USER -p PASS
+# Uso basico (credenciales desde ~/.env)
+osx extract TABLA --tns PROD_DB
 
 # Multiples tablas
-osx extract CUSTOMERS,ORDERS --tns PROD_DB -u USER -p PASS -o output.json
+osx extract TABLA1,TABLA2,TABLA3 --tns PROD_DB
+
+# Guardar en archivo (nombre auto: TABLA.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
+
+# Easy Connect (sin tnsnames.ora)
+osx extract TABLA --tns "servidor:1521/servicio" -u USER -p PASS
 
-# Con variables de entorno
-export OSX_USER=USER OSX_PASSWORD=PASS
-osx extract PRODUCTS --tns PROD_DB --pretty
+# Extraer de un schema diferente al usuario
+osx extract TABLA --tns PROD_DB --schema OWNER_SCHEMA
 ```
 
 ## Opciones
 
 | Opcion | Descripcion |
 | ------ | ----------- |
-| `-t, --tns` | Alias TNS (requerido) |
-| `-s, --schema` | Schema Oracle (default: TNS) |
-| `-u, --user` | Usuario (o env: OSX_USER) |
-| `-p, --password` | Password (o env: OSX_PASSWORD) |
-| `-o, --output` | Fichero salida (default: stdout) |
+| `-t, --tns` | Alias TNS o Easy Connect (host:port/service) |
+| `-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 (sin nombre: auto, 1 tabla=TABLA.json, N tablas=extractYYYYMMDD.json) |
 | `--pretty` | JSON formateado |
 | `-d, --delay` | Delay entre tablas (ms) |
 
-## Requisitos
-
-- Node.js >= 20
-- Oracle Instant Client
-- Oracle Database 11g, 12c, 18c, 19c, 21c o 23ai
+## Prioridad de Credenciales
 
-## tnsnames.ora
+1. Flags de linea de comandos (`-u`, `-p`)
+2. Variables de entorno (`OSX_USER`, `OSX_PASSWORD`)
+3. Archivo `~/.env` (`USER`, `PWD`)
 
-```text
-PROD_DB =
-  (DESCRIPTION =
-    (ADDRESS = (PROTOCOL = TCP)(HOST = oracle.example.com)(PORT = 1521))
-    (CONNECT_DATA = (SERVICE_NAME = ORCL))
-  )
-```
+## Requisitos
 
-Variable de entorno: `TNS_ADMIN=/path/to/tnsnames`
+- Node.js >= 20
+- Oracle Instant Client (para BD con auth moderna)
+- Oracle Database 11g+
 
 ## Licencia
 

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

@@ -126,6 +126,14 @@ 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
+`;
+function buildExamplesQuery(schema, tableName, limit = 10) {
+  return `SELECT * FROM ${schema}.${tableName} ORDER BY ROWID DESC FETCH FIRST ${limit} ROWS ONLY`;
+}
 
 // src/services/SchemaExtractor.ts
 var SchemaExtractor = class {
@@ -135,7 +143,7 @@ var SchemaExtractor = class {
   /**
    * 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 +156,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-R65IT4N7.js";
 
 // src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";
@@ -120,7 +120,7 @@ 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 || options.tns;
+  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'
@@ -148,12 +148,24 @@ async function extractCommand(tables, options) {
     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 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 +183,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;
 }
@@ -69,11 +73,11 @@ declare class SchemaExtractor {
     /**
      * 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[]>;
 }
 
 /**

package/dist/index.js

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

package/package.json

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