@warlock.js/core 5.29.0 → 5.31.0

package/esm/cli/commands/generate/generators/resource.generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.generator.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/generate/generators/resource.generator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../../commands/types\";\nimport { resourceStub } from \"../templates/stubs\";\nimport { putFileAsync, setDryRun } from \"../utils/writer\";\nimport { parseModulePath, parseName } from \"../utils/name-parser\";\nimport {\n  componentExists,\n  ensureComponentDirectory,\n  moduleExists,\n  resolveComponentPath,\n} from \"../utils/path-resolver\";\n\nexport async function generateResource(data: CommandActionData): Promise<void> {\n  const input = data.args[0];\n\n  if (!input) {\n    console.log(colors.red(\"Error: Resource name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.resource <module>/<name>\"));\n    console.log(colors.yellow(\"Example: warlock generate.resource users/user\"));\n    process.exit(1);\n  }\n\n  const { module, name: componentName } = parseModulePath(input);\n\n  if (!module) {\n    console.log(colors.red(\"Error: Module name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.resource <module>/<name>\"));\n    process.exit(1);\n  }\n\n  // Check if module exists\n  if (!(await moduleExists(module))) {\n    console.log(colors.red(`Error: Module \"${module}\" does not exist`));\n    console.log(colors.yellow(`Run: warlock generate.module ${module}`));\n    process.exit(1);\n  }\n\n  const name = parseName(componentName);\n  const force = data.options.force || data.options.f;\n  setDryRun(Boolean(data.options.dryRun));\n\n  // Check if resource already exists\n  if ((await componentExists(module, \"resources\", `${name.kebab}.resource`)) && !force) {\n    console.log(colors.red(`Error: Resource \"${name.kebab}.resource.ts\" already exists`));\n    console.log(colors.yellow(\"Use --force to overwrite\"));\n    process.exit(1);\n  }\n\n  // Ensure directories exist\n  await ensureComponentDirectory(module, \"resources\");\n\n  // Generate resource\n  const resourcePath = resolveComponentPath(module, \"resources\", `${name.kebab}.resource`);\n  const resourceContent = resourceStub(name);\n\n  await putFileAsync(resourcePath, resourceContent);\n\n  console.log(colors.cyan(`\\nResource \"${name.pascal}Resource\" generated successfully!`));\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,iBAAiB,MAAwC;CAC7E,MAAM,QAAQ,KAAK,KAAK;CAExB,IAAI,CAAC,OAAO;EACV,QAAQ,IAAI,OAAO,IAAI,kCAAkC,CAAC;EAC1D,QAAQ,IAAI,OAAO,OAAO,kDAAkD,CAAC;EAC7E,QAAQ,IAAI,OAAO,OAAO,+CAA+C,CAAC;EAC1E,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,EAAE,QAAQ,MAAM,kBAAkB,gBAAgB,KAAK;CAE7D,IAAI,CAAC,QAAQ;EACX,QAAQ,IAAI,OAAO,IAAI,gCAAgC,CAAC;EACxD,QAAQ,IAAI,OAAO,OAAO,kDAAkD,CAAC;EAC7E,QAAQ,KAAK,CAAC;CAChB;CAGA,IAAI,CAAE,MAAM,aAAa,MAAM,GAAI;EACjC,QAAQ,IAAI,OAAO,IAAI,kBAAkB,OAAO,iBAAiB,CAAC;EAClE,QAAQ,IAAI,OAAO,OAAO,gCAAgC,QAAQ,CAAC;EACnE,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,OAAO,UAAU,aAAa;CACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ;CACjD,UAAU,QAAQ,KAAK,QAAQ,MAAM,CAAC;CAGtC,IAAK,MAAM,gBAAgB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAAU,KAAM,CAAC,OAAO;EACpF,QAAQ,IAAI,OAAO,IAAI,oBAAoB,KAAK,MAAM,6BAA6B,CAAC;EACpF,QAAQ,IAAI,OAAO,OAAO,0BAA0B,CAAC;EACrD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,yBAAyB,QAAQ,WAAW;CAMlD,MAAM,aAHe,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAG/C,GAFN,aAAa,IAEU,CAAC;CAEhD,QAAQ,IAAI,OAAO,KAAK,eAAe,KAAK,OAAO,kCAAkC,CAAC;AACxF"}
+{"version":3,"file":"resource.generator.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/generators/resource.generator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../../commands/types\";\nimport { resourceStub } from \"../templates/stubs\";\nimport { putFileAsync, setDryRun } from \"../utils/writer\";\nimport { parseModulePath, parseName } from \"../utils/name-parser\";\nimport {\n  componentExists,\n  ensureComponentDirectory,\n  moduleExists,\n  resolveComponentPath,\n} from \"../utils/path-resolver\";\n\nexport async function generateResource(data: CommandActionData): Promise<void> {\n  const input = data.args[0];\n\n  if (!input) {\n    console.log(colors.red(\"Error: Resource name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.resource <module>/<name>\"));\n    console.log(colors.yellow(\"Example: warlock generate.resource users/user\"));\n    process.exit(1);\n  }\n\n  const { module, name: componentName } = parseModulePath(input);\n\n  if (!module) {\n    console.log(colors.red(\"Error: Module name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.resource <module>/<name>\"));\n    process.exit(1);\n  }\n\n  // Check if module exists\n  if (!(await moduleExists(module))) {\n    console.log(colors.red(`Error: Module \"${module}\" does not exist`));\n    console.log(colors.yellow(`Run: warlock generate.module ${module}`));\n    process.exit(1);\n  }\n\n  const name = parseName(componentName);\n  const force = data.options.force || data.options.f;\n  setDryRun(Boolean(data.options.dryRun));\n\n  // Check if resource already exists\n  if ((await componentExists(module, \"resources\", `${name.kebab}.resource`)) && !force) {\n    console.log(colors.red(`Error: Resource \"${name.kebab}.resource.ts\" already exists`));\n    console.log(colors.yellow(\"Use --force to overwrite\"));\n    process.exit(1);\n  }\n\n  // Ensure directories exist\n  await ensureComponentDirectory(module, \"resources\");\n\n  // Generate resource\n  const resourcePath = resolveComponentPath(module, \"resources\", `${name.kebab}.resource`);\n  const resourceContent = resourceStub(name);\n\n  await putFileAsync(resourcePath, resourceContent);\n\n  console.log(colors.cyan(`\\nResource \"${name.pascal}Resource\" generated successfully!`));\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,iBAAiB,MAAwC;CAC7E,MAAM,QAAQ,KAAK,KAAK;CAExB,IAAI,CAAC,OAAO;EACV,QAAQ,IAAI,OAAO,IAAI,kCAAkC,CAAC;EAC1D,QAAQ,IAAI,OAAO,OAAO,kDAAkD,CAAC;EAC7E,QAAQ,IAAI,OAAO,OAAO,+CAA+C,CAAC;EAC1E,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,EAAE,QAAQ,MAAM,kBAAkB,gBAAgB,KAAK;CAE7D,IAAI,CAAC,QAAQ;EACX,QAAQ,IAAI,OAAO,IAAI,gCAAgC,CAAC;EACxD,QAAQ,IAAI,OAAO,OAAO,kDAAkD,CAAC;EAC7E,QAAQ,KAAK,CAAC;CAChB;CAGA,IAAI,CAAE,MAAM,aAAa,MAAM,GAAI;EACjC,QAAQ,IAAI,OAAO,IAAI,kBAAkB,OAAO,iBAAiB,CAAC;EAClE,QAAQ,IAAI,OAAO,OAAO,gCAAgC,QAAQ,CAAC;EACnE,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,OAAO,UAAU,aAAa;CACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ;CACjD,UAAU,QAAQ,KAAK,QAAQ,MAAM,CAAC;CAGtC,IAAK,MAAM,gBAAgB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAAU,KAAM,CAAC,OAAO;EACpF,QAAQ,IAAI,OAAO,IAAI,oBAAoB,KAAK,MAAM,6BAA6B,CAAC;EACpF,QAAQ,IAAI,OAAO,OAAO,0BAA0B,CAAC;EACrD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,yBAAyB,QAAQ,WAAW;CAMlD,MAAM,aAHe,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAG/C,GAFN,aAAa,IAEU,CAAC;CAEhD,QAAQ,IAAI,OAAO,KAAK,eAAe,KAAK,OAAO,kCAAkC,CAAC;AACxF"}

package/esm/cli/commands/generate/generators/service.generator.mjs

@@ -4,7 +4,7 @@ import { putFileAsync, setDryRun } from "../utils/writer.mjs";
 import { componentExists, ensureComponentDirectory, moduleExists, resolveComponentPath } from "../utils/path-resolver.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/cli/commands/generate/generators/service.generator.ts
+//#region ../../packages/core/src/cli/commands/generate/generators/service.generator.ts
 async function generateService(data) {
 	const input = data.args[0];
 	if (!input) {

package/esm/cli/commands/generate/generators/service.generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.generator.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/generate/generators/service.generator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../../commands/types\";\nimport { serviceStub } from \"../templates/stubs\";\nimport { putFileAsync, setDryRun } from \"../utils/writer\";\nimport { parseModulePath, parseName } from \"../utils/name-parser\";\nimport {\n  componentExists,\n  ensureComponentDirectory,\n  moduleExists,\n  resolveComponentPath,\n} from \"../utils/path-resolver\";\n\nexport async function generateService(data: CommandActionData): Promise<void> {\n  const input = data.args[0];\n\n  if (!input) {\n    console.log(colors.red(\"Error: Service name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.service <module>/<name>\"));\n    console.log(colors.yellow(\"Example: warlock generate.service users/create-user\"));\n    process.exit(1);\n  }\n\n  const { module, name: componentName } = parseModulePath(input);\n\n  if (!module) {\n    console.log(colors.red(\"Error: Module name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.service <module>/<name>\"));\n    process.exit(1);\n  }\n\n  // Check if module exists\n  if (!(await moduleExists(module))) {\n    console.log(colors.red(`Error: Module \"${module}\" does not exist`));\n    console.log(colors.yellow(`Run: warlock generate.module ${module}`));\n    process.exit(1);\n  }\n\n  const name = parseName(componentName);\n  const force = data.options.force || data.options.f;\n  setDryRun(Boolean(data.options.dryRun));\n\n  // Check if service already exists\n  if ((await componentExists(module, \"services\", `${name.kebab}.service`)) && !force) {\n    console.log(colors.red(`Error: Service \"${name.kebab}.service.ts\" already exists`));\n    console.log(colors.yellow(\"Use --force to overwrite\"));\n    process.exit(1);\n  }\n\n  // Ensure directories exist\n  await ensureComponentDirectory(module, \"services\");\n\n  // Generate service\n  const servicePath = resolveComponentPath(module, \"services\", `${name.kebab}.service`);\n  const serviceContent = serviceStub(name);\n\n  await putFileAsync(servicePath, serviceContent);\n\n  console.log(colors.cyan(`\\n✨ Service \"${name.camel}\" generated successfully!`));\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,gBAAgB,MAAwC;CAC5E,MAAM,QAAQ,KAAK,KAAK;CAExB,IAAI,CAAC,OAAO;EACV,QAAQ,IAAI,OAAO,IAAI,iCAAiC,CAAC;EACzD,QAAQ,IAAI,OAAO,OAAO,iDAAiD,CAAC;EAC5E,QAAQ,IAAI,OAAO,OAAO,qDAAqD,CAAC;EAChF,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,EAAE,QAAQ,MAAM,kBAAkB,gBAAgB,KAAK;CAE7D,IAAI,CAAC,QAAQ;EACX,QAAQ,IAAI,OAAO,IAAI,gCAAgC,CAAC;EACxD,QAAQ,IAAI,OAAO,OAAO,iDAAiD,CAAC;EAC5E,QAAQ,KAAK,CAAC;CAChB;CAGA,IAAI,CAAE,MAAM,aAAa,MAAM,GAAI;EACjC,QAAQ,IAAI,OAAO,IAAI,kBAAkB,OAAO,iBAAiB,CAAC;EAClE,QAAQ,IAAI,OAAO,OAAO,gCAAgC,QAAQ,CAAC;EACnE,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,OAAO,UAAU,aAAa;CACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ;CACjD,UAAU,QAAQ,KAAK,QAAQ,MAAM,CAAC;CAGtC,IAAK,MAAM,gBAAgB,QAAQ,YAAY,GAAG,KAAK,MAAM,SAAS,KAAM,CAAC,OAAO;EAClF,QAAQ,IAAI,OAAO,IAAI,mBAAmB,KAAK,MAAM,4BAA4B,CAAC;EAClF,QAAQ,IAAI,OAAO,OAAO,0BAA0B,CAAC;EACrD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,yBAAyB,QAAQ,UAAU;CAMjD,MAAM,aAHc,qBAAqB,QAAQ,YAAY,GAAG,KAAK,MAAM,SAG9C,GAFN,YAAY,IAEU,CAAC;CAE9C,QAAQ,IAAI,OAAO,KAAK,gBAAgB,KAAK,MAAM,0BAA0B,CAAC;AAChF"}
+{"version":3,"file":"service.generator.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/generators/service.generator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../../commands/types\";\nimport { serviceStub } from \"../templates/stubs\";\nimport { putFileAsync, setDryRun } from \"../utils/writer\";\nimport { parseModulePath, parseName } from \"../utils/name-parser\";\nimport {\n  componentExists,\n  ensureComponentDirectory,\n  moduleExists,\n  resolveComponentPath,\n} from \"../utils/path-resolver\";\n\nexport async function generateService(data: CommandActionData): Promise<void> {\n  const input = data.args[0];\n\n  if (!input) {\n    console.log(colors.red(\"Error: Service name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.service <module>/<name>\"));\n    console.log(colors.yellow(\"Example: warlock generate.service users/create-user\"));\n    process.exit(1);\n  }\n\n  const { module, name: componentName } = parseModulePath(input);\n\n  if (!module) {\n    console.log(colors.red(\"Error: Module name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.service <module>/<name>\"));\n    process.exit(1);\n  }\n\n  // Check if module exists\n  if (!(await moduleExists(module))) {\n    console.log(colors.red(`Error: Module \"${module}\" does not exist`));\n    console.log(colors.yellow(`Run: warlock generate.module ${module}`));\n    process.exit(1);\n  }\n\n  const name = parseName(componentName);\n  const force = data.options.force || data.options.f;\n  setDryRun(Boolean(data.options.dryRun));\n\n  // Check if service already exists\n  if ((await componentExists(module, \"services\", `${name.kebab}.service`)) && !force) {\n    console.log(colors.red(`Error: Service \"${name.kebab}.service.ts\" already exists`));\n    console.log(colors.yellow(\"Use --force to overwrite\"));\n    process.exit(1);\n  }\n\n  // Ensure directories exist\n  await ensureComponentDirectory(module, \"services\");\n\n  // Generate service\n  const servicePath = resolveComponentPath(module, \"services\", `${name.kebab}.service`);\n  const serviceContent = serviceStub(name);\n\n  await putFileAsync(servicePath, serviceContent);\n\n  console.log(colors.cyan(`\\n✨ Service \"${name.camel}\" generated successfully!`));\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,gBAAgB,MAAwC;CAC5E,MAAM,QAAQ,KAAK,KAAK;CAExB,IAAI,CAAC,OAAO;EACV,QAAQ,IAAI,OAAO,IAAI,iCAAiC,CAAC;EACzD,QAAQ,IAAI,OAAO,OAAO,iDAAiD,CAAC;EAC5E,QAAQ,IAAI,OAAO,OAAO,qDAAqD,CAAC;EAChF,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,EAAE,QAAQ,MAAM,kBAAkB,gBAAgB,KAAK;CAE7D,IAAI,CAAC,QAAQ;EACX,QAAQ,IAAI,OAAO,IAAI,gCAAgC,CAAC;EACxD,QAAQ,IAAI,OAAO,OAAO,iDAAiD,CAAC;EAC5E,QAAQ,KAAK,CAAC;CAChB;CAGA,IAAI,CAAE,MAAM,aAAa,MAAM,GAAI;EACjC,QAAQ,IAAI,OAAO,IAAI,kBAAkB,OAAO,iBAAiB,CAAC;EAClE,QAAQ,IAAI,OAAO,OAAO,gCAAgC,QAAQ,CAAC;EACnE,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,OAAO,UAAU,aAAa;CACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ;CACjD,UAAU,QAAQ,KAAK,QAAQ,MAAM,CAAC;CAGtC,IAAK,MAAM,gBAAgB,QAAQ,YAAY,GAAG,KAAK,MAAM,SAAS,KAAM,CAAC,OAAO;EAClF,QAAQ,IAAI,OAAO,IAAI,mBAAmB,KAAK,MAAM,4BAA4B,CAAC;EAClF,QAAQ,IAAI,OAAO,OAAO,0BAA0B,CAAC;EACrD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,yBAAyB,QAAQ,UAAU;CAMjD,MAAM,aAHc,qBAAqB,QAAQ,YAAY,GAAG,KAAK,MAAM,SAG9C,GAFN,YAAY,IAEU,CAAC;CAE9C,QAAQ,IAAI,OAAO,KAAK,gBAAgB,KAAK,MAAM,0BAA0B,CAAC;AAChF"}

package/esm/cli/commands/generate/generators/use-case.generator.mjs

@@ -4,7 +4,7 @@ import { putFileAsync, setDryRun } from "../utils/writer.mjs";
 import { componentExists, ensureComponentDirectory, moduleExists, resolveComponentPath } from "../utils/path-resolver.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/cli/commands/generate/generators/use-case.generator.ts
+//#region ../../packages/core/src/cli/commands/generate/generators/use-case.generator.ts
 async function generateUseCase(data) {
 	const input = data.args[0];
 	if (!input) {

package/esm/cli/commands/generate/generators/use-case.generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-case.generator.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/generate/generators/use-case.generator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../../commands/types\";\nimport { useCaseSpecStub, useCaseStub } from \"../templates/stubs\";\nimport { parseModulePath, parseName } from \"../utils/name-parser\";\nimport {\n  componentExists,\n  ensureComponentDirectory,\n  moduleExists,\n  resolveComponentPath,\n} from \"../utils/path-resolver\";\nimport { putFileAsync, setDryRun } from \"../utils/writer\";\n\nexport async function generateUseCase(data: CommandActionData): Promise<void> {\n  const input = data.args[0];\n\n  if (!input) {\n    console.log(colors.red(\"Error: Use-case name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.use-case <module>/<verb-noun>\"));\n    console.log(colors.yellow(\"Example: warlock generate.use-case orders/place-order\"));\n    process.exit(1);\n  }\n\n  const { module, name: componentName } = parseModulePath(input);\n\n  if (!module) {\n    console.log(colors.red(\"Error: Module name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.use-case <module>/<verb-noun>\"));\n    process.exit(1);\n  }\n\n  if (!(await moduleExists(module))) {\n    console.log(colors.red(`Error: Module \"${module}\" does not exist`));\n    console.log(colors.yellow(`Run: warlock generate.module ${module}`));\n    process.exit(1);\n  }\n\n  const name = parseName(componentName);\n  const force = data.options.force || data.options.f;\n  setDryRun(Boolean(data.options.dryRun));\n\n  // Refuse to overwrite either file unless --force\n  for (const file of [`${name.kebab}.use-case`, `${name.kebab}.use-case.spec`]) {\n    if ((await componentExists(module, \"use-cases\", file)) && !force) {\n      console.log(colors.red(`Error: Use-case file \"${file}.ts\" already exists`));\n      console.log(colors.yellow(\"Use --force to overwrite\"));\n      process.exit(1);\n    }\n  }\n\n  await ensureComponentDirectory(module, \"use-cases\");\n\n  await putFileAsync(\n    resolveComponentPath(module, \"use-cases\", `${name.kebab}.use-case`),\n    useCaseStub(name),\n  );\n  await putFileAsync(\n    resolveComponentPath(module, \"use-cases\", `${name.kebab}.use-case.spec`),\n    useCaseSpecStub(name),\n  );\n\n  console.log(colors.cyan(`\\n✨ Use-case \"${name.camel}UseCase\" generated successfully!`));\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,gBAAgB,MAAwC;CAC5E,MAAM,QAAQ,KAAK,KAAK;CAExB,IAAI,CAAC,OAAO;EACV,QAAQ,IAAI,OAAO,IAAI,kCAAkC,CAAC;EAC1D,QAAQ,IAAI,OAAO,OAAO,uDAAuD,CAAC;EAClF,QAAQ,IAAI,OAAO,OAAO,uDAAuD,CAAC;EAClF,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,EAAE,QAAQ,MAAM,kBAAkB,gBAAgB,KAAK;CAE7D,IAAI,CAAC,QAAQ;EACX,QAAQ,IAAI,OAAO,IAAI,gCAAgC,CAAC;EACxD,QAAQ,IAAI,OAAO,OAAO,uDAAuD,CAAC;EAClF,QAAQ,KAAK,CAAC;CAChB;CAEA,IAAI,CAAE,MAAM,aAAa,MAAM,GAAI;EACjC,QAAQ,IAAI,OAAO,IAAI,kBAAkB,OAAO,iBAAiB,CAAC;EAClE,QAAQ,IAAI,OAAO,OAAO,gCAAgC,QAAQ,CAAC;EACnE,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,OAAO,UAAU,aAAa;CACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ;CACjD,UAAU,QAAQ,KAAK,QAAQ,MAAM,CAAC;CAGtC,KAAK,MAAM,QAAQ,CAAC,GAAG,KAAK,MAAM,YAAY,GAAG,KAAK,MAAM,eAAe,GACzE,IAAK,MAAM,gBAAgB,QAAQ,aAAa,IAAI,KAAM,CAAC,OAAO;EAChE,QAAQ,IAAI,OAAO,IAAI,yBAAyB,KAAK,oBAAoB,CAAC;EAC1E,QAAQ,IAAI,OAAO,OAAO,0BAA0B,CAAC;EACrD,QAAQ,KAAK,CAAC;CAChB;CAGF,MAAM,yBAAyB,QAAQ,WAAW;CAElD,MAAM,aACJ,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAAU,GAClE,YAAY,IAAI,CAClB;CACA,MAAM,aACJ,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,eAAe,GACvE,gBAAgB,IAAI,CACtB;CAEA,QAAQ,IAAI,OAAO,KAAK,iBAAiB,KAAK,MAAM,iCAAiC,CAAC;AACxF"}
+{"version":3,"file":"use-case.generator.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/generators/use-case.generator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../../commands/types\";\nimport { useCaseSpecStub, useCaseStub } from \"../templates/stubs\";\nimport { parseModulePath, parseName } from \"../utils/name-parser\";\nimport {\n  componentExists,\n  ensureComponentDirectory,\n  moduleExists,\n  resolveComponentPath,\n} from \"../utils/path-resolver\";\nimport { putFileAsync, setDryRun } from \"../utils/writer\";\n\nexport async function generateUseCase(data: CommandActionData): Promise<void> {\n  const input = data.args[0];\n\n  if (!input) {\n    console.log(colors.red(\"Error: Use-case name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.use-case <module>/<verb-noun>\"));\n    console.log(colors.yellow(\"Example: warlock generate.use-case orders/place-order\"));\n    process.exit(1);\n  }\n\n  const { module, name: componentName } = parseModulePath(input);\n\n  if (!module) {\n    console.log(colors.red(\"Error: Module name is required\"));\n    console.log(colors.yellow(\"Usage: warlock generate.use-case <module>/<verb-noun>\"));\n    process.exit(1);\n  }\n\n  if (!(await moduleExists(module))) {\n    console.log(colors.red(`Error: Module \"${module}\" does not exist`));\n    console.log(colors.yellow(`Run: warlock generate.module ${module}`));\n    process.exit(1);\n  }\n\n  const name = parseName(componentName);\n  const force = data.options.force || data.options.f;\n  setDryRun(Boolean(data.options.dryRun));\n\n  // Refuse to overwrite either file unless --force\n  for (const file of [`${name.kebab}.use-case`, `${name.kebab}.use-case.spec`]) {\n    if ((await componentExists(module, \"use-cases\", file)) && !force) {\n      console.log(colors.red(`Error: Use-case file \"${file}.ts\" already exists`));\n      console.log(colors.yellow(\"Use --force to overwrite\"));\n      process.exit(1);\n    }\n  }\n\n  await ensureComponentDirectory(module, \"use-cases\");\n\n  await putFileAsync(\n    resolveComponentPath(module, \"use-cases\", `${name.kebab}.use-case`),\n    useCaseStub(name),\n  );\n  await putFileAsync(\n    resolveComponentPath(module, \"use-cases\", `${name.kebab}.use-case.spec`),\n    useCaseSpecStub(name),\n  );\n\n  console.log(colors.cyan(`\\n✨ Use-case \"${name.camel}UseCase\" generated successfully!`));\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,gBAAgB,MAAwC;CAC5E,MAAM,QAAQ,KAAK,KAAK;CAExB,IAAI,CAAC,OAAO;EACV,QAAQ,IAAI,OAAO,IAAI,kCAAkC,CAAC;EAC1D,QAAQ,IAAI,OAAO,OAAO,uDAAuD,CAAC;EAClF,QAAQ,IAAI,OAAO,OAAO,uDAAuD,CAAC;EAClF,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,EAAE,QAAQ,MAAM,kBAAkB,gBAAgB,KAAK;CAE7D,IAAI,CAAC,QAAQ;EACX,QAAQ,IAAI,OAAO,IAAI,gCAAgC,CAAC;EACxD,QAAQ,IAAI,OAAO,OAAO,uDAAuD,CAAC;EAClF,QAAQ,KAAK,CAAC;CAChB;CAEA,IAAI,CAAE,MAAM,aAAa,MAAM,GAAI;EACjC,QAAQ,IAAI,OAAO,IAAI,kBAAkB,OAAO,iBAAiB,CAAC;EAClE,QAAQ,IAAI,OAAO,OAAO,gCAAgC,QAAQ,CAAC;EACnE,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,OAAO,UAAU,aAAa;CACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ;CACjD,UAAU,QAAQ,KAAK,QAAQ,MAAM,CAAC;CAGtC,KAAK,MAAM,QAAQ,CAAC,GAAG,KAAK,MAAM,YAAY,GAAG,KAAK,MAAM,eAAe,GACzE,IAAK,MAAM,gBAAgB,QAAQ,aAAa,IAAI,KAAM,CAAC,OAAO;EAChE,QAAQ,IAAI,OAAO,IAAI,yBAAyB,KAAK,oBAAoB,CAAC;EAC1E,QAAQ,IAAI,OAAO,OAAO,0BAA0B,CAAC;EACrD,QAAQ,KAAK,CAAC;CAChB;CAGF,MAAM,yBAAyB,QAAQ,WAAW;CAElD,MAAM,aACJ,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAAU,GAClE,YAAY,IAAI,CAClB;CACA,MAAM,aACJ,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,eAAe,GACvE,gBAAgB,IAAI,CACtB;CAEA,QAAQ,IAAI,OAAO,KAAK,iBAAiB,KAAK,MAAM,iCAAiC,CAAC;AACxF"}

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

@@ -0,0 +1,341 @@
+//#region ../../packages/core/src/cli/commands/generate/templates/endpoint-stubs.ts
+/** `POST /posts` — used in comments, test names and descriptions. */
+function endpointLabel(spec) {
+	return `${spec.method.toUpperCase()} ${spec.path}`;
+}
+/** The success status the controller answers with. */
+function endpointStatus(spec) {
+	return spec.method === "post" ? 201 : 200;
+}
+/** `createPostSuccess` — the locale key of the success message. */
+function successMessageKey(spec) {
+	return `${spec.name.camel}Success`;
+}
+/** `Create post completed successfully.` — the English success message. */
+function successMessage(spec) {
+	const words = spec.name.kebab.split("-").join(" ");
+	return `${words.charAt(0).toUpperCase()}${words.slice(1)} completed successfully.`;
+}
+/** The key the resource sits under in the response body, e.g. `post`. */
+function resourceResponseKey(spec) {
+	return spec.resource.singular.camel;
+}
+/** `schema/<name>.schema.ts` when no `--schema` file was given. */
+function endpointSchemaStub(spec) {
+	return `import { type Infer, v } from "@warlock.js/seal";
+
+/** Request input for ${endpointLabel(spec)}. */
+export const ${spec.name.camel}Schema = v.object({
+  // TODO: describe the request input, then run make endpoint again with --force
+  // to regenerate the resource and test from it.
+});
+
+export type ${spec.name.pascal}Schema = Infer<typeof ${spec.name.camel}Schema>;
+`;
+}
+/** `services/<name>.service.ts`. */
+function endpointServiceStub(spec) {
+	return `import type { ${spec.name.pascal}Schema } from "../schema/${spec.name.kebab}.schema";
+
+/**
+ * The work behind ${endpointLabel(spec)}. It takes validated input, never the
+ * request, so a job, a command or another service can call it too.
+ */
+export async function ${spec.name.camel}Service(input: ${spec.name.pascal}Schema) {
+  // TODO: persist or act on the input, then return what the endpoint answers with.
+  return input;
+}
+`;
+}
+/** `resources/<resource>.resource.ts`, shaped from the request fields. */
+function endpointResourceStub(spec) {
+	const fields = spec.fields.filter((field) => field.cast !== void 0);
+	const body = fields.length === 0 ? "    // TODO: list the fields this resource outputs, e.g. id: \"number\"" : fields.map((field) => `    ${propertyKey(field.name)}: "${field.cast}",`).join("\n");
+	return `import { defineResource } from "@warlock.js/core";
+
+/** What ${spec.resource.pascal} looks like in a response. */
+export const ${spec.resource.pascal}Resource = defineResource({
+  schema: {
+${body}
+  },
+});
+`;
+}
+/** `controllers/<name>.controller.ts` — one handler per file. */
+function endpointControllerStub(spec) {
+	const resource = `${spec.resource.pascal}Resource`;
+	const key = resourceResponseKey(spec);
+	const status = endpointStatus(spec);
+	const respond = status === 201 ? "successCreate" : "success";
+	const controller = `${spec.name.camel}Controller`;
+	const schemaType = `${spec.name.pascal}Schema`;
+	const handlerType = spec.access === "guarded" ? `GuardedRequestHandler<${schemaType}>` : `RequestHandler<Request<${schemaType}>>`;
+	return `${spec.access === "guarded" ? `import { t } from "@warlock.js/core";
+import { type GuardedRequestHandler } from "app/auth/requests/guarded.request";` : `import { type Request, type RequestHandler, t } from "@warlock.js/core";`}
+import { ${resource} } from "../resources/${spec.resource.singular.kebab}.resource";
+import { type ${schemaType}, ${spec.name.camel}Schema } from "../schema/${spec.name.kebab}.schema";
+import { ${spec.name.camel}Service } from "../services/${spec.name.kebab}.service";
+
+/** ${endpointLabel(spec)} */
+export const ${controller}: ${handlerType} = async ({
+  request,
+  response,
+}) => {
+  const ${key} = await ${spec.name.camel}Service(request.validated());
+
+  return response.${respond}({
+    message: t("${spec.module}.${successMessageKey(spec)}"),
+    ${key}: new ${resource}(${key}),
+  });
+};
+
+${controller}.description = "${successMessage(spec).replace(" completed successfully.", "")}";
+
+${controller}.validation = {
+  schema: ${spec.name.camel}Schema,
+};
+
+// Documents the success response for \`warlock generate.openapi\` and the typed route map.
+${controller}.responseSchema = {
+  ${status}: {
+    body: {
+      message: "string",
+      ${key}: ${resource},
+    },
+  },
+};
+`;
+}
+/** The import lines a module `routes.ts` needs for this endpoint. */
+function endpointRouteImports(spec) {
+	return [`import { ${spec.name.camel}Controller } from "./controllers/${spec.name.kebab}.controller";`];
+}
+/** The registration block appended to the module's `routes.ts`. */
+function endpointRouteRegistration(spec) {
+	const controller = `${spec.name.camel}Controller`;
+	if (spec.access === "public") return `// ${endpointLabel(spec)} — public on purpose: no auth guard.
+router.${spec.method}("${spec.path}", ${controller}, { public: true });
+`;
+	return `guarded(() => {
+  router.${spec.method}("${spec.path}", ${controller});
+});
+`;
+}
+/** A fresh module `routes.ts` holding only this endpoint. */
+function endpointRoutesFileStub(spec) {
+	const imports = [`import { router } from "@warlock.js/core";`];
+	if (spec.access === "guarded") imports.push(`import { guarded } from "app/shared/utils/router";`);
+	imports.push(...endpointRouteImports(spec));
+	return `${imports.join("\n")}
+
+${endpointRouteRegistration(spec)}`;
+}
+/** The path the generated test requests: route params get a placeholder. */
+function endpointTestPath(spec) {
+	return spec.path.replace(/:[A-Za-z0-9_]+\??/g, "1");
+}
+/** The request input the generated test sends: every field JSON can carry. */
+function endpointSampleInput(spec) {
+	const input = {};
+	for (const field of spec.fields) if (field.sample !== void 0) input[field.name] = field.sample;
+	return input;
+}
+/** The part of the input the response echoes unchanged. */
+function comparableInput(spec) {
+	const input = {};
+	for (const field of spec.fields) if (field.comparable) input[field.name] = field.sample;
+	return input;
+}
+/** A required field the test can drop to prove validation runs, if any. */
+function droppableRequiredField(spec) {
+	return spec.fields.find((field) => field.required && field.sample !== void 0);
+}
+/** Fields JSON cannot carry (files): the happy path needs multipart instead. */
+function uncarriableRequiredFields(spec) {
+	return spec.fields.filter((field) => field.required && field.sample === void 0).map((field) => field.name);
+}
+function propertyKey(name) {
+	return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
+}
+/** A TypeScript literal for a JSON value: unquoted identifier keys, trailing commas. */
+function toLiteral(value, indent) {
+	if (Array.isArray(value)) {
+		if (value.length === 0) return "[]";
+		return `[\n${value.map((item) => `${indent}  ${toLiteral(item, `${indent}  `)},`).join("\n")}\n${indent}]`;
+	}
+	if (typeof value === "object" && value !== null) {
+		const entries = Object.entries(value);
+		if (entries.length === 0) return "{}";
+		return `{\n${entries.map(([key, item]) => `${indent}  ${propertyKey(key)}: ${toLiteral(item, `${indent}  `)},`).join("\n")}\n${indent}}`;
+	}
+	return JSON.stringify(value);
+}
+function indentJson(value, indent) {
+	return toLiteral(value, indent);
+}
+/**
+* The statement that sends `inputExpression` to the endpoint, through
+* `client` (`testRequest`-shaped helpers or an `actingAs()` client).
+*/
+function sendRequest(spec, client, inputExpression) {
+	const path = JSON.stringify(endpointTestPath(spec));
+	switch (spec.method) {
+		case "get": return `${client === "" ? "testGet" : `${client}.get`}(${path} + "?" + new URLSearchParams(toQuery(${inputExpression})).toString())`;
+		case "delete": return `${client === "" ? "testRequest" : `${client}.request`}(${path}, {
+      method: "DELETE",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(${inputExpression}),
+    })`;
+		default: {
+			const helper = `test${spec.method.charAt(0).toUpperCase()}${spec.method.slice(1)}`;
+			return `${client === "" ? helper : `${client}.${spec.method}`}(${path}, ${inputExpression})`;
+		}
+	}
+}
+/** The `@warlock.js/core/tests` helpers a test sends anonymous requests with. */
+function anonymousHelpers(spec) {
+	switch (spec.method) {
+		case "get": return ["testGet"];
+		case "delete": return ["testRequest"];
+		default: return [`test${spec.method.charAt(0).toUpperCase()}${spec.method.slice(1)}`];
+	}
+}
+/**
+* `tests/<name>.test.ts` — requests the endpoint over the real HTTP stack
+* (the test server `warlock add test` wires up): routing, middleware,
+* validation, controller, resource and serialization all run.
+*/
+function endpointTestStub(spec) {
+	const label = endpointLabel(spec);
+	const key = resourceResponseKey(spec);
+	const status = endpointStatus(spec);
+	const input = endpointSampleInput(spec);
+	const expected = comparableInput(spec);
+	const dropped = droppableRequiredField(spec);
+	const uncarriable = uncarriableRequiredFields(spec);
+	const guarded = spec.access === "guarded";
+	const needsQuery = spec.method === "get";
+	const helpers = new Set(["expectJson", ...anonymousHelpers(spec)]);
+	if (guarded) helpers.add("actingAs");
+	const lines = [];
+	if (guarded) {
+		lines.push(`import type { Auth } from "@warlock.js/auth";`);
+		lines.push(`import type { ChildModel } from "@warlock.js/cascade";`);
+		lines.push(`import { config } from "@warlock.js/core";`);
+	}
+	lines.push(`import { ${[...helpers].sort().join(", ")} } from "@warlock.js/core/tests";`);
+	if (guarded) lines.push(`import { randomUUID } from "node:crypto";`);
+	lines.push(`import { ${guarded ? "afterAll, describe, expect, it" : "describe, expect, it"} } from "vitest";`);
+	const header = `${lines.join("\n")}
+
+/** A valid request for ${label}, derived from its schema. */
+const validInput: Record<string, unknown> = ${indentJson(input, "")};
+${needsQuery ? `
+/** Query values travel as strings; numeric schema fields need \`.coerce()\`. */
+function toQuery(input: Record<string, unknown>): Record<string, string> {
+  return Object.fromEntries(Object.entries(input).map(([key, value]) => [key, String(value)]));
+}
+` : ""}`;
+	const happyAssertions = (indent) => [
+		`const body = await expectJson<{ message: string; ${key}: Record<string, unknown> }>(`,
+		`  response,`,
+		`  ${status},`,
+		`);`,
+		``,
+		`expect(typeof body.message).toBe("string");`,
+		`expect(body.${key}).toMatchObject(${indentJson(expected, indent)});`
+	].map((line, index) => index === 0 || line === "" ? line : `${indent}${line}`).join("\n");
+	const dropStatement = dropped ? `const input = { ...validInput };
+
+    delete input[${JSON.stringify(dropped.name)}];
+` : "";
+	const validationCase = dropped ? `
+  it("rejects a request without ${dropped.name}", async () => {
+    ${dropStatement}
+    const response = await ${sendRequest(spec, "", "input")};
+
+    expect(response.status).toBeGreaterThanOrEqual(400);
+    expect(response.status).toBeLessThan(500);
+  });
+` : "";
+	if (!guarded) return `${header}
+describe("${label}", () => {
+${uncarriable.length > 0 ? `  it.todo("answers a valid request — send ${uncarriable.join(", ")} as multipart form data (JSON cannot carry files)");\n` : `  it("answers a valid request with the ${spec.resource.singular.pascal} resource", async () => {
+    const response = await ${sendRequest(spec, "", "validInput")};
+
+    ${happyAssertions("    ")}
+  });
+`}${validationCase}});
+`;
+	const signedInHappy = uncarriable.length > 0 ? `  it.todo("answers a signed-in user — send ${uncarriable.join(", ")} as multipart form data (JSON cannot carry files)");\n` : `  it("answers a signed-in user with the ${spec.resource.singular.pascal} resource", async () => {
+    const client = await signIn();
+
+    try {
+      const response = await ${sendRequest(spec, "client", "validInput")};
+
+      ${happyAssertions("      ")}
+    } finally {
+      await client.dispose();
+    }
+  });
+`;
+	const guardedValidation = dropped ? `
+  it("rejects a request without ${dropped.name}", async () => {
+    const client = await signIn();
+
+    try {
+      const input = { ...validInput };
+
+      delete input[${JSON.stringify(dropped.name)}];
+
+      const response = await ${sendRequest(spec, "client", "input")};
+
+      expect(response.status).toBeGreaterThanOrEqual(400);
+      expect(response.status).toBeLessThan(500);
+    } finally {
+      await client.dispose();
+    }
+  });
+` : "";
+	return `${header}
+describe("${label}", () => {
+  const users: Auth[] = [];
+
+  /** A real user and a real access token; adjust the fields if your user model requires more. */
+  async function signIn() {
+    const User = config.key<ChildModel<Auth>>("auth.userType.user");
+
+    if (!User) throw new Error("This test needs the configured auth.userType.user model.");
+
+    const user = await User.create({
+      name: "Endpoint test user",
+      email: "endpoint-" + randomUUID() + "@example.test",
+      password: "test-password",
+    });
+
+    users.push(user);
+
+    return actingAs(user);
+  }
+
+  afterAll(async () => {
+    await Promise.all(users.splice(0).map((user) => user.destroy({ strategy: "permanent" })));
+  });
+
+  it("rejects an anonymous request", async () => {
+    const response = await ${sendRequest(spec, "", "validInput")};
+
+    expect(response.status).toBe(401);
+  });
+
+${signedInHappy}${guardedValidation}});
+`;
+}
+/** The locale entry merged into the module's `utils/locales.json`. */
+function endpointLocaleEntries(spec) {
+	return { [successMessageKey(spec)]: { en: successMessage(spec) } };
+}
+
+//#endregion
+export { endpointControllerStub, endpointLabel, endpointLocaleEntries, endpointResourceStub, endpointRouteImports, endpointRouteRegistration, endpointRoutesFileStub, endpointSchemaStub, endpointServiceStub, endpointTestStub };
+//# sourceMappingURL=endpoint-stubs.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-stubs.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/templates/endpoint-stubs.ts"],"sourcesContent":["import type { Name } from \"../utils/name-parser\";\nimport type { EndpointField } from \"../utils/endpoint-schema\";\n\n/**\n * Stubs for `warlock make endpoint`.\n *\n * Every stub follows the conventions `warlock check` enforces:\n * one controller per file, input read through `request.validated()` only,\n * the work done in a service that never sees the request, a resource for the\n * output, the response documented through `responseSchema` (OpenAPI), and a\n * mutating route that is either guarded or explicitly `public: true`.\n */\n\nexport type EndpointMethod = \"get\" | \"post\" | \"put\" | \"patch\" | \"delete\";\n\nexport type EndpointAccess = \"guarded\" | \"public\";\n\nexport type EndpointSpec = {\n  /** Module folder name, e.g. `posts`. */\n  module: string;\n  /** The endpoint's name, e.g. `create-post`. */\n  name: Name;\n  method: EndpointMethod;\n  /** Route path, e.g. `/posts` or `/posts/:id`. */\n  path: string;\n  access: EndpointAccess;\n  /** The resource the endpoint answers with, e.g. `Post`. */\n  resource: Name;\n  /** Top-level request fields, read from the schema (empty without `--schema`). */\n  fields: EndpointField[];\n};\n\n/** `POST /posts` — used in comments, test names and descriptions. */\nexport function endpointLabel(spec: EndpointSpec): string {\n  return `${spec.method.toUpperCase()} ${spec.path}`;\n}\n\n/** The success status the controller answers with. */\nexport function endpointStatus(spec: EndpointSpec): 200 | 201 {\n  return spec.method === \"post\" ? 201 : 200;\n}\n\n/** `createPostSuccess` — the locale key of the success message. */\nexport function successMessageKey(spec: EndpointSpec): string {\n  return `${spec.name.camel}Success`;\n}\n\n/** `Create post completed successfully.` — the English success message. */\nexport function successMessage(spec: EndpointSpec): string {\n  const words = spec.name.kebab.split(\"-\").join(\" \");\n\n  return `${words.charAt(0).toUpperCase()}${words.slice(1)} completed successfully.`;\n}\n\n/** The key the resource sits under in the response body, e.g. `post`. */\nexport function resourceResponseKey(spec: EndpointSpec): string {\n  return spec.resource.singular.camel;\n}\n\n/** `schema/<name>.schema.ts` when no `--schema` file was given. */\nexport function endpointSchemaStub(spec: EndpointSpec): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\n/** Request input for ${endpointLabel(spec)}. */\nexport const ${spec.name.camel}Schema = v.object({\n  // TODO: describe the request input, then run make endpoint again with --force\n  // to regenerate the resource and test from it.\n});\n\nexport type ${spec.name.pascal}Schema = Infer<typeof ${spec.name.camel}Schema>;\n`;\n}\n\n/** `services/<name>.service.ts`. */\nexport function endpointServiceStub(spec: EndpointSpec): string {\n  return `import type { ${spec.name.pascal}Schema } from \"../schema/${spec.name.kebab}.schema\";\n\n/**\n * The work behind ${endpointLabel(spec)}. It takes validated input, never the\n * request, so a job, a command or another service can call it too.\n */\nexport async function ${spec.name.camel}Service(input: ${spec.name.pascal}Schema) {\n  // TODO: persist or act on the input, then return what the endpoint answers with.\n  return input;\n}\n`;\n}\n\n/** `resources/<resource>.resource.ts`, shaped from the request fields. */\nexport function endpointResourceStub(spec: EndpointSpec): string {\n  const fields = spec.fields.filter((field) => field.cast !== undefined);\n  const body =\n    fields.length === 0\n      ? '    // TODO: list the fields this resource outputs, e.g. id: \"number\"'\n      : fields.map((field) => `    ${propertyKey(field.name)}: \"${field.cast}\",`).join(\"\\n\");\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\n/** What ${spec.resource.pascal} looks like in a response. */\nexport const ${spec.resource.pascal}Resource = defineResource({\n  schema: {\n${body}\n  },\n});\n`;\n}\n\n/** `controllers/<name>.controller.ts` — one handler per file. */\nexport function endpointControllerStub(spec: EndpointSpec): string {\n  const resource = `${spec.resource.pascal}Resource`;\n  const key = resourceResponseKey(spec);\n  const status = endpointStatus(spec);\n  const respond = status === 201 ? \"successCreate\" : \"success\";\n  const controller = `${spec.name.camel}Controller`;\n  const schemaType = `${spec.name.pascal}Schema`;\n  const handlerType =\n    spec.access === \"guarded\"\n      ? `GuardedRequestHandler<${schemaType}>`\n      : `RequestHandler<Request<${schemaType}>>`;\n  const coreImport =\n    spec.access === \"guarded\"\n      ? `import { t } from \"@warlock.js/core\";\nimport { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";`\n      : `import { type Request, type RequestHandler, t } from \"@warlock.js/core\";`;\n\n  return `${coreImport}\nimport { ${resource} } from \"../resources/${spec.resource.singular.kebab}.resource\";\nimport { type ${schemaType}, ${spec.name.camel}Schema } from \"../schema/${spec.name.kebab}.schema\";\nimport { ${spec.name.camel}Service } from \"../services/${spec.name.kebab}.service\";\n\n/** ${endpointLabel(spec)} */\nexport const ${controller}: ${handlerType} = async ({\n  request,\n  response,\n}) => {\n  const ${key} = await ${spec.name.camel}Service(request.validated());\n\n  return response.${respond}({\n    message: t(\"${spec.module}.${successMessageKey(spec)}\"),\n    ${key}: new ${resource}(${key}),\n  });\n};\n\n${controller}.description = \"${successMessage(spec).replace(\" completed successfully.\", \"\")}\";\n\n${controller}.validation = {\n  schema: ${spec.name.camel}Schema,\n};\n\n// Documents the success response for \\`warlock generate.openapi\\` and the typed route map.\n${controller}.responseSchema = {\n  ${status}: {\n    body: {\n      message: \"string\",\n      ${key}: ${resource},\n    },\n  },\n};\n`;\n}\n\n/** The import lines a module `routes.ts` needs for this endpoint. */\nexport function endpointRouteImports(spec: EndpointSpec): string[] {\n  const imports = [\n    `import { ${spec.name.camel}Controller } from \"./controllers/${spec.name.kebab}.controller\";`,\n  ];\n\n  return imports;\n}\n\n/** The registration block appended to the module's `routes.ts`. */\nexport function endpointRouteRegistration(spec: EndpointSpec): string {\n  const controller = `${spec.name.camel}Controller`;\n\n  if (spec.access === \"public\") {\n    return `// ${endpointLabel(spec)} — public on purpose: no auth guard.\nrouter.${spec.method}(\"${spec.path}\", ${controller}, { public: true });\n`;\n  }\n\n  return `guarded(() => {\n  router.${spec.method}(\"${spec.path}\", ${controller});\n});\n`;\n}\n\n/** A fresh module `routes.ts` holding only this endpoint. */\nexport function endpointRoutesFileStub(spec: EndpointSpec): string {\n  const imports = [`import { router } from \"@warlock.js/core\";`];\n\n  if (spec.access === \"guarded\") {\n    imports.push(`import { guarded } from \"app/shared/utils/router\";`);\n  }\n\n  imports.push(...endpointRouteImports(spec));\n\n  return `${imports.join(\"\\n\")}\n\n${endpointRouteRegistration(spec)}`;\n}\n\n/** The path the generated test requests: route params get a placeholder. */\nexport function endpointTestPath(spec: EndpointSpec): string {\n  return spec.path.replace(/:[A-Za-z0-9_]+\\??/g, \"1\");\n}\n\n/** The request input the generated test sends: every field JSON can carry. */\nexport function endpointSampleInput(spec: EndpointSpec): Record<string, unknown> {\n  const input: Record<string, unknown> = {};\n\n  for (const field of spec.fields) {\n    if (field.sample !== undefined) input[field.name] = field.sample;\n  }\n\n  return input;\n}\n\n/** The part of the input the response echoes unchanged. */\nfunction comparableInput(spec: EndpointSpec): Record<string, unknown> {\n  const input: Record<string, unknown> = {};\n\n  for (const field of spec.fields) {\n    if (field.comparable) input[field.name] = field.sample;\n  }\n\n  return input;\n}\n\n/** A required field the test can drop to prove validation runs, if any. */\nfunction droppableRequiredField(spec: EndpointSpec) {\n  return spec.fields.find((field) => field.required && field.sample !== undefined);\n}\n\n/** Fields JSON cannot carry (files): the happy path needs multipart instead. */\nfunction uncarriableRequiredFields(spec: EndpointSpec): string[] {\n  return spec.fields\n    .filter((field) => field.required && field.sample === undefined)\n    .map((field) => field.name);\n}\n\nfunction propertyKey(name: string): string {\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\n}\n\n/** A TypeScript literal for a JSON value: unquoted identifier keys, trailing commas. */\nfunction toLiteral(value: unknown, indent: string): string {\n  if (Array.isArray(value)) {\n    if (value.length === 0) return \"[]\";\n\n    return `[\\n${value.map((item) => `${indent}  ${toLiteral(item, `${indent}  `)},`).join(\"\\n\")}\\n${indent}]`;\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    const entries = Object.entries(value);\n\n    if (entries.length === 0) return \"{}\";\n\n    return `{\\n${entries\n      .map(([key, item]) => `${indent}  ${propertyKey(key)}: ${toLiteral(item, `${indent}  `)},`)\n      .join(\"\\n\")}\\n${indent}}`;\n  }\n\n  return JSON.stringify(value);\n}\n\nfunction indentJson(value: unknown, indent: string): string {\n  return toLiteral(value, indent);\n}\n\n/**\n * The statement that sends `inputExpression` to the endpoint, through\n * `client` (`testRequest`-shaped helpers or an `actingAs()` client).\n */\nfunction sendRequest(spec: EndpointSpec, client: string, inputExpression: string): string {\n  const path = JSON.stringify(endpointTestPath(spec));\n\n  switch (spec.method) {\n    case \"get\":\n      return `${client === \"\" ? \"testGet\" : `${client}.get`}(${path} + \"?\" + new URLSearchParams(toQuery(${inputExpression})).toString())`;\n    case \"delete\":\n      return `${client === \"\" ? \"testRequest\" : `${client}.request`}(${path}, {\n      method: \"DELETE\",\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify(${inputExpression}),\n    })`;\n    default: {\n      const helper = `test${spec.method.charAt(0).toUpperCase()}${spec.method.slice(1)}`;\n\n      return `${client === \"\" ? helper : `${client}.${spec.method}`}(${path}, ${inputExpression})`;\n    }\n  }\n}\n\n/** The `@warlock.js/core/tests` helpers a test sends anonymous requests with. */\nfunction anonymousHelpers(spec: EndpointSpec): string[] {\n  switch (spec.method) {\n    case \"get\":\n      return [\"testGet\"];\n    case \"delete\":\n      return [\"testRequest\"];\n    default:\n      return [`test${spec.method.charAt(0).toUpperCase()}${spec.method.slice(1)}`];\n  }\n}\n\n/**\n * `tests/<name>.test.ts` — requests the endpoint over the real HTTP stack\n * (the test server `warlock add test` wires up): routing, middleware,\n * validation, controller, resource and serialization all run.\n */\nexport function endpointTestStub(spec: EndpointSpec): string {\n  const label = endpointLabel(spec);\n  const key = resourceResponseKey(spec);\n  const status = endpointStatus(spec);\n  const input = endpointSampleInput(spec);\n  const expected = comparableInput(spec);\n  const dropped = droppableRequiredField(spec);\n  const uncarriable = uncarriableRequiredFields(spec);\n  const guarded = spec.access === \"guarded\";\n  const needsQuery = spec.method === \"get\";\n  const helpers = new Set<string>([\"expectJson\", ...anonymousHelpers(spec)]);\n\n  if (guarded) helpers.add(\"actingAs\");\n\n  const lines: string[] = [];\n\n  if (guarded) {\n    lines.push(`import type { Auth } from \"@warlock.js/auth\";`);\n    lines.push(`import type { ChildModel } from \"@warlock.js/cascade\";`);\n    lines.push(`import { config } from \"@warlock.js/core\";`);\n  }\n\n  lines.push(`import { ${[...helpers].sort().join(\", \")} } from \"@warlock.js/core/tests\";`);\n\n  if (guarded) lines.push(`import { randomUUID } from \"node:crypto\";`);\n\n  lines.push(\n    `import { ${guarded ? \"afterAll, describe, expect, it\" : \"describe, expect, it\"} } from \"vitest\";`,\n  );\n\n  const header = `${lines.join(\"\\n\")}\n\n/** A valid request for ${label}, derived from its schema. */\nconst validInput: Record<string, unknown> = ${indentJson(input, \"\")};\n${\n  needsQuery\n    ? `\n/** Query values travel as strings; numeric schema fields need \\`.coerce()\\`. */\nfunction toQuery(input: Record<string, unknown>): Record<string, string> {\n  return Object.fromEntries(Object.entries(input).map(([key, value]) => [key, String(value)]));\n}\n`\n    : \"\"\n}`;\n\n  const happyAssertions = (indent: string) =>\n    [\n      `const body = await expectJson<{ message: string; ${key}: Record<string, unknown> }>(`,\n      `  response,`,\n      `  ${status},`,\n      `);`,\n      ``,\n      `expect(typeof body.message).toBe(\"string\");`,\n      `expect(body.${key}).toMatchObject(${indentJson(expected, indent)});`,\n    ]\n      .map((line, index) => (index === 0 || line === \"\" ? line : `${indent}${line}`))\n      .join(\"\\n\");\n\n  const dropStatement = dropped\n    ? `const input = { ...validInput };\n\n    delete input[${JSON.stringify(dropped.name)}];\n`\n    : \"\";\n\n  const validationCase = dropped\n    ? `\n  it(\"rejects a request without ${dropped.name}\", async () => {\n    ${dropStatement}\n    const response = await ${sendRequest(spec, \"\", \"input\")};\n\n    expect(response.status).toBeGreaterThanOrEqual(400);\n    expect(response.status).toBeLessThan(500);\n  });\n`\n    : \"\";\n\n  if (!guarded) {\n    const happy =\n      uncarriable.length > 0\n        ? `  it.todo(\"answers a valid request — send ${uncarriable.join(\", \")} as multipart form data (JSON cannot carry files)\");\\n`\n        : `  it(\"answers a valid request with the ${spec.resource.singular.pascal} resource\", async () => {\n    const response = await ${sendRequest(spec, \"\", \"validInput\")};\n\n    ${happyAssertions(\"    \")}\n  });\n`;\n\n    return `${header}\ndescribe(\"${label}\", () => {\n${happy}${validationCase}});\n`;\n  }\n\n  const signedInHappy =\n    uncarriable.length > 0\n      ? `  it.todo(\"answers a signed-in user — send ${uncarriable.join(\", \")} as multipart form data (JSON cannot carry files)\");\\n`\n      : `  it(\"answers a signed-in user with the ${spec.resource.singular.pascal} resource\", async () => {\n    const client = await signIn();\n\n    try {\n      const response = await ${sendRequest(spec, \"client\", \"validInput\")};\n\n      ${happyAssertions(\"      \")}\n    } finally {\n      await client.dispose();\n    }\n  });\n`;\n\n  const guardedValidation = dropped\n    ? `\n  it(\"rejects a request without ${dropped.name}\", async () => {\n    const client = await signIn();\n\n    try {\n      const input = { ...validInput };\n\n      delete input[${JSON.stringify(dropped.name)}];\n\n      const response = await ${sendRequest(spec, \"client\", \"input\")};\n\n      expect(response.status).toBeGreaterThanOrEqual(400);\n      expect(response.status).toBeLessThan(500);\n    } finally {\n      await client.dispose();\n    }\n  });\n`\n    : \"\";\n\n  return `${header}\ndescribe(\"${label}\", () => {\n  const users: Auth[] = [];\n\n  /** A real user and a real access token; adjust the fields if your user model requires more. */\n  async function signIn() {\n    const User = config.key<ChildModel<Auth>>(\"auth.userType.user\");\n\n    if (!User) throw new Error(\"This test needs the configured auth.userType.user model.\");\n\n    const user = await User.create({\n      name: \"Endpoint test user\",\n      email: \"endpoint-\" + randomUUID() + \"@example.test\",\n      password: \"test-password\",\n    });\n\n    users.push(user);\n\n    return actingAs(user);\n  }\n\n  afterAll(async () => {\n    await Promise.all(users.splice(0).map((user) => user.destroy({ strategy: \"permanent\" })));\n  });\n\n  it(\"rejects an anonymous request\", async () => {\n    const response = await ${sendRequest(spec, \"\", \"validInput\")};\n\n    expect(response.status).toBe(401);\n  });\n\n${signedInHappy}${guardedValidation}});\n`;\n}\n\n/** The locale entry merged into the module's `utils/locales.json`. */\nexport function endpointLocaleEntries(spec: EndpointSpec): Record<string, Record<string, string>> {\n  return { [successMessageKey(spec)]: { en: successMessage(spec) } };\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/cli/commands/generate/templates/stubs.ts
+//#region ../../packages/core/src/cli/commands/generate/templates/stubs.ts
 /**
 * Controller template stub
 *
@@ -85,20 +85,33 @@ update${moduleName.pascal}Controller.validation = {
 */
 function crudListControllerStub(moduleName) {
 	const plural = moduleName.plural;
-	return `import { type GuardedRequestHandler } from "app/auth/requests/guarded.request";
+	return `import { type Infer, v } from "@warlock.js/seal";
+import { type GuardedRequestHandler } from "app/auth/requests/guarded.request";
 import { list${plural.pascal}Service } from "../services/list-${plural.kebab}.service";
 
-export const list${plural.pascal}Controller: GuardedRequestHandler = async ({
-  request,
-  response,
-}) => {
-  const { data, pagination } = await list${plural.pascal}Service(request.all());
+/**
+ * Query parameters the list accepts. Add each filter you expose; unknown keys
+ * are stripped, so nothing unvalidated reaches the repository.
+ */
+const list${plural.pascal}QuerySchema = v.object({
+  page: v.numeric().min(1).optional(),
+  limit: v.numeric().min(1).max(100).optional(),
+});
+
+export const list${plural.pascal}Controller: GuardedRequestHandler<
+  Infer<typeof list${plural.pascal}QuerySchema>
+> = async ({ request, response }) => {
+  const { data, pagination } = await list${plural.pascal}Service(request.validated());
 
   return response.success({
     data,
     pagination,
   });
 };
+
+list${plural.pascal}Controller.validation = {
+  schema: list${plural.pascal}QuerySchema,
+};
 `;
 }
 /**