@drzl/cli 1.0.0 → 2.0.0

package/dist/cli.js

@@ -3,19 +3,96 @@ import {
   computeGeneratorOutputDirs,
   computeWatchTargets,
   loadConfig
-} from "./chunk-MEPFGJIF.js";
+} from "./chunk-HHT7INUJ.js";
 
 // src/cli.ts
 import { SchemaAnalyzer } from "@drzl/analyzer";
 import { ORPCGenerator } from "@drzl/generator-orpc";
-import chalk from "chalk";
+import chalk2 from "chalk";
 import chokidar from "chokidar";
 import cliProgress from "cli-progress";
 import { Command } from "commander";
-import * as path from "path";
+import * as path2 from "path";
 import ora from "ora";
+
+// src/sponsor.ts
+import chalk from "chalk";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import path from "path";
+var CACHE_DIR = path.join(process.cwd(), "node_modules", ".cache", "@drzl");
+var CACHE_FILE = path.join(CACHE_DIR, "sponsor-message.json");
+var DEFAULT_INTERVAL_MS = 1e3 * 60 * 15;
+var shownThisProcess = false;
+var tips = [
+  "Pair DRZL watch mode with drizzle-kit to keep schema & API synced.",
+  "Templatize your ORPC routers to roll out new endpoints safely.",
+  "Need typed validators? Enable the zod, valibot, or arktype generators.",
+  "Use output headers to track generated files and trim noisy diffs."
+];
+var green = (msg) => chalk.hex("#6ee7b7")(msg);
+var cyan = (msg) => chalk.cyan(msg);
+var gray = (msg) => chalk.gray(msg);
+function maybeShowSponsorMessage({
+  reason = "generate",
+  minIntervalMs = DEFAULT_INTERVAL_MS,
+  force = false
+} = {}) {
+  const hideViaEnv = process.env.DRZL_HIDE_SPONSOR?.toLowerCase();
+  const hideRequested = hideViaEnv === "1" || hideViaEnv === "true";
+  if (hideRequested || process.env.CI && !force || shownThisProcess && !force) return;
+  try {
+    mkdirSync(CACHE_DIR, { recursive: true });
+    const payload = readCache();
+    payload.runs += 1;
+    const now = Date.now();
+    const shouldShow = force || now - (payload.lastShownAt ?? 0) >= minIntervalMs;
+    if (shouldShow) {
+      payload.lastShownAt = now;
+      payload.lastReason = reason;
+    }
+    writeCache(payload);
+    if (!shouldShow) return;
+    shownThisProcess = true;
+    const tip = tips[payload.runs % tips.length];
+    console.log(
+      `
+${cyan(`\u{1F680} DRZL finished a ${reason} run (#${payload.runs.toLocaleString()}).`)}
+
+${green("\u2728 Sponsors keep DRZL shipping. Consider supporting ongoing dev:")}
+  ${green("GitHub Sponsors")}  ${gray("\u2192 https://github.com/sponsors/omar-dulaimi")}
+
+${green("Pro tip:")} ${tip}
+`
+    );
+  } catch {
+  }
+}
+function readCache() {
+  if (!existsSync(CACHE_FILE)) {
+    return { runs: 0 };
+  }
+  try {
+    const data = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
+    if (typeof data.runs !== "number") return { runs: 0 };
+    return data;
+  } catch {
+    return { runs: 0 };
+  }
+}
+function writeCache(payload) {
+  writeFileSync(CACHE_FILE, JSON.stringify(payload, null, 2), "utf8");
+}
+
+// src/cli.ts
 var program = new Command();
 program.name("drzl").description("DRZL - Drizzle Developer Toolkit").version("0.0.1");
+program.addHelpText(
+  "afterAll",
+  `
+Need a template, adapter, or generator DRZL doesn't ship yet?
+\u2192 DM @omardulaimidev on X: https://x.com/omardulaimidev
+`
+);
 program.command("analyze").argument("<schema>", "path to drizzle schema (TS)").option("--relations", "include relations", true).option("--validate", "validate constraints", true).option("--out <file>", "write analysis JSON to file").option("--json", "print JSON to stdout (overrides --out)", false).action(async (schema, opts) => {
   try {
     const analyzer = new SchemaAnalyzer(schema);
@@ -32,9 +109,9 @@ program.command("analyze").argument("<schema>", "path to drizzle schema (TS)").o
     } else if (opts.out) {
       const fs = await import("fs/promises");
       await fs.writeFile(opts.out, json, "utf8");
-      spinner?.succeed(chalk.green(`Analysis written to ${opts.out} in ${ms}ms`));
+      spinner?.succeed(chalk2.green(`Analysis written to ${opts.out} in ${ms}ms`));
     } else {
-      spinner?.succeed(chalk.green(`Analyzed in ${ms}ms`));
+      spinner?.succeed(chalk2.green(`Analyzed in ${ms}ms`));
       console.log(json);
     }
     process.exit(res.issues.some((i) => i.level === "error") ? 2 : 0);
@@ -44,7 +121,7 @@ program.command("analyze").argument("<schema>", "path to drizzle schema (TS)").o
       console.log(JSON.stringify({ event: "error", code: "DRZL_CLI_ANALYZE", message: msg }));
     else
       console.error(
-        chalk.red("Analyze failed (DRZL_CLI_ANALYZE):"),
+        chalk2.red("Analyze failed (DRZL_CLI_ANALYZE):"),
         msg,
         "\nTip: run with --json for structured output."
       );
@@ -56,7 +133,7 @@ program.command("generate").description("Run configured generators (drzl.config.
     const cfg = await loadConfig(opts.config);
     if (!cfg) {
       console.error(
-        chalk.red("No config found (DRZL_CFG_001). Create drzl.config.ts or pass --config.")
+        chalk2.red("No config found (DRZL_CFG_001). Create drzl.config.ts or pass --config.")
       );
       process.exit(2);
       return;
@@ -87,12 +164,13 @@ program.command("generate").description("Run configured generators (drzl.config.
           outputHeader: g.outputHeader,
           format: g.format,
           templateOptions: g.templateOptions,
+          importExtension: g.importExtension,
           validation: g.validation,
           onProgress: ({ index }) => progress.update(index)
         });
         progress.stop();
-        ora().succeed(chalk.green(`Generated (${g.kind}): ${files.length} files`));
-        files.forEach((f) => console.log("  -", chalk.cyan(f)));
+        ora().succeed(chalk2.green(`Generated (${g.kind}): ${files.length} files`));
+        files.forEach((f) => console.log("  -", chalk2.cyan(f)));
       } else if (g.kind === "service") {
         try {
           const { ServiceGenerator } = await import("@drzl/generator-service");
@@ -104,18 +182,19 @@ program.command("generate").description("Run configured generators (drzl.config.
             format: g.format,
             dataAccess: g.dataAccess,
             dbImportPath: g.dbImportPath,
-            schemaImportPath: g.schemaImportPath
+            schemaImportPath: g.schemaImportPath,
+            importExtension: g.importExtension
           });
           progress.stop();
-          ora().succeed(chalk.green(`Generated (service): ${files.length} files`));
-          files.forEach((f) => console.log("  -", chalk.cyan(f)));
+          ora().succeed(chalk2.green(`Generated (service): ${files.length} files`));
+          files.forEach((f) => console.log("  -", chalk2.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            chalk.red("Service generator missing."),
-            chalk.yellow("\nInstall with: npm install @drzl/generator-service")
+            chalk2.red("Service generator missing."),
+            chalk2.yellow("\nInstall with: npm install @drzl/generator-service")
           );
-          console.error(chalk.gray("Error details:"), e?.message ?? e);
+          console.error(chalk2.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       } else if (g.kind === "zod") {
@@ -128,18 +207,20 @@ program.command("generate").description("Run configured generators (drzl.config.
             outputHeader: g.outputHeader,
             format: g.format,
             schemaSuffix: g.schemaSuffix,
-            fileSuffix: g.fileSuffix
+            fileSuffix: g.fileSuffix,
+            importExtension: g.importExtension,
+            affix: g.affix
           });
           progress.stop();
-          ora().succeed(chalk.green(`Generated (zod): ${files.length} files`));
-          files.forEach((f) => console.log("  -", chalk.cyan(f)));
+          ora().succeed(chalk2.green(`Generated (zod): ${files.length} files`));
+          files.forEach((f) => console.log("  -", chalk2.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            chalk.red("Zod generator missing."),
-            chalk.yellow("\nInstall with: npm install @drzl/generator-zod")
+            chalk2.red("Zod generator missing."),
+            chalk2.yellow("\nInstall with: npm install @drzl/generator-zod")
           );
-          console.error(chalk.gray("Error details:"), e?.message ?? e);
+          console.error(chalk2.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       } else if (g.kind === "valibot") {
@@ -152,18 +233,20 @@ program.command("generate").description("Run configured generators (drzl.config.
             outputHeader: g.outputHeader,
             format: g.format,
             schemaSuffix: g.schemaSuffix,
-            fileSuffix: g.fileSuffix
+            fileSuffix: g.fileSuffix,
+            importExtension: g.importExtension,
+            affix: g.affix
           });
           progress.stop();
-          ora().succeed(chalk.green(`Generated (valibot): ${files.length} files`));
-          files.forEach((f) => console.log("  -", chalk.cyan(f)));
+          ora().succeed(chalk2.green(`Generated (valibot): ${files.length} files`));
+          files.forEach((f) => console.log("  -", chalk2.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            chalk.red("Valibot generator missing."),
-            chalk.yellow("\nInstall with: npm install @drzl/generator-valibot")
+            chalk2.red("Valibot generator missing."),
+            chalk2.yellow("\nInstall with: npm install @drzl/generator-valibot")
           );
-          console.error(chalk.gray("Error details:"), e?.message ?? e);
+          console.error(chalk2.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       } else if (g.kind === "arktype") {
@@ -176,25 +259,30 @@ program.command("generate").description("Run configured generators (drzl.config.
             outputHeader: g.outputHeader,
             format: g.format,
             schemaSuffix: g.schemaSuffix,
-            fileSuffix: g.fileSuffix
+            fileSuffix: g.fileSuffix,
+            importExtension: g.importExtension,
+            affix: g.affix
           });
           progress.stop();
-          ora().succeed(chalk.green(`Generated (arktype): ${files.length} files`));
-          files.forEach((f) => console.log("  -", chalk.cyan(f)));
+          ora().succeed(chalk2.green(`Generated (arktype): ${files.length} files`));
+          files.forEach((f) => console.log("  -", chalk2.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            chalk.red("ArkType generator missing."),
-            chalk.yellow("\nInstall with: npm install @drzl/generator-arktype")
+            chalk2.red("ArkType generator missing."),
+            chalk2.yellow("\nInstall with: npm install @drzl/generator-arktype")
           );
-          console.error(chalk.gray("Error details:"), e?.message ?? e);
+          console.error(chalk2.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       }
     }
+    if (cfg.generators.length) {
+      maybeShowSponsorMessage({ reason: "generate" });
+    }
   } catch (e) {
     console.error(
-      chalk.red("Generate failed (DRZL_GEN_001):"),
+      chalk2.red("Generate failed (DRZL_GEN_001):"),
       e?.message ?? e,
       "\nTip: check your drzl.config.ts and template path."
     );
@@ -214,23 +302,24 @@ program.command("generate:orpc").argument("<schema>", "path to drizzle schema (T
       template: opts.template,
       includeRelations: !!opts.includeRelations
     });
-    console.log(chalk.green(`Generated:`), files.map((f) => chalk.cyan(f)).join(", "));
+    console.log(chalk2.green(`Generated:`), files.map((f) => chalk2.cyan(f)).join(", "));
+    maybeShowSponsorMessage({ reason: "generate:orpc" });
   } catch (e) {
-    console.error(chalk.red("Generate orpc failed:"), e?.message ?? e);
+    console.error(chalk2.red("Generate orpc failed:"), e?.message ?? e);
     process.exit(1);
   }
 });
 program.command("watch").description("Watch schema and regenerate on changes").option("-c, --config <path>", "path to drzl.config").option("--pipeline <name>", "all | analyze | generate-orpc", "all").option("--debounce <ms>", "debounce ms", "200").option("--json", "emit JSON logs", false).option("--poll", "force polling (helps WSL/Docker/remote FS)", false).action(async (opts) => {
   let cfg = await loadConfig(opts.config);
   if (!cfg) {
-    console.error(chalk.red("No config found. Create drzl.config.ts or pass --config."));
+    console.error(chalk2.red("No config found. Create drzl.config.ts or pass --config."));
     process.exit(2);
     return;
   }
-  const abs = (p) => path.resolve(process.cwd(), p);
+  const abs = (p) => path2.resolve(process.cwd(), p);
   const isInside = (child, parent) => {
-    const rel = path.relative(parent, child);
-    return !!rel && !rel.startsWith("..") && !path.isAbsolute(rel);
+    const rel = path2.relative(parent, child);
+    return !!rel && !rel.startsWith("..") && !path2.isAbsolute(rel);
   };
   const ignoredOutDirs = new Set(computeGeneratorOutputDirs(cfg).map(abs));
   const currentTargets = new Set(computeWatchTargets(cfg).map(abs));
@@ -309,7 +398,7 @@ program.command("watch").description("Watch schema and regenerate on changes").o
             })
           );
         } else {
-          console.log(chalk.green("Analyze complete."));
+          console.log(chalk2.green("Analyze complete."));
         }
         return;
       }
@@ -328,11 +417,12 @@ program.command("watch").description("Watch schema and regenerate on changes").o
             outputHeader: g.outputHeader,
             format: g.format,
             templateOptions: g.templateOptions,
+            importExtension: g.importExtension,
             validation: g.validation
           });
           opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-            chalk.green(`Generated (${g.kind}):`),
-            files.map((f) => chalk.cyan(f)).join(", ")
+            chalk2.green(`Generated (${g.kind}):`),
+            files.map((f) => chalk2.cyan(f)).join(", ")
           );
           newFiles.push(...files);
         } else if (g.kind === "service") {
@@ -346,19 +436,20 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               format: g.format,
               dataAccess: g.dataAccess,
               dbImportPath: g.dbImportPath,
-              schemaImportPath: g.schemaImportPath
+              schemaImportPath: g.schemaImportPath,
+              importExtension: g.importExtension
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              chalk.green(`Generated (service): ${files.length} files`),
-              files.map((f) => chalk.cyan(f)).join(", ")
+              chalk2.green(`Generated (service): ${files.length} files`),
+              files.map((f) => chalk2.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              chalk.red("Service generator missing."),
-              chalk.yellow("\nInstall with: npm install @drzl/generator-service")
+              chalk2.red("Service generator missing."),
+              chalk2.yellow("\nInstall with: npm install @drzl/generator-service")
             );
-            console.error(chalk.gray("Error details:"), e?.message ?? e);
+            console.error(chalk2.gray("Error details:"), e?.message ?? e);
             return;
           }
         } else if (g.kind === "zod") {
@@ -371,19 +462,21 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               outputHeader: g.outputHeader,
               format: g.format,
               schemaSuffix: g.schemaSuffix,
-              fileSuffix: g.fileSuffix
+              fileSuffix: g.fileSuffix,
+              importExtension: g.importExtension,
+              affix: g.affix
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              chalk.green(`Generated (zod): ${files.length} files`),
-              files.map((f) => chalk.cyan(f)).join(", ")
+              chalk2.green(`Generated (zod): ${files.length} files`),
+              files.map((f) => chalk2.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              chalk.red("Zod generator missing."),
-              chalk.yellow("\nInstall with: npm install @drzl/generator-zod")
+              chalk2.red("Zod generator missing."),
+              chalk2.yellow("\nInstall with: npm install @drzl/generator-zod")
             );
-            console.error(chalk.gray("Error details:"), e?.message ?? e);
+            console.error(chalk2.gray("Error details:"), e?.message ?? e);
             return;
           }
         } else if (g.kind === "valibot") {
@@ -396,19 +489,21 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               outputHeader: g.outputHeader,
               format: g.format,
               schemaSuffix: g.schemaSuffix,
-              fileSuffix: g.fileSuffix
+              fileSuffix: g.fileSuffix,
+              importExtension: g.importExtension,
+              affix: g.affix
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              chalk.green(`Generated (valibot): ${files.length} files`),
-              files.map((f) => chalk.cyan(f)).join(", ")
+              chalk2.green(`Generated (valibot): ${files.length} files`),
+              files.map((f) => chalk2.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              chalk.red("Valibot generator missing."),
-              chalk.yellow("\nInstall with: npm install @drzl/generator-valibot")
+              chalk2.red("Valibot generator missing."),
+              chalk2.yellow("\nInstall with: npm install @drzl/generator-valibot")
             );
-            console.error(chalk.gray("Error details:"), e?.message ?? e);
+            console.error(chalk2.gray("Error details:"), e?.message ?? e);
             return;
           }
         } else if (g.kind === "arktype") {
@@ -421,19 +516,21 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               outputHeader: g.outputHeader,
               format: g.format,
               schemaSuffix: g.schemaSuffix,
-              fileSuffix: g.fileSuffix
+              fileSuffix: g.fileSuffix,
+              importExtension: g.importExtension,
+              affix: g.affix
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              chalk.green(`Generated (arktype): ${files.length} files`),
-              files.map((f) => chalk.cyan(f)).join(", ")
+              chalk2.green(`Generated (arktype): ${files.length} files`),
+              files.map((f) => chalk2.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              chalk.red("ArkType generator missing."),
-              chalk.yellow("\nInstall with: npm install @drzl/generator-arktype")
+              chalk2.red("ArkType generator missing."),
+              chalk2.yellow("\nInstall with: npm install @drzl/generator-arktype")
             );
-            console.error(chalk.gray("Error details:"), e?.message ?? e);
+            console.error(chalk2.gray("Error details:"), e?.message ?? e);
             return;
           }
         }
@@ -441,12 +538,16 @@ program.command("watch").description("Watch schema and regenerate on changes").o
       const added = newFiles.filter((f) => !lastFiles.includes(f));
       const removed = lastFiles.filter((f) => !newFiles.includes(f));
       opts.json ? console.log(JSON.stringify({ event: "diff", added, removed })) : (() => {
-        if (added.length) console.log(chalk.blue(`Added: ${added.join(", ")}`));
-        if (removed.length) console.log(chalk.yellow(`Removed: ${removed.join(", ")}`));
+        if (added.length) console.log(chalk2.blue(`Added: ${added.join(", ")}`));
+        if (removed.length) console.log(chalk2.yellow(`Removed: ${removed.join(", ")}`));
       })();
+      if (newFiles.length && !opts.json) {
+        const reason = opts.pipeline && opts.pipeline !== "all" ? `watch:${opts.pipeline}` : "watch";
+        maybeShowSponsorMessage({ reason });
+      }
       lastFiles = newFiles;
     } catch (e) {
-      opts.json ? console.log(JSON.stringify({ event: "error", message: String(e?.message ?? e) })) : console.error(chalk.red("Watch pipeline failed:"), e?.message ?? e);
+      opts.json ? console.log(JSON.stringify({ event: "error", message: String(e?.message ?? e) })) : console.error(chalk2.red("Watch pipeline failed:"), e?.message ?? e);
     }
   };
   const debounced = Number(opts.debounce) || 200;
@@ -471,18 +572,18 @@ program.command("watch").description("Watch schema and regenerate on changes").o
     );
   } else {
     console.log(
-      chalk.gray(
-        "Watching:\n  " + Array.from(currentTargets).map((p) => path.relative(process.cwd(), p)).join("\n  ")
+      chalk2.gray(
+        "Watching:\n  " + Array.from(currentTargets).map((p) => path2.relative(process.cwd(), p)).join("\n  ")
       )
     );
   }
-  watcher.on("add", (p) => trigger(p)).on("change", (p) => trigger(p)).on("unlink", (p) => trigger(p)).on("error", (err) => console.error(chalk.red("Watcher error:"), err));
+  watcher.on("add", (p) => trigger(p)).on("change", (p) => trigger(p)).on("unlink", (p) => trigger(p)).on("error", (err) => console.error(chalk2.red("Watcher error:"), err));
   await run();
 });
 program.command("init").description("Scaffold a drzl.config.ts").option("-y, --yes", "accept defaults").action(async (_opts) => {
   const fs = await import("fs/promises");
-  const path2 = await import("path");
-  const target = path2.resolve(process.cwd(), "drzl.config.ts");
+  const path3 = await import("path");
+  const target = path3.resolve(process.cwd(), "drzl.config.ts");
   const template = `export default {
   schema: 'src/db/schema.ts',
   outDir: 'src/api',
@@ -494,9 +595,9 @@ program.command("init").description("Scaffold a drzl.config.ts").option("-y, --y
 `;
   try {
     await fs.writeFile(target, template, { flag: "wx" });
-    console.log(chalk.green(`Created ${target}`));
+    console.log(chalk2.green(`Created ${target}`));
   } catch (e) {
-    console.error(chalk.red("Init failed:"), e?.message ?? e);
+    console.error(chalk2.red("Init failed:"), e?.message ?? e);
     process.exit(1);
   }
 });