@znight/openapi 0.0.0-stage → 0.1.1

package/dist/types-VzBexMKj.d.mts

@@ -0,0 +1,213 @@
+/**
+ * OpenAPI 3.1 types (our own, no `openapi-types` dependency). They describe the documents produced
+ * by `buildOpenApiDocument`: every object is read-only, optional fields are omitted when absent and
+ * `x-*` specification extensions are allowed where OpenAPI allows them.
+ *
+ * Schemas are JSON Schema 2020-12 ({@link JsonSchema}), the dialect of OpenAPI 3.1.
+ */
+/** A JSON value. */
+type JsonValue = string | number | boolean | null | readonly JsonValue[] | {
+  readonly [key: string]: JsonValue;
+};
+/** A JSON Schema 2020-12 object (keywords are not modelled one by one). */
+interface JsonSchema {
+  readonly [keyword: string]: JsonValue | undefined;
+}
+/** `x-*` fields. */
+interface SpecificationExtensions {
+  readonly [extension: `x-${string}`]: JsonValue | undefined;
+}
+/** `{ $ref }` to a component (`#/components/schemas/Book`). */
+interface ReferenceObject {
+  readonly $ref: string;
+  readonly summary?: string;
+  readonly description?: string;
+}
+interface ContactObject extends SpecificationExtensions {
+  readonly name?: string;
+  readonly url?: string;
+  readonly email?: string;
+}
+interface LicenseObject extends SpecificationExtensions {
+  readonly name: string;
+  /** SPDX expression (exclusive with `url`). */
+  readonly identifier?: string;
+  readonly url?: string;
+}
+interface InfoObject extends SpecificationExtensions {
+  readonly title: string;
+  readonly version: string;
+  readonly summary?: string;
+  readonly description?: string;
+  readonly termsOfService?: string;
+  readonly contact?: ContactObject;
+  readonly license?: LicenseObject;
+}
+interface ServerVariableObject extends SpecificationExtensions {
+  readonly enum?: readonly string[];
+  readonly default: string;
+  readonly description?: string;
+}
+interface ServerObject extends SpecificationExtensions {
+  readonly url: string;
+  readonly description?: string;
+  readonly variables?: Readonly<Record<string, ServerVariableObject>>;
+}
+interface ExternalDocumentationObject extends SpecificationExtensions {
+  readonly url: string;
+  readonly description?: string;
+}
+interface TagObject extends SpecificationExtensions {
+  readonly name: string;
+  readonly description?: string;
+  readonly externalDocs?: ExternalDocumentationObject;
+}
+/** Parameter locations. */
+type ParameterLocation = "path" | "query" | "header" | "cookie";
+interface ExampleObject extends SpecificationExtensions {
+  readonly summary?: string;
+  readonly description?: string;
+  readonly value?: JsonValue;
+  readonly externalValue?: string;
+}
+interface ParameterObjectOf<S> extends SpecificationExtensions {
+  readonly name: string;
+  readonly in: ParameterLocation;
+  readonly description?: string;
+  readonly required?: boolean;
+  readonly deprecated?: boolean;
+  readonly allowEmptyValue?: boolean;
+  readonly style?: string;
+  readonly explode?: boolean;
+  readonly schema?: S;
+  readonly example?: JsonValue;
+  readonly examples?: Readonly<Record<string, ExampleObject | ReferenceObject>>;
+}
+interface HeaderObjectOf<S> extends SpecificationExtensions {
+  readonly description?: string;
+  readonly required?: boolean;
+  readonly deprecated?: boolean;
+  readonly schema?: S;
+  readonly example?: JsonValue;
+}
+interface EncodingObjectOf<S> extends SpecificationExtensions {
+  readonly contentType?: string;
+  readonly headers?: Readonly<Record<string, HeaderObjectOf<S> | ReferenceObject>>;
+  readonly style?: string;
+  readonly explode?: boolean;
+}
+interface MediaTypeObjectOf<S> extends SpecificationExtensions {
+  readonly schema?: S;
+  readonly example?: JsonValue;
+  readonly examples?: Readonly<Record<string, ExampleObject | ReferenceObject>>;
+  readonly encoding?: Readonly<Record<string, EncodingObjectOf<S>>>;
+}
+interface RequestBodyObjectOf<S> extends SpecificationExtensions {
+  readonly description?: string;
+  readonly content: Readonly<Record<string, MediaTypeObjectOf<S>>>;
+  readonly required?: boolean;
+}
+interface ResponseObjectOf<S> extends SpecificationExtensions {
+  readonly description: string;
+  readonly headers?: Readonly<Record<string, HeaderObjectOf<S> | ReferenceObject>>;
+  readonly content?: Readonly<Record<string, MediaTypeObjectOf<S>>>;
+}
+/** `{ schemeName: scopes }`: every scheme of one requirement applies (AND). */
+interface SecurityRequirementObject {
+  readonly [scheme: string]: readonly string[];
+}
+/** An OpenAPI Operation Object whose schemas are `S` and whose parameters may also be `P`. */
+interface OperationObjectOf<S, P = never> extends SpecificationExtensions {
+  readonly tags?: readonly string[];
+  readonly summary?: string;
+  readonly description?: string;
+  readonly externalDocs?: ExternalDocumentationObject;
+  readonly operationId?: string;
+  readonly parameters?: readonly (ParameterObjectOf<S> | ReferenceObject | P)[];
+  readonly requestBody?: RequestBodyObjectOf<S> | ReferenceObject;
+  readonly responses?: Readonly<Record<string, ResponseObjectOf<S> | ReferenceObject>>;
+  readonly deprecated?: boolean;
+  readonly security?: readonly SecurityRequirementObject[];
+  readonly servers?: readonly ServerObject[];
+}
+type ParameterObject = ParameterObjectOf<JsonSchema>;
+type HeaderObject = HeaderObjectOf<JsonSchema>;
+type MediaTypeObject = MediaTypeObjectOf<JsonSchema>;
+type RequestBodyObject = RequestBodyObjectOf<JsonSchema>;
+type ResponseObject = ResponseObjectOf<JsonSchema>;
+type OperationObject = OperationObjectOf<JsonSchema>;
+/** HTTP methods of a path item, in OpenAPI order. */
+type OpenApiMethod = "get" | "put" | "post" | "delete" | "options" | "head" | "patch";
+interface PathItemObject extends SpecificationExtensions {
+  readonly summary?: string;
+  readonly description?: string;
+  readonly get?: OperationObject;
+  readonly put?: OperationObject;
+  readonly post?: OperationObject;
+  readonly delete?: OperationObject;
+  readonly options?: OperationObject;
+  readonly head?: OperationObject;
+  readonly patch?: OperationObject;
+  readonly trace?: OperationObject;
+  readonly servers?: readonly ServerObject[];
+  readonly parameters?: readonly (ParameterObject | ReferenceObject)[];
+}
+interface OAuthFlowObject extends SpecificationExtensions {
+  readonly authorizationUrl?: string;
+  readonly tokenUrl?: string;
+  readonly refreshUrl?: string;
+  readonly scopes: Readonly<Record<string, string>>;
+}
+interface OAuthFlowsObject extends SpecificationExtensions {
+  readonly implicit?: OAuthFlowObject;
+  readonly password?: OAuthFlowObject;
+  readonly clientCredentials?: OAuthFlowObject;
+  readonly authorizationCode?: OAuthFlowObject;
+}
+/** An OpenAPI Security Scheme Object. */
+type SecuritySchemeObject = ({
+  readonly type: "apiKey";
+  readonly name: string;
+  readonly in: "query" | "header" | "cookie";
+  readonly description?: string;
+} & SpecificationExtensions) | ({
+  readonly type: "http";
+  /** `bearer`, `basic`... (RFC 7235 scheme name). */
+  readonly scheme: string;
+  readonly bearerFormat?: string;
+  readonly description?: string;
+} & SpecificationExtensions) | ({
+  readonly type: "oauth2";
+  readonly flows: OAuthFlowsObject;
+  readonly description?: string;
+} & SpecificationExtensions) | ({
+  readonly type: "openIdConnect";
+  readonly openIdConnectUrl: string;
+  readonly description?: string;
+} & SpecificationExtensions) | ({
+  readonly type: "mutualTLS";
+  readonly description?: string;
+} & SpecificationExtensions);
+interface ComponentsObject extends SpecificationExtensions {
+  readonly schemas?: Readonly<Record<string, JsonSchema>>;
+  readonly responses?: Readonly<Record<string, ResponseObject | ReferenceObject>>;
+  readonly parameters?: Readonly<Record<string, ParameterObject | ReferenceObject>>;
+  readonly examples?: Readonly<Record<string, ExampleObject | ReferenceObject>>;
+  readonly requestBodies?: Readonly<Record<string, RequestBodyObject | ReferenceObject>>;
+  readonly headers?: Readonly<Record<string, HeaderObject | ReferenceObject>>;
+  readonly securitySchemes?: Readonly<Record<string, SecuritySchemeObject>>;
+}
+/** An OpenAPI 3.1 document. */
+interface OpenApiObject extends SpecificationExtensions {
+  readonly openapi: string;
+  readonly info: InfoObject;
+  readonly jsonSchemaDialect?: string;
+  readonly servers?: readonly ServerObject[];
+  readonly paths?: Readonly<Record<string, PathItemObject>>;
+  readonly components?: ComponentsObject;
+  readonly security?: readonly SecurityRequirementObject[];
+  readonly tags?: readonly TagObject[];
+  readonly externalDocs?: ExternalDocumentationObject;
+}
+export { SecuritySchemeObject as A, PathItemObject as C, ResponseObject as D, RequestBodyObjectOf as E, ServerVariableObject as M, SpecificationExtensions as N, ResponseObjectOf as O, TagObject as P, ParameterObjectOf as S, RequestBodyObject as T, OpenApiObject as _, ExternalDocumentationObject as a, ParameterLocation as b, InfoObject as c, LicenseObject as d, MediaTypeObject as f, OpenApiMethod as g, OAuthFlowsObject as h, ExampleObject as i, ServerObject as j, SecurityRequirementObject as k, JsonSchema as l, OAuthFlowObject as m, ContactObject as n, HeaderObject as o, MediaTypeObjectOf as p, EncodingObjectOf as r, HeaderObjectOf as s, ComponentsObject as t, JsonValue as u, OperationObject as v, ReferenceObject as w, ParameterObject as x, OperationObjectOf as y };
+//# sourceMappingURL=types-VzBexMKj.d.mts.map

package/dist/vite.d.mts

@@ -0,0 +1,24 @@
+import { r as EmitRuntime } from "./index-CqQ6IRnN.mjs";
+import { Plugin } from "vite";
+/** Name of the plugin (an application uses one instance: the first one wins). */
+export declare const OPENAPI_PLUGIN_NAME = "znight:openapi";
+/** Options of {@link openapi}. */
+export interface OpenApiVitePluginOptions {
+  /** Output files, relative to the Vite root (`.yaml` / `.yml` write YAML). Default: `<build.outDir>/openapi.json`. */
+  readonly output?: string | readonly string[];
+  /**
+   * CI: never write the outputs outside `build.outDir` (the committed files), fail the build when one
+   * is missing or stale. The outputs inside `build.outDir` are build artifacts, written by every
+   * build. Default `false`.
+   */
+  readonly check?: boolean;
+  /** HTTP prefix (`servers` default when `@OpenApiDocument` declares none). */
+  readonly prefix?: string;
+  /** Runtime loading the application modules. Default `'auto'`. */
+  readonly runtime?: EmitRuntime;
+  /** Module whose default export is a `SchemaConverter[]`, relative to the Vite root. */
+  readonly converters?: string;
+}
+/** The `openapi()` Vite plugin (build only). */
+export declare function openapi(options?: OpenApiVitePluginOptions): Plugin;
+//# sourceMappingURL=vite.d.mts.map

package/dist/vite.mjs

@@ -0,0 +1,64 @@
+import { isAbsolute, join, relative, resolve } from "node:path";
+// src/vite.ts
+/** Name of the plugin (an application uses one instance: the first one wins). */
+const OPENAPI_PLUGIN_NAME = "znight:openapi";
+/** The `openapi()` Vite plugin (build only). */
+function openapi(options = {}) {
+	let config;
+	let active = true;
+	let emitted = false;
+	const plugin = {
+		name: OPENAPI_PLUGIN_NAME,
+		apply: "build",
+		configResolved(resolved) {
+			config = resolved;
+			active = resolved.plugins.find((candidate) => candidate.name === OPENAPI_PLUGIN_NAME) === plugin;
+		},
+		buildStart() {
+			emitted = false;
+		},
+		async writeBundle() {
+			if (!active || emitted || config === void 0) return;
+			emitted = true;
+			const api = config.plugins.find((candidate) => candidate.name === "znight")?.api;
+			if (api?.result !== void 0 && api.result.ok === false) return;
+			const root = config.root;
+			const outputs = options.output === void 0 ? [join(resolve(root, config.build.outDir), "openapi.json")] : (typeof options.output === "string" ? [options.output] : options.output).map((file) => resolve(root, file));
+			const outDir = resolve(root, config.build.outDir);
+			const checked = options.check === true ? outputs.filter((file) => !isInside(outDir, file)) : [];
+			if (options.check === true && checked.length === 0) this.warn("[znight:openapi] check: every output is in build.outDir, written by each build: nothing is checked (add the committed file to output)");
+			const compilerRoot = api?.compiler?.options?.root;
+			const given = typeof api?.options === "object" && api.options !== null ? api.options : void 0;
+			const { emitOpenApi } = await import("./emit.mjs");
+			const result = await emitOpenApi({
+				root,
+				output: outputs,
+				...checked.length === 0 ? {} : { check: checked },
+				...options.prefix === void 0 ? {} : { prefix: options.prefix },
+				...options.runtime === void 0 ? {} : { runtime: options.runtime },
+				...options.converters === void 0 ? {} : { converters: options.converters },
+				...config.configFile === void 0 ? {} : { config: config.configFile },
+				...given === void 0 ? {} : { compilerOptions: {
+					...given,
+					root: typeof compilerRoot === "string" ? compilerRoot : resolve(root, String(given["root"] ?? "."))
+				} }
+			});
+			const show = (file) => {
+				const path = relative(root, file);
+				return path === "" || path.startsWith("..") || isAbsolute(path) ? file : path;
+			};
+			if (!result.ok) this.error(`[znight:openapi] the application does not compile: ${result.diagnostics.filter((d) => d.severity === "error").length} error(s)`);
+			for (const warning of result.warnings) this.warn(`${warning.code}: ${warning.message}`);
+			if (result.stale) this.error(`[znight:openapi] ${result.staleFiles.map(show).join(", ")} ${result.staleFiles.length > 1 ? "are" : "is"} missing or out of date: run "znight openapi"`);
+			for (const file of result.written) config.logger.info(`[znight:openapi] wrote ${show(file)}`);
+		}
+	};
+	return plugin;
+}
+function isInside(directory, file) {
+	const path = relative(directory, file);
+	return path !== "" && !path.startsWith("..") && !isAbsolute(path);
+}
+export { OPENAPI_PLUGIN_NAME, openapi };
+
+//# sourceMappingURL=vite.mjs.map

package/dist/vite.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.mjs","names":[],"sources":["../src/vite.ts"],"sourcesContent":["/**\n * `@znight/openapi/vite`: the `openapi()` Vite plugin. After `vite build` / `znight build` wrote the\n * bundle (and after each good rebuild of `znight dev`), it emits the OpenAPI document with\n * `emitOpenApi()`; with `check`, a missing or stale committed output fails the build.\n *\n * ```ts\n * export default defineConfig({\n *   plugins: [znight(options), openapi({ output: ['openapi.json', 'dist/openapi.json'], check: process.env['CI'] === 'true' })],\n * })\n * ```\n */\nimport type { Plugin, ResolvedConfig } from 'vite'\nimport type { EmitRuntime } from './emit/index.ts'\n\nimport { isAbsolute, join, relative, resolve } from 'node:path'\n\n/** Name of the plugin (an application uses one instance: the first one wins). */\nexport const OPENAPI_PLUGIN_NAME = 'znight:openapi'\n\n/** Options of {@link openapi}. */\nexport interface OpenApiVitePluginOptions {\n  /** Output files, relative to the Vite root (`.yaml` / `.yml` write YAML). Default: `<build.outDir>/openapi.json`. */\n  readonly output?: string | readonly string[]\n  /**\n   * CI: never write the outputs outside `build.outDir` (the committed files), fail the build when one\n   * is missing or stale. The outputs inside `build.outDir` are build artifacts, written by every\n   * build. Default `false`.\n   */\n  readonly check?: boolean\n  /** HTTP prefix (`servers` default when `@OpenApiDocument` declares none). */\n  readonly prefix?: string\n  /** Runtime loading the application modules. Default `'auto'`. */\n  readonly runtime?: EmitRuntime\n  /** Module whose default export is a `SchemaConverter[]`, relative to the Vite root. */\n  readonly converters?: string\n}\n\ninterface ZnightApiLike {\n  readonly options?: unknown\n  readonly result?: { readonly ok?: unknown }\n  readonly compiler?: { readonly options?: { readonly root?: unknown } }\n}\n\n/** The `openapi()` Vite plugin (build only). */\nexport function openapi(options: OpenApiVitePluginOptions = {}): Plugin {\n  let config: ResolvedConfig | undefined\n  let active = true\n  let emitted = false\n  const plugin: Plugin = {\n    name: OPENAPI_PLUGIN_NAME,\n    apply: 'build',\n    configResolved(resolved) {\n      config = resolved\n      // the config file wins over a copy added by the CLI (znight build --openapi)\n      active = resolved.plugins.find(candidate => candidate.name === OPENAPI_PLUGIN_NAME) === plugin\n    },\n    buildStart() {\n      emitted = false\n    },\n    async writeBundle() {\n      if (!active || emitted || config === undefined) return\n      emitted = true\n      const znight = config.plugins.find(candidate => candidate.name === 'znight') as\n        | { api?: ZnightApiLike }\n        | undefined\n      const api = znight?.api\n      // watch mode: the bundle of a failed compile throws the diagnostics; keep the last document\n      if (api?.result !== undefined && api.result.ok === false) return\n      const root = config.root\n      const outputs =\n        options.output === undefined\n          ? [join(resolve(root, config.build.outDir), 'openapi.json')]\n          : (typeof options.output === 'string' ? [options.output] : options.output).map(file => resolve(root, file))\n      const outDir = resolve(root, config.build.outDir)\n      const checked = options.check === true ? outputs.filter(file => !isInside(outDir, file)) : []\n      if (options.check === true && checked.length === 0) {\n        this.warn(\n          '[znight:openapi] check: every output is in build.outDir, written by each build: nothing is checked (add the committed file to output)',\n        )\n      }\n      const compilerRoot = api?.compiler?.options?.root\n      const given =\n        typeof api?.options === 'object' && api.options !== null ? (api.options as Record<string, unknown>) : undefined\n      const { emitOpenApi } = await import('./emit/index.ts')\n      const result = await emitOpenApi({\n        root,\n        output: outputs,\n        ...(checked.length === 0 ? {} : { check: checked }),\n        ...(options.prefix === undefined ? {} : { prefix: options.prefix }),\n        ...(options.runtime === undefined ? {} : { runtime: options.runtime }),\n        ...(options.converters === undefined ? {} : { converters: options.converters }),\n        ...(config.configFile === undefined ? {} : { config: config.configFile }),\n        ...(given === undefined\n          ? {}\n          : {\n              compilerOptions: {\n                ...given,\n                root: typeof compilerRoot === 'string' ? compilerRoot : resolve(root, String(given['root'] ?? '.')),\n              },\n            }),\n      })\n      const show = (file: string): string => {\n        const path = relative(root, file)\n        return path === '' || path.startsWith('..') || isAbsolute(path) ? file : path\n      }\n      if (!result.ok) {\n        this.error(\n          `[znight:openapi] the application does not compile: ${result.diagnostics.filter(d => d.severity === 'error').length} error(s)`,\n        )\n      }\n      for (const warning of result.warnings) this.warn(`${warning.code}: ${warning.message}`)\n      if (result.stale) {\n        this.error(\n          `[znight:openapi] ${result.staleFiles.map(show).join(', ')} ${result.staleFiles.length > 1 ? 'are' : 'is'} missing or out of date: run \"znight openapi\"`,\n        )\n      }\n      for (const file of result.written) config.logger.info(`[znight:openapi] wrote ${show(file)}`)\n    },\n  }\n  return plugin\n}\n\nfunction isInside(directory: string, file: string): boolean {\n  const path = relative(directory, file)\n  return path !== '' && !path.startsWith('..') && !isAbsolute(path)\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,117 @@
 {
   "name": "@znight/openapi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Znight OpenAPI: OpenAPI 3.1 documents generated at build time from your controllers, served with Scalar or Swagger UI",
+  "license": "MIT",
+  "author": "Ugho STEPHAN",
+  "homepage": "https://github.com/znight-org/znight/tree/main/packages/openapi#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/znight-org/znight.git",
+    "directory": "packages/openapi"
+  },
+  "bugs": "https://github.com/znight-org/znight/issues",
+  "keywords": ["znight", "openapi", "swagger", "scalar", "api-docs", "json-schema"],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "@znight/source": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./compiler": {
+      "@znight/source": "./src/compiler/index.ts",
+      "types": "./dist/compiler.d.mts",
+      "default": "./dist/compiler.mjs"
+    },
+    "./emit": {
+      "@znight/source": "./src/emit/index.ts",
+      "types": "./dist/emit.d.mts",
+      "default": "./dist/emit.mjs"
+    },
+    "./vite": {
+      "@znight/source": "./src/vite.ts",
+      "types": "./dist/vite.d.mts",
+      "default": "./dist/vite.mjs"
+    },
+    "./testing": {
+      "@znight/source": "./src/testing.ts",
+      "types": "./dist/testing.d.mts",
+      "default": "./dist/testing.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.mts",
+  "files": ["dist", "src"],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@znight/core": "0.1.1"
+  },
+  "peerDependencies": {
+    "@znight/http": "^0.1.1",
+    "@znight/compiler": "^0.1.1",
+    "vite": "^8.0.0",
+    "@valibot/to-json-schema": "^1.5.0",
+    "yaml": "^2.0.0",
+    "@scalar/api-reference": "^1.0.0",
+    "swagger-ui-dist": "^5.0.0",
+    "@cfworker/json-schema": "^4.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@znight/compiler": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "@valibot/to-json-schema": {
+      "optional": true
+    },
+    "yaml": {
+      "optional": true
+    },
+    "@scalar/api-reference": {
+      "optional": true
+    },
+    "swagger-ui-dist": {
+      "optional": true
+    },
+    "@cfworker/json-schema": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@znight/http": "0.1.1",
+    "@znight/compiler": "0.1.1",
+    "@znight/testing": "0.1.1",
+    "zod": "4.6.7",
+    "valibot": "1.5.0",
+    "@valibot/to-json-schema": "1.8.0",
+    "arktype": "2.2.9",
+    "yaml": "2.9.1",
+    "@seriousme/openapi-schema-validator": "2.11.0",
+    "@cfworker/json-schema": "4.1.1",
+    "vite": "8.3.5"
+  },
+  "znight": {
+    "apiVersion": 1,
+    "compiler": "@znight/openapi/compiler",
+    "provides": [
+      {
+        "export": "OpenApi",
+        "plugin": "OpenApiPlugin",
+        "scope": "singleton"
+      }
+    ]
+  }
+}