zudojs-cli 2.1.2 → 2.2.0

package/dist/src/templates/backendApp/parts/config.template.js

@@ -18,8 +18,12 @@ export function baseEnvVariables(port) {
             value: "",
             comment: "Comma-separated origins allowed to call the API from a browser (empty: none)",
         },
-        { name: "RATE_LIMIT_WINDOW_MS", value: "60000", comment: "Requests allowed per client per window" },
-        { name: "RATE_LIMIT_MAX", value: "300" },
+        { name: "RATE_LIMIT_WINDOW_MS", value: "60000", comment: "Length of the rate-limit window in milliseconds" },
+        {
+            name: "RATE_LIMIT_MAX",
+            value: "1000",
+            comment: "Requests allowed per client per window; 0 disables the limit (load tests, local development)",
+        },
     ];
 }
 /** Renders `.env.example` lines for `variables`. */
@@ -34,12 +38,13 @@ export function renderEnvVariables(variables) {
  * placed between the config markers.
  */
 export function renderConfigFile(options) {
-    return `import { ConfigurationError } from "@zudojs/errors";
-import {
+    return `import {
   createConfigManager,
   createEnvironmentConfigSource,
   type ConfigManager,
 } from "@zudojs/config";
+import { resolveEnvironment } from "@zudojs/constants";
+import { ConfigurationError } from "@zudojs/errors";
 
 const DEFAULT_PORT = ${options.defaultPort};
 
@@ -99,7 +104,10 @@ export async function loadConfig(env: NodeJS.ProcessEnv = process.env) {
   await config.load();
 
   return Object.freeze({
-    nodeEnv: text(config, "node_env", "development"),
+    // NODE_ENV is read here, once, the way the framework reads it: \`prod\`
+    // and \`Production\` are production, an unknown value warns once. app.ts
+    // and server.ts take the resolved value from this object.
+    nodeEnv: resolveEnvironment({ NODE_ENV: text(config, "node_env", "development") }),
     host: text(config, "host", "0.0.0.0"),
     port: port(config),
     corsOrigins: list(config, "cors_origins"),
@@ -115,4 +123,3 @@ ${renderMarkerBlock(MARKERS.config, options.sections, "    ")}
 export type AppConfig = Awaited<ReturnType<typeof loadConfig>>;
 `;
 }
-//# sourceMappingURL=config.template.js.map

package/dist/src/templates/backendApp/parts/httpUtils.template.d.ts

@@ -3,8 +3,8 @@
  *
  * The small helpers every generated controller and the server use: JSON
  * responses, schema-issue responses, JSON body reading, mapping exposed
- * 4xx errors to responses, and the @zudojs/security default headers.
+ * errors to responses, describing unexpected ones for the log, and the
+ * @zudojs/security default headers.
  */
 /** Renders `src/utils/http.ts`. */
 export declare function renderHttpUtils(): string;
-//# sourceMappingURL=httpUtils.template.d.ts.map

package/dist/src/templates/backendApp/parts/httpUtils.template.js

@@ -3,7 +3,8 @@
  *
  * The small helpers every generated controller and the server use: JSON
  * responses, schema-issue responses, JSON body reading, mapping exposed
- * 4xx errors to responses, and the @zudojs/security default headers.
+ * errors to responses, describing unexpected ones for the log, and the
+ * @zudojs/security default headers.
  */
 /** Renders `src/utils/http.ts`. */
 export function renderHttpUtils() {
@@ -61,9 +62,10 @@ export function readJsonBody(ctx: HttpRouterContext): unknown {
 }
 
 /**
- * The response for an error that carries an exposed 4xx status
- * (NotFoundError, badRequest(), ...). Anything else is left to the server,
- * which answers a generic 500 and never leaks the message.
+ * The response for an error that carries an exposed HTTP status
+ * (NotFoundError, badRequest(), an exposed 503, ...): its status, message
+ * and code. \`undefined\` for anything else; server.ts then logs the error
+ * and answers a generic 500 that never leaks the message.
  */
 export function errorResponse(error: unknown): HttpResponseContext | undefined {
   if (typeof error !== "object" || error === null) return undefined;
@@ -74,7 +76,7 @@ export function errorResponse(error: unknown): HttpResponseContext | undefined {
     readonly code?: unknown;
   };
   const status = candidate.statusCode;
-  if (typeof status !== "number" || status < 400 || status > 499) return undefined;
+  if (typeof status !== "number" || status < 400 || status > 599) return undefined;
   if (candidate.expose !== true || typeof candidate.message !== "string") return undefined;
   return json(status, {
     error: candidate.message,
@@ -82,6 +84,19 @@ export function errorResponse(error: unknown): HttpResponseContext | undefined {
   });
 }
 
+/** What the log records about an unexpected error: name, message, code, stack. */
+export function errorDetails(error: unknown): Record<string, string> {
+  if (!(error instanceof Error)) return { error: String(error) };
+  const { code } = error as { readonly code?: unknown };
+  return {
+    error: error.message,
+    name: error.name,
+    ...(typeof code === "string" ? { code } : {}),
+    ...(error.stack === undefined ? {} : { stack: error.stack }),
+    ...(error.cause === undefined ? {} : { cause: error.cause instanceof Error ? error.cause.message : String(error.cause) }),
+  };
+}
+
 /**
  * Adds the @zudojs/security default headers (CSP, HSTS, nosniff,
  * X-Frame-Options DENY, ...) to every response that does not set its own:
@@ -100,4 +115,3 @@ export function securityHeaders(): HttpMiddleware {
 }
 `;
 }
-//# sourceMappingURL=httpUtils.template.js.map

package/dist/src/templates/backendApp/parts/index.d.ts

@@ -6,4 +6,3 @@ export * from "./config.template.js";
 export * from "./httpUtils.template.js";
 export * from "./integrations.template.js";
 export * from "./wiring.template.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/backendApp/parts/index.js

@@ -6,4 +6,3 @@ export * from "./config.template.js";
 export * from "./httpUtils.template.js";
 export * from "./integrations.template.js";
 export * from "./wiring.template.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/backendApp/parts/integrations.template.d.ts

@@ -13,4 +13,3 @@ import type { MarkerLines } from "./wiring.template.js";
 export declare function renderIntegrationsIndex(lines: MarkerLines): string;
 /** Renders `src/integrations/integration.ts`. */
 export declare function renderIntegrationContract(): string;
-//# sourceMappingURL=integrations.template.d.ts.map

package/dist/src/templates/backendApp/parts/integrations.template.js

@@ -112,4 +112,3 @@ export async function checkIntegrations(
 }
 `;
 }
-//# sourceMappingURL=integrations.template.js.map

package/dist/src/templates/backendApp/parts/wiring.template.d.ts

@@ -5,7 +5,9 @@
  *   plus every resource (and module) between the `routes` markers.
  * - `src/modules/<name>/routes/index.ts` does the same for one module.
  * - `src/container.ts` constructs every controller, service and repository
- *   in one place, between the `container` markers.
+ *   in one place, between the `container` markers, and exports the
+ *   `APP_DEPENDENCIES` token under which server.ts registers the result in
+ *   the runtime's DI container.
  */
 /** Lines a template pre-fills between a pair of markers. */
 export interface MarkerLines {
@@ -23,4 +25,3 @@ export declare function renderModuleRoutesIndex(functionName: string, containerF
 export declare function renderHealthRoutes(): string;
 /** Renders `src/container.ts`. */
 export declare function renderContainer(lines: MarkerLines): string;
-//# sourceMappingURL=wiring.template.d.ts.map

package/dist/src/templates/backendApp/parts/wiring.template.js

@@ -5,7 +5,9 @@
  *   plus every resource (and module) between the `routes` markers.
  * - `src/modules/<name>/routes/index.ts` does the same for one module.
  * - `src/container.ts` constructs every controller, service and repository
- *   in one place, between the `container` markers.
+ *   in one place, between the `container` markers, and exports the
+ *   `APP_DEPENDENCIES` token under which server.ts registers the result in
+ *   the runtime's DI container.
  */
 import { MARKERS, renderMarkerBlock } from "../../../wiring/index.js";
 /** Renders `src/routes/index.ts`. */
@@ -80,9 +82,18 @@ export function registerHealthRoutes(router: HttpRouter, check: HealthCheck): vo
 }
 /** Renders `src/container.ts`. */
 export function renderContainer(lines) {
-    return `import type { HealthCheck } from "./routes/health.routes.js";
+    return `import { createToken } from "@zudojs/container";
+
+import type { HealthCheck } from "./routes/health.routes.js";
 ${renderMarkerBlock(MARKERS.containerImports, lines.imports)}
 
+/**
+ * The token server.ts registers the composition root under in the runtime
+ * container, so a module can reach it:
+ * \`context.application.container.resolve(APP_DEPENDENCIES)\`.
+ */
+export const APP_DEPENDENCIES = createToken<AppDependencies>("app.dependencies");
+
 /** Options for {@link createDependencies}. */
 export interface DependencyOptions {
   /** Readiness for /health; server.ts passes the runtime's. */
@@ -108,4 +119,3 @@ ${renderMarkerBlock(MARKERS.container, lines.entries, "    ")}
 export type AppDependencies = ReturnType<typeof createDependencies>;
 `;
 }
-//# sourceMappingURL=wiring.template.js.map

package/dist/src/templates/microservice/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Microservice Template Index
  */
 export { generateMicroserviceFiles, resolveMicroserviceServices, RESERVED_MICROSERVICE_APP_NAMES, } from "./microservice.template.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/microservice/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Microservice Template Index
  */
 export { generateMicroserviceFiles, resolveMicroserviceServices, RESERVED_MICROSERVICE_APP_NAMES, } from "./microservice.template.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/microservice/microservice.template.d.ts

@@ -44,4 +44,3 @@ export declare const RESERVED_MICROSERVICE_APP_NAMES: readonly ["gateway"];
  */
 export declare function resolveMicroserviceServices(requested: readonly string[]): readonly string[];
 export declare function generateMicroserviceFiles(options: ScaffoldOptions): Record<string, string>;
-//# sourceMappingURL=microservice.template.d.ts.map

package/dist/src/templates/microservice/microservice.template.js

@@ -26,7 +26,7 @@ import { zudojsDependencies } from "../../constants/index.js";
 import { normalizeName } from "../../utils/utils.name.js";
 import { RUNTIME_APP_DEPENDENCIES, capabilityPackages, moduleSpec, renderAppPackageDockerfile, renderModuleFile, renderPnpmWorkspaceFile, resolveProjectCapabilities, } from "../shared/index.js";
 import { DEPENDENCY_VERSION_RANGES, TYPESCRIPT_VERSION_RANGES, } from "../../resolvers/dependency/dependencyVersions.constant.js";
-import { APP_SOURCE_DEPENDENCIES, APP_TEST_DEPENDENCIES, applyDatabaseSetting, backendDevDependencies, emptyBarrels, renderBackendAppSource, } from "../backendApp/index.js";
+import { APP_SOURCE_DEPENDENCIES, APP_TEST_DEPENDENCIES, applyDatabaseSetting, backendAppScripts, backendDevDependencies, backendTsconfigFiles, emptyBarrels, renderBackendAppSource, } from "../backendApp/index.js";
 /**
  * The gateway app is always generated at `apps/gateway`, so "gateway" is a
  * reserved name: a service called `gateway` would produce a second, competing
@@ -205,33 +205,13 @@ MIT
     // app there, so nothing would compile a file placed in it. Every app owns
     // its own `src/types/`, and code genuinely shared between apps belongs in a
     // workspace package the author creates deliberately.
-    const appTsconfig = `{
-  "compilerOptions": {
-    "target": "ES2024",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "lib": ["ES2024"],
-    "types": ["node"]
-  },
-  "include": ["src/**/*"]
-}
-`;
+    /** tsconfig.json and tsconfig.test.json of one app, under `appDir`. */
+    const appTsconfigs = (appDir) => Object.fromEntries(Object.entries(backendTsconfigFiles()).map(([name, content]) => [`${appDir}/${name}`, content]));
     const appDevDeps = {
         ...backendDevDependencies(),
         ...zudojsDependencies(APP_TEST_DEPENDENCIES),
     };
-    const appScripts = {
-        dev: "tsx watch src/server.ts",
-        start: "node dist/server.js",
-        build: "tsc",
-        typecheck: "tsc --noEmit",
-        test: "vitest run",
-    };
+    const appScripts = backendAppScripts();
     /** The wired source tree of one app, plus its folder barrels. */
     const appSource = (appName, port) => {
         const spec = moduleSpec(appName, "./modules/index.js");
@@ -273,7 +253,7 @@ MIT
             dependencies: zudojsDependencies(gatewayDeps),
             devDependencies: appDevDeps,
         }, null, 2) + "\n";
-    files["apps/gateway/tsconfig.json"] = appTsconfig;
+    Object.assign(files, appTsconfigs("apps/gateway"));
     files["apps/gateway/Dockerfile"] = renderAppPackageDockerfile({
         appPath: "apps/gateway",
         port: 3000,
@@ -301,7 +281,7 @@ MIT
                 dependencies: zudojsDependencies(serviceDeps),
                 devDependencies: appDevDeps,
             }, null, 2) + "\n";
-        files[`apps/services/${svcName}/tsconfig.json`] = appTsconfig;
+        Object.assign(files, appTsconfigs(`apps/services/${svcName}`));
         files[`apps/services/${svcName}/Dockerfile`] = renderAppPackageDockerfile({
             appPath: `apps/services/${svcName}`,
             port,
@@ -313,4 +293,3 @@ MIT
     }
     return files;
 }
-//# sourceMappingURL=microservice.template.js.map

package/dist/src/templates/modular-monolith/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Modular Monolith Template Index
  */
 export { generateModularMonolithFiles } from "./modularMonolith.template.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/modular-monolith/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Modular Monolith Template Index
  */
 export { generateModularMonolithFiles } from "./modularMonolith.template.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/modular-monolith/modularMonolith.template.d.ts

@@ -33,4 +33,3 @@
  */
 import type { ScaffoldOptions } from "../../types/index.js";
 export declare function generateModularMonolithFiles(options: ScaffoldOptions): Record<string, string>;
-//# sourceMappingURL=modularMonolith.template.d.ts.map

package/dist/src/templates/modular-monolith/modularMonolith.template.js

@@ -35,7 +35,7 @@ import { renderDatabaseEnv } from "../../adapters/databases/databaseAdapter.reso
 import { zudojsDependencies } from "../../constants/index.js";
 import { normalizeName } from "../../utils/utils.name.js";
 import { RUNTIME_APP_DEPENDENCIES, capabilityPackages, moduleSpec, renderModuleFile, renderPnpmWorkspaceFile, resolveProjectCapabilities, } from "../shared/index.js";
-import { APP_SOURCE_DEPENDENCIES, APP_TEST_DEPENDENCIES, applyDatabaseSetting, backendDevDependencies, backendTsconfig, emptyBarrels, renderBackendAppSource, runCommand, } from "../backendApp/index.js";
+import { APP_SOURCE_DEPENDENCIES, APP_TEST_DEPENDENCIES, applyDatabaseSetting, backendAppScripts, backendDevDependencies, backendTsconfigFiles, emptyBarrels, renderBackendAppSource, runCommand, } from "../backendApp/index.js";
 export function generateModularMonolithFiles(options) {
     const nameSlug = options.projectName
         .replace(/[^a-z0-9-]+/gi, "-")
@@ -77,20 +77,14 @@ export function generateModularMonolithFiles(options) {
                 architecture: "modular-monolith",
                 features: capabilities,
             },
-            scripts: {
-                dev: "tsx watch src/server.ts",
-                start: "node dist/server.js",
-                build: "tsc",
-                typecheck: "tsc --noEmit",
-                test: "vitest run",
-            },
+            scripts: backendAppScripts(),
             dependencies: zudojsDependencies(deps),
             devDependencies: {
                 ...backendDevDependencies(),
                 ...zudojsDependencies(APP_TEST_DEPENDENCIES),
             },
         }, null, 2) + "\n";
-    files["tsconfig.json"] = backendTsconfig();
+    Object.assign(files, backendTsconfigFiles());
     if (options.packageManager === "pnpm") {
         files["pnpm-workspace.yaml"] = renderPnpmWorkspaceFile();
     }
@@ -159,4 +153,3 @@ MIT
     }
     return files;
 }
-//# sourceMappingURL=modularMonolith.template.js.map

package/dist/src/templates/monolith/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Monolith Template Index
  */
 export { generateMonolithFiles } from "./monolith.template.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/monolith/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Monolith Template Index
  */
 export { generateMonolithFiles } from "./monolith.template.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/monolith/monolith.template.d.ts

@@ -24,4 +24,3 @@
  */
 import type { ScaffoldOptions } from "../../types/index.js";
 export declare function generateMonolithFiles(options: ScaffoldOptions): Record<string, string>;
-//# sourceMappingURL=monolith.template.d.ts.map

package/dist/src/templates/monolith/monolith.template.js

@@ -26,7 +26,7 @@ import { renderDatabaseEnv } from "../../adapters/databases/databaseAdapter.reso
 import { zudojsDependencies } from "../../constants/index.js";
 import { normalizeName, toPascalCase } from "../../utils/utils.name.js";
 import { RUNTIME_APP_DEPENDENCIES, capabilityPackages, moduleSpec, renderModuleFile, renderServiceFile, renderPnpmWorkspaceFile, resolveProjectCapabilities, } from "../shared/index.js";
-import { APP_SOURCE_DEPENDENCIES, APP_TEST_DEPENDENCIES, applyDatabaseSetting, backendDevDependencies, backendTsconfig, emptyBarrels, runCommand, renderBackendAppSource, } from "../backendApp/index.js";
+import { APP_SOURCE_DEPENDENCIES, APP_TEST_DEPENDENCIES, applyDatabaseSetting, backendAppScripts, backendDevDependencies, backendTsconfigFiles, emptyBarrels, runCommand, renderBackendAppSource, } from "../backendApp/index.js";
 export function generateMonolithFiles(options) {
     const name = options.projectName;
     const nameSlug = name.replace(/[^a-z0-9-]+/gi, "-").toLowerCase();
@@ -56,21 +56,14 @@ export function generateMonolithFiles(options) {
                 architecture: "monolith",
                 features: capabilities,
             },
-            scripts: {
-                dev: "tsx watch src/server.ts",
-                start: "node dist/server.js",
-                build: "tsc",
-                typecheck: "tsc --noEmit",
-                test: "vitest run",
-                lint: "tsc --noEmit",
-            },
+            scripts: backendAppScripts(),
             dependencies: zudojsDependencies(deps),
             devDependencies: {
                 ...backendDevDependencies(),
                 ...zudojsDependencies(APP_TEST_DEPENDENCIES),
             },
         }, null, 2) + "\n";
-    files["tsconfig.json"] = backendTsconfig();
+    Object.assign(files, backendTsconfigFiles());
     if (options.packageManager === "pnpm") {
         files["pnpm-workspace.yaml"] = renderPnpmWorkspaceFile();
     }
@@ -148,4 +141,3 @@ MIT
         `export { ${serviceClassName} } from "./${moduleName}.service.js";\n`;
     return files;
 }
-//# sourceMappingURL=monolith.template.js.map

package/dist/src/templates/resource/index.d.ts

@@ -6,4 +6,3 @@ export * from "./resource.names.js";
 export * from "./resource.type.js";
 export * from "./resource.files.js";
 export * from "./layers/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/resource/index.js

@@ -6,4 +6,3 @@ export * from "./resource.names.js";
 export * from "./resource.type.js";
 export * from "./resource.files.js";
 export * from "./layers/index.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/resource/layers/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * zudojs-cli — Resource layer templates: DTO, repositories, service,
- * controller, routes and test.
+ * zudojs-cli — Resource layer templates: DTO, repositories (in-memory and
+ * Prisma), service, and the HTTP layers (controller, routes, test).
  */
 export * from "./resourceData.template.js";
+export * from "./resourceMemory.template.js";
 export * from "./resourcePrisma.template.js";
 export * from "./resourceService.template.js";
-export * from "./resourceRoutes.template.js";
-//# sourceMappingURL=index.d.ts.map
+export * from "./resourceHttp/index.js";

package/dist/src/templates/resource/layers/index.js

@@ -1,9 +1,9 @@
 /**
- * zudojs-cli — Resource layer templates: DTO, repositories, service,
- * controller, routes and test.
+ * zudojs-cli — Resource layer templates: DTO, repositories (in-memory and
+ * Prisma), service, and the HTTP layers (controller, routes, test).
  */
 export * from "./resourceData.template.js";
+export * from "./resourceMemory.template.js";
 export * from "./resourcePrisma.template.js";
 export * from "./resourceService.template.js";
-export * from "./resourceRoutes.template.js";
-//# sourceMappingURL=index.js.map
+export * from "./resourceHttp/index.js";

package/dist/src/templates/resource/layers/resourceData.template.d.ts

@@ -1,9 +1,13 @@
 /**
- * zudojs-cli — A resource's DTO schemas and in-memory repository.
+ * zudojs-cli — A resource's DTO schemas: record, create/update bodies, path
+ * parameters, and the list query and page shape.
+ *
+ * List endpoints paginate with a cursor: `?limit=` (1–MAX_PAGE_SIZE,
+ * default DEFAULT_PAGE_SIZE) and `?cursor=<id of the last item seen>`. A
+ * page answers `{ items, nextCursor }`, `nextCursor` being `null` on the
+ * last page. They used to return every record at once — up to 10,000 from
+ * the in-memory store.
  */
 import { type ResourceNames } from "../resource.names.js";
 /** `dtos/<slug>.dto.ts`: @zudojs/schema schemas and their inferred types. */
 export declare function renderResourceDto(n: ResourceNames): string;
-/** `repositories/<slug>.repository.ts`: the contract and a memory store. */
-export declare function renderResourceRepository(n: ResourceNames): string;
-//# sourceMappingURL=resourceData.template.d.ts.map

package/dist/src/templates/resource/layers/resourceData.template.js

@@ -1,5 +1,12 @@
 /**
- * zudojs-cli — A resource's DTO schemas and in-memory repository.
+ * zudojs-cli — A resource's DTO schemas: record, create/update bodies, path
+ * parameters, and the list query and page shape.
+ *
+ * List endpoints paginate with a cursor: `?limit=` (1–MAX_PAGE_SIZE,
+ * default DEFAULT_PAGE_SIZE) and `?cursor=<id of the last item seen>`. A
+ * page answers `{ items, nextCursor }`, `nextCursor` being `null` on the
+ * last page. They used to return every record at once — up to 10,000 from
+ * the in-memory store.
  */
 import { withArticle } from "../resource.names.js";
 /** `dtos/<slug>.dto.ts`: @zudojs/schema schemas and their inferred types. */
@@ -29,81 +36,32 @@ export const ${n.entity}ParamsSchema = schema.object({
   id: schema.string().uuid(),
 });
 
-export type ${n.entity} = Infer<typeof ${n.entity}Schema>;
-export type Create${n.entity}Input = Infer<typeof Create${n.entity}Schema>;
-export type Update${n.entity}Input = Infer<typeof Update${n.entity}Schema>;
-`;
-}
-/** `repositories/<slug>.repository.ts`: the contract and a memory store. */
-export function renderResourceRepository(n) {
-    const types = `Create${n.entity}Input, ${n.entity}, Update${n.entity}Input`;
-    return `import { randomUUID } from "node:crypto";
+/** Page size when \`limit\` is not given, and the most a client may ask for. */
+export const DEFAULT_PAGE_SIZE = 50;
+export const MAX_PAGE_SIZE = 200;
 
-import { ConflictError } from "@zudojs/errors";
+/** Query of \`GET ${n.routePath}\`: page size and the id to continue after. */
+export const List${n.pascal}QuerySchema = schema.object({
+  limit: schema.coerce.number().int().min(1).max(MAX_PAGE_SIZE).optional(),
+  cursor: schema.string().uuid().optional(),
+});
 
-import type { ${types} } from "../dtos/${n.slug}.dto.js";
+/** One page of ${n.label} records; \`nextCursor\` is null on the last page. */
+export const ${n.entity}PageSchema = schema.object({
+  items: schema.array(${n.entity}Schema),
+  nextCursor: schema.nullable(schema.string().uuid()),
+});
 
-/** Storage contract for ${n.label} records; the service depends on this only. */
-export interface ${n.pascal}Repository {
-  findAll(): Promise<readonly ${n.entity}[]>;
-  findById(id: string): Promise<${n.entity} | undefined>;
-  create(input: Create${n.entity}Input): Promise<${n.entity}>;
-  update(id: string, input: Update${n.entity}Input): Promise<${n.entity} | undefined>;
-  delete(id: string): Promise<boolean>;
+/** What a repository is asked for: a page size and where to continue. */
+export interface ${n.entity}PageRequest {
+  readonly limit: number;
+  readonly cursor?: string;
 }
 
-/** Most records the in-memory store keeps, so it cannot exhaust memory. */
-const MAX_RECORDS = 10_000;
-
-/**
- * Keeps ${n.label} records in process memory: for development and tests.
- * Data is lost on restart. Swap the implementation in container.ts.
- */
-export class InMemory${n.pascal}Repository implements ${n.pascal}Repository {
-  private readonly records = new Map<string, ${n.entity}>();
-
-  public async findAll(): Promise<readonly ${n.entity}[]> {
-    return [...this.records.values()];
-  }
-
-  public async findById(id: string): Promise<${n.entity} | undefined> {
-    return this.records.get(id);
-  }
-
-  public async create(input: Create${n.entity}Input): Promise<${n.entity}> {
-    if (this.records.size >= MAX_RECORDS) {
-      throw new ConflictError("The in-memory ${n.label} store is full.");
-    }
-    const now = new Date().toISOString();
-    const record: ${n.entity} = {
-      id: randomUUID(),
-      name: input.name,
-      createdAt: now,
-      updatedAt: now,
-    };
-    this.records.set(record.id, record);
-    return record;
-  }
-
-  public async update(
-    id: string,
-    input: Update${n.entity}Input,
-  ): Promise<${n.entity} | undefined> {
-    const existing = this.records.get(id);
-    if (existing === undefined) return undefined;
-    const updated: ${n.entity} = {
-      ...existing,
-      name: input.name ?? existing.name,
-      updatedAt: new Date().toISOString(),
-    };
-    this.records.set(id, updated);
-    return updated;
-  }
-
-  public async delete(id: string): Promise<boolean> {
-    return this.records.delete(id);
-  }
-}
+export type ${n.entity} = Infer<typeof ${n.entity}Schema>;
+export type Create${n.entity}Input = Infer<typeof Create${n.entity}Schema>;
+export type Update${n.entity}Input = Infer<typeof Update${n.entity}Schema>;
+export type List${n.pascal}Query = Infer<typeof List${n.pascal}QuerySchema>;
+export type ${n.entity}Page = Infer<typeof ${n.entity}PageSchema>;
 `;
 }
-//# sourceMappingURL=resourceData.template.js.map

package/dist/src/templates/resource/layers/resourceHttp/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * zudojs-cli — HTTP layers of a resource: controller, routes and test.
+ */
+export * from "./resourceController.template.js";
+export * from "./resourceRoutes.template.js";
+export * from "./resourceTest.template.js";

package/dist/src/templates/resource/layers/resourceHttp/index.js

@@ -0,0 +1,6 @@
+/**
+ * zudojs-cli — HTTP layers of a resource: controller, routes and test.
+ */
+export * from "./resourceController.template.js";
+export * from "./resourceRoutes.template.js";
+export * from "./resourceTest.template.js";

package/dist/src/templates/resource/layers/resourceHttp/resourceController.template.d.ts

@@ -0,0 +1,10 @@
+/**
+ * zudojs-cli — A resource's controller.
+ */
+import type { ResourceNames } from "../../resource.names.js";
+/**
+ * `controllers/<slug>.controller.ts`: validates input with the DTO schemas
+ * and maps service results to responses. Handlers are arrow properties so
+ * they can be passed to the router unbound.
+ */
+export declare function renderResourceController(n: ResourceNames, appSrcFromControllers: string): string;