@warlock.js/core 5.31.0 → 5.32.0

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

@@ -33,7 +33,9 @@ async function generateResource(data) {
 		process.exit(1);
 	}
 	await ensureComponentDirectory(module, "resources");
-	await putFileAsync(resolveComponentPath(module, "resources", `${name.kebab}.resource`), resourceStub(name));
+	const resourcePath = resolveComponentPath(module, "resources", `${name.kebab}.resource`);
+	const resourceContent = resourceStub(name);
+	await putFileAsync(resourcePath, resourceContent);
 	console.log(colors.cyan(`\nResource "${name.pascal}Resource" generated successfully!`));
 }
 

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

@@ -1 +1 @@
-{"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"}
+{"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;CAGlD,MAAM,eAAe,qBAAqB,QAAQ,aAAa,GAAG,KAAK,MAAM,UAAU;CACvF,MAAM,kBAAkB,aAAa,IAAI;CAEzC,MAAM,aAAa,cAAc,eAAe;CAEhD,QAAQ,IAAI,OAAO,KAAK,eAAe,KAAK,OAAO,kCAAkC,CAAC;AACxF"}

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

@@ -33,7 +33,9 @@ async function generateService(data) {
 		process.exit(1);
 	}
 	await ensureComponentDirectory(module, "services");
-	await putFileAsync(resolveComponentPath(module, "services", `${name.kebab}.service`), serviceStub(name));
+	const servicePath = resolveComponentPath(module, "services", `${name.kebab}.service`);
+	const serviceContent = serviceStub(name);
+	await putFileAsync(servicePath, serviceContent);
 	console.log(colors.cyan(`\n✨ Service "${name.camel}" generated successfully!`));
 }
 

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

@@ -1 +1 @@
-{"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"}
+{"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;CAGjD,MAAM,cAAc,qBAAqB,QAAQ,YAAY,GAAG,KAAK,MAAM,SAAS;CACpF,MAAM,iBAAiB,YAAY,IAAI;CAEvC,MAAM,aAAa,aAAa,cAAc;CAE9C,QAAQ,IAAI,OAAO,KAAK,gBAAgB,KAAK,MAAM,0BAA0B,CAAC;AAChF"}

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

@@ -215,7 +215,7 @@ function endpointTestStub(spec) {
 	const uncarriable = uncarriableRequiredFields(spec);
 	const guarded = spec.access === "guarded";
 	const needsQuery = spec.method === "get";
-	const helpers = new Set(["expectJson", ...anonymousHelpers(spec)]);
+	const helpers = /* @__PURE__ */ new Set(["expectJson", ...anonymousHelpers(spec)]);
 	if (guarded) helpers.add("actingAs");
 	const lines = [];
 	if (guarded) {
@@ -337,5 +337,5 @@ function endpointLocaleEntries(spec) {
 }
 
 //#endregion
-export { endpointControllerStub, endpointLabel, endpointLocaleEntries, endpointResourceStub, endpointRouteImports, endpointRouteRegistration, endpointRoutesFileStub, endpointSchemaStub, endpointServiceStub, endpointTestStub };
+export { endpointControllerStub, endpointLabel, endpointLocaleEntries, endpointResourceStub, endpointRouteImports, endpointRouteRegistration, endpointRoutesFileStub, endpointSampleInput, endpointSchemaStub, endpointServiceStub, endpointStatus, endpointTestPath, endpointTestStub, resourceResponseKey, successMessage, successMessageKey };
 //# sourceMappingURL=endpoint-stubs.mjs.map

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

@@ -1 +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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"}
+{"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/utils/endpoint-schema.mjs

@@ -92,7 +92,6 @@ function sampleString(node, seed) {
 		case "uuid": return "00000000-0000-4000-8000-000000000001";
 		case "date-time": return "2026-01-01T00:00:00.000Z";
 		case "date": return "2026-01-01";
-		default: break;
 	}
 	const minLength = node.minLength ?? 1;
 	let value = `${seed} sample`;
@@ -133,5 +132,5 @@ function readEndpointFields(jsonSchema) {
 }
 
 //#endregion
-export { readEndpointFields };
+export { castForNode, readEndpointFields, sampleForNode };
 //# sourceMappingURL=endpoint-schema.mjs.map

package/esm/cli/commands/generate/utils/endpoint-schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint-schema.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/endpoint-schema.ts"],"sourcesContent":["/**\n * What the endpoint generator needs to know about a request schema, read\n * from the JSON Schema seal produces (`validator.toJsonSchema()`).\n *\n * Kept free of seal imports: it works on the plain JSON Schema object, so it\n * is unit-testable and survives seal's internals changing.\n */\n\n/** The JSON Schema subset this module reads. */\nexport type JsonSchemaNode = {\n  type?: string | string[];\n  format?: string;\n  enum?: unknown[];\n  const?: unknown;\n  minimum?: number;\n  exclusiveMinimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  minItems?: number;\n  items?: JsonSchemaNode;\n  properties?: Record<string, JsonSchemaNode>;\n  required?: string[];\n  anyOf?: JsonSchemaNode[];\n  oneOf?: JsonSchemaNode[];\n  contentMediaType?: string;\n  contentEncoding?: string;\n};\n\n/** One top-level field of the request schema. */\nexport type EndpointField = {\n  name: string;\n  required: boolean;\n  /** The resource cast for this field, or `undefined` when it has no plain JSON shape (a file). */\n  cast?: string;\n  /** A deterministic valid value, or `undefined` when JSON cannot carry one (a file). */\n  sample?: unknown;\n  /**\n   * Whether the response echoes the sample unchanged, so a generated test can\n   * compare it. Dates are parsed and re-cast, so they are not comparable.\n   */\n  comparable: boolean;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The non-null JSON types a node allows, and whether `null` is one of them. */\nfunction typesOf(node: JsonSchemaNode): { types: string[]; nullable: boolean } {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (variants) {\n    const all = variants.map(typesOf);\n\n    return {\n      types: all.flatMap((entry) => entry.types),\n      nullable: all.some((entry) => entry.nullable),\n    };\n  }\n\n  const raw = node.type === undefined ? [] : Array.isArray(node.type) ? node.type : [node.type];\n\n  return { types: raw.filter((type) => type !== \"null\"), nullable: raw.includes(\"null\") };\n}\n\nfunction primaryNode(node: JsonSchemaNode): JsonSchemaNode {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (!variants) return node;\n\n  return (\n    variants.find((variant) => !typesOf(variant).types.every((type) => type === \"null\")) ?? node\n  );\n}\n\n/** A file upload: JSON cannot carry it, so it has no sample and no cast. */\nfunction isFileNode(node: JsonSchemaNode): boolean {\n  return (\n    node.format === \"binary\" ||\n    node.contentEncoding === \"binary\" ||\n    node.contentMediaType !== undefined\n  );\n}\n\nconst CASTS: Record<string, string> = {\n  string: \"string\",\n  integer: \"int\",\n  number: \"number\",\n  boolean: \"boolean\",\n  array: \"array\",\n  object: \"object\",\n};\n\n/** `\"string\"` or `\"number\"` when every enum value has that type. */\nfunction enumValuesType(node: JsonSchemaNode): string | undefined {\n  if (!node.enum || node.enum.length === 0) return undefined;\n  if (node.enum.every((value) => typeof value === \"string\")) return \"string\";\n  if (node.enum.every((value) => typeof value === \"number\")) return \"number\";\n\n  return undefined;\n}\n\n/** The resource cast for a field, with `?` when the value may be null or absent. */\nexport function castForNode(node: JsonSchemaNode, required: boolean): string | undefined {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n\n  const { types, nullable } = typesOf(node);\n  const enumType = enumValuesType(primary);\n  const only = types.length === 1 ? types[0] : undefined;\n  const base = enumType ?? (only === undefined ? undefined : CASTS[only]);\n\n  if (base === undefined) return undefined;\n\n  if (base === \"string\" && (primary.format === \"date-time\" || primary.format === \"date\")) {\n    return nullable || !required ? \"date?\" : \"date\";\n  }\n\n  return nullable || !required ? `${base}?` : base;\n}\n\n/**\n * A deterministic value that satisfies `node`, or `undefined` when JSON cannot\n * express one. `seed` keeps values readable and stable between runs.\n */\nexport function sampleForNode(node: JsonSchemaNode, seed: string): unknown {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n  if (primary.const !== undefined) return primary.const;\n  if (primary.enum && primary.enum.length > 0) return primary.enum[0];\n\n  const { types } = typesOf(node);\n  const type = types[0];\n\n  switch (type) {\n    case \"string\":\n      return sampleString(primary, seed);\n    case \"integer\":\n      return sampleNumber(primary, true);\n    case \"number\":\n      return sampleNumber(primary, false);\n    case \"boolean\":\n      return true;\n    case \"array\": {\n      const count = primary.minItems ?? 0;\n      const item = primary.items ? sampleForNode(primary.items, `${seed}-item`) : undefined;\n\n      if (count > 0 && item === undefined) return undefined;\n\n      return Array.from({ length: count }, () => item);\n    }\n    case \"object\":\n      return sampleObject(primary, seed);\n    default:\n      return undefined;\n  }\n}\n\nfunction sampleNumber(node: JsonSchemaNode, integer: boolean): number {\n  const lower =\n    node.minimum ?? (node.exclusiveMinimum !== undefined ? node.exclusiveMinimum + 1 : 1);\n  let value = integer ? Math.ceil(lower) : lower;\n\n  if (node.maximum !== undefined && value > node.maximum) value = node.maximum;\n\n  return value;\n}\n\nfunction sampleString(node: JsonSchemaNode, seed: string): string {\n  switch (node.format) {\n    case \"email\":\n      return `${seed.replace(/[^a-z0-9]/gi, \"\").toLowerCase() || \"user\"}@example.test`;\n    case \"uri\":\n    case \"url\":\n      return `https://example.test/${seed}`;\n    case \"uuid\":\n      return \"00000000-0000-4000-8000-000000000001\";\n    case \"date-time\":\n      return \"2026-01-01T00:00:00.000Z\";\n    case \"date\":\n      return \"2026-01-01\";\n    default:\n      break;\n  }\n\n  const minLength = node.minLength ?? 1;\n  let value = `${seed} sample`;\n\n  while (value.length < minLength) value += \" sample\";\n\n  return node.maxLength !== undefined ? value.slice(0, Math.max(node.maxLength, minLength)) : value;\n}\n\nfunction sampleObject(node: JsonSchemaNode, seed: string): Record<string, unknown> | undefined {\n  const required = new Set(node.required ?? []);\n  const result: Record<string, unknown> = {};\n\n  for (const [key, child] of Object.entries(node.properties ?? {})) {\n    const value = sampleForNode(child, key);\n\n    if (value === undefined) {\n      if (required.has(key)) return undefined;\n      continue;\n    }\n\n    result[key] = value;\n  }\n\n  void seed;\n\n  return result;\n}\n\n/** Read the top-level fields of a request schema's JSON Schema. */\nexport function readEndpointFields(jsonSchema: unknown): EndpointField[] {\n  if (!isRecord(jsonSchema)) return [];\n\n  const node = jsonSchema as JsonSchemaNode;\n  const required = new Set(node.required ?? []);\n\n  return Object.entries(node.properties ?? {}).map(([name, child]) => {\n    const isRequired = required.has(name);\n    const cast = castForNode(child, isRequired);\n    const sample = sampleForNode(child, name);\n    const field: EndpointField = {\n      name,\n      required: isRequired,\n      comparable:\n        sample !== undefined &&\n        cast !== undefined &&\n        !cast.startsWith(\"date\") &&\n        !cast.startsWith(\"object\"),\n    };\n\n    if (cast !== undefined) field.cast = cast;\n    if (sample !== undefined) field.sample = sample;\n\n    return field;\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"endpoint-schema.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/endpoint-schema.ts"],"sourcesContent":["/**\n * What the endpoint generator needs to know about a request schema, read\n * from the JSON Schema seal produces (`validator.toJsonSchema()`).\n *\n * Kept free of seal imports: it works on the plain JSON Schema object, so it\n * is unit-testable and survives seal's internals changing.\n */\n\n/** The JSON Schema subset this module reads. */\nexport type JsonSchemaNode = {\n  type?: string | string[];\n  format?: string;\n  enum?: unknown[];\n  const?: unknown;\n  minimum?: number;\n  exclusiveMinimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  minItems?: number;\n  items?: JsonSchemaNode;\n  properties?: Record<string, JsonSchemaNode>;\n  required?: string[];\n  anyOf?: JsonSchemaNode[];\n  oneOf?: JsonSchemaNode[];\n  contentMediaType?: string;\n  contentEncoding?: string;\n};\n\n/** One top-level field of the request schema. */\nexport type EndpointField = {\n  name: string;\n  required: boolean;\n  /** The resource cast for this field, or `undefined` when it has no plain JSON shape (a file). */\n  cast?: string;\n  /** A deterministic valid value, or `undefined` when JSON cannot carry one (a file). */\n  sample?: unknown;\n  /**\n   * Whether the response echoes the sample unchanged, so a generated test can\n   * compare it. Dates are parsed and re-cast, so they are not comparable.\n   */\n  comparable: boolean;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The non-null JSON types a node allows, and whether `null` is one of them. */\nfunction typesOf(node: JsonSchemaNode): { types: string[]; nullable: boolean } {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (variants) {\n    const all = variants.map(typesOf);\n\n    return {\n      types: all.flatMap((entry) => entry.types),\n      nullable: all.some((entry) => entry.nullable),\n    };\n  }\n\n  const raw = node.type === undefined ? [] : Array.isArray(node.type) ? node.type : [node.type];\n\n  return { types: raw.filter((type) => type !== \"null\"), nullable: raw.includes(\"null\") };\n}\n\nfunction primaryNode(node: JsonSchemaNode): JsonSchemaNode {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (!variants) return node;\n\n  return (\n    variants.find((variant) => !typesOf(variant).types.every((type) => type === \"null\")) ?? node\n  );\n}\n\n/** A file upload: JSON cannot carry it, so it has no sample and no cast. */\nfunction isFileNode(node: JsonSchemaNode): boolean {\n  return (\n    node.format === \"binary\" ||\n    node.contentEncoding === \"binary\" ||\n    node.contentMediaType !== undefined\n  );\n}\n\nconst CASTS: Record<string, string> = {\n  string: \"string\",\n  integer: \"int\",\n  number: \"number\",\n  boolean: \"boolean\",\n  array: \"array\",\n  object: \"object\",\n};\n\n/** `\"string\"` or `\"number\"` when every enum value has that type. */\nfunction enumValuesType(node: JsonSchemaNode): string | undefined {\n  if (!node.enum || node.enum.length === 0) return undefined;\n  if (node.enum.every((value) => typeof value === \"string\")) return \"string\";\n  if (node.enum.every((value) => typeof value === \"number\")) return \"number\";\n\n  return undefined;\n}\n\n/** The resource cast for a field, with `?` when the value may be null or absent. */\nexport function castForNode(node: JsonSchemaNode, required: boolean): string | undefined {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n\n  const { types, nullable } = typesOf(node);\n  const enumType = enumValuesType(primary);\n  const only = types.length === 1 ? types[0] : undefined;\n  const base = enumType ?? (only === undefined ? undefined : CASTS[only]);\n\n  if (base === undefined) return undefined;\n\n  if (base === \"string\" && (primary.format === \"date-time\" || primary.format === \"date\")) {\n    return nullable || !required ? \"date?\" : \"date\";\n  }\n\n  return nullable || !required ? `${base}?` : base;\n}\n\n/**\n * A deterministic value that satisfies `node`, or `undefined` when JSON cannot\n * express one. `seed` keeps values readable and stable between runs.\n */\nexport function sampleForNode(node: JsonSchemaNode, seed: string): unknown {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n  if (primary.const !== undefined) return primary.const;\n  if (primary.enum && primary.enum.length > 0) return primary.enum[0];\n\n  const { types } = typesOf(node);\n  const type = types[0];\n\n  switch (type) {\n    case \"string\":\n      return sampleString(primary, seed);\n    case \"integer\":\n      return sampleNumber(primary, true);\n    case \"number\":\n      return sampleNumber(primary, false);\n    case \"boolean\":\n      return true;\n    case \"array\": {\n      const count = primary.minItems ?? 0;\n      const item = primary.items ? sampleForNode(primary.items, `${seed}-item`) : undefined;\n\n      if (count > 0 && item === undefined) return undefined;\n\n      return Array.from({ length: count }, () => item);\n    }\n    case \"object\":\n      return sampleObject(primary, seed);\n    default:\n      return undefined;\n  }\n}\n\nfunction sampleNumber(node: JsonSchemaNode, integer: boolean): number {\n  const lower =\n    node.minimum ?? (node.exclusiveMinimum !== undefined ? node.exclusiveMinimum + 1 : 1);\n  let value = integer ? Math.ceil(lower) : lower;\n\n  if (node.maximum !== undefined && value > node.maximum) value = node.maximum;\n\n  return value;\n}\n\nfunction sampleString(node: JsonSchemaNode, seed: string): string {\n  switch (node.format) {\n    case \"email\":\n      return `${seed.replace(/[^a-z0-9]/gi, \"\").toLowerCase() || \"user\"}@example.test`;\n    case \"uri\":\n    case \"url\":\n      return `https://example.test/${seed}`;\n    case \"uuid\":\n      return \"00000000-0000-4000-8000-000000000001\";\n    case \"date-time\":\n      return \"2026-01-01T00:00:00.000Z\";\n    case \"date\":\n      return \"2026-01-01\";\n    default:\n      break;\n  }\n\n  const minLength = node.minLength ?? 1;\n  let value = `${seed} sample`;\n\n  while (value.length < minLength) value += \" sample\";\n\n  return node.maxLength !== undefined ? value.slice(0, Math.max(node.maxLength, minLength)) : value;\n}\n\nfunction sampleObject(node: JsonSchemaNode, seed: string): Record<string, unknown> | undefined {\n  const required = new Set(node.required ?? []);\n  const result: Record<string, unknown> = {};\n\n  for (const [key, child] of Object.entries(node.properties ?? {})) {\n    const value = sampleForNode(child, key);\n\n    if (value === undefined) {\n      if (required.has(key)) return undefined;\n      continue;\n    }\n\n    result[key] = value;\n  }\n\n  void seed;\n\n  return result;\n}\n\n/** Read the top-level fields of a request schema's JSON Schema. */\nexport function readEndpointFields(jsonSchema: unknown): EndpointField[] {\n  if (!isRecord(jsonSchema)) return [];\n\n  const node = jsonSchema as JsonSchemaNode;\n  const required = new Set(node.required ?? []);\n\n  return Object.entries(node.properties ?? {}).map(([name, child]) => {\n    const isRequired = required.has(name);\n    const cast = castForNode(child, isRequired);\n    const sample = sampleForNode(child, name);\n    const field: EndpointField = {\n      name,\n      required: isRequired,\n      comparable:\n        sample !== undefined &&\n        cast !== undefined &&\n        !cast.startsWith(\"date\") &&\n        !cast.startsWith(\"object\"),\n    };\n\n    if (cast !== undefined) field.cast = cast;\n    if (sample !== undefined) field.sample = sample;\n\n    return field;\n  });\n}\n"],"mappings":"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"}

package/esm/cli/commands/generate/utils/name-parser.mjs

@@ -65,5 +65,5 @@ var Name = class Name {
 };
 
 //#endregion
-export { parseModulePath, parseName, pluralName, singularName };
+export { Name, parseModulePath, parseName, pluralName, singularName };
 //# sourceMappingURL=name-parser.mjs.map

package/esm/cli/commands/generate/utils/path-resolver.mjs

@@ -52,5 +52,5 @@ async function ensureComponentDirectory(module, type) {
 }
 
 //#endregion
-export { componentExists, ensureComponentDirectory, moduleExists, resolveComponentPath, resolveModulePath };
+export { componentExists, ensureComponentDirectory, ensureDirectory, moduleExists, resolveComponentPath, resolveModulePath };
 //# sourceMappingURL=path-resolver.mjs.map

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

@@ -54,8 +54,9 @@ function formatInspectSummary(report) {
 async function inspectCommandAction({ options }) {
 	const sections = parseInspectSections(stringOption(options.section));
 	const json = options.json === true;
+	const boot = json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect();
 	const report = await inspectApp({
-		...inspectOptionsFromBoot(json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect()),
+		...inspectOptionsFromBoot(boot),
 		sections
 	});
 	if (json) {
@@ -68,5 +69,5 @@ async function inspectCommandAction({ options }) {
 }
 
 //#endregion
-export { inspectCommandAction };
+export { formatInspectSummary, inspectCommandAction };
 //# sourceMappingURL=inspect-command.action.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"inspect-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/inspect/inspect-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp, parseInspectSections } from \"../../../tooling/inspect/inspect-app\";\nimport type { InspectReport } from \"../../../tooling/inspect/inspect-report.types\";\nimport { withConsoleOnStderr } from \"../routes/with-console-on-stderr\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The human summary `warlock inspect` prints without `--json`: one count per\n * section, the routes as `METHOD path  [auth] name`, and the warnings.\n * Returned as lines so it is testable.\n */\nexport function formatInspectSummary(report: InspectReport): string[] {\n  const lines: string[] = [\n    `${report.app.name ?? \"app\"}${report.app.version ? `@${report.app.version}` : \"\"} (${report.app.runtimeStrategy}, Node ${report.app.node})`,\n    \"\",\n  ];\n\n  const counts: [string, number | undefined][] = [\n    [\"routes\", report.routes?.length],\n    [\"models\", report.models?.length],\n    [\"resources\", report.resources?.length],\n    [\"config keys\", report.config?.length],\n    [\"events\", report.events?.length],\n    [\"pages\", report.pages?.length],\n    [\"jobs\", report.jobs?.length],\n    [\"schedules\", report.schedules?.length],\n    [\"packages\", report.packages?.length],\n  ];\n\n  for (const [label, count] of counts) {\n    if (count !== undefined) lines.push(`  ${label.padEnd(12)} ${count}`);\n  }\n\n  if (report.routes && report.routes.length > 0) {\n    lines.push(\"\", \"Routes:\");\n\n    for (const route of report.routes) {\n      const guard = route.auth.required ? \" [auth]\" : \"\";\n      const name = route.name ? `  ${route.name}` : \"\";\n\n      lines.push(`  ${route.method.padEnd(7)} ${route.path}${guard}${name}`);\n    }\n  }\n\n  if (report.warnings.length > 0) {\n    lines.push(\"\", `${report.warnings.length} warning(s):`);\n\n    for (const warning of report.warnings) {\n      lines.push(`  - ${warning.code ? `${warning.code} ` : \"\"}${warning.message}`);\n    }\n  }\n\n  lines.push(\"\", \"Run `warlock inspect --json` for the full report.\");\n\n  return lines;\n}\n\n/**\n * Action behind `warlock inspect`.\n *\n * Boots the app read-only (the `warlock doctor` boot pass: connectors booted,\n * none started, no connection, no port), then describes it with\n * `inspectApp()`. With `--json`, stdout carries exactly the report and the\n * boot's progress lines go to stderr.\n *\n * @param data Parsed CLI args: `options.json`, `options.section`.\n */\nexport async function inspectCommandAction({ options }: CommandActionData): Promise<void> {\n  // Parsed first, so a typo fails before the app boots.\n  const sections = parseInspectSections(stringOption(options.section));\n  const json = options.json === true;\n  const boot = json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect();\n  const report = await inspectApp({ ...inspectOptionsFromBoot(boot), sections });\n\n  if (json) {\n    console.log(JSON.stringify(report, null, 2));\n    return;\n  }\n\n  const [heading, ...rest] = formatInspectSummary(report);\n\n  console.log(colors.bold(heading ?? \"\"));\n\n  for (const line of rest) {\n    console.log(line);\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;AAOA,SAAgB,qBAAqB,QAAiC;CACpE,MAAM,QAAkB,CACtB,GAAG,OAAO,IAAI,QAAQ,QAAQ,OAAO,IAAI,UAAU,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,OAAO,IAAI,gBAAgB,SAAS,OAAO,IAAI,KAAK,IACzI,EACF;CAEA,MAAM,SAAyC;EAC7C,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,eAAe,OAAO,QAAQ,MAAM;EACrC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,SAAS,OAAO,OAAO,MAAM;EAC9B,CAAC,QAAQ,OAAO,MAAM,MAAM;EAC5B,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,YAAY,OAAO,UAAU,MAAM;CACtC;CAEA,KAAK,MAAM,CAAC,OAAO,UAAU,QAC3B,IAAI,UAAU,QAAW,MAAM,KAAK,KAAK,MAAM,OAAO,EAAE,EAAE,GAAG,OAAO;CAGtE,IAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;EAC7C,MAAM,KAAK,IAAI,SAAS;EAExB,KAAK,MAAM,SAAS,OAAO,QAAQ;GACjC,MAAM,QAAQ,MAAM,KAAK,WAAW,YAAY;GAChD,MAAM,OAAO,MAAM,OAAO,KAAK,MAAM,SAAS;GAE9C,MAAM,KAAK,KAAK,MAAM,OAAO,OAAO,CAAC,EAAE,GAAG,MAAM,OAAO,QAAQ,MAAM;EACvE;CACF;CAEA,IAAI,OAAO,SAAS,SAAS,GAAG;EAC9B,MAAM,KAAK,IAAI,GAAG,OAAO,SAAS,OAAO,aAAa;EAEtD,KAAK,MAAM,WAAW,OAAO,UAC3B,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG,QAAQ,KAAK,KAAK,KAAK,QAAQ,SAAS;CAEhF;CAEA,MAAM,KAAK,IAAI,mDAAmD;CAElE,OAAO;AACT;;;;;;;;;;;AAYA,eAAsB,qBAAqB,EAAE,WAA6C;CAExF,MAAM,WAAW,qBAAqB,aAAa,QAAQ,OAAO,CAAC;CACnE,MAAM,OAAO,QAAQ,SAAS;CAE9B,MAAM,SAAS,MAAM,WAAW;EAAE,GAAG,uBADxB,OAAO,MAAM,0BAA0B,eAAe,CAAC,IAAI,MAAM,eAAe,CAC7B;EAAG;CAAS,CAAC;CAE7E,IAAI,MAAM;EACR,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;EAC3C;CACF;CAEA,MAAM,CAAC,SAAS,GAAG,QAAQ,qBAAqB,MAAM;CAEtD,QAAQ,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;CAEtC,KAAK,MAAM,QAAQ,MACjB,QAAQ,IAAI,IAAI;AAEpB"}
+{"version":3,"file":"inspect-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/inspect/inspect-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp, parseInspectSections } from \"../../../tooling/inspect/inspect-app\";\nimport type { InspectReport } from \"../../../tooling/inspect/inspect-report.types\";\nimport { withConsoleOnStderr } from \"../routes/with-console-on-stderr\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The human summary `warlock inspect` prints without `--json`: one count per\n * section, the routes as `METHOD path  [auth] name`, and the warnings.\n * Returned as lines so it is testable.\n */\nexport function formatInspectSummary(report: InspectReport): string[] {\n  const lines: string[] = [\n    `${report.app.name ?? \"app\"}${report.app.version ? `@${report.app.version}` : \"\"} (${report.app.runtimeStrategy}, Node ${report.app.node})`,\n    \"\",\n  ];\n\n  const counts: [string, number | undefined][] = [\n    [\"routes\", report.routes?.length],\n    [\"models\", report.models?.length],\n    [\"resources\", report.resources?.length],\n    [\"config keys\", report.config?.length],\n    [\"events\", report.events?.length],\n    [\"pages\", report.pages?.length],\n    [\"jobs\", report.jobs?.length],\n    [\"schedules\", report.schedules?.length],\n    [\"packages\", report.packages?.length],\n  ];\n\n  for (const [label, count] of counts) {\n    if (count !== undefined) lines.push(`  ${label.padEnd(12)} ${count}`);\n  }\n\n  if (report.routes && report.routes.length > 0) {\n    lines.push(\"\", \"Routes:\");\n\n    for (const route of report.routes) {\n      const guard = route.auth.required ? \" [auth]\" : \"\";\n      const name = route.name ? `  ${route.name}` : \"\";\n\n      lines.push(`  ${route.method.padEnd(7)} ${route.path}${guard}${name}`);\n    }\n  }\n\n  if (report.warnings.length > 0) {\n    lines.push(\"\", `${report.warnings.length} warning(s):`);\n\n    for (const warning of report.warnings) {\n      lines.push(`  - ${warning.code ? `${warning.code} ` : \"\"}${warning.message}`);\n    }\n  }\n\n  lines.push(\"\", \"Run `warlock inspect --json` for the full report.\");\n\n  return lines;\n}\n\n/**\n * Action behind `warlock inspect`.\n *\n * Boots the app read-only (the `warlock doctor` boot pass: connectors booted,\n * none started, no connection, no port), then describes it with\n * `inspectApp()`. With `--json`, stdout carries exactly the report and the\n * boot's progress lines go to stderr.\n *\n * @param data Parsed CLI args: `options.json`, `options.section`.\n */\nexport async function inspectCommandAction({ options }: CommandActionData): Promise<void> {\n  // Parsed first, so a typo fails before the app boots.\n  const sections = parseInspectSections(stringOption(options.section));\n  const json = options.json === true;\n  const boot = json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect();\n  const report = await inspectApp({ ...inspectOptionsFromBoot(boot), sections });\n\n  if (json) {\n    console.log(JSON.stringify(report, null, 2));\n    return;\n  }\n\n  const [heading, ...rest] = formatInspectSummary(report);\n\n  console.log(colors.bold(heading ?? \"\"));\n\n  for (const line of rest) {\n    console.log(line);\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;AAOA,SAAgB,qBAAqB,QAAiC;CACpE,MAAM,QAAkB,CACtB,GAAG,OAAO,IAAI,QAAQ,QAAQ,OAAO,IAAI,UAAU,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,OAAO,IAAI,gBAAgB,SAAS,OAAO,IAAI,KAAK,IACzI,EACF;CAEA,MAAM,SAAyC;EAC7C,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,eAAe,OAAO,QAAQ,MAAM;EACrC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,SAAS,OAAO,OAAO,MAAM;EAC9B,CAAC,QAAQ,OAAO,MAAM,MAAM;EAC5B,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,YAAY,OAAO,UAAU,MAAM;CACtC;CAEA,KAAK,MAAM,CAAC,OAAO,UAAU,QAC3B,IAAI,UAAU,QAAW,MAAM,KAAK,KAAK,MAAM,OAAO,EAAE,EAAE,GAAG,OAAO;CAGtE,IAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;EAC7C,MAAM,KAAK,IAAI,SAAS;EAExB,KAAK,MAAM,SAAS,OAAO,QAAQ;GACjC,MAAM,QAAQ,MAAM,KAAK,WAAW,YAAY;GAChD,MAAM,OAAO,MAAM,OAAO,KAAK,MAAM,SAAS;GAE9C,MAAM,KAAK,KAAK,MAAM,OAAO,OAAO,CAAC,EAAE,GAAG,MAAM,OAAO,QAAQ,MAAM;EACvE;CACF;CAEA,IAAI,OAAO,SAAS,SAAS,GAAG;EAC9B,MAAM,KAAK,IAAI,GAAG,OAAO,SAAS,OAAO,aAAa;EAEtD,KAAK,MAAM,WAAW,OAAO,UAC3B,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG,QAAQ,KAAK,KAAK,KAAK,QAAQ,SAAS;CAEhF;CAEA,MAAM,KAAK,IAAI,mDAAmD;CAElE,OAAO;AACT;;;;;;;;;;;AAYA,eAAsB,qBAAqB,EAAE,WAA6C;CAExF,MAAM,WAAW,qBAAqB,aAAa,QAAQ,OAAO,CAAC;CACnE,MAAM,OAAO,QAAQ,SAAS;CAC9B,MAAM,OAAO,OAAO,MAAM,0BAA0B,eAAe,CAAC,IAAI,MAAM,eAAe;CAC7F,MAAM,SAAS,MAAM,WAAW;EAAE,GAAG,uBAAuB,IAAI;EAAG;CAAS,CAAC;CAE7E,IAAI,MAAM;EACR,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;EAC3C;CACF;CAEA,MAAM,CAAC,SAAS,GAAG,QAAQ,qBAAqB,MAAM;CAEtD,QAAQ,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;CAEtC,KAAK,MAAM,QAAQ,MACjB,QAAQ,IAAI,IAAI;AAEpB"}

package/esm/cli/commands/issue/collect-environment.mjs

@@ -0,0 +1,187 @@
+import path from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { parseSync } from "oxc-parser";
+import { spawnSync } from "node:child_process";
+import os from "node:os";
+
+//#region ../../packages/core/src/cli/commands/issue/collect-environment.ts
+function readJson(file) {
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {
+		return;
+	}
+}
+function field(value, key) {
+	return typeof value === "object" && value !== null ? Reflect.get(value, key) : void 0;
+}
+function versionOf(value) {
+	return typeof value === "string" && /^\d+\.\d+\.\d+(?:[-+][\w.+-]+)?$/.test(value) ? value : null;
+}
+function moduleDirectories(cwd) {
+	const directories = [];
+	for (let current = path.resolve(cwd);; current = path.dirname(current)) {
+		directories.push(path.join(current, "node_modules"));
+		if (path.dirname(current) === current) return directories;
+	}
+}
+function installedVersion(directories, name) {
+	for (const directory of directories) {
+		const file = path.join(directory, name, "package.json");
+		if (existsSync(file)) return versionOf(field(readJson(file), "version"));
+	}
+	return null;
+}
+function installedPackages(directories) {
+	const names = /* @__PURE__ */ new Set();
+	for (const directory of directories) try {
+		for (const name of readdirSync(path.join(directory, "@warlock.js"))) if (/^[a-z0-9][a-z0-9-]*$/.test(name)) names.add(`@warlock.js/${name}`);
+	} catch {}
+	const packages = {};
+	for (const name of [...names].sort()) {
+		const version = installedVersion(directories, name);
+		if (version) packages[name] = version;
+	}
+	return packages;
+}
+function packageManager(cwd, userAgent) {
+	const agent = /^(npm|pnpm|yarn|bun)\/(\d+\.\d+\.\d+(?:[-+][\w.+-]+)?)(?:\s|$)/.exec(userAgent ?? "");
+	if (agent?.[1] && agent[2]) return {
+		name: agent[1],
+		version: agent[2]
+	};
+	const declared = field(readJson(path.join(cwd, "package.json")), "packageManager");
+	const detected = (typeof declared === "string" ? /^(npm|pnpm|yarn|bun)@/.exec(declared)?.[1] : void 0) ?? [
+		["pnpm-lock.yaml", "pnpm"],
+		["yarn.lock", "yarn"],
+		["bun.lock", "bun"],
+		["bun.lockb", "bun"],
+		["package-lock.json", "npm"]
+	].find(([file]) => existsSync(path.join(cwd, file)))?.[1];
+	if (!detected) return null;
+	const child = spawnSync(detected, ["--version"], {
+		cwd: path.parse(path.resolve(cwd)).root,
+		encoding: "utf8",
+		timeout: 3e3,
+		maxBuffer: 4096,
+		env: {
+			...process.env,
+			COREPACK_ENABLE_NETWORK: "0",
+			COREPACK_ENABLE_AUTO_PIN: "0"
+		},
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		],
+		windowsHide: true
+	});
+	return {
+		name: detected,
+		version: child.status === 0 ? versionOf(child.stdout.trim()) : null
+	};
+}
+function unwrap(node) {
+	if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression" || node.type === "TSTypeAssertion") return unwrap(node.expression);
+	return node;
+}
+function property(object, name) {
+	for (const item of [...object.properties].reverse()) {
+		if (item.type !== "Property" || item.computed || item.method) continue;
+		if ((item.key.type === "Identifier" ? item.key.name : item.key.type === "Literal" ? item.key.value : void 0) === name) return unwrap(item.value);
+	}
+}
+/** Parse syntax only; never import config, .env, connectors or app modules. */
+function collectIssueConfig(cwd) {
+	const summary = {
+		status: "missing",
+		sections: [],
+		buildFlags: {},
+		connectors: null,
+		customCommands: null,
+		dynamic: false
+	};
+	const file = path.join(cwd, "warlock.config.ts");
+	if (!existsSync(file)) return summary;
+	let source;
+	try {
+		source = readFileSync(file, "utf8");
+	} catch {
+		return {
+			...summary,
+			status: "unreadable"
+		};
+	}
+	try {
+		const parsed = parseSync("warlock.config.ts", source);
+		if (parsed.errors.length) return {
+			...summary,
+			status: "unparsed",
+			dynamic: true
+		};
+		const exported = parsed.program.body.find((node) => node.type === "ExportDefaultDeclaration");
+		let value = exported ? unwrap(exported.declaration) : void 0;
+		if (value?.type === "CallExpression" && value.callee.type === "Identifier" && value.callee.name === "defineConfig") value = value.arguments[0];
+		if (value) value = unwrap(value);
+		if (value?.type !== "ObjectExpression") return {
+			...summary,
+			status: "unparsed",
+			dynamic: true
+		};
+		const object = value;
+		summary.status = "static";
+		summary.sections = [
+			"server",
+			"build",
+			"connectors",
+			"cli",
+			"devServer",
+			"database",
+			"testing"
+		].filter((name) => property(object, name) !== void 0);
+		summary.dynamic = object.properties.some((item) => item.type === "SpreadElement" || item.computed);
+		const build = property(object, "build");
+		if (build?.type === "ObjectExpression") for (const key of [
+			"minify",
+			"sourcemap",
+			"singleBundle",
+			"esmShim",
+			"splitting"
+		]) {
+			const flag = property(build, key);
+			if (flag?.type === "Literal" && typeof flag.value === "boolean") summary.buildFlags[key] = flag.value;
+		}
+		const connectors = property(object, "connectors");
+		if (connectors?.type === "ArrayExpression" && !connectors.elements.some((item) => item?.type === "SpreadElement")) summary.connectors = connectors.elements.length;
+		const cli = property(object, "cli");
+		const commands = cli?.type === "ObjectExpression" ? property(cli, "commands") : void 0;
+		if (commands?.type === "ArrayExpression" && !commands.elements.some((item) => item?.type === "SpreadElement")) summary.customCommands = commands.elements.length;
+		return summary;
+	} catch {
+		return {
+			...summary,
+			status: "unparsed",
+			dynamic: true
+		};
+	}
+}
+/** Collect installed metadata without starting the app or reading private values. */
+function collectIssueEnvironment(cwd = process.cwd(), userAgent = process.env.npm_config_user_agent) {
+	const directories = moduleDirectories(cwd);
+	return {
+		packages: installedPackages(directories),
+		node: process.version,
+		packageManager: packageManager(cwd, userAgent),
+		os: {
+			platform: os.platform(),
+			release: os.release(),
+			arch: os.arch()
+		},
+		typescript: installedVersion(directories, "typescript"),
+		config: collectIssueConfig(cwd)
+	};
+}
+
+//#endregion
+export { collectIssueConfig, collectIssueEnvironment };
+//# sourceMappingURL=collect-environment.mjs.map

package/esm/cli/commands/issue/collect-environment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-environment.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/issue/collect-environment.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { parseSync, type Node, type ObjectExpression } from \"oxc-parser\";\n\nexport type IssueConfigSummary = {\n  status: \"missing\" | \"unreadable\" | \"unparsed\" | \"static\";\n  sections: string[];\n  buildFlags: Record<string, boolean>;\n  connectors: number | null;\n  customCommands: number | null;\n  dynamic: boolean;\n};\n\nexport type IssueEnvironment = {\n  packages: Record<string, string>;\n  node: string;\n  packageManager: { name: string; version: string | null } | null;\n  os: { platform: string; release: string; arch: string };\n  typescript: string | null;\n  config: IssueConfigSummary;\n};\n\nfunction readJson(file: string): unknown {\n  try {\n    return JSON.parse(readFileSync(file, \"utf8\"));\n  } catch {\n    return undefined;\n  }\n}\n\nfunction field(value: unknown, key: string): unknown {\n  return typeof value === \"object\" && value !== null ? Reflect.get(value, key) : undefined;\n}\n\n// Version metadata only: never copy arbitrary manifest strings into a public report.\nfunction versionOf(value: unknown): string | null {\n  return typeof value === \"string\" && /^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.+-]+)?$/.test(value) ? value : null;\n}\n\nfunction moduleDirectories(cwd: string): string[] {\n  const directories: string[] = [];\n  for (let current = path.resolve(cwd); ; current = path.dirname(current)) {\n    directories.push(path.join(current, \"node_modules\"));\n    if (path.dirname(current) === current) return directories;\n  }\n}\n\nfunction installedVersion(directories: string[], name: string): string | null {\n  for (const directory of directories) {\n    const file = path.join(directory, name, \"package.json\");\n    if (existsSync(file)) return versionOf(field(readJson(file), \"version\"));\n  }\n  return null;\n}\n\nfunction installedPackages(directories: string[]): Record<string, string> {\n  const names = new Set<string>();\n  for (const directory of directories) {\n    try {\n      for (const name of readdirSync(path.join(directory, \"@warlock.js\"))) {\n        if (/^[a-z0-9][a-z0-9-]*$/.test(name)) names.add(`@warlock.js/${name}`);\n      }\n    } catch {\n      // Missing node_modules is useful information, not a reason to require a boot.\n    }\n  }\n  const packages: Record<string, string> = {};\n  for (const name of [...names].sort()) {\n    const version = installedVersion(directories, name);\n    if (version) packages[name] = version;\n  }\n  return packages;\n}\n\nfunction packageManager(\n  cwd: string,\n  userAgent: string | undefined,\n): IssueEnvironment[\"packageManager\"] {\n  const agent = /^(npm|pnpm|yarn|bun)\\/(\\d+\\.\\d+\\.\\d+(?:[-+][\\w.+-]+)?)(?:\\s|$)/.exec(\n    userAgent ?? \"\",\n  );\n  if (agent?.[1] && agent[2]) return { name: agent[1], version: agent[2] };\n\n  const declared = field(readJson(path.join(cwd, \"package.json\")), \"packageManager\");\n  const name =\n    typeof declared === \"string\" ? /^(npm|pnpm|yarn|bun)@/.exec(declared)?.[1] : undefined;\n  const detected =\n    name ??\n    (\n      [\n        [\"pnpm-lock.yaml\", \"pnpm\"],\n        [\"yarn.lock\", \"yarn\"],\n        [\"bun.lock\", \"bun\"],\n        [\"bun.lockb\", \"bun\"],\n        [\"package-lock.json\", \"npm\"],\n      ] as const\n    ).find(([file]) => existsSync(path.join(cwd, file)))?.[1];\n  if (!detected) return null;\n\n  // Only a known executable and --version, never app scripts or npm_execpath.\n  // Probe outside the app so manager shims cannot select/install an app-pinned\n  // version or load project plugins. The result records our child's PID;\n  // timeout targets only that child.\n  const child = spawnSync(detected, [\"--version\"], {\n    cwd: path.parse(path.resolve(cwd)).root,\n    encoding: \"utf8\",\n    timeout: 3_000,\n    maxBuffer: 4_096,\n    env: { ...process.env, COREPACK_ENABLE_NETWORK: \"0\", COREPACK_ENABLE_AUTO_PIN: \"0\" },\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    windowsHide: true,\n  });\n  return { name: detected, version: child.status === 0 ? versionOf(child.stdout.trim()) : null };\n}\n\nfunction unwrap(node: Node): Node {\n  if (\n    node.type === \"TSAsExpression\" ||\n    node.type === \"TSSatisfiesExpression\" ||\n    node.type === \"ParenthesizedExpression\" ||\n    node.type === \"TSTypeAssertion\"\n  )\n    return unwrap(node.expression);\n  return node;\n}\n\nfunction property(object: ObjectExpression, name: string): Node | undefined {\n  for (const item of [...object.properties].reverse()) {\n    if (item.type !== \"Property\" || item.computed || item.method) continue;\n    const key =\n      item.key.type === \"Identifier\"\n        ? item.key.name\n        : item.key.type === \"Literal\"\n          ? item.key.value\n          : undefined;\n    if (key === name) return unwrap(item.value);\n  }\n  return undefined;\n}\n\n/** Parse syntax only; never import config, .env, connectors or app modules. */\nexport function collectIssueConfig(cwd: string): IssueConfigSummary {\n  const summary: IssueConfigSummary = {\n    status: \"missing\",\n    sections: [],\n    buildFlags: {},\n    connectors: null,\n    customCommands: null,\n    dynamic: false,\n  };\n  const file = path.join(cwd, \"warlock.config.ts\");\n  if (!existsSync(file)) return summary;\n  let source: string;\n  try {\n    source = readFileSync(file, \"utf8\");\n  } catch {\n    return { ...summary, status: \"unreadable\" };\n  }\n  try {\n    const parsed = parseSync(\"warlock.config.ts\", source);\n    if (parsed.errors.length) return { ...summary, status: \"unparsed\", dynamic: true };\n    const exported = parsed.program.body.find((node) => node.type === \"ExportDefaultDeclaration\");\n    let value: Node | undefined = exported ? unwrap(exported.declaration) : undefined;\n    if (\n      value?.type === \"CallExpression\" &&\n      value.callee.type === \"Identifier\" &&\n      value.callee.name === \"defineConfig\"\n    ) {\n      value = value.arguments[0];\n    }\n    if (value) value = unwrap(value);\n    if (value?.type !== \"ObjectExpression\")\n      return { ...summary, status: \"unparsed\", dynamic: true };\n\n    const object = value;\n    summary.status = \"static\";\n    // Fixed allowlist excludes custom keys, paths, names and all string values.\n    summary.sections = [\n      \"server\",\n      \"build\",\n      \"connectors\",\n      \"cli\",\n      \"devServer\",\n      \"database\",\n      \"testing\",\n    ].filter((name) => property(object, name) !== undefined);\n    summary.dynamic = object.properties.some(\n      (item) => item.type === \"SpreadElement\" || item.computed,\n    );\n    const build = property(object, \"build\");\n    if (build?.type === \"ObjectExpression\") {\n      for (const key of [\"minify\", \"sourcemap\", \"singleBundle\", \"esmShim\", \"splitting\"]) {\n        const flag = property(build, key);\n        if (flag?.type === \"Literal\" && typeof flag.value === \"boolean\")\n          summary.buildFlags[key] = flag.value;\n      }\n    }\n    const connectors = property(object, \"connectors\");\n    if (\n      connectors?.type === \"ArrayExpression\" &&\n      !connectors.elements.some((item) => item?.type === \"SpreadElement\")\n    ) {\n      summary.connectors = connectors.elements.length;\n    }\n    const cli = property(object, \"cli\");\n    const commands = cli?.type === \"ObjectExpression\" ? property(cli, \"commands\") : undefined;\n    if (\n      commands?.type === \"ArrayExpression\" &&\n      !commands.elements.some((item) => item?.type === \"SpreadElement\")\n    ) {\n      summary.customCommands = commands.elements.length;\n    }\n    return summary;\n  } catch {\n    return { ...summary, status: \"unparsed\", dynamic: true };\n  }\n}\n\n/** Collect installed metadata without starting the app or reading private values. */\nexport function collectIssueEnvironment(\n  cwd = process.cwd(),\n  userAgent = process.env.npm_config_user_agent,\n): IssueEnvironment {\n  const directories = moduleDirectories(cwd);\n  return {\n    packages: installedPackages(directories),\n    node: process.version,\n    packageManager: packageManager(cwd, userAgent),\n    os: { platform: os.platform(), release: os.release(), arch: os.arch() },\n    typescript: installedVersion(directories, \"typescript\"),\n    config: collectIssueConfig(cwd),\n  };\n}\n"],"mappings":"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"}