@blixis-io/openapi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Voeten
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# `@blixis-io/openapi`
+
+Generates an OpenAPI 3.1 document from a running app's real controllers. Built on `@blixis-io/http`'s decorator metadata; no serving mechanism or bundled UI of its own.
+
+```bash
+npm install @blixis-io/openapi @blixis-io/http @blixis-io/di zod
+```
+
+```ts
+import { generateOpenApiDocument } from "@blixis-io/openapi";
+
+const app = await createHttpApplication(AppModule);
+
+const doc = generateOpenApiDocument(app, {
+  title: "my-api",
+  version: "1.0.0",
+});
+```
+
+Reads the same `@Controller`/`@Get`/`@Body`/`@Query`/`@Param`/`@Returns` metadata the router itself already uses — no separate annotation system to keep in sync. `generateOpenApiDocument` only needs `{ controllers: readonly Class[] }`, so it's cheap to unit test without booting a real app.
+
+Part of [Blixis Framework](https://github.com/blixis-io/framework) — full docs: [API Documentation](https://blixis-io.github.io/framework/concepts/api-documentation/) · [API reference](https://blixis-io.github.io/framework/reference/blixis-openapi/).

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { Class } from "@blixis-io/di";
+//#region src/generate.d.ts
+/** The one thing `generateOpenApiDocument` needs — a real `HttpApplication` satisfies this structurally, no import of the class itself required. */
+interface ControllerSource {
+  readonly controllers: readonly Class[];
+}
+type JsonSchema = Record<string, unknown>;
+interface OpenApiParameter {
+  name: string;
+  in: "path" | "query" | "header";
+  required: boolean;
+  schema: JsonSchema;
+}
+interface OpenApiResponse {
+  description: string;
+  content?: {
+    "application/json": {
+      schema: JsonSchema;
+    };
+  };
+}
+interface OpenApiOperation {
+  operationId: string;
+  summary?: string;
+  description?: string;
+  tags?: string[];
+  parameters?: OpenApiParameter[];
+  requestBody?: {
+    required: boolean;
+    content: {
+      "application/json": {
+        schema: JsonSchema;
+      };
+    };
+  };
+  responses: Record<string, OpenApiResponse>;
+}
+interface OpenApiDocument {
+  openapi: "3.1.0";
+  info: {
+    title: string;
+    version: string;
+    description?: string;
+  };
+  paths: Record<string, Record<string, OpenApiOperation>>;
+  components: {
+    schemas: {
+      Problem: JsonSchema;
+    };
+  };
+}
+interface OpenApiDocumentOptions {
+  title: string;
+  version: string;
+  description?: string;
+}
+/**
+ * Builds an OpenAPI 3.1 document from `app`'s real controller list —
+ * walking the same public decorator-metadata readers `@blixis-io/http`'s own
+ * `buildRouter` uses internally, so the document always reflects the
+ * routes actually registered, not a separately-maintained description of
+ * them. Returns a plain object; mount it yourself (`@Get("openapi.json")
+ * spec() { return generateOpenApiDocument(...); }`) — no serving
+ * mechanism or bundled UI here.
+ */
+export declare function generateOpenApiDocument(app: ControllerSource, options: OpenApiDocumentOptions): OpenApiDocument;
+//#endregion
+export type { ControllerSource, JsonSchema, OpenApiDocument, OpenApiDocumentOptions, OpenApiOperation, OpenApiParameter, OpenApiResponse };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/generate.ts"],"mappings":";;;UAeiB;WACN,sBAAsB;;KAGrB,aAAa;UAER;EACf;EACA;EACA;EACA,QAAQ;;UAGO;EACf;EACA;IAAY;MAAsB,QAAQ;;;;UAG3B;EACf;EACA;EACA;EACA;EACA,aAAa;EACb;IAAgB;IAAmB;MAAW;QAAsB,QAAQ;;;;EAC5E,WAAW,eAAe;;UAGX;EACf;EACA;IAAQ;IAAe;IAAiB;;EACxC,OAAO,eAAe,eAAe;EACrC;IAAc;MAAW,SAAS;;;;UAGnB;EACf;EACA;EACA;;;;;;;;;;;wBA0Hc,wBAAwB,KAAK,kBAAkB,SAAS,yBAAyB"}

package/dist/index.js

@@ -0,0 +1,136 @@
+import { getApiOperation, getClassApiTags, getControllerPrefix, getHttpCode, getMethodApiTags, getParamSources, getReturnsSchema, getRoutes } from "@blixis-io/http";
+import { z } from "zod";
+//#region src/generate.ts
+const PROBLEM_SCHEMA = {
+	type: "object",
+	properties: {
+		type: { type: "string" },
+		title: { type: "string" },
+		status: { type: "integer" },
+		detail: { type: "string" }
+	},
+	required: [
+		"type",
+		"title",
+		"status",
+		"detail"
+	]
+};
+/** `z.toJSONSchema()`'s output, minus the top-level `$schema` key — OpenAPI Schema Objects don't carry that. */
+function toSchema(schema) {
+	const { $schema: _unused, ...rest } = z.toJSONSchema(schema);
+	return rest;
+}
+/**
+* Converts one route's path segments to an OpenAPI path template
+* (`:id` → `{id}`), or `undefined` if the route contains a `*` wildcard
+* segment — OpenAPI has no equivalent construct, so wildcard routes are
+* excluded from the generated document entirely.
+*/
+function buildOpenApiPath(prefix, routePath) {
+	const segments = `${prefix}/${routePath}`.split("/").filter((segment) => segment.length > 0);
+	if (segments.includes("*")) return;
+	return `/${segments.map((segment) => segment.startsWith(":") ? `{${segment.slice(1)}}` : segment).join("/")}`;
+}
+function buildParameters(prototype, propertyKey) {
+	const parameters = [];
+	let requestBody;
+	for (const source of getParamSources(prototype, propertyKey).values()) switch (source.kind) {
+		case "param":
+			parameters.push({
+				name: source.name,
+				in: "path",
+				required: true,
+				schema: source.schema ? toSchema(source.schema) : { type: "string" }
+			});
+			break;
+		case "query":
+			if (source.schema instanceof z.ZodObject) for (const [name, fieldSchema] of Object.entries(source.schema.shape)) parameters.push({
+				name,
+				in: "query",
+				required: !fieldSchema.isOptional(),
+				schema: toSchema(fieldSchema)
+			});
+			break;
+		case "headers":
+			if (source.name) parameters.push({
+				name: source.name,
+				in: "header",
+				required: false,
+				schema: { type: "string" }
+			});
+			break;
+		case "body": if (source.schema) requestBody = {
+			required: true,
+			content: { "application/json": { schema: toSchema(source.schema) } }
+		};
+	}
+	return {
+		parameters,
+		requestBody
+	};
+}
+function buildResponses(prototype, propertyKey) {
+	const status = String(getHttpCode(prototype, propertyKey) ?? 200);
+	const returnsSchema = getReturnsSchema(prototype, propertyKey);
+	return {
+		[status]: returnsSchema ? {
+			description: "Success",
+			content: { "application/json": { schema: toSchema(returnsSchema) } }
+		} : { description: "Success" },
+		default: {
+			description: "Error",
+			content: { "application/json": { schema: { $ref: "#/components/schemas/Problem" } } }
+		}
+	};
+}
+function buildOperation(controller, route) {
+	const prototype = controller.prototype;
+	const operation = getApiOperation(prototype, route.propertyKey);
+	const tags = [...getClassApiTags(controller), ...getMethodApiTags(prototype, route.propertyKey)];
+	const { parameters, requestBody } = buildParameters(prototype, route.propertyKey);
+	return {
+		operationId: operation?.operationId ?? `${controller.name}_${String(route.propertyKey)}`,
+		...operation?.summary ? { summary: operation.summary } : {},
+		...operation?.description ? { description: operation.description } : {},
+		...tags.length > 0 ? { tags } : {},
+		...parameters.length > 0 ? { parameters } : {},
+		...requestBody ? { requestBody } : {},
+		responses: buildResponses(prototype, route.propertyKey)
+	};
+}
+/**
+* Builds an OpenAPI 3.1 document from `app`'s real controller list —
+* walking the same public decorator-metadata readers `@blixis-io/http`'s own
+* `buildRouter` uses internally, so the document always reflects the
+* routes actually registered, not a separately-maintained description of
+* them. Returns a plain object; mount it yourself (`@Get("openapi.json")
+* spec() { return generateOpenApiDocument(...); }`) — no serving
+* mechanism or bundled UI here.
+*/
+function generateOpenApiDocument(app, options) {
+	const paths = {};
+	for (const controller of app.controllers) {
+		const prefix = getControllerPrefix(controller) ?? "";
+		for (const route of getRoutes(controller)) {
+			const path = buildOpenApiPath(prefix, route.path);
+			if (!path) continue;
+			paths[path] ??= {};
+			paths[path][route.method.toLowerCase()] = buildOperation(controller, route);
+		}
+	}
+	return {
+		openapi: "3.1.0",
+		info: {
+			title: options.title,
+			version: options.version,
+			...options.description ? { description: options.description } : {}
+		},
+		paths,
+		components: { schemas: { Problem: PROBLEM_SCHEMA } }
+	};
+}
+//#endregion
+export { generateOpenApiDocument };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/generate.ts"],"sourcesContent":["import type { Class } from \"@blixis-io/di\";\nimport {\n  getApiOperation,\n  getClassApiTags,\n  getControllerPrefix,\n  getHttpCode,\n  getMethodApiTags,\n  getParamSources,\n  getReturnsSchema,\n  getRoutes,\n  type RouteDefinition,\n} from \"@blixis-io/http\";\nimport { z, type ZodType } from \"zod\";\n\n/** The one thing `generateOpenApiDocument` needs — a real `HttpApplication` satisfies this structurally, no import of the class itself required. */\nexport interface ControllerSource {\n  readonly controllers: readonly Class[];\n}\n\nexport type JsonSchema = Record<string, unknown>;\n\nexport interface OpenApiParameter {\n  name: string;\n  in: \"path\" | \"query\" | \"header\";\n  required: boolean;\n  schema: JsonSchema;\n}\n\nexport interface OpenApiResponse {\n  description: string;\n  content?: { \"application/json\": { schema: JsonSchema } };\n}\n\nexport interface OpenApiOperation {\n  operationId: string;\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  parameters?: OpenApiParameter[];\n  requestBody?: { required: boolean; content: { \"application/json\": { schema: JsonSchema } } };\n  responses: Record<string, OpenApiResponse>;\n}\n\nexport interface OpenApiDocument {\n  openapi: \"3.1.0\";\n  info: { title: string; version: string; description?: string };\n  paths: Record<string, Record<string, OpenApiOperation>>;\n  components: { schemas: { Problem: JsonSchema } };\n}\n\nexport interface OpenApiDocumentOptions {\n  title: string;\n  version: string;\n  description?: string;\n}\n\nconst PROBLEM_SCHEMA: JsonSchema = {\n  type: \"object\",\n  properties: {\n    type: { type: \"string\" },\n    title: { type: \"string\" },\n    status: { type: \"integer\" },\n    detail: { type: \"string\" },\n  },\n  required: [\"type\", \"title\", \"status\", \"detail\"],\n};\n\n/** `z.toJSONSchema()`'s output, minus the top-level `$schema` key — OpenAPI Schema Objects don't carry that. */\nfunction toSchema(schema: ZodType): JsonSchema {\n  const { $schema: _unused, ...rest } = z.toJSONSchema(schema);\n  return rest;\n}\n\n/**\n * Converts one route's path segments to an OpenAPI path template\n * (`:id` → `{id}`), or `undefined` if the route contains a `*` wildcard\n * segment — OpenAPI has no equivalent construct, so wildcard routes are\n * excluded from the generated document entirely.\n */\nfunction buildOpenApiPath(prefix: string, routePath: string): string | undefined {\n  const segments = `${prefix}/${routePath}`.split(\"/\").filter((segment) => segment.length > 0);\n  if (segments.includes(\"*\")) {\n    return undefined;\n  }\n  const converted = segments.map((segment) => (segment.startsWith(\":\") ? `{${segment.slice(1)}}` : segment));\n  return `/${converted.join(\"/\")}`;\n}\n\nfunction buildParameters(prototype: object, propertyKey: string | symbol): {\n  parameters: OpenApiParameter[];\n  requestBody: OpenApiOperation[\"requestBody\"];\n} {\n  const parameters: OpenApiParameter[] = [];\n  let requestBody: OpenApiOperation[\"requestBody\"];\n\n  for (const source of getParamSources(prototype, propertyKey).values()) {\n    switch (source.kind) {\n      case \"param\":\n        parameters.push({\n          name: source.name,\n          in: \"path\",\n          required: true,\n          schema: source.schema ? toSchema(source.schema) : { type: \"string\" },\n        });\n        break;\n      case \"query\":\n        if (source.schema instanceof z.ZodObject) {\n          for (const [name, fieldSchema] of Object.entries(source.schema.shape)) {\n            parameters.push({\n              name,\n              in: \"query\",\n              required: !fieldSchema.isOptional(),\n              schema: toSchema(fieldSchema),\n            });\n          }\n        }\n        break;\n      case \"headers\":\n        if (source.name) {\n          parameters.push({ name: source.name, in: \"header\", required: false, schema: { type: \"string\" } });\n        }\n        break;\n      case \"body\":\n        if (source.schema) {\n          requestBody = { required: true, content: { \"application/json\": { schema: toSchema(source.schema) } } };\n        }\n        break;\n      // `req` (the raw Request) has nothing documentable — no case needed.\n    }\n  }\n\n  return { parameters, requestBody };\n}\n\nfunction buildResponses(prototype: object, propertyKey: string | symbol): Record<string, OpenApiResponse> {\n  const status = String(getHttpCode(prototype, propertyKey) ?? 200);\n  const returnsSchema = getReturnsSchema(prototype, propertyKey);\n\n  return {\n    [status]: returnsSchema\n      ? { description: \"Success\", content: { \"application/json\": { schema: toSchema(returnsSchema) } } }\n      : { description: \"Success\" },\n    default: {\n      description: \"Error\",\n      content: { \"application/json\": { schema: { $ref: \"#/components/schemas/Problem\" } } },\n    },\n  };\n}\n\nfunction buildOperation(controller: Class, route: RouteDefinition): OpenApiOperation {\n  const prototype = controller.prototype as object;\n  const operation = getApiOperation(prototype, route.propertyKey);\n  const tags = [...getClassApiTags(controller), ...getMethodApiTags(prototype, route.propertyKey)];\n  const { parameters, requestBody } = buildParameters(prototype, route.propertyKey);\n\n  return {\n    operationId: operation?.operationId ?? `${controller.name}_${String(route.propertyKey)}`,\n    ...(operation?.summary ? { summary: operation.summary } : {}),\n    ...(operation?.description ? { description: operation.description } : {}),\n    ...(tags.length > 0 ? { tags } : {}),\n    ...(parameters.length > 0 ? { parameters } : {}),\n    ...(requestBody ? { requestBody } : {}),\n    responses: buildResponses(prototype, route.propertyKey),\n  };\n}\n\n/**\n * Builds an OpenAPI 3.1 document from `app`'s real controller list —\n * walking the same public decorator-metadata readers `@blixis-io/http`'s own\n * `buildRouter` uses internally, so the document always reflects the\n * routes actually registered, not a separately-maintained description of\n * them. Returns a plain object; mount it yourself (`@Get(\"openapi.json\")\n * spec() { return generateOpenApiDocument(...); }`) — no serving\n * mechanism or bundled UI here.\n */\nexport function generateOpenApiDocument(app: ControllerSource, options: OpenApiDocumentOptions): OpenApiDocument {\n  const paths: OpenApiDocument[\"paths\"] = {};\n\n  for (const controller of app.controllers) {\n    const prefix = getControllerPrefix(controller) ?? \"\";\n\n    for (const route of getRoutes(controller)) {\n      const path = buildOpenApiPath(prefix, route.path);\n      if (!path) {\n        continue;\n      }\n\n      paths[path] ??= {};\n      paths[path][route.method.toLowerCase()] = buildOperation(controller, route);\n    }\n  }\n\n  return {\n    openapi: \"3.1.0\",\n    info: { title: options.title, version: options.version, ...(options.description ? { description: options.description } : {}) },\n    paths,\n    components: { schemas: { Problem: PROBLEM_SCHEMA } },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@blixis-io/openapi",
+  "version": "0.1.0",
+  "description": "Generates an OpenAPI 3.1 document from a running app's real controllers. Built on @blixis-io/http's decorator metadata; no serving mechanism or bundled UI of its own.",
+  "license": "MIT",
+  "author": "Michael Voeten <michael@voeten.online>",
+  "homepage": "https://blixis-io.github.io/framework/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blixis-io/framework.git",
+    "directory": "packages/openapi"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "keywords": [
+    "openapi",
+    "swagger",
+    "api-documentation",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "@blixis-io/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@blixis-io/di": "0.1.0",
+    "@blixis-io/http": "0.1.0",
+    "zod": "^4.6.5"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "build": "rolldown -c"
+  }
+}