@drzl/cli 1.0.0 → 1.1.0

package/README.md

@@ -13,6 +13,20 @@ Analyze your Drizzle schema and generate validation, services, and routers.
 
 </div>
 
+## 💚 Sponsor DRZL
+
+<div align="center">
+
+<strong>DRZL is crafted nights & weekends. Sponsorships keep the generators fast, tested, and free.</strong>
+
+[![Sponsor DRZL](https://img.shields.io/badge/GitHub%20Sponsors-Support%20the%20project-ff69b4?logo=github)](https://github.com/sponsors/omar-dulaimi)
+
+</div>
+
+- Every dollar speeds up CI hardware and offsets long test runs on my aging laptop.
+- Sponsors get roadmap input and priority responses in GitHub Issues.
+- Prefer a quick overview? Check `docs/sponsor.md` for the current goals and thank-yous.
+
 ## Commands
 
 - Init: `pnpm dlx @drzl/cli init`

package/dist/cli.cjs

@@ -26,11 +26,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/cli.ts
 var import_analyzer = require("@drzl/analyzer");
 var import_generator_orpc = require("@drzl/generator-orpc");
-var import_chalk = __toESM(require("chalk"), 1);
+var import_chalk2 = __toESM(require("chalk"), 1);
 var import_chokidar = __toESM(require("chokidar"), 1);
 var import_cli_progress = __toESM(require("cli-progress"), 1);
 var import_commander = require("commander");
-var path2 = __toESM(require("path"), 1);
+var path3 = __toESM(require("path"), 1);
 var import_ora = __toESM(require("ora"), 1);
 
 // src/config.ts
@@ -182,9 +182,84 @@ function computeWatchTargets(cfg, cwd = process.cwd()) {
   return [...targets];
 }
 
+// src/sponsor.ts
+var import_chalk = __toESM(require("chalk"), 1);
+var import_node_fs = require("fs");
+var import_node_path = __toESM(require("path"), 1);
+var CACHE_DIR = import_node_path.default.join(process.cwd(), "node_modules", ".cache", "@drzl");
+var CACHE_FILE = import_node_path.default.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) => import_chalk.default.hex("#6ee7b7")(msg);
+var cyan = (msg) => import_chalk.default.cyan(msg);
+var gray = (msg) => import_chalk.default.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 {
+    (0, import_node_fs.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 (!(0, import_node_fs.existsSync)(CACHE_FILE)) {
+    return { runs: 0 };
+  }
+  try {
+    const data = JSON.parse((0, import_node_fs.readFileSync)(CACHE_FILE, "utf8"));
+    if (typeof data.runs !== "number") return { runs: 0 };
+    return data;
+  } catch {
+    return { runs: 0 };
+  }
+}
+function writeCache(payload) {
+  (0, import_node_fs.writeFileSync)(CACHE_FILE, JSON.stringify(payload, null, 2), "utf8");
+}
+
 // src/cli.ts
 var program = new import_commander.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 import_analyzer.SchemaAnalyzer(schema);
@@ -201,9 +276,9 @@ program.command("analyze").argument("<schema>", "path to drizzle schema (TS)").o
     } else if (opts.out) {
       const fs2 = await import("fs/promises");
       await fs2.writeFile(opts.out, json, "utf8");
-      spinner?.succeed(import_chalk.default.green(`Analysis written to ${opts.out} in ${ms}ms`));
+      spinner?.succeed(import_chalk2.default.green(`Analysis written to ${opts.out} in ${ms}ms`));
     } else {
-      spinner?.succeed(import_chalk.default.green(`Analyzed in ${ms}ms`));
+      spinner?.succeed(import_chalk2.default.green(`Analyzed in ${ms}ms`));
       console.log(json);
     }
     process.exit(res.issues.some((i) => i.level === "error") ? 2 : 0);
@@ -213,7 +288,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(
-        import_chalk.default.red("Analyze failed (DRZL_CLI_ANALYZE):"),
+        import_chalk2.default.red("Analyze failed (DRZL_CLI_ANALYZE):"),
         msg,
         "\nTip: run with --json for structured output."
       );
@@ -225,7 +300,7 @@ program.command("generate").description("Run configured generators (drzl.config.
     const cfg = await loadConfig(opts.config);
     if (!cfg) {
       console.error(
-        import_chalk.default.red("No config found (DRZL_CFG_001). Create drzl.config.ts or pass --config.")
+        import_chalk2.default.red("No config found (DRZL_CFG_001). Create drzl.config.ts or pass --config.")
       );
       process.exit(2);
       return;
@@ -260,8 +335,8 @@ program.command("generate").description("Run configured generators (drzl.config.
           onProgress: ({ index }) => progress.update(index)
         });
         progress.stop();
-        (0, import_ora.default)().succeed(import_chalk.default.green(`Generated (${g.kind}): ${files.length} files`));
-        files.forEach((f) => console.log("  -", import_chalk.default.cyan(f)));
+        (0, import_ora.default)().succeed(import_chalk2.default.green(`Generated (${g.kind}): ${files.length} files`));
+        files.forEach((f) => console.log("  -", import_chalk2.default.cyan(f)));
       } else if (g.kind === "service") {
         try {
           const { ServiceGenerator } = await import("@drzl/generator-service");
@@ -276,15 +351,15 @@ program.command("generate").description("Run configured generators (drzl.config.
             schemaImportPath: g.schemaImportPath
           });
           progress.stop();
-          (0, import_ora.default)().succeed(import_chalk.default.green(`Generated (service): ${files.length} files`));
-          files.forEach((f) => console.log("  -", import_chalk.default.cyan(f)));
+          (0, import_ora.default)().succeed(import_chalk2.default.green(`Generated (service): ${files.length} files`));
+          files.forEach((f) => console.log("  -", import_chalk2.default.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            import_chalk.default.red("Service generator missing."),
-            import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-service")
+            import_chalk2.default.red("Service generator missing."),
+            import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-service")
           );
-          console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+          console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       } else if (g.kind === "zod") {
@@ -300,15 +375,15 @@ program.command("generate").description("Run configured generators (drzl.config.
             fileSuffix: g.fileSuffix
           });
           progress.stop();
-          (0, import_ora.default)().succeed(import_chalk.default.green(`Generated (zod): ${files.length} files`));
-          files.forEach((f) => console.log("  -", import_chalk.default.cyan(f)));
+          (0, import_ora.default)().succeed(import_chalk2.default.green(`Generated (zod): ${files.length} files`));
+          files.forEach((f) => console.log("  -", import_chalk2.default.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            import_chalk.default.red("Zod generator missing."),
-            import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-zod")
+            import_chalk2.default.red("Zod generator missing."),
+            import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-zod")
           );
-          console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+          console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       } else if (g.kind === "valibot") {
@@ -324,15 +399,15 @@ program.command("generate").description("Run configured generators (drzl.config.
             fileSuffix: g.fileSuffix
           });
           progress.stop();
-          (0, import_ora.default)().succeed(import_chalk.default.green(`Generated (valibot): ${files.length} files`));
-          files.forEach((f) => console.log("  -", import_chalk.default.cyan(f)));
+          (0, import_ora.default)().succeed(import_chalk2.default.green(`Generated (valibot): ${files.length} files`));
+          files.forEach((f) => console.log("  -", import_chalk2.default.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            import_chalk.default.red("Valibot generator missing."),
-            import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-valibot")
+            import_chalk2.default.red("Valibot generator missing."),
+            import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-valibot")
           );
-          console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+          console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       } else if (g.kind === "arktype") {
@@ -348,22 +423,25 @@ program.command("generate").description("Run configured generators (drzl.config.
             fileSuffix: g.fileSuffix
           });
           progress.stop();
-          (0, import_ora.default)().succeed(import_chalk.default.green(`Generated (arktype): ${files.length} files`));
-          files.forEach((f) => console.log("  -", import_chalk.default.cyan(f)));
+          (0, import_ora.default)().succeed(import_chalk2.default.green(`Generated (arktype): ${files.length} files`));
+          files.forEach((f) => console.log("  -", import_chalk2.default.cyan(f)));
         } catch (e) {
           progress.stop();
           console.error(
-            import_chalk.default.red("ArkType generator missing."),
-            import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-arktype")
+            import_chalk2.default.red("ArkType generator missing."),
+            import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-arktype")
           );
-          console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+          console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
           process.exit(1);
         }
       }
     }
+    if (cfg.generators.length) {
+      maybeShowSponsorMessage({ reason: "generate" });
+    }
   } catch (e) {
     console.error(
-      import_chalk.default.red("Generate failed (DRZL_GEN_001):"),
+      import_chalk2.default.red("Generate failed (DRZL_GEN_001):"),
       e?.message ?? e,
       "\nTip: check your drzl.config.ts and template path."
     );
@@ -383,23 +461,24 @@ program.command("generate:orpc").argument("<schema>", "path to drizzle schema (T
       template: opts.template,
       includeRelations: !!opts.includeRelations
     });
-    console.log(import_chalk.default.green(`Generated:`), files.map((f) => import_chalk.default.cyan(f)).join(", "));
+    console.log(import_chalk2.default.green(`Generated:`), files.map((f) => import_chalk2.default.cyan(f)).join(", "));
+    maybeShowSponsorMessage({ reason: "generate:orpc" });
   } catch (e) {
-    console.error(import_chalk.default.red("Generate orpc failed:"), e?.message ?? e);
+    console.error(import_chalk2.default.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(import_chalk.default.red("No config found. Create drzl.config.ts or pass --config."));
+    console.error(import_chalk2.default.red("No config found. Create drzl.config.ts or pass --config."));
     process.exit(2);
     return;
   }
-  const abs = (p) => path2.resolve(process.cwd(), p);
+  const abs = (p) => path3.resolve(process.cwd(), p);
   const isInside = (child, parent) => {
-    const rel = path2.relative(parent, child);
-    return !!rel && !rel.startsWith("..") && !path2.isAbsolute(rel);
+    const rel = path3.relative(parent, child);
+    return !!rel && !rel.startsWith("..") && !path3.isAbsolute(rel);
   };
   const ignoredOutDirs = new Set(computeGeneratorOutputDirs(cfg).map(abs));
   const currentTargets = new Set(computeWatchTargets(cfg).map(abs));
@@ -478,7 +557,7 @@ program.command("watch").description("Watch schema and regenerate on changes").o
             })
           );
         } else {
-          console.log(import_chalk.default.green("Analyze complete."));
+          console.log(import_chalk2.default.green("Analyze complete."));
         }
         return;
       }
@@ -500,8 +579,8 @@ program.command("watch").description("Watch schema and regenerate on changes").o
             validation: g.validation
           });
           opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-            import_chalk.default.green(`Generated (${g.kind}):`),
-            files.map((f) => import_chalk.default.cyan(f)).join(", ")
+            import_chalk2.default.green(`Generated (${g.kind}):`),
+            files.map((f) => import_chalk2.default.cyan(f)).join(", ")
           );
           newFiles.push(...files);
         } else if (g.kind === "service") {
@@ -518,16 +597,16 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               schemaImportPath: g.schemaImportPath
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              import_chalk.default.green(`Generated (service): ${files.length} files`),
-              files.map((f) => import_chalk.default.cyan(f)).join(", ")
+              import_chalk2.default.green(`Generated (service): ${files.length} files`),
+              files.map((f) => import_chalk2.default.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              import_chalk.default.red("Service generator missing."),
-              import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-service")
+              import_chalk2.default.red("Service generator missing."),
+              import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-service")
             );
-            console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+            console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
             return;
           }
         } else if (g.kind === "zod") {
@@ -543,16 +622,16 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               fileSuffix: g.fileSuffix
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              import_chalk.default.green(`Generated (zod): ${files.length} files`),
-              files.map((f) => import_chalk.default.cyan(f)).join(", ")
+              import_chalk2.default.green(`Generated (zod): ${files.length} files`),
+              files.map((f) => import_chalk2.default.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              import_chalk.default.red("Zod generator missing."),
-              import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-zod")
+              import_chalk2.default.red("Zod generator missing."),
+              import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-zod")
             );
-            console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+            console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
             return;
           }
         } else if (g.kind === "valibot") {
@@ -568,16 +647,16 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               fileSuffix: g.fileSuffix
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              import_chalk.default.green(`Generated (valibot): ${files.length} files`),
-              files.map((f) => import_chalk.default.cyan(f)).join(", ")
+              import_chalk2.default.green(`Generated (valibot): ${files.length} files`),
+              files.map((f) => import_chalk2.default.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              import_chalk.default.red("Valibot generator missing."),
-              import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-valibot")
+              import_chalk2.default.red("Valibot generator missing."),
+              import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-valibot")
             );
-            console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+            console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
             return;
           }
         } else if (g.kind === "arktype") {
@@ -593,16 +672,16 @@ program.command("watch").description("Watch schema and regenerate on changes").o
               fileSuffix: g.fileSuffix
             });
             opts.json ? console.log(JSON.stringify({ event: "generate_complete", kind: g.kind, files })) : console.log(
-              import_chalk.default.green(`Generated (arktype): ${files.length} files`),
-              files.map((f) => import_chalk.default.cyan(f)).join(", ")
+              import_chalk2.default.green(`Generated (arktype): ${files.length} files`),
+              files.map((f) => import_chalk2.default.cyan(f)).join(", ")
             );
             newFiles.push(...files);
           } catch (e) {
             console.error(
-              import_chalk.default.red("ArkType generator missing."),
-              import_chalk.default.yellow("\nInstall with: npm install @drzl/generator-arktype")
+              import_chalk2.default.red("ArkType generator missing."),
+              import_chalk2.default.yellow("\nInstall with: npm install @drzl/generator-arktype")
             );
-            console.error(import_chalk.default.gray("Error details:"), e?.message ?? e);
+            console.error(import_chalk2.default.gray("Error details:"), e?.message ?? e);
             return;
           }
         }
@@ -610,12 +689,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(import_chalk.default.blue(`Added: ${added.join(", ")}`));
-        if (removed.length) console.log(import_chalk.default.yellow(`Removed: ${removed.join(", ")}`));
+        if (added.length) console.log(import_chalk2.default.blue(`Added: ${added.join(", ")}`));
+        if (removed.length) console.log(import_chalk2.default.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(import_chalk.default.red("Watch pipeline failed:"), e?.message ?? e);
+      opts.json ? console.log(JSON.stringify({ event: "error", message: String(e?.message ?? e) })) : console.error(import_chalk2.default.red("Watch pipeline failed:"), e?.message ?? e);
     }
   };
   const debounced = Number(opts.debounce) || 200;
@@ -640,18 +723,18 @@ program.command("watch").description("Watch schema and regenerate on changes").o
     );
   } else {
     console.log(
-      import_chalk.default.gray(
-        "Watching:\n  " + Array.from(currentTargets).map((p) => path2.relative(process.cwd(), p)).join("\n  ")
+      import_chalk2.default.gray(
+        "Watching:\n  " + Array.from(currentTargets).map((p) => path3.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(import_chalk.default.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(import_chalk2.default.red("Watcher error:"), err));
   await run();
 });
 program.command("init").description("Scaffold a drzl.config.ts").option("-y, --yes", "accept defaults").action(async (_opts) => {
   const fs2 = await import("fs/promises");
-  const path3 = await import("path");
-  const target = path3.resolve(process.cwd(), "drzl.config.ts");
+  const path4 = await import("path");
+  const target = path4.resolve(process.cwd(), "drzl.config.ts");
   const template = `export default {
   schema: 'src/db/schema.ts',
   outDir: 'src/api',
@@ -663,9 +746,9 @@ program.command("init").description("Scaffold a drzl.config.ts").option("-y, --y
 `;
   try {
     await fs2.writeFile(target, template, { flag: "wx" });
-    console.log(import_chalk.default.green(`Created ${target}`));
+    console.log(import_chalk2.default.green(`Created ${target}`));
   } catch (e) {
-    console.error(import_chalk.default.red("Init failed:"), e?.message ?? e);
+    console.error(import_chalk2.default.red("Init failed:"), e?.message ?? e);
     process.exit(1);
   }
 });