@warlock.js/core 5.30.0 → 5.32.0

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\nimport { Name } from \"../utils/name-parser\";\n\n/**\n * Controller template stub\n *\n * Controllers default to the guarded handler type since application\n * routes run behind `guarded()`. When `withValidation` is set, the\n * schema's exported type + value are imported directly from the\n * `schema/` folder and bound to the handler — no `requests/` alias.\n */\nexport function controllerStub(\n  name: ParsedName,\n  options: { withValidation?: boolean } = {},\n): string {\n  const { withValidation } = options;\n\n  if (!withValidation) {\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler = async ({ response }) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n`;\n  }\n\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async ({\n  response,\n}) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n\n${name.camel}Controller.validation = {\n  schema: ${name.camel}Schema,\n};\n`;\n}\n\n/**\n * CRUD Create Controller template\n * Note: moduleName is the module (plural), we need singular entity name\n */\nexport function crudCreateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\n\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\n\n  return response.successCreate({\n    ${moduleName.camel},\n  });\n};\n\ncreate${moduleName.pascal}Controller.validation = {\n  schema: create${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD Update Controller template\n */\nexport function crudUpdateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\n\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n\nupdate${moduleName.pascal}Controller.validation = {\n  schema: update${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD List Controller template\n */\nexport function crudListControllerStub(moduleName: Name): string {\n  const plural = moduleName.plural;\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\n\nexport const list${plural.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  const { data, pagination } = await list${plural.pascal}Service(request.all());\n\n  return response.success({\n    data,\n    pagination,\n  });\n};\n`;\n}\n\n/**\n * CRUD Show/Get Controller template\n */\nexport function crudShowControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\n\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\n\n  if (!${moduleName.camel}) {\n    return response.notFound();\n  }\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n`;\n}\n\n/**\n * CRUD Delete Controller template\n */\nexport function crudDeleteControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\n\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\n\n  return response.noContent();\n};\n`;\n}\n\n/**\n * CRUD Routes template\n */\nexport function crudRoutesStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { router } from \"@warlock.js/core\";\nimport { guarded } from \"app/shared/utils/router\";\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\n\nguarded(() => {\n  router\n    .route(\"/${plural.kebab}\")\n    .list(list${plural.pascal}Controller)\n    .show(get${singular.pascal}Controller)\n    .create(create${singular.pascal}Controller)\n    .update(update${singular.pascal}Controller)\n    .destroy(delete${singular.pascal}Controller);\n});\n`;\n}\n\n/**\n * CRUD Model template\n */\nexport function crudModelStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\nimport { type Infer, v } from \"@warlock.js/seal\";\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\n\nexport const ${singular.camel}Schema = v.object({\n  // TODO: Add more fields\n});\n\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\n\n@RegisterModel()\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\n  public static table = \"${plural.snake}\";\n\n  public static schema = ${singular.camel}Schema;\n\n  public static relations = {};\n\n  public static resource = ${singular.pascal}Resource;\n}\n`;\n}\n\n/**\n * CRUD Resource template\n */\nexport function crudResourceStub(moduleName: Name): string {\n  // Get singular entity name\n  const entity = moduleName.singular;\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\nexport const ${entity.pascal}Resource = defineResource({\n  schema: {\n    id: \"number\",\n    // TODO: Add more resource fields\n  },\n});\n`;\n}\n\n/**\n * CRUD Repository template\n */\nexport function crudRepositoryStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  const modulePluralName = entity.plural;\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\n\ntype ${moduleSingularName.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\n\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\n  public source = ${moduleSingularName.pascal};\n\n  public simpleSelectColumns: string[] = [\"id\"];\n\n  public filterBy: FilterRules = {\n    id: \"=\",\n  };\n\n  public defaultOptions: RepositoryOptions = {\n    orderBy: {\n      id: \"desc\",\n    },\n  };\n}\n\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\n`;\n}\n\n/**\n * CRUD Create Service template\n */\nexport function crudCreateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\n\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD Update Service template\n */\nexport function crudUpdateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\n\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\n\n  await ${moduleSingularName.camel}.save({ merge: data });\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD List Service template\n */\nexport function crudListServiceStub(entity: Name): string {\n  const modulePluralName = entity.plural;\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\n\nexport async function list${modulePluralName.pascal}Service(filters: any) {\n  return ${modulePluralName.camel}Repository.listCached(filters);\n}\n`;\n}\n\n/**\n * CRUD Get Service template\n */\nexport function crudGetServiceStub(entity: Name): string {\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\n\nexport async function get${entity.singular.pascal}Service(id: number | string) {\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\n\n  if (!${entity.singular.camel}) {\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\n  }\n\n  return ${entity.singular.camel};\n}\n`;\n}\n\n/**\n * CRUD Delete Service template\n */\nexport function crudDeleteServiceStub(entity: Name): string {\n  const singular = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\n\nexport async function delete${singular.pascal}Service(id: number | string) {\n  const ${singular.camel} = await get${singular.pascal}Service(id);\n  if (!${singular.camel}) {\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\n  }\n  await ${singular.camel}.destroy();\n}\n`;\n}\n\n/**\n * CRUD Seed template\n */\nexport function crudSeedStub(entity: Name): string {\n  return `import { seeder } from \"@warlock.js/core\";\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\n\nexport default seeder({\n  name: \"Seed ${entity.plural.pascal}\",\n  once: true,\n  // Disabled until you fill in the fields below. A generated stub calls\n  // create({}) with no data, which fails required-field validation and would\n  // abort the whole \\`warlock seed\\` run. Add the fields, then set this to true.\n  enabled: false,\n  run: async ({ track }) => {\n    const total = 10;\n    for (let i = 0; i < total; i++) {\n      track(\n        await ${entity.singular.pascal}.create({\n          // TODO: Add the model's required fields here, then set enabled: true above.\n        }),\n      );\n    }\n  },\n});\n`;\n}\n\n/**\n * Migration template\n */\n/**\n * Migration Create template\n */\nexport function migrationStub(\n  entityName: ParsedName,\n  options: {\n    columns?: string;\n    imports?: string[];\n    timestamps?: boolean;\n    tableName?: string;\n  } = {},\n): string {\n  const { columns = \"\", imports = [], timestamps = true } = options;\n\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  let optionsString = \"\";\n  if (timestamps === false) {\n    optionsString = `, { timestamps: false }`;\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.create(${entityName.pascal}, {\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\n}${optionsString});\n`;\n}\n\n/**\n * Migration Alter template\n */\nexport function migrationAlterStub(\n  entityName: ParsedName,\n  options: {\n    add?: string;\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\n    rename?: string; // stringified object like `{ old: \"new\" }`\n    imports?: string[];\n  } = {},\n): string {\n  const { add = \"\", drop, rename, imports = [] } = options;\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  // Build the schema object dynamically\n  const schemaParts: string[] = [];\n\n  if (add) {\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\n  }\n\n  if (drop) {\n    schemaParts.push(`  drop: ${drop},`);\n  }\n\n  if (rename) {\n    schemaParts.push(`  rename: ${rename},`);\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.alter(${entityName.pascal}, {\n${schemaParts.join(\"\\n\")}\n});\n`;\n}\n\n/**\n * CRUD Create Schema template\n * Outputs to: schema/create-{entity}.schema.ts\n */\nexport function crudCreateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const create${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * CRUD Update Schema template\n * Outputs to: schema/update-{entity}.schema.ts\n */\nexport function crudUpdateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const update${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * Service template stub\n */\nexport function serviceStub(name: Name): string {\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\n  // TODO: Implement service logic\n  throw new Error(\"${name.camel}Service not implemented\");\n}\n`;\n}\n\n/**\n * Schema template stub\n * Outputs to: schema/{name}.schema.ts\n */\nexport function schemaStub(name: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const ${name.camel}Schema = v.object({\n  // TODO: Define validation schema\n});\n\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\n`;\n}\n\n/**\n * Model template stub\n */\nexport function modelStub(\n  name: Name,\n  options: { tableName?: string; withResource?: boolean } = {},\n): string {\n  const { tableName = `${name.plural.snake}`, withResource } = options;\n\n  return `import { Model, type StrictMode } from \"@warlock.js/cascade\";\nimport { v, type Infer } from \"@warlock.js/seal\";\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\n\nconst ${name.singular.camel}Schema = v.object({\n  // TODO: Define model schema\n});\n\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\n\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\n  public static table = \"${tableName}\";\n  public static strictMode: StrictMode = \"fail\";\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\n\n  public static schema = ${name.singular.camel}Schema;\n\n  public static relations = {\n    // TODO: Define relations\n  };\n}\n`;\n}\n\n/**\n * Repository template stub\n */\nexport function repositoryStub(name: Name): string {\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\n\ntype ${name.singular.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${name.singular.pascal}ListOptions = TypedRepositoryOptions<${name.singular.pascal}ListFilter>;\n\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\n  public source = ${name.singular.pascal};\n\n  protected defaultOptions: Partial<RepositoryOptions> = {};\n\n  protected filterBy: FilterRules = {\n    name: \"like\",\n  };\n}\n\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\n`;\n}\n\n/**\n * Resource template stub\n */\nexport function resourceStub(name: Name): string {\n  return `import { Resource, type ResourceSchema } from \"@warlock.js/core\";\n\nexport class ${name.singular.pascal}Resource extends Resource {\n  public static schema: ResourceSchema = {\n    id: \"int\",\n    name: \"string\",\n    // TODO: Define resource schema\n  };\n}\n`;\n}\n\n/**\n * Use-case template stub\n * Outputs to: use-cases/{name}.use-case.ts\n *\n * A use-case takes validated input and an actor, never a request or response,\n * so a page action and a controller can both call it.\n */\nexport function useCaseStub(name: Name): string {\n  return `import type { ${name.pascal}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport type ${name.pascal}Actor = { id: number | string };\n\nexport type ${name.pascal}Result =\n  | { code: \"OK\" }\n  | { code: \"FORBIDDEN\" }\n  | { code: \"NOT_FOUND\" };\n\nexport async function ${name.camel}UseCase(\n  input: ${name.pascal}Schema,\n  actor: ${name.pascal}Actor,\n): Promise<${name.pascal}Result> {\n  // TODO: Implement use-case logic\n  void input;\n  void actor;\n\n  return { code: \"OK\" };\n}\n`;\n}\n\n/**\n * Use-case spec template stub\n * Outputs to: use-cases/{name}.use-case.spec.ts\n */\nexport function useCaseSpecStub(name: Name): string {\n  return `import { describe, expect, it } from \"vitest\";\nimport { ${name.camel}UseCase } from \"./${name.kebab}.use-case\";\n\ndescribe(\"${name.camel}UseCase\", () => {\n  it(\"returns OK for a valid input\", async () => {\n    const result = await ${name.camel}UseCase({} as never, { id: 1 });\n\n    expect(result.code).toBe(\"OK\");\n  });\n});\n`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\nimport { Name } from \"../utils/name-parser\";\n\n/**\n * Controller template stub\n *\n * Controllers default to the guarded handler type since application\n * routes run behind `guarded()`. When `withValidation` is set, the\n * schema's exported type + value are imported directly from the\n * `schema/` folder and bound to the handler — no `requests/` alias.\n */\nexport function controllerStub(\n  name: ParsedName,\n  options: { withValidation?: boolean } = {},\n): string {\n  const { withValidation } = options;\n\n  if (!withValidation) {\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler = async ({ response }) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n`;\n  }\n\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async ({\n  response,\n}) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n\n${name.camel}Controller.validation = {\n  schema: ${name.camel}Schema,\n};\n`;\n}\n\n/**\n * CRUD Create Controller template\n * Note: moduleName is the module (plural), we need singular entity name\n */\nexport function crudCreateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\n\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\n\n  return response.successCreate({\n    ${moduleName.camel},\n  });\n};\n\ncreate${moduleName.pascal}Controller.validation = {\n  schema: create${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD Update Controller template\n */\nexport function crudUpdateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\n\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n\nupdate${moduleName.pascal}Controller.validation = {\n  schema: update${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD List Controller template\n */\nexport function crudListControllerStub(moduleName: Name): string {\n  const plural = moduleName.plural;\n  return `import { type Infer, v } from \"@warlock.js/seal\";\nimport { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\n\n/**\n * Query parameters the list accepts. Add each filter you expose; unknown keys\n * are stripped, so nothing unvalidated reaches the repository.\n */\nconst list${plural.pascal}QuerySchema = v.object({\n  page: v.numeric().min(1).optional(),\n  limit: v.numeric().min(1).max(100).optional(),\n});\n\nexport const list${plural.pascal}Controller: GuardedRequestHandler<\n  Infer<typeof list${plural.pascal}QuerySchema>\n> = async ({ request, response }) => {\n  const { data, pagination } = await list${plural.pascal}Service(request.validated());\n\n  return response.success({\n    data,\n    pagination,\n  });\n};\n\nlist${plural.pascal}Controller.validation = {\n  schema: list${plural.pascal}QuerySchema,\n};\n`;\n}\n\n/**\n * CRUD Show/Get Controller template\n */\nexport function crudShowControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\n\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\n\n  if (!${moduleName.camel}) {\n    return response.notFound();\n  }\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n`;\n}\n\n/**\n * CRUD Delete Controller template\n */\nexport function crudDeleteControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\n\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\n\n  return response.noContent();\n};\n`;\n}\n\n/**\n * CRUD Routes template\n */\nexport function crudRoutesStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { router } from \"@warlock.js/core\";\nimport { guarded } from \"app/shared/utils/router\";\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\n\nguarded(() => {\n  router\n    .route(\"/${plural.kebab}\")\n    .list(list${plural.pascal}Controller)\n    .show(get${singular.pascal}Controller)\n    .create(create${singular.pascal}Controller)\n    .update(update${singular.pascal}Controller)\n    .destroy(delete${singular.pascal}Controller);\n});\n`;\n}\n\n/**\n * CRUD Model template\n */\nexport function crudModelStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\nimport { type Infer, v } from \"@warlock.js/seal\";\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\n\nexport const ${singular.camel}Schema = v.object({\n  // TODO: Add more fields\n});\n\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\n\n@RegisterModel()\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\n  public static table = \"${plural.snake}\";\n\n  public static schema = ${singular.camel}Schema;\n\n  public static relations = {};\n\n  public static resource = ${singular.pascal}Resource;\n}\n`;\n}\n\n/**\n * CRUD Resource template\n */\nexport function crudResourceStub(moduleName: Name): string {\n  // Get singular entity name\n  const entity = moduleName.singular;\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\nexport const ${entity.pascal}Resource = defineResource({\n  schema: {\n    id: \"number\",\n    // TODO: Add more resource fields\n  },\n});\n`;\n}\n\n/**\n * CRUD Repository template\n */\nexport function crudRepositoryStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  const modulePluralName = entity.plural;\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\n\ntype ${moduleSingularName.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\n\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\n  public source = ${moduleSingularName.pascal};\n\n  public simpleSelectColumns: string[] = [\"id\"];\n\n  public filterBy: FilterRules = {\n    id: \"=\",\n  };\n\n  public defaultOptions: RepositoryOptions = {\n    orderBy: {\n      id: \"desc\",\n    },\n  };\n}\n\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\n`;\n}\n\n/**\n * CRUD Create Service template\n */\nexport function crudCreateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\n\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD Update Service template\n */\nexport function crudUpdateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\n\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\n\n  await ${moduleSingularName.camel}.save({ merge: data });\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD List Service template\n */\nexport function crudListServiceStub(entity: Name): string {\n  const modulePluralName = entity.plural;\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\n\nexport async function list${modulePluralName.pascal}Service(filters: any) {\n  return ${modulePluralName.camel}Repository.listCached(filters);\n}\n`;\n}\n\n/**\n * CRUD Get Service template\n */\nexport function crudGetServiceStub(entity: Name): string {\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\n\nexport async function get${entity.singular.pascal}Service(id: number | string) {\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\n\n  if (!${entity.singular.camel}) {\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\n  }\n\n  return ${entity.singular.camel};\n}\n`;\n}\n\n/**\n * CRUD Delete Service template\n */\nexport function crudDeleteServiceStub(entity: Name): string {\n  const singular = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\n\nexport async function delete${singular.pascal}Service(id: number | string) {\n  const ${singular.camel} = await get${singular.pascal}Service(id);\n  if (!${singular.camel}) {\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\n  }\n  await ${singular.camel}.destroy();\n}\n`;\n}\n\n/**\n * CRUD Seed template\n */\nexport function crudSeedStub(entity: Name): string {\n  return `import { seeder } from \"@warlock.js/core\";\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\n\nexport default seeder({\n  name: \"Seed ${entity.plural.pascal}\",\n  once: true,\n  // Disabled until you fill in the fields below. A generated stub calls\n  // create({}) with no data, which fails required-field validation and would\n  // abort the whole \\`warlock seed\\` run. Add the fields, then set this to true.\n  enabled: false,\n  run: async ({ track }) => {\n    const total = 10;\n    for (let i = 0; i < total; i++) {\n      track(\n        await ${entity.singular.pascal}.create({\n          // TODO: Add the model's required fields here, then set enabled: true above.\n        }),\n      );\n    }\n  },\n});\n`;\n}\n\n/**\n * Migration template\n */\n/**\n * Migration Create template\n */\nexport function migrationStub(\n  entityName: ParsedName,\n  options: {\n    columns?: string;\n    imports?: string[];\n    timestamps?: boolean;\n    tableName?: string;\n  } = {},\n): string {\n  const { columns = \"\", imports = [], timestamps = true } = options;\n\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  let optionsString = \"\";\n  if (timestamps === false) {\n    optionsString = `, { timestamps: false }`;\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.create(${entityName.pascal}, {\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\n}${optionsString});\n`;\n}\n\n/**\n * Migration Alter template\n */\nexport function migrationAlterStub(\n  entityName: ParsedName,\n  options: {\n    add?: string;\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\n    rename?: string; // stringified object like `{ old: \"new\" }`\n    imports?: string[];\n  } = {},\n): string {\n  const { add = \"\", drop, rename, imports = [] } = options;\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  // Build the schema object dynamically\n  const schemaParts: string[] = [];\n\n  if (add) {\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\n  }\n\n  if (drop) {\n    schemaParts.push(`  drop: ${drop},`);\n  }\n\n  if (rename) {\n    schemaParts.push(`  rename: ${rename},`);\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.alter(${entityName.pascal}, {\n${schemaParts.join(\"\\n\")}\n});\n`;\n}\n\n/**\n * CRUD Create Schema template\n * Outputs to: schema/create-{entity}.schema.ts\n */\nexport function crudCreateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const create${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * CRUD Update Schema template\n * Outputs to: schema/update-{entity}.schema.ts\n */\nexport function crudUpdateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const update${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * Service template stub\n */\nexport function serviceStub(name: Name): string {\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\n  // TODO: Implement service logic\n  throw new Error(\"${name.camel}Service not implemented\");\n}\n`;\n}\n\n/**\n * Schema template stub\n * Outputs to: schema/{name}.schema.ts\n */\nexport function schemaStub(name: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const ${name.camel}Schema = v.object({\n  // TODO: Define validation schema\n});\n\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\n`;\n}\n\n/**\n * Model template stub\n */\nexport function modelStub(\n  name: Name,\n  options: { tableName?: string; withResource?: boolean } = {},\n): string {\n  const { tableName = `${name.plural.snake}`, withResource } = options;\n\n  return `import { Model, type StrictMode } from \"@warlock.js/cascade\";\nimport { v, type Infer } from \"@warlock.js/seal\";\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\n\nconst ${name.singular.camel}Schema = v.object({\n  // TODO: Define model schema\n});\n\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\n\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\n  public static table = \"${tableName}\";\n  public static strictMode: StrictMode = \"fail\";\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\n\n  public static schema = ${name.singular.camel}Schema;\n\n  public static relations = {\n    // TODO: Define relations\n  };\n}\n`;\n}\n\n/**\n * Repository template stub\n */\nexport function repositoryStub(name: Name): string {\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\n\ntype ${name.singular.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${name.singular.pascal}ListOptions = TypedRepositoryOptions<${name.singular.pascal}ListFilter>;\n\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\n  public source = ${name.singular.pascal};\n\n  protected defaultOptions: Partial<RepositoryOptions> = {};\n\n  protected filterBy: FilterRules = {\n    name: \"like\",\n  };\n}\n\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\n`;\n}\n\n/**\n * Resource template stub\n */\nexport function resourceStub(name: Name): string {\n  return `import { Resource, type ResourceSchema } from \"@warlock.js/core\";\n\nexport class ${name.singular.pascal}Resource extends Resource {\n  public static schema: ResourceSchema = {\n    id: \"int\",\n    name: \"string\",\n    // TODO: Define resource schema\n  };\n}\n`;\n}\n\n/**\n * Use-case template stub\n * Outputs to: use-cases/{name}.use-case.ts\n *\n * A use-case takes validated input and an actor, never a request or response,\n * so a page action and a controller can both call it.\n */\nexport function useCaseStub(name: Name): string {\n  return `import type { ${name.pascal}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport type ${name.pascal}Actor = { id: number | string };\n\nexport type ${name.pascal}Result =\n  | { code: \"OK\" }\n  | { code: \"FORBIDDEN\" }\n  | { code: \"NOT_FOUND\" };\n\nexport async function ${name.camel}UseCase(\n  input: ${name.pascal}Schema,\n  actor: ${name.pascal}Actor,\n): Promise<${name.pascal}Result> {\n  // TODO: Implement use-case logic\n  void input;\n  void actor;\n\n  return { code: \"OK\" };\n}\n`;\n}\n\n/**\n * Use-case spec template stub\n * Outputs to: use-cases/{name}.use-case.spec.ts\n */\nexport function useCaseSpecStub(name: Name): string {\n  return `import { describe, expect, it } from \"vitest\";\nimport { ${name.camel}UseCase } from \"./${name.kebab}.use-case\";\n\ndescribe(\"${name.camel}UseCase\", () => {\n  it(\"returns OK for a valid input\", async () => {\n    const result = await ${name.camel}UseCase({} as never, { id: 1 });\n\n    expect(result.code).toBe(\"OK\");\n  });\n});\n`;\n}\n"],"mappings":"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"}