@warlock.js/core 4.4.0 → 4.6.0

package/esm/cli/commands/doctor/doctor-command.action.mjs

@@ -0,0 +1,28 @@
+import { defaultDoctorChecks } from "./checks/index.mjs";
+import { printReport } from "./format-report.mjs";
+import { runChecks } from "./run-checks.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/doctor-command.action.ts
+/**
+* Action behind `warlock doctor`. Runs the default read-only diagnostic
+* checks, prints the grouped pass/warn/fail report, and — when any check
+* failed — exits the process with a non-zero code so the command signals
+* failure to scripts/CI.
+*
+* A failing check is REPORTED (a line in the report + a non-zero exit), never
+* thrown: the runner converts any thrown check into a `fail` result first.
+*
+* On success this simply returns; the CLI manager then prints its own success
+* banner and exits zero.
+*
+* @param _data Parsed CLI args (unused — doctor takes no positional args).
+*/
+async function doctorCommandAction(_data) {
+	const report = await runChecks(defaultDoctorChecks);
+	printReport(report);
+	if (report.hasFailures) process.exit(report.exitCode);
+}
+
+//#endregion
+export { doctorCommandAction };
+//# sourceMappingURL=doctor-command.action.mjs.map

package/esm/cli/commands/doctor/doctor-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-command.action.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/doctor-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../types\";\nimport { defaultDoctorChecks } from \"./checks\";\nimport { printReport } from \"./format-report\";\nimport { runChecks } from \"./run-checks\";\n\n/**\n * Action behind `warlock doctor`. Runs the default read-only diagnostic\n * checks, prints the grouped pass/warn/fail report, and — when any check\n * failed — exits the process with a non-zero code so the command signals\n * failure to scripts/CI.\n *\n * A failing check is REPORTED (a line in the report + a non-zero exit), never\n * thrown: the runner converts any thrown check into a `fail` result first.\n *\n * On success this simply returns; the CLI manager then prints its own success\n * banner and exits zero.\n *\n * @param _data Parsed CLI args (unused — doctor takes no positional args).\n */\nexport async function doctorCommandAction(_data: CommandActionData): Promise<void> {\n  const report = await runChecks(defaultDoctorChecks);\n\n  printReport(report);\n\n  if (report.hasFailures) {\n    process.exit(report.exitCode);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,oBAAoB,OAAyC;CACjF,MAAM,SAAS,MAAM,UAAU,mBAAmB;CAElD,YAAY,MAAM;CAElB,IAAI,OAAO,aACT,QAAQ,KAAK,OAAO,QAAQ;AAEhC"}

package/esm/cli/commands/doctor/format-report.mjs

@@ -0,0 +1,44 @@
+import { colors } from "@mongez/copper";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/format-report.ts
+/**
+* The glyph shown beside each check, keyed by status.
+*/
+const STATUS_SYMBOL = {
+	ok: "✓",
+	warn: "⚠",
+	fail: "✗"
+};
+/**
+* Colorize a status glyph. Kept separate from {@link STATUS_SYMBOL} so the
+* plain glyphs remain available for snapshot-friendly, color-free assertions.
+*/
+function colorizeSymbol(status) {
+	const symbol = STATUS_SYMBOL[status];
+	switch (status) {
+		case "ok": return colors.green(symbol);
+		case "warn": return colors.yellow(symbol);
+		case "fail": return colors.red(symbol);
+	}
+}
+/**
+* Print the report to stdout with colored status glyphs and a colored summary
+* verdict. Thin wrapper over {@link formatReportLines} — the structured report
+* stays the source of truth for the exit code.
+*
+* @param report The aggregated doctor report.
+*/
+function printReport(report) {
+	for (const result of report.results) {
+		const symbol = colorizeSymbol(result.status);
+		console.log(`${symbol} ${colors.bold(result.name)}: ${result.detail}`);
+	}
+	const { ok, warn, fail } = report.summary;
+	const summaryLine = `Summary: ${ok} ok, ${warn} warn, ${fail} fail`;
+	console.log("");
+	console.log(report.hasFailures ? colors.red(summaryLine) : colors.green(summaryLine));
+}
+
+//#endregion
+export { printReport };
+//# sourceMappingURL=format-report.mjs.map

package/esm/cli/commands/doctor/format-report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-report.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/format-report.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CheckStatus, DoctorReport } from \"./check.types\";\n\n/**\n * The glyph shown beside each check, keyed by status.\n */\nconst STATUS_SYMBOL: Record<CheckStatus, string> = {\n  ok: \"✓\",\n  warn: \"⚠\",\n  fail: \"✗\",\n};\n\n/**\n * Colorize a status glyph. Kept separate from {@link STATUS_SYMBOL} so the\n * plain glyphs remain available for snapshot-friendly, color-free assertions.\n */\nfunction colorizeSymbol(status: CheckStatus): string {\n  const symbol = STATUS_SYMBOL[status];\n\n  switch (status) {\n    case \"ok\":\n      return colors.green(symbol);\n    case \"warn\":\n      return colors.yellow(symbol);\n    case \"fail\":\n      return colors.red(symbol);\n  }\n}\n\n/**\n * Build the report body as an ordered list of plain (uncolored) lines:\n * one `<symbol> <name>: <detail>` line per check, a blank line, then a summary\n * line. Returned as strings (not printed) so the formatting is unit-testable.\n *\n * @param report The aggregated doctor report.\n * @returns The lines to print, top to bottom.\n */\nexport function formatReportLines(report: DoctorReport): string[] {\n  const lines = report.results.map((result) => {\n    return `${STATUS_SYMBOL[result.status]} ${result.name}: ${result.detail}`;\n  });\n\n  const { ok, warn, fail } = report.summary;\n\n  lines.push(\"\");\n  lines.push(`Summary: ${ok} ok, ${warn} warn, ${fail} fail`);\n\n  return lines;\n}\n\n/**\n * Print the report to stdout with colored status glyphs and a colored summary\n * verdict. Thin wrapper over {@link formatReportLines} — the structured report\n * stays the source of truth for the exit code.\n *\n * @param report The aggregated doctor report.\n */\nexport function printReport(report: DoctorReport): void {\n  for (const result of report.results) {\n    const symbol = colorizeSymbol(result.status);\n\n    console.log(`${symbol} ${colors.bold(result.name)}: ${result.detail}`);\n  }\n\n  const { ok, warn, fail } = report.summary;\n  const summaryLine = `Summary: ${ok} ok, ${warn} warn, ${fail} fail`;\n\n  console.log(\"\");\n  console.log(report.hasFailures ? colors.red(summaryLine) : colors.green(summaryLine));\n}\n"],"mappings":";;;;;;AAMA,MAAM,gBAA6C;CACjD,IAAI;CACJ,MAAM;CACN,MAAM;AACR;;;;;AAMA,SAAS,eAAe,QAA6B;CACnD,MAAM,SAAS,cAAc;CAE7B,QAAQ,QAAR;EACE,KAAK,MACH,OAAO,OAAO,MAAM,MAAM;EAC5B,KAAK,QACH,OAAO,OAAO,OAAO,MAAM;EAC7B,KAAK,QACH,OAAO,OAAO,IAAI,MAAM;CAC5B;AACF;;;;;;;;AA8BA,SAAgB,YAAY,QAA4B;CACtD,KAAK,MAAM,UAAU,OAAO,SAAS;EACnC,MAAM,SAAS,eAAe,OAAO,MAAM;EAE3C,QAAQ,IAAI,GAAG,OAAO,GAAG,OAAO,KAAK,OAAO,IAAI,EAAE,IAAI,OAAO,QAAQ;CACvE;CAEA,MAAM,EAAE,IAAI,MAAM,SAAS,OAAO;CAClC,MAAM,cAAc,YAAY,GAAG,OAAO,KAAK,SAAS,KAAK;CAE7D,QAAQ,IAAI,EAAE;CACd,QAAQ,IAAI,OAAO,cAAc,OAAO,IAAI,WAAW,IAAI,OAAO,MAAM,WAAW,CAAC;AACtF"}

package/esm/cli/commands/doctor/run-checks.mjs

@@ -0,0 +1,50 @@
+//#region ../@warlock.js/core/src/cli/commands/doctor/run-checks.ts
+/**
+* Run one check defensively: a check that throws (or rejects) is recorded as a
+* `fail` carrying the error message, never re-thrown. This is what keeps
+* `doctor` itself crash-proof — a broken probe degrades to a failed check
+* instead of taking the whole command down.
+*/
+async function runOne(check) {
+	try {
+		return await check.run();
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return {
+			name: check.name,
+			status: "fail",
+			detail: `check threw: ${message}`
+		};
+	}
+}
+/**
+* Run every check and aggregate the results into a {@link DoctorReport}.
+*
+* Checks run in registration order. Each is isolated via {@link runOne}, so one
+* throwing check cannot abort the others. The exit code is `1` if any check
+* resolved to `fail`, otherwise `0` — warnings never fail the command.
+*
+* @param checks The diagnostic probes to execute.
+* @returns The aggregated report (results + per-status counts + exit code).
+*/
+async function runChecks(checks) {
+	const results = [];
+	for (const check of checks) results.push(await runOne(check));
+	const summary = {
+		ok: 0,
+		warn: 0,
+		fail: 0
+	};
+	for (const result of results) summary[result.status] += 1;
+	const hasFailures = summary.fail > 0;
+	return {
+		results,
+		summary,
+		hasFailures,
+		exitCode: hasFailures ? 1 : 0
+	};
+}
+
+//#endregion
+export { runChecks };
+//# sourceMappingURL=run-checks.mjs.map

package/esm/cli/commands/doctor/run-checks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-checks.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/run-checks.ts"],"sourcesContent":["import type { CheckResult, CheckStatus, DoctorCheck, DoctorReport } from \"./check.types\";\n\n/**\n * Run one check defensively: a check that throws (or rejects) is recorded as a\n * `fail` carrying the error message, never re-thrown. This is what keeps\n * `doctor` itself crash-proof — a broken probe degrades to a failed check\n * instead of taking the whole command down.\n */\nasync function runOne(check: DoctorCheck): Promise<CheckResult> {\n  try {\n    return await check.run();\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n\n    return {\n      name: check.name,\n      status: \"fail\",\n      detail: `check threw: ${message}`,\n    };\n  }\n}\n\n/**\n * Run every check and aggregate the results into a {@link DoctorReport}.\n *\n * Checks run in registration order. Each is isolated via {@link runOne}, so one\n * throwing check cannot abort the others. The exit code is `1` if any check\n * resolved to `fail`, otherwise `0` — warnings never fail the command.\n *\n * @param checks The diagnostic probes to execute.\n * @returns The aggregated report (results + per-status counts + exit code).\n */\nexport async function runChecks(checks: DoctorCheck[]): Promise<DoctorReport> {\n  const results: CheckResult[] = [];\n\n  for (const check of checks) {\n    results.push(await runOne(check));\n  }\n\n  const summary: Record<CheckStatus, number> = { ok: 0, warn: 0, fail: 0 };\n\n  for (const result of results) {\n    summary[result.status] += 1;\n  }\n\n  const hasFailures = summary.fail > 0;\n\n  return {\n    results,\n    summary,\n    hasFailures,\n    exitCode: hasFailures ? 1 : 0,\n  };\n}\n"],"mappings":";;;;;;;AAQA,eAAe,OAAO,OAA0C;CAC9D,IAAI;EACF,OAAO,MAAM,MAAM,IAAI;CACzB,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAErE,OAAO;GACL,MAAM,MAAM;GACZ,QAAQ;GACR,QAAQ,gBAAgB;EAC1B;CACF;AACF;;;;;;;;;;;AAYA,eAAsB,UAAU,QAA8C;CAC5E,MAAM,UAAyB,CAAC;CAEhC,KAAK,MAAM,SAAS,QAClB,QAAQ,KAAK,MAAM,OAAO,KAAK,CAAC;CAGlC,MAAM,UAAuC;EAAE,IAAI;EAAG,MAAM;EAAG,MAAM;CAAE;CAEvE,KAAK,MAAM,UAAU,SACnB,QAAQ,OAAO,WAAW;CAG5B,MAAM,cAAc,QAAQ,OAAO;CAEnC,OAAO;EACL;EACA;EACA;EACA,UAAU,cAAc,IAAI;CAC9B;AACF"}

package/esm/cli/commands/doctor.command.mjs

@@ -0,0 +1,29 @@
+import { command } from "../cli-command.mjs";
+import { doctorCommandAction } from "./doctor/doctor-command.action.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor.command.ts
+/**
+* `warlock doctor` — run a set of READ-ONLY diagnostic checks (routes, config,
+* connectors, optional peers, health endpoints, release hygiene) and print a
+* grouped pass/warn/fail report. Exits non-zero if any check fails.
+*
+* Preload plan: load every config file and bootstrap app code so routes and
+* connectors are registered for introspection, but DELIBERATELY start no
+* connectors — doctor must not open database/cache/socket connections. The
+* connectors check therefore reports the registered set and which (if any) are
+* already active without forcing them up.
+*/
+const doctorCommand = command({
+	name: "doctor",
+	description: "Run read-only health checks (routes, config, connectors, optional peers, health endpoints, release hygiene) and print a pass/warn/fail report",
+	action: doctorCommandAction,
+	preload: {
+		config: true,
+		env: true,
+		bootstrap: true
+	}
+});
+
+//#endregion
+export { doctorCommand };
+//# sourceMappingURL=doctor.command.mjs.map

package/esm/cli/commands/doctor.command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/doctor.command.ts"],"sourcesContent":["import { command } from \"../cli-command\";\nimport { doctorCommandAction } from \"./doctor/doctor-command.action\";\n\n/**\n * `warlock doctor` — run a set of READ-ONLY diagnostic checks (routes, config,\n * connectors, optional peers, health endpoints, release hygiene) and print a\n * grouped pass/warn/fail report. Exits non-zero if any check fails.\n *\n * Preload plan: load every config file and bootstrap app code so routes and\n * connectors are registered for introspection, but DELIBERATELY start no\n * connectors — doctor must not open database/cache/socket connections. The\n * connectors check therefore reports the registered set and which (if any) are\n * already active without forcing them up.\n */\nexport const doctorCommand = command({\n  name: \"doctor\",\n  description:\n    \"Run read-only health checks (routes, config, connectors, optional peers, health endpoints, release hygiene) and print a pass/warn/fail report\",\n  action: doctorCommandAction,\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;CACb;AACF,CAAC"}

package/esm/cli/commands/generate/templates/stubs.mjs

@@ -174,7 +174,7 @@ function crudModelStub(moduleName) {
 	const singular = moduleName.singular;
 	const plural = moduleName.plural;
 	return `import { Model, RegisterModel } from "@warlock.js/cascade";
-import { type Infer, v } from "@warlock.js/core";
+import { type Infer, v } from "@warlock.js/seal";
 import { ${singular.pascal}Resource } from "app/${plural.kebab}/resources/${singular.kebab}.resource";
 
 export const ${singular.camel}Schema = v.object({
@@ -333,17 +333,15 @@ export default seeder({
   name: "Seed ${entity.plural.pascal}",
   once: true,
   enabled: true,
-  run: async () => {
+  run: async ({ track }) => {
     const total = 10;
     for (let i = 0; i < total; i++) {
-      await ${entity.singular.pascal}.create({
-        // TODO: Add more fields
-      });
+      track(
+        await ${entity.singular.pascal}.create({
+          // TODO: Add more fields
+        }),
+      );
     }
-
-    return {
-      recordsCreated: total,
-    };
   },
 });
 `;
@@ -442,9 +440,8 @@ export type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;
 */
 function modelStub(name, options = {}) {
 	const { tableName = `${name.plural.snake}`, withResource } = options;
-	return `import { Model } from "@warlock.js/core";
-import type { StrictMode } from "@warlock.js/cascade";
-import { v, type Infer } from "@warlock.js/core";
+	return `import { Model, type StrictMode } from "@warlock.js/cascade";
+import { v, type Infer } from "@warlock.js/seal";
 ${withResource ? `import { ${name.singular.pascal}Resource } from "../../resources/${name.singular.kebab}.resource";` : ""}
 
 const ${name.singular.camel}Schema = v.object({

package/esm/cli/commands/generate/templates/stubs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\r\nimport { Name } from \"../utils/name-parser\";\r\n\r\n/**\r\n * Controller template stub\r\n *\r\n * Controllers default to the guarded handler type since application\r\n * routes run behind `guarded()`. When `withValidation` is set, the\r\n * schema's exported type + value are imported directly from the\r\n * `schema/` folder and bound to the handler — no `requests/` alias.\r\n */\r\nexport function controllerStub(\r\n  name: ParsedName,\r\n  options: { withValidation?: boolean } = {},\r\n): string {\r\n  const { withValidation } = options;\r\n\r\n  if (!withValidation) {\r\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\n\r\nexport const ${name.camel}Controller: GuardedRequestHandler = async (request, response) => {\r\n  // TODO: Implement controller logic\r\n  return response.success({});\r\n};\r\n`;\r\n  }\r\n\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\r\n\r\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async (\r\n  request,\r\n  response,\r\n) => {\r\n  // TODO: Implement controller logic\r\n  return response.success({});\r\n};\r\n\r\n${name.camel}Controller.validation = {\r\n  schema: ${name.camel}Schema,\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Create Controller template\r\n * Note: moduleName is the module (plural), we need singular entity name\r\n */\r\nexport function crudCreateControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\r\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\r\n\r\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\r\n\r\n  return response.successCreate({\r\n    ${moduleName.camel},\r\n  });\r\n};\r\n\r\ncreate${moduleName.pascal}Controller.validation = {\r\n  schema: create${moduleName.pascal}Schema,\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Update Controller template\r\n */\r\nexport function crudUpdateControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\r\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\r\n\r\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\r\n\r\n  return response.success({\r\n    ${moduleName.camel},\r\n  });\r\n};\r\n\r\nupdate${moduleName.pascal}Controller.validation = {\r\n  schema: update${moduleName.pascal}Schema,\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD List Controller template\r\n */\r\nexport function crudListControllerStub(moduleName: Name): string {\r\n  const plural = moduleName.plural;\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\r\n\r\nexport const list${plural.pascal}Controller: GuardedRequestHandler = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const { data, pagination } = await list${plural.pascal}Service(request.all());\r\n\r\n  return response.success({\r\n    data,\r\n    pagination,\r\n  });\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Show/Get Controller template\r\n */\r\nexport function crudShowControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\r\n\r\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\r\n\r\n  if (!${moduleName.camel}) {\r\n    return response.notFound();\r\n  }\r\n\r\n  return response.success({\r\n    ${moduleName.camel},\r\n  });\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Delete Controller template\r\n */\r\nexport function crudDeleteControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\r\n\r\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async (\r\n  request,\r\n  response,\r\n) => {\r\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\r\n\r\n  return response.noContent();\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Routes template\r\n */\r\nexport function crudRoutesStub(moduleName: Name): string {\r\n  const singular = moduleName.singular;\r\n  const plural = moduleName.plural;\r\n\r\n  return `import { router } from \"@warlock.js/core\";\r\nimport { guarded } from \"app/shared/utils/router\";\r\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\r\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\r\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\r\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\r\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\r\n\r\nguarded(() => {\r\n  router\r\n    .route(\"/${plural.kebab}\")\r\n    .list(list${plural.pascal}Controller)\r\n    .show(get${singular.pascal}Controller)\r\n    .create(create${singular.pascal}Controller)\r\n    .update(update${singular.pascal}Controller)\r\n    .destroy(delete${singular.pascal}Controller);\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Model template\r\n */\r\nexport function crudModelStub(moduleName: Name): string {\r\n  const singular = moduleName.singular;\r\n  const plural = moduleName.plural;\r\n\r\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\r\nimport { type Infer, v } from \"@warlock.js/core\";\r\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\r\n\r\nexport const ${singular.camel}Schema = v.object({\r\n  // TODO: Add more fields\r\n});\r\n\r\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\r\n\r\n@RegisterModel()\r\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\r\n  public static table = \"${plural.snake}\";\r\n\r\n  public static schema = ${singular.camel}Schema;\r\n\r\n  public static relations = {};\r\n\r\n  public static resource = ${singular.pascal}Resource;\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Resource template\r\n */\r\nexport function crudResourceStub(moduleName: Name): string {\r\n  // Get singular entity name\r\n  const entity = moduleName.singular;\r\n\r\n  return `import { defineResource } from \"@warlock.js/core\";\r\n\r\nexport const ${entity.pascal}Resource = defineResource({\r\n  schema: {\r\n    id: \"number\",\r\n    // TODO: Add more resource fields\r\n  },\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Repository template\r\n */\r\nexport function crudRepositoryStub(entity: Name): string {\r\n  const moduleSingularName = entity.singular;\r\n  const modulePluralName = entity.plural;\r\n  return `import type { FilterRules, TypedRepositoryOptions } from \"@warlock.js/core\";\r\nimport { RepositoryManager } from \"@warlock.js/core\";\r\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\r\n\r\ntype ${moduleSingularName.pascal}ListFilter = {\r\n  // Repository list filters\r\n};\r\n\r\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\r\n\r\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\r\n  public source = ${moduleSingularName.pascal};\r\n\r\n  public simpleSelectColumns: string[] = [\"id\"];\r\n\r\n  public filterBy: FilterRules = {\r\n    id: \"=\",\r\n  };\r\n\r\n  public defaultOptions: RepositoryOptions = {\r\n    orderBy: {\r\n      id: \"desc\",\r\n    },\r\n  };\r\n}\r\n\r\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Create Service template\r\n */\r\nexport function crudCreateServiceStub(entity: Name): string {\r\n  const moduleSingularName = entity.singular;\r\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\r\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\r\n\r\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\r\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\r\n  return ${moduleSingularName.camel};\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Update Service template\r\n */\r\nexport function crudUpdateServiceStub(entity: Name): string {\r\n  const moduleSingularName = entity.singular;\r\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\r\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\r\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\r\n\r\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\r\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\r\n\r\n  await ${moduleSingularName.camel}.save({ merge: data });\r\n  return ${moduleSingularName.camel};\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD List Service template\r\n */\r\nexport function crudListServiceStub(entity: Name): string {\r\n  const modulePluralName = entity.plural;\r\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\r\n\r\nexport async function list${modulePluralName.pascal}Service(filters: any) {\r\n  return ${modulePluralName.camel}Repository.listCached(filters);\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Get Service template\r\n */\r\nexport function crudGetServiceStub(entity: Name): string {\r\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\r\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\r\n\r\nexport async function get${entity.singular.pascal}Service(id: number | string) {\r\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\r\n\r\n  if (!${entity.singular.camel}) {\r\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\r\n  }\r\n\r\n  return ${entity.singular.camel};\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Delete Service template\r\n */\r\nexport function crudDeleteServiceStub(entity: Name): string {\r\n  const singular = entity.singular;\r\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\r\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\r\n\r\nexport async function delete${singular.pascal}Service(id: number | string) {\r\n  const ${singular.camel} = await get${singular.pascal}Service(id);\r\n  if (!${singular.camel}) {\r\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\r\n  }\r\n  await ${singular.camel}.destroy();\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Seed template\r\n */\r\nexport function crudSeedStub(entity: Name): string {\r\n  return `import { seeder } from \"@warlock.js/core\";\r\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\r\n\r\nexport default seeder({\r\n  name: \"Seed ${entity.plural.pascal}\",\r\n  once: true,\r\n  enabled: true,\r\n  run: async () => {\r\n    const total = 10;\r\n    for (let i = 0; i < total; i++) {\r\n      await ${entity.singular.pascal}.create({\r\n        // TODO: Add more fields\r\n      });\r\n    }\r\n\r\n    return {\r\n      recordsCreated: total,\r\n    };\r\n  },\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * Migration template\r\n */\r\n/**\r\n * Migration Create template\r\n */\r\nexport function migrationStub(\r\n  entityName: ParsedName,\r\n  options: {\r\n    columns?: string;\r\n    imports?: string[];\r\n    timestamps?: boolean;\r\n    tableName?: string;\r\n  } = {},\r\n): string {\r\n  const { columns = \"\", imports = [], timestamps = true } = options;\r\n\r\n  const allImports = [\"Migration\", ...imports].join(\", \");\r\n\r\n  let optionsString = \"\";\r\n  if (timestamps === false) {\r\n    optionsString = `, { timestamps: false }`;\r\n  }\r\n\r\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\r\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\r\n\r\nexport default Migration.create(${entityName.pascal}, {\r\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\r\n}${optionsString});\r\n`;\r\n}\r\n\r\n/**\r\n * Migration Alter template\r\n */\r\nexport function migrationAlterStub(\r\n  entityName: ParsedName,\r\n  options: {\r\n    add?: string;\r\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\r\n    rename?: string; // stringified object like `{ old: \"new\" }`\r\n    imports?: string[];\r\n  } = {},\r\n): string {\r\n  const { add = \"\", drop, rename, imports = [] } = options;\r\n  const allImports = [\"Migration\", ...imports].join(\", \");\r\n\r\n  // Build the schema object dynamically\r\n  const schemaParts: string[] = [];\r\n\r\n  if (add) {\r\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\r\n  }\r\n\r\n  if (drop) {\r\n    schemaParts.push(`  drop: ${drop},`);\r\n  }\r\n\r\n  if (rename) {\r\n    schemaParts.push(`  rename: ${rename},`);\r\n  }\r\n\r\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\r\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\r\n\r\nexport default Migration.alter(${entityName.pascal}, {\r\n${schemaParts.join(\"\\n\")}\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Create Schema template\r\n * Outputs to: schema/create-{entity}.schema.ts\r\n */\r\nexport function crudCreateSchemaStub(moduleName: Name): string {\r\n  return `import { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nexport const create${moduleName.pascal}Schema = v.object({\r\n  // TODO: Add validation rules\r\n});\r\n\r\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Update Schema template\r\n * Outputs to: schema/update-{entity}.schema.ts\r\n */\r\nexport function crudUpdateSchemaStub(moduleName: Name): string {\r\n  return `import { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nexport const update${moduleName.pascal}Schema = v.object({\r\n  // TODO: Add validation rules\r\n});\r\n\r\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\r\n`;\r\n}\r\n\r\n/**\r\n * Service template stub\r\n */\r\nexport function serviceStub(name: Name): string {\r\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\r\n  // TODO: Implement service logic\r\n  throw new Error(\"${name.camel}Service not implemented\");\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * Schema template stub\r\n * Outputs to: schema/{name}.schema.ts\r\n */\r\nexport function schemaStub(name: Name): string {\r\n  return `import { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nexport const ${name.camel}Schema = v.object({\r\n  // TODO: Define validation schema\r\n});\r\n\r\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\r\n`;\r\n}\r\n\r\n/**\r\n * Model template stub\r\n */\r\nexport function modelStub(\r\n  name: Name,\r\n  options: { tableName?: string; withResource?: boolean } = {},\r\n): string {\r\n  const { tableName = `${name.plural.snake}`, withResource } = options;\r\n\r\n  return `import { Model } from \"@warlock.js/core\";\r\nimport type { StrictMode } from \"@warlock.js/cascade\";\r\nimport { v, type Infer } from \"@warlock.js/core\";\r\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\r\n\r\nconst ${name.singular.camel}Schema = v.object({\r\n  // TODO: Define model schema\r\n});\r\n\r\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\r\n\r\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\r\n  public static table = \"${tableName}\";\r\n  public static strictMode: StrictMode = \"fail\";\r\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\r\n\r\n  public static schema = ${name.singular.camel}Schema;\r\n\r\n  public static relations = {\r\n    // TODO: Define relations\r\n  };\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * Repository template stub\r\n */\r\nexport function repositoryStub(name: Name): string {\r\n  return `import type { FilterByOptions, RepositoryOptions } from \"@warlock.js/core\";\r\nimport { RepositoryManager } from \"@warlock.js/core\";\r\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\r\n\r\ntype ${name.singular.pascal}ListFilter = {\r\n  // Repository list filters\r\n};\r\n\r\nexport type ${name.singular.pascal}ListOptions = RepositoryOptions & ${name.singular.pascal}ListFilter;\r\n\r\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\r\n  public source = ${name.singular.pascal};\r\n\r\n  protected defaultOptions: RepositoryOptions = this.withDefaultOptions({});\r\n\r\n  protected filterBy: FilterByOptions = this.withDefaultFilters({\r\n    name: \"like\",\r\n  });\r\n}\r\n\r\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\r\n`;\r\n}\r\n\r\n/**\r\n * Resource template stub\r\n */\r\nexport function resourceStub(name: Name): string {\r\n  return `import { Resource } from \"@warlock.js/core\";\r\n\r\nexport class ${name.singular.pascal}Resource extends Resource {\r\n  public schema = {\r\n    id: \"int\",\r\n    name: \"string\",\r\n    // TODO: Define resource schema\r\n  };\r\n}\r\n`;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\nimport { Name } from \"../utils/name-parser\";\n\n/**\n * Controller template stub\n *\n * Controllers default to the guarded handler type since application\n * routes run behind `guarded()`. When `withValidation` is set, the\n * schema's exported type + value are imported directly from the\n * `schema/` folder and bound to the handler — no `requests/` alias.\n */\nexport function controllerStub(\n  name: ParsedName,\n  options: { withValidation?: boolean } = {},\n): string {\n  const { withValidation } = options;\n\n  if (!withValidation) {\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler = async (request, response) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n`;\n  }\n\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async (\n  request,\n  response,\n) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n\n${name.camel}Controller.validation = {\n  schema: ${name.camel}Schema,\n};\n`;\n}\n\n/**\n * CRUD Create Controller template\n * Note: moduleName is the module (plural), we need singular entity name\n */\nexport function crudCreateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\n\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async (\n  request,\n  response,\n) => {\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\n\n  return response.successCreate({\n    ${moduleName.camel},\n  });\n};\n\ncreate${moduleName.pascal}Controller.validation = {\n  schema: create${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD Update Controller template\n */\nexport function crudUpdateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\n\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async (\n  request,\n  response,\n) => {\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n\nupdate${moduleName.pascal}Controller.validation = {\n  schema: update${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD List Controller template\n */\nexport function crudListControllerStub(moduleName: Name): string {\n  const plural = moduleName.plural;\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\n\nexport const list${plural.pascal}Controller: GuardedRequestHandler = async (\n  request,\n  response,\n) => {\n  const { data, pagination } = await list${plural.pascal}Service(request.all());\n\n  return response.success({\n    data,\n    pagination,\n  });\n};\n`;\n}\n\n/**\n * CRUD Show/Get Controller template\n */\nexport function crudShowControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\n\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async (\n  request,\n  response,\n) => {\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\n\n  if (!${moduleName.camel}) {\n    return response.notFound();\n  }\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n`;\n}\n\n/**\n * CRUD Delete Controller template\n */\nexport function crudDeleteControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\n\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async (\n  request,\n  response,\n) => {\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\n\n  return response.noContent();\n};\n`;\n}\n\n/**\n * CRUD Routes template\n */\nexport function crudRoutesStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { router } from \"@warlock.js/core\";\nimport { guarded } from \"app/shared/utils/router\";\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\n\nguarded(() => {\n  router\n    .route(\"/${plural.kebab}\")\n    .list(list${plural.pascal}Controller)\n    .show(get${singular.pascal}Controller)\n    .create(create${singular.pascal}Controller)\n    .update(update${singular.pascal}Controller)\n    .destroy(delete${singular.pascal}Controller);\n});\n`;\n}\n\n/**\n * CRUD Model template\n */\nexport function crudModelStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\nimport { type Infer, v } from \"@warlock.js/seal\";\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\n\nexport const ${singular.camel}Schema = v.object({\n  // TODO: Add more fields\n});\n\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\n\n@RegisterModel()\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\n  public static table = \"${plural.snake}\";\n\n  public static schema = ${singular.camel}Schema;\n\n  public static relations = {};\n\n  public static resource = ${singular.pascal}Resource;\n}\n`;\n}\n\n/**\n * CRUD Resource template\n */\nexport function crudResourceStub(moduleName: Name): string {\n  // Get singular entity name\n  const entity = moduleName.singular;\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\nexport const ${entity.pascal}Resource = defineResource({\n  schema: {\n    id: \"number\",\n    // TODO: Add more resource fields\n  },\n});\n`;\n}\n\n/**\n * CRUD Repository template\n */\nexport function crudRepositoryStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  const modulePluralName = entity.plural;\n  return `import type { FilterRules, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\n\ntype ${moduleSingularName.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\n\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\n  public source = ${moduleSingularName.pascal};\n\n  public simpleSelectColumns: string[] = [\"id\"];\n\n  public filterBy: FilterRules = {\n    id: \"=\",\n  };\n\n  public defaultOptions: RepositoryOptions = {\n    orderBy: {\n      id: \"desc\",\n    },\n  };\n}\n\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\n`;\n}\n\n/**\n * CRUD Create Service template\n */\nexport function crudCreateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\n\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD Update Service template\n */\nexport function crudUpdateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\n\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\n\n  await ${moduleSingularName.camel}.save({ merge: data });\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD List Service template\n */\nexport function crudListServiceStub(entity: Name): string {\n  const modulePluralName = entity.plural;\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\n\nexport async function list${modulePluralName.pascal}Service(filters: any) {\n  return ${modulePluralName.camel}Repository.listCached(filters);\n}\n`;\n}\n\n/**\n * CRUD Get Service template\n */\nexport function crudGetServiceStub(entity: Name): string {\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\n\nexport async function get${entity.singular.pascal}Service(id: number | string) {\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\n\n  if (!${entity.singular.camel}) {\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\n  }\n\n  return ${entity.singular.camel};\n}\n`;\n}\n\n/**\n * CRUD Delete Service template\n */\nexport function crudDeleteServiceStub(entity: Name): string {\n  const singular = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\n\nexport async function delete${singular.pascal}Service(id: number | string) {\n  const ${singular.camel} = await get${singular.pascal}Service(id);\n  if (!${singular.camel}) {\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\n  }\n  await ${singular.camel}.destroy();\n}\n`;\n}\n\n/**\n * CRUD Seed template\n */\nexport function crudSeedStub(entity: Name): string {\n  return `import { seeder } from \"@warlock.js/core\";\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\n\nexport default seeder({\n  name: \"Seed ${entity.plural.pascal}\",\n  once: true,\n  enabled: true,\n  run: async ({ track }) => {\n    const total = 10;\n    for (let i = 0; i < total; i++) {\n      track(\n        await ${entity.singular.pascal}.create({\n          // TODO: Add more fields\n        }),\n      );\n    }\n  },\n});\n`;\n}\n\n/**\n * Migration template\n */\n/**\n * Migration Create template\n */\nexport function migrationStub(\n  entityName: ParsedName,\n  options: {\n    columns?: string;\n    imports?: string[];\n    timestamps?: boolean;\n    tableName?: string;\n  } = {},\n): string {\n  const { columns = \"\", imports = [], timestamps = true } = options;\n\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  let optionsString = \"\";\n  if (timestamps === false) {\n    optionsString = `, { timestamps: false }`;\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.create(${entityName.pascal}, {\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\n}${optionsString});\n`;\n}\n\n/**\n * Migration Alter template\n */\nexport function migrationAlterStub(\n  entityName: ParsedName,\n  options: {\n    add?: string;\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\n    rename?: string; // stringified object like `{ old: \"new\" }`\n    imports?: string[];\n  } = {},\n): string {\n  const { add = \"\", drop, rename, imports = [] } = options;\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  // Build the schema object dynamically\n  const schemaParts: string[] = [];\n\n  if (add) {\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\n  }\n\n  if (drop) {\n    schemaParts.push(`  drop: ${drop},`);\n  }\n\n  if (rename) {\n    schemaParts.push(`  rename: ${rename},`);\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.alter(${entityName.pascal}, {\n${schemaParts.join(\"\\n\")}\n});\n`;\n}\n\n/**\n * CRUD Create Schema template\n * Outputs to: schema/create-{entity}.schema.ts\n */\nexport function crudCreateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const create${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * CRUD Update Schema template\n * Outputs to: schema/update-{entity}.schema.ts\n */\nexport function crudUpdateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const update${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * Service template stub\n */\nexport function serviceStub(name: Name): string {\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\n  // TODO: Implement service logic\n  throw new Error(\"${name.camel}Service not implemented\");\n}\n`;\n}\n\n/**\n * Schema template stub\n * Outputs to: schema/{name}.schema.ts\n */\nexport function schemaStub(name: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const ${name.camel}Schema = v.object({\n  // TODO: Define validation schema\n});\n\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\n`;\n}\n\n/**\n * Model template stub\n */\nexport function modelStub(\n  name: Name,\n  options: { tableName?: string; withResource?: boolean } = {},\n): string {\n  const { tableName = `${name.plural.snake}`, withResource } = options;\n\n  return `import { Model, type StrictMode } from \"@warlock.js/cascade\";\nimport { v, type Infer } from \"@warlock.js/seal\";\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\n\nconst ${name.singular.camel}Schema = v.object({\n  // TODO: Define model schema\n});\n\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\n\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\n  public static table = \"${tableName}\";\n  public static strictMode: StrictMode = \"fail\";\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\n\n  public static schema = ${name.singular.camel}Schema;\n\n  public static relations = {\n    // TODO: Define relations\n  };\n}\n`;\n}\n\n/**\n * Repository template stub\n */\nexport function repositoryStub(name: Name): string {\n  return `import type { FilterByOptions, RepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\n\ntype ${name.singular.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${name.singular.pascal}ListOptions = RepositoryOptions & ${name.singular.pascal}ListFilter;\n\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\n  public source = ${name.singular.pascal};\n\n  protected defaultOptions: RepositoryOptions = this.withDefaultOptions({});\n\n  protected filterBy: FilterByOptions = this.withDefaultFilters({\n    name: \"like\",\n  });\n}\n\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\n`;\n}\n\n/**\n * Resource template stub\n */\nexport function resourceStub(name: Name): string {\n  return `import { Resource } from \"@warlock.js/core\";\n\nexport class ${name.singular.pascal}Resource extends Resource {\n  public schema = {\n    id: \"int\",\n    name: \"string\",\n    // TODO: Define resource schema\n  };\n}\n`;\n}\n"],"mappings":"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"}

package/esm/cli/commands/routes/format-routes-table.mjs

@@ -0,0 +1,129 @@
+import { methodRank } from "./route-row.mjs";
+import { colors } from "@mongez/copper";
+
+//#region ../@warlock.js/core/src/cli/commands/routes/format-routes-table.ts
+/** The columns rendered, in order, with their header labels. */
+const COLUMNS = [
+	{
+		key: "method",
+		header: "METHOD"
+	},
+	{
+		key: "path",
+		header: "PATH"
+	},
+	{
+		key: "name",
+		header: "NAME"
+	},
+	{
+		key: "action",
+		header: "ACTION"
+	},
+	{
+		key: "middleware",
+		header: "MW"
+	},
+	{
+		key: "source",
+		header: "SOURCE"
+	}
+];
+/** Two spaces between columns. */
+const GAP = "  ";
+/** Shown for an empty string cell so the column doesn't read as a gap. */
+const EMPTY_CELL = "—";
+/**
+* The plain (uncolored) text of one cell. Numbers render as-is; an empty string
+* renders as {@link EMPTY_CELL}. This is the single source of truth for both
+* the width math and the rendered text, so colored and uncolored output stay
+* aligned.
+*
+* @param row - The row
+* @param key - The column key
+* @returns The cell's printable text
+*/
+function cellText(row, key) {
+	if (key === "middleware") return String(row.middleware);
+	const value = row[key];
+	return value.length > 0 ? value : EMPTY_CELL;
+}
+/**
+* Per-column display width: the longest of the header and every cell.
+*
+* @param rows - The rows to measure
+* @returns One width per column, in column order
+*/
+function columnWidths(rows) {
+	return COLUMNS.map((column) => Math.max(column.header.length, ...rows.map((row) => cellText(row, column.key).length)));
+}
+/**
+* Build a one-line, human-readable summary: the total plus a per-method
+* breakdown ordered by {@link methodRank}, e.g.
+* `42 routes (38 GET · 2 POST · 1 PUT · 1 DELETE)`.
+*
+* @param rows - The rows being summarized
+* @returns The summary line
+*/
+function routesSummary(rows) {
+	const noun = rows.length === 1 ? "route" : "routes";
+	if (rows.length === 0) return `0 ${noun}`;
+	const counts = /* @__PURE__ */ new Map();
+	for (const row of rows) counts.set(row.method, (counts.get(row.method) ?? 0) + 1);
+	const breakdown = [...counts.entries()].sort(([a], [b]) => methodRank(a) - methodRank(b)).map(([method, count]) => `${count} ${method}`).join(" · ");
+	return `${rows.length} ${noun} (${breakdown})`;
+}
+/** Per-verb color for the METHOD column. Unknown verbs fall back to white. */
+const METHOD_COLOR = {
+	GET: colors.green,
+	POST: colors.blue,
+	PUT: colors.yellow,
+	PATCH: colors.yellow,
+	DELETE: colors.red,
+	OPTIONS: colors.gray,
+	HEAD: colors.gray,
+	ALL: colors.magenta
+};
+/**
+* Colorize the method label, then right-pad with plain spaces so column
+* alignment is computed from the visible width, not the ANSI-coded length.
+*
+* @param method - The uppercased HTTP verb
+* @param width - The METHOD column width
+* @returns The colored, padded cell
+*/
+function colorizeMethodCell(method, width) {
+	return (METHOD_COLOR[method] ?? colors.white)(method) + " ".repeat(Math.max(0, width - method.length));
+}
+/**
+* Print the routes table to stdout with a bold header, verb-colored METHOD
+* column, and a dimmed summary. The empty case prints a single yellow notice
+* (a booted app with zero routes usually means a route module failed to load).
+*
+* Thin presentation wrapper over {@link formatRoutesTableLines} /
+* {@link routesSummary} — those stay the source of truth for layout.
+*
+* @param rows - The rows to print (already filtered/sorted by the caller)
+*/
+function printRoutesTable(rows) {
+	if (rows.length === 0) {
+		console.log(colors.yellow("No routes registered — did a route module fail to load?"));
+		return;
+	}
+	const widths = columnWidths(rows);
+	const headerLine = COLUMNS.map((column, index) => column.header.padEnd(widths[index])).join(GAP).trimEnd();
+	console.log(colors.bold(headerLine));
+	for (const row of rows) {
+		const cells = COLUMNS.map((column, index) => {
+			if (column.key === "method") return colorizeMethodCell(row.method, widths[index]);
+			return cellText(row, column.key).padEnd(widths[index]);
+		});
+		console.log(cells.join(GAP).trimEnd());
+	}
+	console.log("");
+	console.log(colors.gray(routesSummary(rows)));
+}
+
+//#endregion
+export { printRoutesTable };
+//# sourceMappingURL=format-routes-table.mjs.map

package/esm/cli/commands/routes/format-routes-table.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-routes-table.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/cli/commands/routes/format-routes-table.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { methodRank, type RouteRow } from \"./route-row\";\n\n/** The columns rendered, in order, with their header labels. */\nconst COLUMNS = [\n  { key: \"method\", header: \"METHOD\" },\n  { key: \"path\", header: \"PATH\" },\n  { key: \"name\", header: \"NAME\" },\n  { key: \"action\", header: \"ACTION\" },\n  { key: \"middleware\", header: \"MW\" },\n  { key: \"source\", header: \"SOURCE\" },\n] as const;\n\ntype ColumnKey = (typeof COLUMNS)[number][\"key\"];\n\n/** Two spaces between columns. */\nconst GAP = \"  \";\n\n/** Shown for an empty string cell so the column doesn't read as a gap. */\nconst EMPTY_CELL = \"—\";\n\n/**\n * The plain (uncolored) text of one cell. Numbers render as-is; an empty string\n * renders as {@link EMPTY_CELL}. This is the single source of truth for both\n * the width math and the rendered text, so colored and uncolored output stay\n * aligned.\n *\n * @param row - The row\n * @param key - The column key\n * @returns The cell's printable text\n */\nfunction cellText(row: RouteRow, key: ColumnKey): string {\n  if (key === \"middleware\") return String(row.middleware);\n\n  const value = row[key] as string;\n\n  return value.length > 0 ? value : EMPTY_CELL;\n}\n\n/**\n * Per-column display width: the longest of the header and every cell.\n *\n * @param rows - The rows to measure\n * @returns One width per column, in column order\n */\nfunction columnWidths(rows: RouteRow[]): number[] {\n  return COLUMNS.map((column) =>\n    Math.max(column.header.length, ...rows.map((row) => cellText(row, column.key).length)),\n  );\n}\n\n/**\n * Build a one-line, human-readable summary: the total plus a per-method\n * breakdown ordered by {@link methodRank}, e.g.\n * `42 routes (38 GET · 2 POST · 1 PUT · 1 DELETE)`.\n *\n * @param rows - The rows being summarized\n * @returns The summary line\n */\nexport function routesSummary(rows: RouteRow[]): string {\n  const noun = rows.length === 1 ? \"route\" : \"routes\";\n\n  if (rows.length === 0) return `0 ${noun}`;\n\n  const counts = new Map<string, number>();\n\n  for (const row of rows) {\n    counts.set(row.method, (counts.get(row.method) ?? 0) + 1);\n  }\n\n  const breakdown = [...counts.entries()]\n    .sort(([a], [b]) => methodRank(a) - methodRank(b))\n    .map(([method, count]) => `${count} ${method}`)\n    .join(\" · \");\n\n  return `${rows.length} ${noun} (${breakdown})`;\n}\n\n/**\n * Render the routes table as an ordered list of plain (uncolored) lines:\n * a header row, one row per route, a blank line, then the summary. Returned as\n * strings (not printed) so the layout is unit-testable without ANSI noise.\n *\n * @param rows - The rows to render (already filtered/sorted by the caller)\n * @returns The lines to print, top to bottom\n */\nexport function formatRoutesTableLines(rows: RouteRow[]): string[] {\n  if (rows.length === 0) {\n    return [\"No routes registered.\"];\n  }\n\n  const widths = columnWidths(rows);\n\n  const renderRow = (cells: string[]) =>\n    cells.map((text, index) => text.padEnd(widths[index])).join(GAP).trimEnd();\n\n  const lines = [renderRow(COLUMNS.map((column) => column.header))];\n\n  for (const row of rows) {\n    lines.push(renderRow(COLUMNS.map((column) => cellText(row, column.key))));\n  }\n\n  lines.push(\"\");\n  lines.push(routesSummary(rows));\n\n  return lines;\n}\n\n/** Per-verb color for the METHOD column. Unknown verbs fall back to white. */\nconst METHOD_COLOR: Record<string, (input: string) => string> = {\n  GET: colors.green,\n  POST: colors.blue,\n  PUT: colors.yellow,\n  PATCH: colors.yellow,\n  DELETE: colors.red,\n  OPTIONS: colors.gray,\n  HEAD: colors.gray,\n  ALL: colors.magenta,\n};\n\n/**\n * Colorize the method label, then right-pad with plain spaces so column\n * alignment is computed from the visible width, not the ANSI-coded length.\n *\n * @param method - The uppercased HTTP verb\n * @param width - The METHOD column width\n * @returns The colored, padded cell\n */\nfunction colorizeMethodCell(method: string, width: number): string {\n  const colorize = METHOD_COLOR[method] ?? colors.white;\n\n  return colorize(method) + \" \".repeat(Math.max(0, width - method.length));\n}\n\n/**\n * Print the routes table to stdout with a bold header, verb-colored METHOD\n * column, and a dimmed summary. The empty case prints a single yellow notice\n * (a booted app with zero routes usually means a route module failed to load).\n *\n * Thin presentation wrapper over {@link formatRoutesTableLines} /\n * {@link routesSummary} — those stay the source of truth for layout.\n *\n * @param rows - The rows to print (already filtered/sorted by the caller)\n */\nexport function printRoutesTable(rows: RouteRow[]): void {\n  if (rows.length === 0) {\n    console.log(colors.yellow(\"No routes registered — did a route module fail to load?\"));\n    return;\n  }\n\n  const widths = columnWidths(rows);\n\n  const headerLine = COLUMNS.map((column, index) => column.header.padEnd(widths[index]))\n    .join(GAP)\n    .trimEnd();\n\n  console.log(colors.bold(headerLine));\n\n  for (const row of rows) {\n    const cells = COLUMNS.map((column, index) => {\n      if (column.key === \"method\") {\n        return colorizeMethodCell(row.method, widths[index]);\n      }\n\n      return cellText(row, column.key).padEnd(widths[index]);\n    });\n\n    console.log(cells.join(GAP).trimEnd());\n  }\n\n  console.log(\"\");\n  console.log(colors.gray(routesSummary(rows)));\n}\n"],"mappings":";;;;;AAIA,MAAM,UAAU;CACd;EAAE,KAAK;EAAU,QAAQ;CAAS;CAClC;EAAE,KAAK;EAAQ,QAAQ;CAAO;CAC9B;EAAE,KAAK;EAAQ,QAAQ;CAAO;CAC9B;EAAE,KAAK;EAAU,QAAQ;CAAS;CAClC;EAAE,KAAK;EAAc,QAAQ;CAAK;CAClC;EAAE,KAAK;EAAU,QAAQ;CAAS;AACpC;;AAKA,MAAM,MAAM;;AAGZ,MAAM,aAAa;;;;;;;;;;;AAYnB,SAAS,SAAS,KAAe,KAAwB;CACvD,IAAI,QAAQ,cAAc,OAAO,OAAO,IAAI,UAAU;CAEtD,MAAM,QAAQ,IAAI;CAElB,OAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;;;;;;;AAQA,SAAS,aAAa,MAA4B;CAChD,OAAO,QAAQ,KAAK,WAClB,KAAK,IAAI,OAAO,OAAO,QAAQ,GAAG,KAAK,KAAK,QAAQ,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CACvF;AACF;;;;;;;;;AAUA,SAAgB,cAAc,MAA0B;CACtD,MAAM,OAAO,KAAK,WAAW,IAAI,UAAU;CAE3C,IAAI,KAAK,WAAW,GAAG,OAAO,KAAK;CAEnC,MAAM,yBAAS,IAAI,IAAoB;CAEvC,KAAK,MAAM,OAAO,MAChB,OAAO,IAAI,IAAI,SAAS,OAAO,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC;CAG1D,MAAM,YAAY,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,CACpC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CACjD,KAAK,CAAC,QAAQ,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,CAC9C,KAAK,KAAK;CAEb,OAAO,GAAG,KAAK,OAAO,GAAG,KAAK,IAAI,UAAU;AAC9C;;AAiCA,MAAM,eAA0D;CAC9D,KAAK,OAAO;CACZ,MAAM,OAAO;CACb,KAAK,OAAO;CACZ,OAAO,OAAO;CACd,QAAQ,OAAO;CACf,SAAS,OAAO;CAChB,MAAM,OAAO;CACb,KAAK,OAAO;AACd;;;;;;;;;AAUA,SAAS,mBAAmB,QAAgB,OAAuB;CAGjE,QAFiB,aAAa,WAAW,OAAO,MAEjC,CAAC,MAAM,IAAI,IAAI,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,MAAM,CAAC;AACzE;;;;;;;;;;;AAYA,SAAgB,iBAAiB,MAAwB;CACvD,IAAI,KAAK,WAAW,GAAG;EACrB,QAAQ,IAAI,OAAO,OAAO,yDAAyD,CAAC;EACpF;CACF;CAEA,MAAM,SAAS,aAAa,IAAI;CAEhC,MAAM,aAAa,QAAQ,KAAK,QAAQ,UAAU,OAAO,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,CACnF,KAAK,GAAG,CAAC,CACT,QAAQ;CAEX,QAAQ,IAAI,OAAO,KAAK,UAAU,CAAC;CAEnC,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,UAAU;GAC3C,IAAI,OAAO,QAAQ,UACjB,OAAO,mBAAmB,IAAI,QAAQ,OAAO,MAAM;GAGrD,OAAO,SAAS,KAAK,OAAO,GAAG,CAAC,CAAC,OAAO,OAAO,MAAM;EACvD,CAAC;EAED,QAAQ,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC;CACvC;CAEA,QAAQ,IAAI,EAAE;CACd,QAAQ,IAAI,OAAO,KAAK,cAAc,IAAI,CAAC,CAAC;AAC9C"}

package/esm/cli/commands/routes/route-row.mjs

@@ -0,0 +1,92 @@
+//#region ../@warlock.js/core/src/cli/commands/routes/route-row.ts
+/**
+* Display order of HTTP methods — used to rank rows within a path and to order
+* the per-method breakdown in the summary line.
+*/
+const METHOD_ORDER = [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"OPTIONS",
+	"HEAD",
+	"ALL"
+];
+/**
+* Rank of a method for sorting. Unknown methods sort last (stable among
+* themselves).
+*
+* @param method - Uppercased HTTP verb
+* @returns The sort index
+*/
+function methodRank(method) {
+	const index = METHOD_ORDER.indexOf(method);
+	return index === -1 ? METHOD_ORDER.length : index;
+}
+/**
+* Derive the handler/controller-action label for a route. Uses the handler
+* function's name, stripping the `bound ` prefix that `Function.prototype.bind`
+* prepends, and falls back to `"anonymous"` for an unnamed handler.
+*
+* @param route - The route to label
+* @returns A printable action label
+*/
+function routeAction(route) {
+	const handler = route.handler;
+	if (typeof handler !== "function") return "anonymous";
+	const name = handler.name?.replace(/^bound /, "").trim();
+	return name ? name : "anonymous";
+}
+/**
+* Normalize a live {@link Route} into a printable {@link RouteRow}.
+*
+* @param route - The registered route
+* @returns The display-ready row
+*/
+function toRouteRow(route) {
+	return {
+		method: route.method.toUpperCase(),
+		path: route.path,
+		name: route.name ?? "",
+		action: routeAction(route),
+		middleware: route.middleware?.length ?? 0,
+		source: route.sourceFile ?? ""
+	};
+}
+/**
+* Apply the `--method` / `--path` / `--name` filters to a set of rows. An
+* omitted filter matches everything; provided filters are AND-ed.
+*
+* @param rows - The rows to filter
+* @param filter - The active filters
+* @returns The matching rows (a new array)
+*/
+function filterRouteRows(rows, filter) {
+	const method = filter.method?.toUpperCase();
+	const path = filter.path?.toLowerCase();
+	const name = filter.name?.toLowerCase();
+	return rows.filter((row) => {
+		if (method && row.method !== method) return false;
+		if (path && !row.path.toLowerCase().includes(path)) return false;
+		if (name && !row.name.toLowerCase().includes(name)) return false;
+		return true;
+	});
+}
+/**
+* Sort rows by path (ascending), then by HTTP-method order within a path, so
+* every verb of one resource lists together in a predictable sequence.
+*
+* @param rows - The rows to sort
+* @returns A new, sorted array
+*/
+function sortRouteRows(rows) {
+	return [...rows].sort((a, b) => {
+		if (a.path !== b.path) return a.path < b.path ? -1 : 1;
+		return methodRank(a.method) - methodRank(b.method);
+	});
+}
+
+//#endregion
+export { filterRouteRows, methodRank, sortRouteRows, toRouteRow };
+//# sourceMappingURL=route-row.mjs.map

package/esm/cli/commands/routes/route-row.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-row.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/cli/commands/routes/route-row.ts"],"sourcesContent":["import type { Route } from \"../../../router/types\";\n\n/**\n * A single registered route, normalized to the flat, display-ready shape the\n * `warlock routes` table (and its `--json` output) render. Kept separate from\n * the live {@link Route} so the formatter and filters never touch the handler\n * function, validation object, or Fastify server options — only printable\n * scalars.\n */\nexport type RouteRow = {\n  /** Uppercased HTTP verb (`\"all\"` → `\"ALL\"`). */\n  method: string;\n\n  /** Full request path (prefix already folded in by the router). */\n  path: string;\n\n  /** Route name, or `\"\"` when the route was registered without one. */\n  name: string;\n\n  /** Handler/controller-action label — the handler function name, or `\"anonymous\"`. */\n  action: string;\n\n  /** Number of middleware attached to the route. */\n  middleware: number;\n\n  /** Relative source file the route was registered from, or `\"\"`. */\n  source: string;\n};\n\n/** Filters accepted by `warlock routes`, each optional and additive (AND-ed). */\nexport type RouteFilter = {\n  /** Exact HTTP method (case-insensitive). */\n  method?: string;\n\n  /** Case-insensitive substring matched against the path. */\n  path?: string;\n\n  /** Case-insensitive substring matched against the route name. */\n  name?: string;\n};\n\n/**\n * Display order of HTTP methods — used to rank rows within a path and to order\n * the per-method breakdown in the summary line.\n */\nexport const METHOD_ORDER = [\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"OPTIONS\",\n  \"HEAD\",\n  \"ALL\",\n];\n\n/**\n * Rank of a method for sorting. Unknown methods sort last (stable among\n * themselves).\n *\n * @param method - Uppercased HTTP verb\n * @returns The sort index\n */\nexport function methodRank(method: string): number {\n  const index = METHOD_ORDER.indexOf(method);\n  return index === -1 ? METHOD_ORDER.length : index;\n}\n\n/**\n * Derive the handler/controller-action label for a route. Uses the handler\n * function's name, stripping the `bound ` prefix that `Function.prototype.bind`\n * prepends, and falls back to `\"anonymous\"` for an unnamed handler.\n *\n * @param route - The route to label\n * @returns A printable action label\n */\nfunction routeAction(route: Route): string {\n  const handler = route.handler as unknown;\n\n  if (typeof handler !== \"function\") return \"anonymous\";\n\n  const name = handler.name?.replace(/^bound /, \"\").trim();\n\n  return name ? name : \"anonymous\";\n}\n\n/**\n * Normalize a live {@link Route} into a printable {@link RouteRow}.\n *\n * @param route - The registered route\n * @returns The display-ready row\n */\nexport function toRouteRow(route: Route): RouteRow {\n  return {\n    method: route.method.toUpperCase(),\n    path: route.path,\n    name: route.name ?? \"\",\n    action: routeAction(route),\n    middleware: route.middleware?.length ?? 0,\n    source: route.sourceFile ?? \"\",\n  };\n}\n\n/**\n * Apply the `--method` / `--path` / `--name` filters to a set of rows. An\n * omitted filter matches everything; provided filters are AND-ed.\n *\n * @param rows - The rows to filter\n * @param filter - The active filters\n * @returns The matching rows (a new array)\n */\nexport function filterRouteRows(rows: RouteRow[], filter: RouteFilter): RouteRow[] {\n  const method = filter.method?.toUpperCase();\n  const path = filter.path?.toLowerCase();\n  const name = filter.name?.toLowerCase();\n\n  return rows.filter((row) => {\n    if (method && row.method !== method) return false;\n    if (path && !row.path.toLowerCase().includes(path)) return false;\n    if (name && !row.name.toLowerCase().includes(name)) return false;\n    return true;\n  });\n}\n\n/**\n * Sort rows by path (ascending), then by HTTP-method order within a path, so\n * every verb of one resource lists together in a predictable sequence.\n *\n * @param rows - The rows to sort\n * @returns A new, sorted array\n */\nexport function sortRouteRows(rows: RouteRow[]): RouteRow[] {\n  return [...rows].sort((a, b) => {\n    if (a.path !== b.path) return a.path < b.path ? -1 : 1;\n    return methodRank(a.method) - methodRank(b.method);\n  });\n}\n"],"mappings":";;;;;AA6CA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;AASA,SAAgB,WAAW,QAAwB;CACjD,MAAM,QAAQ,aAAa,QAAQ,MAAM;CACzC,OAAO,UAAU,KAAK,aAAa,SAAS;AAC9C;;;;;;;;;AAUA,SAAS,YAAY,OAAsB;CACzC,MAAM,UAAU,MAAM;CAEtB,IAAI,OAAO,YAAY,YAAY,OAAO;CAE1C,MAAM,OAAO,QAAQ,MAAM,QAAQ,WAAW,EAAE,CAAC,CAAC,KAAK;CAEvD,OAAO,OAAO,OAAO;AACvB;;;;;;;AAQA,SAAgB,WAAW,OAAwB;CACjD,OAAO;EACL,QAAQ,MAAM,OAAO,YAAY;EACjC,MAAM,MAAM;EACZ,MAAM,MAAM,QAAQ;EACpB,QAAQ,YAAY,KAAK;EACzB,YAAY,MAAM,YAAY,UAAU;EACxC,QAAQ,MAAM,cAAc;CAC9B;AACF;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAkB,QAAiC;CACjF,MAAM,SAAS,OAAO,QAAQ,YAAY;CAC1C,MAAM,OAAO,OAAO,MAAM,YAAY;CACtC,MAAM,OAAO,OAAO,MAAM,YAAY;CAEtC,OAAO,KAAK,QAAQ,QAAQ;EAC1B,IAAI,UAAU,IAAI,WAAW,QAAQ,OAAO;EAC5C,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC3D,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC3D,OAAO;CACT,CAAC;AACH;;;;;;;;AASA,SAAgB,cAAc,MAA8B;CAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;EAC9B,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK;EACrD,OAAO,WAAW,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM;CACnD,CAAC;AACH"}