@forinda/kickjs-cli 5.0.1 → 5.1.0

package/dist/{typegen-Ebxm_Bhz.mjs → typegen-BNz_RQTb.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.0.1
+ * @forinda/kickjs-cli v5.1.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,9 +8,10 @@
  *
  * @license MIT
  */
+import { t as __exportAll } from "./rolldown-runtime-BM29JyaJ.mjs";
+import { statSync } from "node:fs";
 import { dirname, extname, join, relative, resolve, sep } from "node:path";
 import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import { statSync } from "node:fs";
 import { globSync } from "glob";
 //#region src/typegen/scanner.ts
 /** Decorators that mark a class as DI-managed */
@@ -1374,6 +1375,10 @@ function suggestRename(name) {
 *
 * @module @forinda/kickjs-cli/typegen
 */
+var typegen_exports = /* @__PURE__ */ __exportAll({
+	runTypegen: () => runTypegen,
+	watchTypegen: () => watchTypegen
+});
 /** Resolve options to absolute paths */
 function resolveOptions(opts) {
 	const cwd = opts.cwd ?? process.cwd();
@@ -1444,7 +1449,82 @@ async function runTypegen(opts = {}) {
 		tokenWarnings
 	};
 }
+/**
+* Watch mode for `kick typegen --watch`.
+*
+* Uses Node's built-in `fs.watch` (recursive, available on Linux 22+ and
+* macOS 19+). Falls back gracefully if recursive watch is not supported.
+*
+* Debounces re-runs by 100ms so a bulk file change (e.g. `kick g module`
+* creating 5 files at once) emits one regen, not five.
+*
+* In watch mode collisions are reported but never thrown — the watcher
+* keeps running so the user can fix the rename and the next scan
+* recovers automatically.
+*
+* Returns a `stop()` function that closes the watcher.
+*/
+async function watchTypegen(opts = {}) {
+	const resolved = resolveOptions(opts);
+	const { srcDir, silent, cwd } = resolved;
+	const runOpts = {
+		...resolved,
+		allowDuplicates: true
+	};
+	const [{ runAllPluginTypegens }, { loadKickConfig }] = await Promise.all([import("./builtins-Cb_d-b1S.mjs").then((n) => n.r), import("./config-8bAt-mLl.mjs").then((n) => n.n)]);
+	const pluginConfig = await loadKickConfig(cwd);
+	const runPlugins = () => runAllPluginTypegens({
+		cwd,
+		config: pluginConfig,
+		silent: true
+	}).catch(() => {});
+	await safeRun(runOpts, silent);
+	await runPlugins();
+	const { watch } = await import("node:fs");
+	let timer = null;
+	const trigger = (filename) => {
+		if (!filename) return;
+		if (!/\.(ts|tsx|mts|cts)$/.test(filename)) return;
+		if (filename.includes(".kickjs")) return;
+		if (filename.endsWith(".d.ts")) return;
+		if (timer) clearTimeout(timer);
+		timer = setTimeout(() => {
+			safeRun(runOpts, silent);
+			runPlugins();
+		}, 100);
+	};
+	let watcher;
+	try {
+		watcher = watch(srcDir, { recursive: true }, (_event, filename) => {
+			trigger(filename);
+		});
+	} catch (err) {
+		if (!silent) console.warn(`  kick typegen: watch mode unavailable (${err?.message ?? err}). Falling back to polling.`);
+		const interval = setInterval(() => {
+			safeRun({
+				...runOpts,
+				silent: true
+			}, true);
+		}, 2e3);
+		return () => clearInterval(interval);
+	}
+	return () => {
+		if (timer) clearTimeout(timer);
+		watcher.close();
+	};
+}
+/** Run typegen swallowing errors so the watcher loop never dies */
+async function safeRun(opts, silent) {
+	try {
+		await runTypegen(opts);
+	} catch (err) {
+		if (silent) return;
+		if (err instanceof TokenCollisionError) console.error("\n" + err.message + "\n");
+		else {
+			const msg = err instanceof Error ? err.message : String(err);
+			console.error(`  kick typegen failed: ${msg}`);
+		}
+	}
+}
 //#endregion
-export { runTypegen };
-
-//# sourceMappingURL=typegen-Ebxm_Bhz.mjs.map
+export { discoverAssets as a, TokenCollisionError as i, typegen_exports as n, renderAssetTypes as o, watchTypegen as r, runTypegen as t };

package/dist/types-BBUo1vXh.mjs

@@ -0,0 +1,25 @@
+/**
+ * @forinda/kickjs-cli v5.1.0
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+//#region src/plugin/types.ts
+/** Identity helper — exists for type inference + parity with definePlugin. */
+function defineCliPlugin(p) {
+	return p;
+}
+var KickPluginConflictError = class extends Error {
+	constructor(kind, id, owners) {
+		super(`Two plugins registered the same ${kind} '${id}': ${owners.join(", ")}. Plugins must use unique ${kind} names.`);
+		this.name = "KickPluginConflictError";
+	}
+};
+//#endregion
+export { defineCliPlugin as n, KickPluginConflictError as t };
+
+//# sourceMappingURL=types-BBUo1vXh.mjs.map

package/dist/types-BBUo1vXh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BBUo1vXh.mjs","names":[],"sources":["../src/plugin/types.ts"],"sourcesContent":["// CLI Plugin shape.\n//\n// The kick CLI is itself a composition of plugins — every built-in\n// command (init, generate, run, typegen, db, …) ships as a KickCliPlugin\n// internally. Adopters extend the same surface from kick.config.ts to\n// add commands, generators, and typegens; the merging + conflict\n// detection runs the same way for built-ins and user plugins.\n//\n// Four contribution kinds:\n//\n//   • commands[]   — declarative shell-handler commands (same shape as\n//                    the existing kick.config.ts `commands` field).\n//   • register()   — programmatic commander registration. Called with\n//                    `(program, ctx)` so the callback has cwd + config\n//                    without re-loading.\n//   • typegens[]   — TypegenPlugin instances that `kick typegen` runs\n//                    after the legacy pass.\n//   • generators[] — `kick g <name>` scaffolders (defineGenerator).\n//                    Replaces the `package.json > kickjs.generators`\n//                    discovery; that path stays as a deprecated\n//                    fallback for one minor version.\n//\n// Mirrors `definePlugin` / `defineAdapter` factory parity so adopters\n// don't have to learn a new helper-naming convention.\n\nimport type { Command } from 'commander'\n\nimport type { TypegenPlugin } from '../typegen/plugin'\nimport type { KickCommandDefinition, KickConfig } from '../config'\nimport type { GeneratorSpec } from '../generator-extension/define'\n\n/**\n * Runtime context handed to `register()` — saves callbacks from\n * re-loading config or guessing cwd. Forward-compatible: future fields\n * land here without changing the callback signature.\n */\nexport interface KickCliPluginContext {\n  cwd: string\n  /** Resolved kick.config.ts (null if the project has none). */\n  config: KickConfig | null\n  log: (msg: string) => void\n}\n\nexport interface KickCliPlugin {\n  /** Stable identifier — used in error messages on conflict + de-dup. */\n  name: string\n  commands?: KickCommandDefinition[]\n  /** Programmatic command registration. Called once at CLI startup. */\n  register?: (program: Command, ctx: KickCliPluginContext) => void | Promise<void>\n  typegens?: TypegenPlugin[]\n  generators?: GeneratorSpec[]\n}\n\n/** Identity helper — exists for type inference + parity with definePlugin. */\nexport function defineCliPlugin(p: KickCliPlugin): KickCliPlugin {\n  return p\n}\n\nexport class KickPluginConflictError extends Error {\n  constructor(kind: 'plugin' | 'command' | 'typegen' | 'generator', id: string, owners: string[]) {\n    super(\n      `Two plugins registered the same ${kind} '${id}': ${owners.join(', ')}. ` +\n        `Plugins must use unique ${kind} names.`,\n    )\n    this.name = 'KickPluginConflictError'\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAsDA,SAAgB,gBAAgB,GAAiC;AAC/D,QAAO;;AAGT,IAAa,0BAAb,cAA6C,MAAM;CACjD,YAAY,MAAsD,IAAY,QAAkB;AAC9F,QACE,mCAAmC,KAAK,IAAI,GAAG,KAAK,OAAO,KAAK,KAAK,CAAC,4BACzC,KAAK,SACnC;AACD,OAAK,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-cli",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "description": "CLI for KickJS — project scaffolding, DDD module generation, dev/build/start",
   "keywords": [
     "kickjs",
@@ -67,16 +67,20 @@
     "commander": "^14.0.3",
     "glob": "^13.0.6",
     "picocolors": "^1.1.1",
-    "pluralize": "^8.0.0"
+    "pluralize": "^8.0.0",
+    "@forinda/kickjs-db": "5.1.0"
   },
   "devDependencies": {
     "@swc/core": "^1.15.30",
     "@types/node": "^25.6.0",
+    "@types/pg": "^8.11.10",
     "@types/pluralize": "^0.0.33",
+    "pg": "^8.13.1",
     "typescript": "^6.0.3",
     "vite": "^8.0.9",
     "vitest": "^4.1.5",
-    "@forinda/kickjs-ai": "5.0.1"
+    "@forinda/kickjs-ai": "5.1.0",
+    "@forinda/kickjs-db-pg": "5.1.0"
   },
   "publishConfig": {
     "access": "public"