@gzl10/osx-cli 4.0.6 → 4.0.9

package/dist/{chunk-XHMPD7KT.js → chunk-7QQUO4HK.js}

@@ -47,14 +47,47 @@ var OracleService = class {
   connection = null;
   /**
    * Conecta a Oracle usando TNS
+   * Maneja errores ORA-XXXXX con mensajes descriptivos
    */
   async connect(config) {
+    if (!process.env.NLS_LANG) {
+      process.env.NLS_LANG = "SPANISH_SPAIN.AL32UTF8";
+    }
     initThickMode();
-    this.connection = await oracledb.getConnection({
-      user: config.user,
-      password: config.password,
-      connectString: config.tns
-    });
+    try {
+      this.connection = await oracledb.getConnection({
+        user: config.user,
+        password: config.password,
+        connectString: config.tns
+      });
+    } catch (err) {
+      const oraError = err;
+      const code = oraError.errorNum;
+      switch (code) {
+        case 12154:
+          throw new Error(
+            `TNS inv\xE1lido: No se pudo resolver '${config.tns}'. Verifica tnsnames.ora o usa formato host:puerto/servicio`
+          );
+        case 1017:
+          throw new Error(`Credenciales inv\xE1lidas para usuario '${config.user}'`);
+        case 12170:
+          throw new Error(
+            `Timeout de conexi\xF3n a '${config.tns}'. Verifica red/firewall`
+          );
+        case 28040:
+          throw new Error(
+            `Protocolo de autenticaci\xF3n incompatible. Verifica versi\xF3n de Oracle Instant Client`
+          );
+        case 12541:
+          throw new Error(
+            `No hay listener en '${config.tns}'. Verifica que el servicio Oracle est\xE9 activo`
+          );
+        default:
+          throw new Error(
+            `Error de conexi\xF3n Oracle: ${oraError.message || String(err)}`
+          );
+      }
+    }
   }
   /**
    * Ejecuta una query con parámetros nombrados
@@ -116,16 +149,56 @@ var TABLE_COLUMNS = `
   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
-    ON ac_parent.constraint_name = ac_child.r_constraint_name
-    AND ac_parent.owner = ac_child.r_owner
-  WHERE ac_parent.owner = :schema
-    AND ac_parent.table_name = :tableName
-    AND ac_parent.constraint_type = 'P'
-    AND ac_child.constraint_type = 'R'
-    AND ac_child.status = 'ENABLED'
+  WITH FK_RELATIONS AS (
+    SELECT
+      ac_child.owner AS child_owner,
+      ac_child.table_name AS child_table,
+      acc_child.column_name AS child_column,
+      acc_parent.column_name AS parent_column,
+      acc_child.position
+    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
+    JOIN ALL_CONS_COLUMNS acc_child
+      ON ac_child.constraint_name = acc_child.constraint_name
+      AND ac_child.owner = acc_child.owner
+    JOIN ALL_CONS_COLUMNS acc_parent
+      ON ac_parent.constraint_name = acc_parent.constraint_name
+      AND ac_parent.owner = acc_parent.owner
+      AND acc_child.position = acc_parent.position
+    WHERE ac_parent.owner = :schema
+      AND ac_parent.table_name = :tableName
+      AND ac_parent.constraint_type = 'P'
+      AND ac_child.constraint_type = 'R'
+      AND ac_child.status = 'ENABLED'
+  ),
+  UNIQUE_COLS AS (
+    SELECT DISTINCT
+      uc.owner,
+      uc.table_name,
+      ucc.column_name
+    FROM ALL_CONSTRAINTS uc
+    JOIN ALL_CONS_COLUMNS ucc
+      ON uc.constraint_name = ucc.constraint_name
+      AND uc.owner = ucc.owner
+    WHERE uc.constraint_type IN ('P', 'U')
+      AND (uc.owner, uc.table_name) IN (
+        SELECT DISTINCT child_owner, child_table FROM FK_RELATIONS
+      )
+  )
+  SELECT
+    fk.child_table AS "child_table",
+    fk.child_column AS "child_column",
+    fk.parent_column AS "parent_column",
+    fk.position AS "position",
+    CASE WHEN uc.column_name IS NOT NULL THEN '1:1' ELSE '1:N' END AS "cardinality"
+  FROM FK_RELATIONS fk
+  LEFT JOIN UNIQUE_COLS uc
+    ON uc.owner = fk.child_owner
+    AND uc.table_name = fk.child_table
+    AND uc.column_name = fk.child_column
+  ORDER BY fk.child_table, fk.position
 `;
 var TABLE_STATS = `
   SELECT NUM_ROWS as "count", LAST_ANALYZED as "last_update"
@@ -185,6 +258,23 @@ var SchemaExtractor = class {
       schema,
       tableName
     });
+    const childrenMap = /* @__PURE__ */ new Map();
+    for (const row of childrenRows) {
+      let relation = childrenMap.get(row.child_table);
+      if (!relation) {
+        relation = {
+          table: row.child_table,
+          cardinality: row.cardinality,
+          columns: []
+        };
+        childrenMap.set(row.child_table, relation);
+      }
+      relation.columns.push({
+        child: row.child_column,
+        parent: row.parent_column
+      });
+    }
+    const children = Array.from(childrenMap.values());
     const [statsRow] = await this.oracle.query(TABLE_STATS, {
       schema,
       tableName
@@ -197,7 +287,7 @@ var SchemaExtractor = class {
       name: tableName,
       comment: commentRow?.COMMENTS || "",
       columns,
-      children: childrenRows.map((r) => r.child_table),
+      children,
       count: statsRow?.count ?? 0,
       lastUpdate: statsRow?.last_update?.toISOString() ?? null,
       examples

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   OracleService,
   SchemaExtractor
-} from "./chunk-XHMPD7KT.js";
+} from "./chunk-7QQUO4HK.js";
 
 // src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";

package/dist/index.d.ts

@@ -10,6 +10,17 @@ interface OracleColumn {
     nullable: 'Y' | 'N';
     is_pk: 'Y' | 'N';
 }
+/**
+ * Representa una relación FK con una tabla hija
+ */
+interface ChildRelation {
+    table: string;
+    cardinality: '1:1' | '1:N';
+    columns: Array<{
+        child: string;
+        parent: string;
+    }>;
+}
 /**
  * Esquema de tabla compatible con Atlas OriginType=BBDD
  */
@@ -19,7 +30,7 @@ interface TableSchema {
     name: string;
     comment: string;
     columns: OracleColumn[];
-    children: string[];
+    children: ChildRelation[];
     count: number;
     lastUpdate: string | null;
     examples: Record<string, unknown>[];
@@ -52,6 +63,7 @@ declare class OracleService {
     private connection;
     /**
      * Conecta a Oracle usando TNS
+     * Maneja errores ORA-XXXXX con mensajes descriptivos
      */
     connect(config: OracleConfig): Promise<void>;
     /**
@@ -97,7 +109,10 @@ declare const TABLE_COMMENT = "\n  SELECT comments\n  FROM ALL_TAB_COMMENTS\n  W
 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)
+ * Incluye: columnas de la relación y cardinalidad inferida (1:1 si FK tiene UNIQUE/PK)
+ *
+ * Usa CTEs para evaluar UNIQUE_COLS una sola vez (evita EXISTS anidado por fila)
  */
-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  WITH FK_RELATIONS AS (\n    SELECT\n      ac_child.owner AS child_owner,\n      ac_child.table_name AS child_table,\n      acc_child.column_name AS child_column,\n      acc_parent.column_name AS parent_column,\n      acc_child.position\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    JOIN ALL_CONS_COLUMNS acc_child\n      ON ac_child.constraint_name = acc_child.constraint_name\n      AND ac_child.owner = acc_child.owner\n    JOIN ALL_CONS_COLUMNS acc_parent\n      ON ac_parent.constraint_name = acc_parent.constraint_name\n      AND ac_parent.owner = acc_parent.owner\n      AND acc_child.position = acc_parent.position\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  ),\n  UNIQUE_COLS AS (\n    SELECT DISTINCT\n      uc.owner,\n      uc.table_name,\n      ucc.column_name\n    FROM ALL_CONSTRAINTS uc\n    JOIN ALL_CONS_COLUMNS ucc\n      ON uc.constraint_name = ucc.constraint_name\n      AND uc.owner = ucc.owner\n    WHERE uc.constraint_type IN ('P', 'U')\n      AND (uc.owner, uc.table_name) IN (\n        SELECT DISTINCT child_owner, child_table FROM FK_RELATIONS\n      )\n  )\n  SELECT\n    fk.child_table AS \"child_table\",\n    fk.child_column AS \"child_column\",\n    fk.parent_column AS \"parent_column\",\n    fk.position AS \"position\",\n    CASE WHEN uc.column_name IS NOT NULL THEN '1:1' ELSE '1:N' END AS \"cardinality\"\n  FROM FK_RELATIONS fk\n  LEFT JOIN UNIQUE_COLS uc\n    ON uc.owner = fk.child_owner\n    AND uc.table_name = fk.child_table\n    AND uc.column_name = fk.child_column\n  ORDER BY fk.child_table, fk.position\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-XHMPD7KT.js";
+} from "./chunk-7QQUO4HK.js";
 export {
   OracleService,
   SchemaExtractor,

package/package.json

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