@ddt-tools/cli 0.2.0 → 0.2.5

package/dist/import-script-R5RXPDH6.js

@@ -0,0 +1,79 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/import-script.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { importScript, loadProject, parseScript } from "@ddt-tools/core";
+function importScriptCommand() {
+  const cmd = new Command("import-script");
+  cmd.description(
+    "Parse a SQL script and write each DDL statement into the .ddtproj tree under its canonical folder."
+  ).requiredOption("--script <path>", "Path to the SQL script to import.").requiredOption("-p, --project <path>", "Path to the .ddtproj file.").option("--dry-run", "Report what would be written without touching disk.", false).option("--force", "Overwrite existing files (default refuses on conflict).", false).option(
+    "--ignore-errors",
+    "Import classifiable statements even when others have errors. Default refuses on any error.",
+    false
+  ).action(async (opts) => {
+    const scriptPath = path.resolve(String(opts.script));
+    const projectPath = path.resolve(String(opts.project));
+    const sql = await fs.readFile(scriptPath, "utf8");
+    const parsed = parseScript(sql);
+    printParseReport(scriptPath, parsed);
+    if (parsed.totalErrors > 0 && !opts.ignoreErrors) {
+      console.error(
+        `
+Refusing to import: ${parsed.totalErrors} parse error(s) above. Fix the script and re-run, or pass --ignore-errors to import the clean statements.`
+      );
+      process.exitCode = 2;
+      return;
+    }
+    const loaded = await loadProject(projectPath);
+    const result = await importScript(parsed, loaded, {
+      dryRun: !!opts.dryRun,
+      force: !!opts.force
+    });
+    console.log("");
+    const verb = opts.dryRun ? "would write" : "wrote";
+    for (const item of result.imported) {
+      const rel = path.relative(loaded.rootDir, item.targetPath);
+      console.log(
+        `  ${verb}  ${item.statement.objectType} ${qualified(item.statement)} \u2192 ${rel}`
+      );
+    }
+    for (const item of result.skipped) {
+      const head = item.statement.objectType && item.statement.fqn ? `${item.statement.objectType} ${qualified(item.statement)}` : `<unclassified statement at line ${item.statement.startLine}>`;
+      console.log(`  skip   ${head} \u2014 ${item.reason}`);
+    }
+    console.log("");
+    console.log(
+      `Summary: ${result.imported.length} ${verb}, ${result.skipped.length} skipped, ${parsed.totalErrors} errors, ${parsed.totalWarnings} warnings.`
+    );
+    if (result.imported.length === 0 && result.skipped.length > 0) {
+      process.exitCode = 1;
+    }
+  });
+  return cmd;
+}
+function qualified(stmt) {
+  if (!stmt.fqn) return "<no fqn>";
+  return [stmt.fqn.database, stmt.fqn.schema, stmt.fqn.name].filter(Boolean).join(".");
+}
+function printParseReport(scriptPath, parsed) {
+  console.log(`Parsed ${parsed.statements.length} statement(s) from ${scriptPath}.`);
+  if (parsed.totalErrors === 0 && parsed.totalWarnings === 0) {
+    console.log("All statements classified cleanly.");
+    return;
+  }
+  for (const stmt of parsed.statements) {
+    if (stmt.errors.length === 0 && stmt.warnings.length === 0) continue;
+    const head = stmt.objectType && stmt.fqn ? `${stmt.objectType} ${qualified(stmt)}` : "<unclassified>";
+    console.log(`
+[line ${stmt.startLine}\u2013${stmt.endLine}] ${head}`);
+    for (const e of stmt.errors) console.log(`  ERROR:   ${e}`);
+    for (const w of stmt.warnings) console.log(`  warning: ${w}`);
+  }
+}
+export {
+  importScriptCommand
+};
+//# sourceMappingURL=import-script-R5RXPDH6.js.map

package/dist/import-script-R5RXPDH6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/import-script.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport { importScript, loadProject, parseScript, type ParsedStatement } from '@ddt-tools/core';\n\n/**\n * `ddt import-script` — parse a SQL script and apply each DDL statement to a\n * `.ddtproj` tree, writing each into the canonical folder for its object\n * type (`catalogs/<cat>/schemas/<sch>/<type-folder>/<name>.sql`).\n *\n * This is the script→tree splitter. For converting another tool's artifacts\n * (Liquibase / Flyway / dbt / Terraform / …) into a fresh project, use\n * `ddt import` instead. Byte-aligned with `sdt import-script`.\n *\n * Default mode is safe:\n *   - Parses the whole script first; refuses to write anything if any\n *     statement has hard errors. The user reviews the report, fixes the\n *     script, and re-runs.\n *   - Refuses to overwrite existing files. Pass `--force` to clobber.\n *   - `--dry-run` shows the plan without writing.\n */\nexport function importScriptCommand(): Command {\n  const cmd = new Command('import-script');\n  cmd\n    .description(\n      'Parse a SQL script and write each DDL statement into the .ddtproj tree under its canonical folder.',\n    )\n    .requiredOption('--script <path>', 'Path to the SQL script to import.')\n    .requiredOption('-p, --project <path>', 'Path to the .ddtproj file.')\n    .option('--dry-run', 'Report what would be written without touching disk.', false)\n    .option('--force', 'Overwrite existing files (default refuses on conflict).', false)\n    .option(\n      '--ignore-errors',\n      'Import classifiable statements even when others have errors. Default refuses on any error.',\n      false,\n    )\n    .action(async (opts) => {\n      const scriptPath = path.resolve(String(opts.script));\n      const projectPath = path.resolve(String(opts.project));\n      const sql = await fs.readFile(scriptPath, 'utf8');\n      const parsed = parseScript(sql);\n\n      // Up-front parse report — surfaces every error/warning verbatim.\n      printParseReport(scriptPath, parsed);\n\n      if (parsed.totalErrors > 0 && !opts.ignoreErrors) {\n        console.error(\n          `\\nRefusing to import: ${parsed.totalErrors} parse error(s) above. ` +\n            `Fix the script and re-run, or pass --ignore-errors to import the clean statements.`,\n        );\n        process.exitCode = 2;\n        return;\n      }\n\n      const loaded = await loadProject(projectPath);\n      const result = await importScript(parsed, loaded, {\n        dryRun: !!opts.dryRun,\n        force: !!opts.force,\n      });\n\n      console.log('');\n      const verb = opts.dryRun ? 'would write' : 'wrote';\n      for (const item of result.imported) {\n        const rel = path.relative(loaded.rootDir, item.targetPath);\n        console.log(\n          `  ${verb}  ${item.statement.objectType} ${qualified(item.statement)} → ${rel}`,\n        );\n      }\n      for (const item of result.skipped) {\n        const head =\n          item.statement.objectType && item.statement.fqn\n            ? `${item.statement.objectType} ${qualified(item.statement)}`\n            : `<unclassified statement at line ${item.statement.startLine}>`;\n        console.log(`  skip   ${head} — ${item.reason}`);\n      }\n      console.log('');\n      console.log(\n        `Summary: ${result.imported.length} ${verb}, ${result.skipped.length} skipped, ` +\n          `${parsed.totalErrors} errors, ${parsed.totalWarnings} warnings.`,\n      );\n\n      if (result.imported.length === 0 && result.skipped.length > 0) {\n        process.exitCode = 1;\n      }\n    });\n  return cmd;\n}\n\nfunction qualified(stmt: ParsedStatement): string {\n  if (!stmt.fqn) return '<no fqn>';\n  return [stmt.fqn.database, stmt.fqn.schema, stmt.fqn.name].filter(Boolean).join('.');\n}\n\nfunction printParseReport(scriptPath: string, parsed: ReturnType<typeof parseScript>): void {\n  console.log(`Parsed ${parsed.statements.length} statement(s) from ${scriptPath}.`);\n  if (parsed.totalErrors === 0 && parsed.totalWarnings === 0) {\n    console.log('All statements classified cleanly.');\n    return;\n  }\n  for (const stmt of parsed.statements) {\n    if (stmt.errors.length === 0 && stmt.warnings.length === 0) continue;\n    const head =\n      stmt.objectType && stmt.fqn ? `${stmt.objectType} ${qualified(stmt)}` : '<unclassified>';\n    console.log(`\\n[line ${stmt.startLine}–${stmt.endLine}] ${head}`);\n    for (const e of stmt.errors) console.log(`  ERROR:   ${e}`);\n    for (const w of stmt.warnings) console.log(`  warning: ${w}`);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -28,8 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   catalogCommand: () => catalogCommand,
   compareProfilesCommand: () => compareProfilesCommand,
   connectionCommand: () => connectionCommand,
@@ -42,20 +42,26 @@ __export(index_exports, {
   searchCommand: () => searchCommand,
   sketchCommand: () => sketchCommand
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 
 // src/commands/connection.ts
 var import_commander = require("commander");
 var import_core = require("@ddt-tools/core");
 function connectionCommand() {
   const cmd = new import_commander.Command("connection").description("Manage Databricks connection profiles.");
-  cmd.command("add <name>").description("Store a new connection profile.").option("--host <host>", "Workspace host, e.g. dbc-12345-abcd.cloud.databricks.com").option("--auth <method>", "One of: pat | oauth-m2m | oauth-u2m | azure-ad | google-idc", "pat").option(
+  cmd.command("add [name]").description("Store a new connection profile.").option("--name <name>", "Profile name (flag form of the positional name arg)").option("--host <host>", "Workspace host, e.g. dbc-12345-abcd.cloud.databricks.com").option("--auth <method>", "One of: pat | oauth-m2m | oauth-u2m | azure-ad | google-idc", "pat").option(
     "--token <token>",
     "PAT token \u2014 use env:DATABRICKS_TOKEN to reference an env var, never inline a secret"
   ).option("--client-id <id>", "OAuth M2M / Azure AD client ID").option("--client-secret <secret>", "OAuth M2M / Azure AD client secret").option("--tenant-id <id>", "Azure AD tenant ID").option(
     "--service-account-key-path <path>",
     "Path to a GCP service-account key JSON file (for google-idc auth)"
-  ).requiredOption("--warehouse-id <id>", "SQL warehouse ID for DDL operations").option("--catalog <catalog>", "Default Unity Catalog catalog").option("--schema <schema>", "Default schema").action(async (name, opts) => {
+  ).requiredOption("--warehouse-id <id>", "SQL warehouse ID for DDL operations").option("--catalog <catalog>", "Default Unity Catalog catalog").option("--schema <schema>", "Default schema").action(async (nameArg, opts) => {
+    const name = opts.name ? String(opts.name) : nameArg ?? "";
+    if (!name) {
+      throw new Error(
+        "connection add needs a profile name \u2014 pass it positionally (`ddt connection add <name>`) or via `--name`."
+      );
+    }
     if (!opts.host) throw new Error("--host is required");
     const auth = buildAuth(opts);
     const profile = {