@warlock.js/core 5.26.0 → 5.28.0

package/esm/resource/types.d.mts

@@ -60,18 +60,103 @@ type ResourceFieldBuilderDateOutputOptions = {
 } | "format" | "timestamp" | "humanTime" | "locale" | "iso";
 /**
  * Allowed value types in a response schema body.
- * - Cast type string for primitive fields (e.g. "string", "number")
+ * - Cast type string for primitive fields, with the same suffixes as resource schemas
+ *   (e.g. "string", "number?", "string[]", "date[]?")
  * - ResourceConstructor for a single nested resource object
  * - [ResourceConstructor] (tuple) for an array of a nested resource
+ * - A nested plain object of any of the above
  */
-type ResponseBodyValue = ResourceOutputValueCastType | ResourceConstructor | [ResourceConstructor];
+type ResponseBodyValue = ResourceCastType | ResourceConstructor | [ResourceConstructor] | {
+  [key: string]: ResponseBodyValue;
+};
 /**
  * Response schema for a controller — used for documentation / OpenAPI generation.
  * Keyed by HTTP status code, each entry declares the expected response body shape.
  */
 type ResponseSchema = { [statusCode in ResponseStatus]?: {
-  body: Record<string, ResponseBodyValue>;
+  body: {
+    [key: string]: ResponseBodyValue;
+  };
 } };
+/**
+ * Collapse `any` to `unknown` so an untyped resolver never leaks `any` into a resource output.
+ */
+type AnyToUnknown<T> = 0 extends 1 & T ? unknown : T;
+/**
+ * Output type of a single (suffix-free) cast.
+ *
+ * `date` is the DEFAULT date output of `ResourceFieldBuilder` (iso, format, timestamp and
+ * humanTime are on; timezone, locale and offset are off). A date field customised through a
+ * builder (`dateOptions()`) is a builder field and resolves to `unknown`.
+ */
+type BaseCastOutput<C extends string> = C extends "string" | "localized" | "url" | "uploadsUrl" | "storageUrl" ? string : C extends "number" | "float" | "int" ? number : C extends "boolean" ? boolean : C extends "object" ? Record<string, unknown> : C extends "array" ? unknown[] : C extends "date" ? {
+  iso: string;
+  format: string;
+  timestamp: number;
+  humanTime: string;
+} : unknown;
+/**
+ * Output type of a cast string, including its `[]`, `?` and `[]?` suffixes.
+ * `?` means "always present, value or null" (not an optional key).
+ *
+ * @example
+ * CastOutput<"number">    // number
+ * CastOutput<"string?">   // string | null
+ * CastOutput<"string[]">  // string[]
+ * CastOutput<"url[]?">    // string[] | null
+ */
+type CastOutput<C extends string> = C extends `${infer B}[]?` ? BaseCastOutput<B>[] | null : C extends `${infer B}[]` ? BaseCastOutput<B>[] : C extends `${infer B}?` ? BaseCastOutput<B> | null : BaseCastOutput<C>;
+/**
+ * Output type of one schema field.
+ *
+ * `Root` is the schema of the resource being defined, used to resolve `"self"` and `"self[]"`.
+ * Anything that cannot be inferred statically (builders) is `unknown`, never `any`.
+ */
+type FieldOutput<F, Root extends ResourceSchema = ResourceSchema> = F extends "self" ? ResourceOutputOf<Root, Root> : F extends "self[]" ? ResourceOutputOf<Root, Root>[] : F extends string ? CastOutput<F> : F extends readonly [string, infer C extends string] ? CastOutput<C> : F extends ResourceFieldBuilder ? unknown : F extends Lazy<infer R> ? FieldOutput<R, Root> : F extends {
+  readonly __type: "arrayOf";
+  readonly schema: infer Item extends ResourceSchema;
+} ? ResourceOutputOf<Item, Root>[] : F extends (new (...args: any[]) => {
+  toJSON(): infer O;
+}) ? AnyToUnknown<O> : F extends ((...args: any[]) => infer R) ? AnyToUnknown<R> : unknown;
+/**
+ * JSON output type inferred from a resource schema.
+ *
+ * @example
+ * type UserJson = ResourceOutputOf<{ id: "number"; name: "string?" }>;
+ * // { id: number; name: string | null }
+ */
+type ResourceOutputOf<S extends ResourceSchema, Root extends ResourceSchema = S> = { -readonly [K in keyof S]: FieldOutput<S[K], Root> };
+/**
+ * JSON output type of a resource class or of a resource instance.
+ *
+ * @example
+ * type UserJson = ResourceOutput<typeof UserResource>;
+ * type SameJson = ResourceOutput<InstanceType<typeof UserResource>>;
+ */
+type ResourceOutput<R> = R extends (new (...args: any[]) => {
+  toJSON(): infer O;
+}) ? O : R extends {
+  toJSON(): infer O;
+} ? O : never;
+/**
+ * Output type of one response schema body value, with the same rules as a resource schema:
+ * a cast string resolves through `CastOutput`, a resource through `ResourceOutput`,
+ * `[Resource]` to an array of it, and a nested object recurses.
+ *
+ * @example
+ * type Out = ResponseBodyOutput<{ user: typeof UserResource; token: "string"; tags: "string[]?" }>;
+ */
+type ResponseBodyOutput<B> = B extends string ? CastOutput<B> : B extends readonly [infer R] ? ResourceOutput<R>[] : B extends (new (...args: any[]) => unknown) ? ResourceOutput<B> : B extends object ? { -readonly [K in keyof B]: ResponseBodyOutput<B[K]> } : never;
+/**
+ * Output type of a whole response schema: the body output per declared status code.
+ *
+ * @example
+ * type LoginResponses = ResponseSchemaOutput<typeof loginSchema>;
+ * // { 200: { user: UserJson; token: string }; 400: { error: string } }
+ */
+type ResponseSchemaOutput<S extends ResponseSchema> = { -readonly [K in keyof S]-?: S[K] extends {
+  body: infer B;
+} ? ResponseBodyOutput<B> : never };
 //#endregion
-export { ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyValue, ResponseSchema };
+export { BaseCastOutput, CastOutput, FieldOutput, ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyOutput, ResponseBodyValue, ResponseSchema, ResponseSchemaOutput };
 //# sourceMappingURL=types.d.mts.map

package/esm/resource/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/resource/types.ts"],"mappings":";;;;;;KAKY,2BAAA;;;AAAZ;;;;AAAuC;AAsBvC;;KAAY,qBAAA;;AAAqB;AAQjC;;;;KAAY,gBAAA,GACR,2BAAA,MACG,2BAAA,UACA,2BAAA,SACA,2BAAA;AAAA,KAEK,mBAAA;EACV,MAAA;EACA,MAAA,EAAQ,MAAM,SAAS,mBAAA;AAAA;AAAA,KAGb,mBAAA,GACR,gBAAA,GACA,mBAAA,GACA,qBAAA,GACA,IAAA,CAAK,mBAAA,aACI,gBAAA,IACT,oBAAA,GACA,mBAAA,KACE,KAAA,OAAY,QAAA,EAAU,gBAAA;AAAA,KAEhB,cAAA,GAAiB,MAAM,SAAS,mBAAA;AAAA,KAEhC,qCAAA;EAnBL;;AAA2B;EAwB5B,MAAA;EAtByB;;;EA0BzB,SAAA;EAxBJ;;;EA4BI,SAAA;EA5BsC;AAG5C;;EA6BM,QAAA;EA5BF;;;EAgCE,MAAA;EA7BF;;;EAiCE,MAAA;EA7BsB;;;EAiCtB,GAAA;AAAA;;;;;;;KAcM,iBAAA,GACV,2BAAA,GAA8B,mBAAA,IAAuB,mBAAA;;;;AAhDX;KAsDhC,cAAA,oBACK,cAAA;EACb,IAAA,EAAM,MAAA,SAAe,iBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/resource/types.ts"],"mappings":"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"}

package/esm/router/index.d.mts

@@ -1,6 +1,6 @@
 import { normalizeRoutePath } from "./normalize-route-path.mjs";
 import { normalizeRequestPath } from "./normalize-request-path.mjs";
-import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, NamedApiRoute, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
+import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, NamedApiRoute, NamedApiRoutesOptions, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
 import { PositionalHandlerSuspect, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./positional-handler-diagnostics.mjs";
 import { matchesDerivedRouteName, routeNameMethodSuffix } from "./route-name-method-suffix.mjs";
 import { RouteRegistry } from "./route-registry.mjs";

package/esm/router/named-api-routes-with-responses.mjs

@@ -0,0 +1,59 @@
+import { router } from "./router.mjs";
+import { importAppModule } from "../loader/app-module-importer.mjs";
+import { buildResourceMap, createResourceTypeResolver, describeResponseSchemaTypes } from "./response-schema-types.mjs";
+import { pathToFileURL } from "node:url";
+
+//#region ../core/src/router/named-api-routes-with-responses.ts
+const RESOURCE_FILE_PATTERN = /(^|\/)src\/.*\.resource\.tsx?$/;
+function isResourceFile(file) {
+	return RESOURCE_FILE_PATTERN.test(file.relativePath.replace(/\\/g, "/"));
+}
+async function importResourceNamespaces(files, onWarn) {
+	const namespaces = [];
+	for (const file of files) try {
+		const namespace = await importAppModule(pathToFileURL(file.absolutePath).href);
+		namespaces.push({
+			file: file.absolutePath,
+			namespace
+		});
+	} catch (error) {
+		onWarn?.(`Could not import ${file.relativePath} to type API responses: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	return namespaces;
+}
+/**
+* Identity map from every resource class exported by a `*.resource.ts(x)` file under
+* `src/` to the module export it came from.
+*
+* The modules are imported through the same importer the routes used, so a resource class
+* found in a `responseSchema` is the very instance exported by its module. A module that
+* cannot be imported is reported once through `onWarn` and left out of the map.
+*/
+async function collectResourceExportMap(files, onWarn) {
+	return buildResourceMap(await importResourceNamespaces([...files].filter(isResourceFile), onWarn));
+}
+/**
+* Named API route snapshots, with a `response` type map on every route whose handler
+* declares `responseSchema`.
+*
+* Resource modules are imported only when at least one route declares a schema, through
+* the same importer the routes used, so a resource class seen in a schema is the very
+* instance exported by its module. Never throws: if anything fails the routes come back
+* without `response` (and the failure is reported once through `onWarn`).
+*/
+async function collectNamedApiRoutesWithResponses(options) {
+	try {
+		if (!router.list().some((route) => route.handler?.responseSchema)) return router.getNamedApiRoutes();
+		const resolveResource = createResourceTypeResolver(await collectResourceExportMap(options.files, options.onWarn), options.appRoot);
+		return router.getNamedApiRoutes({ resolveResponse: (schema, route) => describeResponseSchemaTypes(schema, resolveResource, (fieldPath) => {
+			options.onWarn?.(`Route "${route.name}" (${route.method} ${route.path}): response ${fieldPath} is a resource that is not exported from a *.resource.ts file, typed as unknown.`);
+		}) });
+	} catch (error) {
+		options.onWarn?.(`Could not type API responses: ${error instanceof Error ? error.message : String(error)}`);
+		return router.getNamedApiRoutes();
+	}
+}
+
+//#endregion
+export { collectNamedApiRoutesWithResponses, collectResourceExportMap };
+//# sourceMappingURL=named-api-routes-with-responses.mjs.map

package/esm/router/named-api-routes-with-responses.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-api-routes-with-responses.mjs","names":[],"sources":["../../../../../../../core/src/router/named-api-routes-with-responses.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport { importAppModule } from \"../loader/app-module-importer\";\nimport {\n  buildResourceMap,\n  createResourceTypeResolver,\n  describeResponseSchemaTypes,\n  type ResourceModuleExport,\n  type ResourceModuleNamespace,\n  type ResourceTypeResolver,\n} from \"./response-schema-types\";\nimport { router } from \"./router\";\nimport type { NamedApiRoute } from \"./types\";\n\nconst RESOURCE_FILE_PATTERN = /(^|\\/)src\\/.*\\.resource\\.tsx?$/;\n\nexport type ResourceSourceFile = Readonly<{\n  absolutePath: string;\n  relativePath: string;\n}>;\n\nexport type NamedApiRoutesWithResponsesOptions = Readonly<{\n  /**\n   * Application root, the folder that contains `.warlock/typings/`.\n   */\n  appRoot: string;\n  /**\n   * Every file the orchestrator knows about. `*.resource.ts(x)` files under `src/` are\n   * imported to map resource classes back to their exports.\n   */\n  files: Iterable<ResourceSourceFile>;\n  /**\n   * Receives a human readable warning (unmapped resource, unreadable resource module).\n   */\n  onWarn?: (message: string) => void;\n}>;\n\nfunction isResourceFile(file: ResourceSourceFile): boolean {\n  return RESOURCE_FILE_PATTERN.test(file.relativePath.replace(/\\\\/g, \"/\"));\n}\n\nasync function importResourceNamespaces(\n  files: readonly ResourceSourceFile[],\n  onWarn: ((message: string) => void) | undefined,\n): Promise<ResourceModuleNamespace[]> {\n  const namespaces: ResourceModuleNamespace[] = [];\n\n  for (const file of files) {\n    try {\n      const namespace = (await importAppModule(pathToFileURL(file.absolutePath).href)) as Record<\n        string,\n        unknown\n      >;\n\n      namespaces.push({ file: file.absolutePath, namespace });\n    } catch (error) {\n      onWarn?.(\n        `Could not import ${file.relativePath} to type API responses: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n      );\n    }\n  }\n\n  return namespaces;\n}\n\n/**\n * Identity map from every resource class exported by a `*.resource.ts(x)` file under\n * `src/` to the module export it came from.\n *\n * The modules are imported through the same importer the routes used, so a resource class\n * found in a `responseSchema` is the very instance exported by its module. A module that\n * cannot be imported is reported once through `onWarn` and left out of the map.\n */\nexport async function collectResourceExportMap(\n  files: Iterable<ResourceSourceFile>,\n  onWarn?: (message: string) => void,\n): Promise<Map<unknown, ResourceModuleExport>> {\n  const namespaces = await importResourceNamespaces([...files].filter(isResourceFile), onWarn);\n\n  return buildResourceMap(namespaces);\n}\n\n/**\n * Named API route snapshots, with a `response` type map on every route whose handler\n * declares `responseSchema`.\n *\n * Resource modules are imported only when at least one route declares a schema, through\n * the same importer the routes used, so a resource class seen in a schema is the very\n * instance exported by its module. Never throws: if anything fails the routes come back\n * without `response` (and the failure is reported once through `onWarn`).\n */\nexport async function collectNamedApiRoutesWithResponses(\n  options: NamedApiRoutesWithResponsesOptions,\n): Promise<readonly NamedApiRoute[]> {\n  try {\n    const declaresSchema = router.list().some((route) => route.handler?.responseSchema);\n\n    if (!declaresSchema) return router.getNamedApiRoutes();\n\n    const resolveResource: ResourceTypeResolver = createResourceTypeResolver(\n      await collectResourceExportMap(options.files, options.onWarn),\n      options.appRoot,\n    );\n\n    return router.getNamedApiRoutes({\n      resolveResponse: (schema, route) =>\n        describeResponseSchemaTypes(schema, resolveResource, (fieldPath) => {\n          options.onWarn?.(\n            `Route \"${route.name}\" (${route.method} ${route.path}): response ${fieldPath} is a resource that is not exported from a *.resource.ts file, typed as unknown.`,\n          );\n        }),\n    });\n  } catch (error) {\n    options.onWarn?.(\n      `Could not type API responses: ${error instanceof Error ? error.message : String(error)}`,\n    );\n\n    return router.getNamedApiRoutes();\n  }\n}\n"],"mappings":";;;;;;AAaA,MAAM,wBAAwB;AAuB9B,SAAS,eAAe,MAAmC;CACzD,OAAO,sBAAsB,KAAK,KAAK,aAAa,QAAQ,OAAO,GAAG,CAAC;AACzE;AAEA,eAAe,yBACb,OACA,QACoC;CACpC,MAAM,aAAwC,CAAC;CAE/C,KAAK,MAAM,QAAQ,OACjB,IAAI;EACF,MAAM,YAAa,MAAM,gBAAgB,cAAc,KAAK,YAAY,CAAC,CAAC,IAAI;EAK9E,WAAW,KAAK;GAAE,MAAM,KAAK;GAAc;EAAU,CAAC;CACxD,SAAS,OAAO;EACd,SACE,oBAAoB,KAAK,aAAa,0BACpC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAEzD;CACF;CAGF,OAAO;AACT;;;;;;;;;AAUA,eAAsB,yBACpB,OACA,QAC6C;CAG7C,OAAO,iBAAiB,MAFC,yBAAyB,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,cAAc,GAAG,MAAM,CAEzD;AACpC;;;;;;;;;;AAWA,eAAsB,mCACpB,SACmC;CACnC,IAAI;EAGF,IAAI,CAFmB,OAAO,KAAK,CAAC,CAAC,MAAM,UAAU,MAAM,SAAS,cAElD,GAAG,OAAO,OAAO,kBAAkB;EAErD,MAAM,kBAAwC,2BAC5C,MAAM,yBAAyB,QAAQ,OAAO,QAAQ,MAAM,GAC5D,QAAQ,OACV;EAEA,OAAO,OAAO,kBAAkB,EAC9B,kBAAkB,QAAQ,UACxB,4BAA4B,QAAQ,kBAAkB,cAAc;GAClE,QAAQ,SACN,UAAU,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,MAAM,KAAK,cAAc,UAAU,iFAC/E;EACF,CAAC,EACL,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,SACN,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACxF;EAEA,OAAO,OAAO,kBAAkB;CAClC;AACF"}

package/esm/router/response-schema-types.mjs

@@ -0,0 +1,100 @@
+import { posix, relative, sep } from "node:path";
+
+//#region ../core/src/router/response-schema-types.ts
+const CORE_PACKAGE = "@warlock.js/core";
+function isIndexFile(file) {
+	return /(^|[\\/])index\.[cm]?[jt]sx?$/.test(file);
+}
+/**
+* Build an identity map from every function export (resource classes) to the module
+* export it came from.
+*
+* When the same value is exported more than once (a barrel re-export, or a default next
+* to a named export) the most specific location wins: a non-`index.*` file beats an
+* `index.*` file, then a named export beats `default`, then the first one seen.
+*/
+function buildResourceMap(namespaces) {
+	const map = /* @__PURE__ */ new Map();
+	const rank = (location) => (isIndexFile(location.file) ? 2 : 0) + (location.exportName === "default" ? 1 : 0);
+	for (const { file, namespace } of namespaces) for (const [exportName, value] of Object.entries(namespace)) {
+		if (typeof value !== "function") continue;
+		const candidate = {
+			file,
+			exportName
+		};
+		const existing = map.get(value);
+		if (!existing || rank(candidate) < rank(existing)) map.set(value, candidate);
+	}
+	return map;
+}
+/**
+* Turn a resource map into a resolver whose import paths are relative to
+* `<appRoot>/.warlock/typings/`, the folder the generated declarations live in.
+*/
+function createResourceTypeResolver(map, appRoot) {
+	const typingsDirectory = `${appRoot}${sep}.warlock${sep}typings`;
+	return (value) => {
+		const location = map.get(value);
+		if (!location) return void 0;
+		let importPath = relative(typingsDirectory, location.file).split(sep).join(posix.sep).replace(/\.[cm]?[jt]sx?$/, "");
+		if (!importPath.startsWith(".")) importPath = `./${importPath}`;
+		return {
+			importPath,
+			exportName: location.exportName
+		};
+	};
+}
+function describeCast(cast) {
+	return `import(${JSON.stringify(CORE_PACKAGE)}).CastOutput<${JSON.stringify(cast)}>`;
+}
+function describeResource(reference) {
+	return `import(${JSON.stringify(CORE_PACKAGE)}).ResourceOutput<typeof import(${JSON.stringify(reference.importPath)})[${JSON.stringify(reference.exportName)}]>`;
+}
+function describeBodyValue(value, path, resolveResource, onUnmapped) {
+	if (typeof value === "string") return describeCast(value);
+	if (typeof value === "function") {
+		const reference = resolveResource(value);
+		if (!reference) {
+			onUnmapped?.(path);
+			return "unknown";
+		}
+		return describeResource(reference);
+	}
+	if (Array.isArray(value)) return `(${describeBodyValue(value[0], path, resolveResource, onUnmapped)})[]`;
+	if (typeof value === "object" && value !== null) {
+		const members = Object.entries(value).map(([key, member]) => `${JSON.stringify(key)}: ${describeBodyValue(member, `${path}.${key}`, resolveResource, onUnmapped)}`);
+		return members.length === 0 ? "{}" : `{ ${members.join("; ")} }`;
+	}
+	return "unknown";
+}
+/**
+* Serialize a route's `responseSchema` into TypeScript type expressions, one per status code.
+*
+* The expressions are self-contained: they reference only `CastOutput` and `ResourceOutput`
+* from `@warlock.js/core`, `typeof import(...)` of resource modules, object literal types
+* and arrays. A resource that `resolveResource` cannot map becomes `unknown` and is
+* reported through `onUnmapped`.
+*
+* Both the typings child process and the dev server call this, so their output matches.
+*
+* @returns `undefined` when the schema declares no status code.
+*
+* @example
+* describeResponseSchemaTypes({ 400: { body: { error: "string" } } }, resolve);
+* // { "400": '{ "error": import("@warlock.js/core").CastOutput<"string"> }' }
+*/
+function describeResponseSchemaTypes(schema, resolveResource, onUnmapped) {
+	if (typeof schema !== "object" || schema === null) return void 0;
+	const described = {};
+	for (const [status, entry] of Object.entries(schema)) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const body = entry.body;
+		if (typeof body !== "object" || body === null) continue;
+		described[status] = describeBodyValue(body, `${status}.body`, resolveResource, onUnmapped);
+	}
+	return Object.keys(described).length === 0 ? void 0 : described;
+}
+
+//#endregion
+export { buildResourceMap, createResourceTypeResolver, describeResponseSchemaTypes };
+//# sourceMappingURL=response-schema-types.mjs.map

package/esm/router/response-schema-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-schema-types.mjs","names":[],"sources":["../../../../../../../core/src/router/response-schema-types.ts"],"sourcesContent":["import { posix, relative, sep } from \"node:path\";\n\n/**\n * Where a resource class lives: the module it is exported from and the export name.\n */\nexport type ResourceModuleExport = Readonly<{\n  file: string;\n  exportName: string;\n}>;\n\n/**\n * Import location of a resource as it is written in a generated declaration file.\n * `importPath` has no extension and starts with `./` or `../`.\n */\nexport type ResourceTypeReference = Readonly<{\n  importPath: string;\n  exportName: string;\n}>;\n\n/**\n * Maps a response-schema resource value back to where it is exported from.\n * Returns `undefined` when the value is not a known resource export.\n */\nexport type ResourceTypeResolver = (value: unknown) => ResourceTypeReference | undefined;\n\n/**\n * A loaded module namespace together with the file it was imported from.\n */\nexport type ResourceModuleNamespace = Readonly<{\n  file: string;\n  namespace: Record<string, unknown>;\n}>;\n\n/**\n * Called with the dotted path of every field that could not be mapped\n * (for example `200.body.user`).\n */\nexport type UnmappedResourceHandler = (fieldPath: string) => void;\n\nconst CORE_PACKAGE = \"@warlock.js/core\";\n\nfunction isIndexFile(file: string): boolean {\n  return /(^|[\\\\/])index\\.[cm]?[jt]sx?$/.test(file);\n}\n\n/**\n * Build an identity map from every function export (resource classes) to the module\n * export it came from.\n *\n * When the same value is exported more than once (a barrel re-export, or a default next\n * to a named export) the most specific location wins: a non-`index.*` file beats an\n * `index.*` file, then a named export beats `default`, then the first one seen.\n */\nexport function buildResourceMap(\n  namespaces: readonly ResourceModuleNamespace[],\n): Map<unknown, ResourceModuleExport> {\n  const map = new Map<unknown, ResourceModuleExport>();\n\n  const rank = (location: ResourceModuleExport): number =>\n    (isIndexFile(location.file) ? 2 : 0) + (location.exportName === \"default\" ? 1 : 0);\n\n  for (const { file, namespace } of namespaces) {\n    for (const [exportName, value] of Object.entries(namespace)) {\n      if (typeof value !== \"function\") continue;\n\n      const candidate: ResourceModuleExport = { file, exportName };\n      const existing = map.get(value);\n\n      if (!existing || rank(candidate) < rank(existing)) {\n        map.set(value, candidate);\n      }\n    }\n  }\n\n  return map;\n}\n\n/**\n * Turn a resource map into a resolver whose import paths are relative to\n * `<appRoot>/.warlock/typings/`, the folder the generated declarations live in.\n */\nexport function createResourceTypeResolver(\n  map: ReadonlyMap<unknown, ResourceModuleExport>,\n  appRoot: string,\n): ResourceTypeResolver {\n  const typingsDirectory = `${appRoot}${sep}.warlock${sep}typings`;\n\n  return (value) => {\n    const location = map.get(value);\n\n    if (!location) return undefined;\n\n    let importPath = relative(typingsDirectory, location.file)\n      .split(sep)\n      .join(posix.sep)\n      .replace(/\\.[cm]?[jt]sx?$/, \"\");\n\n    if (!importPath.startsWith(\".\")) {\n      importPath = `./${importPath}`;\n    }\n\n    return { importPath, exportName: location.exportName };\n  };\n}\n\nfunction describeCast(cast: string): string {\n  return `import(${JSON.stringify(CORE_PACKAGE)}).CastOutput<${JSON.stringify(cast)}>`;\n}\n\nfunction describeResource(reference: ResourceTypeReference): string {\n  return (\n    `import(${JSON.stringify(CORE_PACKAGE)}).ResourceOutput<` +\n    `typeof import(${JSON.stringify(reference.importPath)})[${JSON.stringify(reference.exportName)}]>`\n  );\n}\n\nfunction describeBodyValue(\n  value: unknown,\n  path: string,\n  resolveResource: ResourceTypeResolver,\n  onUnmapped: UnmappedResourceHandler | undefined,\n): string {\n  if (typeof value === \"string\") {\n    return describeCast(value);\n  }\n\n  if (typeof value === \"function\") {\n    const reference = resolveResource(value);\n\n    if (!reference) {\n      onUnmapped?.(path);\n      return \"unknown\";\n    }\n\n    return describeResource(reference);\n  }\n\n  if (Array.isArray(value)) {\n    return `(${describeBodyValue(value[0], path, resolveResource, onUnmapped)})[]`;\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    const members = Object.entries(value).map(\n      ([key, member]) =>\n        `${JSON.stringify(key)}: ${describeBodyValue(member, `${path}.${key}`, resolveResource, onUnmapped)}`,\n    );\n\n    return members.length === 0 ? \"{}\" : `{ ${members.join(\"; \")} }`;\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Serialize a route's `responseSchema` into TypeScript type expressions, one per status code.\n *\n * The expressions are self-contained: they reference only `CastOutput` and `ResourceOutput`\n * from `@warlock.js/core`, `typeof import(...)` of resource modules, object literal types\n * and arrays. A resource that `resolveResource` cannot map becomes `unknown` and is\n * reported through `onUnmapped`.\n *\n * Both the typings child process and the dev server call this, so their output matches.\n *\n * @returns `undefined` when the schema declares no status code.\n *\n * @example\n * describeResponseSchemaTypes({ 400: { body: { error: \"string\" } } }, resolve);\n * // { \"400\": '{ \"error\": import(\"@warlock.js/core\").CastOutput<\"string\"> }' }\n */\nexport function describeResponseSchemaTypes(\n  schema: unknown,\n  resolveResource: ResourceTypeResolver,\n  onUnmapped?: UnmappedResourceHandler,\n): Record<string, string> | undefined {\n  if (typeof schema !== \"object\" || schema === null) return undefined;\n\n  const described: Record<string, string> = {};\n\n  for (const [status, entry] of Object.entries(schema)) {\n    if (typeof entry !== \"object\" || entry === null) continue;\n\n    const body = (entry as { body?: unknown }).body;\n\n    if (typeof body !== \"object\" || body === null) continue;\n\n    described[status] = describeBodyValue(body, `${status}.body`, resolveResource, onUnmapped);\n  }\n\n  return Object.keys(described).length === 0 ? undefined : described;\n}\n"],"mappings":";;;AAuCA,MAAM,eAAe;AAErB,SAAS,YAAY,MAAuB;CAC1C,OAAO,gCAAgC,KAAK,IAAI;AAClD;;;;;;;;;AAUA,SAAgB,iBACd,YACoC;CACpC,MAAM,sBAAM,IAAI,IAAmC;CAEnD,MAAM,QAAQ,cACX,YAAY,SAAS,IAAI,IAAI,IAAI,MAAM,SAAS,eAAe,YAAY,IAAI;CAElF,KAAK,MAAM,EAAE,MAAM,eAAe,YAChC,KAAK,MAAM,CAAC,YAAY,UAAU,OAAO,QAAQ,SAAS,GAAG;EAC3D,IAAI,OAAO,UAAU,YAAY;EAEjC,MAAM,YAAkC;GAAE;GAAM;EAAW;EAC3D,MAAM,WAAW,IAAI,IAAI,KAAK;EAE9B,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,QAAQ,GAC9C,IAAI,IAAI,OAAO,SAAS;CAE5B;CAGF,OAAO;AACT;;;;;AAMA,SAAgB,2BACd,KACA,SACsB;CACtB,MAAM,mBAAmB,GAAG,UAAU,IAAI,UAAU,IAAI;CAExD,QAAQ,UAAU;EAChB,MAAM,WAAW,IAAI,IAAI,KAAK;EAE9B,IAAI,CAAC,UAAU,OAAO;EAEtB,IAAI,aAAa,SAAS,kBAAkB,SAAS,IAAI,CAAC,CACvD,MAAM,GAAG,CAAC,CACV,KAAK,MAAM,GAAG,CAAC,CACf,QAAQ,mBAAmB,EAAE;EAEhC,IAAI,CAAC,WAAW,WAAW,GAAG,GAC5B,aAAa,KAAK;EAGpB,OAAO;GAAE;GAAY,YAAY,SAAS;EAAW;CACvD;AACF;AAEA,SAAS,aAAa,MAAsB;CAC1C,OAAO,UAAU,KAAK,UAAU,YAAY,EAAE,eAAe,KAAK,UAAU,IAAI,EAAE;AACpF;AAEA,SAAS,iBAAiB,WAA0C;CAClE,OACE,UAAU,KAAK,UAAU,YAAY,EAAE,iCACtB,KAAK,UAAU,UAAU,UAAU,EAAE,IAAI,KAAK,UAAU,UAAU,UAAU,EAAE;AAEnG;AAEA,SAAS,kBACP,OACA,MACA,iBACA,YACQ;CACR,IAAI,OAAO,UAAU,UACnB,OAAO,aAAa,KAAK;CAG3B,IAAI,OAAO,UAAU,YAAY;EAC/B,MAAM,YAAY,gBAAgB,KAAK;EAEvC,IAAI,CAAC,WAAW;GACd,aAAa,IAAI;GACjB,OAAO;EACT;EAEA,OAAO,iBAAiB,SAAS;CACnC;CAEA,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,IAAI,kBAAkB,MAAM,IAAI,MAAM,iBAAiB,UAAU,EAAE;CAG5E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAC/C,MAAM,UAAU,OAAO,QAAQ,KAAK,CAAC,CAAC,KACnC,CAAC,KAAK,YACL,GAAG,KAAK,UAAU,GAAG,EAAE,IAAI,kBAAkB,QAAQ,GAAG,KAAK,GAAG,OAAO,iBAAiB,UAAU,GACtG;EAEA,OAAO,QAAQ,WAAW,IAAI,OAAO,KAAK,QAAQ,KAAK,IAAI,EAAE;CAC/D;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,SAAgB,4BACd,QACA,iBACA,YACoC;CACpC,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO;CAE1D,MAAM,YAAoC,CAAC;CAE3C,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,MAAM,GAAG;EACpD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAEjD,MAAM,OAAQ,MAA6B;EAE3C,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM;EAE/C,UAAU,UAAU,kBAAkB,MAAM,GAAG,OAAO,QAAQ,iBAAiB,UAAU;CAC3F;CAEA,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,WAAW,IAAI,SAAY;AAC3D"}

package/esm/router/router.d.mts

@@ -1,5 +1,5 @@
 import { FastifyInstance } from "../http/server.mjs";
-import { GroupedRoutesOptions, NamedApiRoute, RequestHandler, RequestHandlerType, ResourceMethod, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
+import { GroupedRoutesOptions, NamedApiRoute, NamedApiRoutesOptions, RequestHandler, RequestHandlerType, ResourceMethod, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
 import { RouteBuilder } from "./route-builder.mjs";
 import { FastifyHttpProxyOptions } from "@fastify/http-proxy";
 import { FastifyStaticOptions } from "@fastify/static";
@@ -197,7 +197,7 @@ declare class Router {
    * Names are the registered names, including method suffixes. `all` stays
    * intact as route metadata; consumers decide whether their use supports it.
    */
-  getNamedApiRoutes(): readonly NamedApiRoute[];
+  getNamedApiRoutes(options?: NamedApiRoutesOptions): readonly NamedApiRoute[];
   /**
    * Number of routes currently registered on the singleton.
    *

package/esm/router/router.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.mts","names":[],"sources":["../../../../../../../core/src/router/router.ts"],"mappings":"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"}
+{"version":3,"file":"router.d.mts","names":[],"sources":["../../../../../../../core/src/router/router.ts"],"mappings":"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"}

package/esm/router/router.mjs

@@ -50,6 +50,23 @@ async function runRouteHooks(route, phase, request, reply) {
 	for (const hook of hooks) if (await hook(request, reply) === reply) return reply;
 }
 /**
+* Bound functions do not inherit static properties, so the handler metadata that
+* documentation and typings read (`responseSchema`) is copied onto the bound copy.
+*/
+function copyResponseSchema(source, target) {
+	const responseSchema = source?.responseSchema;
+	if (responseSchema) target.responseSchema = responseSchema;
+}
+/**
+* Bind a restful resource method to its resource, keeping its `responseSchema`.
+*/
+function bindResourceHandler(resource, method) {
+	const source = resource[method];
+	const handler = source?.bind(resource);
+	copyResponseSchema(source, handler);
+	return handler;
+}
+/**
 * Describe one claimant of a route name, for the duplicate-name error.
 *
 * `warlock dev` registers SSR page routes on the same router as API routes, so
@@ -180,6 +197,7 @@ var Router = class Router {
 			const [controller, action] = handler;
 			if (typeof controller[action] !== "function") throw new Error(`Invalid controller action "${action}" for controller "${controller.constructor.name}"`);
 			handler = controller[action].bind(controller);
+			copyResponseSchema(controller[action], handler);
 			if (!handler.validation) {
 				handler.validation = {};
 				if (controller[`${action}ValidationSchema`]) handler.validation.schema = controller[`${action}ValidationSchema`]();
@@ -284,12 +302,12 @@ var Router = class Router {
 			const isAcceptableResource = (type) => {
 				return Boolean((!options.except || !options.except.includes(type)) && (!options.only || options.only.includes(type)));
 			};
-			if (routeResource.list && isAcceptableResource("list")) this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {
+			if (routeResource.list && isAcceptableResource("list")) this.get(path, options.replace?.list || bindResourceHandler(routeResource, "list"), {
 				...options,
 				name: "list",
 				restful: true
 			});
-			if (routeResource.get && isAcceptableResource("get")) this.get("/:id", options.replace?.get || routeResource.get.bind(routeResource), {
+			if (routeResource.get && isAcceptableResource("get")) this.get("/:id", options.replace?.get || bindResourceHandler(routeResource, "get"), {
 				...options,
 				name: "single",
 				restful: true
@@ -318,12 +336,12 @@ var Router = class Router {
 					restful: true
 				});
 			}
-			if (routeResource.delete && isAcceptableResource("delete")) this.delete("/:id", options.replace?.delete || routeResource.delete.bind(routeResource), {
+			if (routeResource.delete && isAcceptableResource("delete")) this.delete("/:id", options.replace?.delete || bindResourceHandler(routeResource, "delete"), {
 				...options,
 				name: "delete",
 				restful: true
 			});
-			if (routeResource.bulkDelete && isAcceptableResource("delete")) this.delete(path, options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource), {
+			if (routeResource.bulkDelete && isAcceptableResource("delete")) this.delete(path, options.replace?.bulkDelete || bindResourceHandler(routeResource, "bulkDelete"), {
 				...options,
 				name: "bulkDelete",
 				restful: true
@@ -444,7 +462,7 @@ var Router = class Router {
 	* Manage validation system for the given resource
 	*/
 	manageValidation(resource, method) {
-		const handler = resource[method]?.bind(resource);
+		const handler = bindResourceHandler(resource, method);
 		const methodValidation = resource?.validation?.[method];
 		if (method === "patch") {
 			handler.validation = methodValidation;
@@ -496,12 +514,21 @@ var Router = class Router {
 	* Names are the registered names, including method suffixes. `all` stays
 	* intact as route metadata; consumers decide whether their use supports it.
 	*/
-	getNamedApiRoutes() {
-		return Object.freeze(this.routes.filter((route) => !route.isPage && typeof route.name === "string" && route.name.length > 0).map((route) => Object.freeze({
-			name: route.name,
-			path: route.path,
-			method: route.method
-		})));
+	getNamedApiRoutes(options = {}) {
+		return Object.freeze(this.routes.filter((route) => !route.isPage && typeof route.name === "string" && route.name.length > 0).map((route) => {
+			const snapshot = {
+				name: route.name,
+				path: route.path,
+				method: route.method
+			};
+			const schema = route.handler?.responseSchema;
+			const response = schema ? options.resolveResponse?.(schema, route) : void 0;
+			if (!response || Object.keys(response).length === 0) return Object.freeze(snapshot);
+			return Object.freeze({
+				...snapshot,
+				response: Object.freeze({ ...response })
+			});
+		}));
 	}
 	/**
 	* Number of routes currently registered on the singleton.