@forinda/kickjs-swagger 2.0.1 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-swagger",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "OpenAPI spec generation from decorators, Swagger UI and ReDoc serving for KickJS",
   "keywords": [
     "kickjs",
@@ -38,20 +38,39 @@
     "vite"
   ],
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     }
   },
   "files": [
     "dist"
   ],
+  "wireit": {
+    "build": {
+      "command": "tsdown",
+      "files": [
+        "src/**/*.ts",
+        "tsdown.config.ts",
+        "tsconfig.json",
+        "package.json"
+      ],
+      "output": [
+        "dist/**"
+      ],
+      "dependencies": [
+        "../core:build",
+        "../http:build"
+      ]
+    }
+  },
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs": "2.0.1"
+    "swagger-ui-dist": "^5.32.1",
+    "@forinda/kickjs": "2.2.0"
   },
   "peerDependencies": {
     "express": "^5.1.0",
@@ -63,12 +82,12 @@
     }
   },
   "devDependencies": {
-    "@swc/core": "^1.7.28",
+    "@swc/core": "^1.15.21",
     "@types/express": "^5.0.6",
     "@types/node": "^25.0.0",
     "express": "^5.1.0",
     "typescript": "^5.9.2",
-    "vitest": "^4.1.1",
+    "vitest": "^4.1.2",
     "zod": "^4.3.6"
   },
   "publishConfig": {
@@ -89,13 +108,12 @@
     "url": "https://github.com/forinda/kick-js/issues"
   },
   "scripts": {
-    "build": "vite build && pnpm build:types",
-    "build:types": "tsc -p tsconfig.build.json",
-    "dev": "vite build --watch",
+    "build": "wireit",
+    "dev": "tsdown --watch",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist .turbo",
+    "clean": "rm -rf dist .wireit",
     "lint": "tsc --noEmit"
   }
 }

package/dist/decorators.d.ts

@@ -1,33 +0,0 @@
-import 'reflect-metadata';
-declare const SWAGGER_KEYS: {
-    OPERATION: symbol;
-    RESPONSES: symbol;
-    TAGS: symbol;
-    BEARER_AUTH: symbol;
-    EXCLUDE: symbol;
-};
-export { SWAGGER_KEYS };
-export interface ApiOperationOptions {
-    summary?: string;
-    description?: string;
-    operationId?: string;
-    deprecated?: boolean;
-}
-export interface ApiResponseOptions {
-    status: number;
-    description?: string;
-    schema?: any;
-    /** Schema name in components/schemas (e.g., 'UserResponse', 'ErrorBody'). Auto-generated from handler name if omitted. */
-    name?: string;
-}
-/** Attach operation metadata to a route handler */
-export declare function ApiOperation(options: ApiOperationOptions): MethodDecorator;
-/** Document a response status. Can be stacked multiple times. */
-export declare function ApiResponse(options: ApiResponseOptions): MethodDecorator;
-/** Apply OpenAPI tags at class or method level */
-export declare function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator;
-/** Mark endpoint as requiring Bearer token auth */
-export declare function ApiBearerAuth(name?: string): ClassDecorator & MethodDecorator;
-/** Exclude a controller or method from the OpenAPI spec */
-export declare function ApiExclude(): ClassDecorator & MethodDecorator;
-//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,QAAA,MAAM,YAAY;;;;;;CAMjB,CAAA;AAED,OAAO,EAAE,YAAY,EAAE,CAAA;AAEvB,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,0HAA0H;IAC1H,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,eAAe,CAI1E;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAWxE;AAED,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,GAAG,eAAe,CAQ3E;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,IAAI,SAAe,GAAG,cAAc,GAAG,eAAe,CAQnF;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,IAAI,cAAc,GAAG,eAAe,CAQ7D"}

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-export { zodSchemaParser, type SchemaParser } from './schema-parser';
-export { ApiOperation, ApiResponse, ApiTags, ApiBearerAuth, ApiExclude, type ApiOperationOptions, type ApiResponseOptions, } from './decorators';
-export { buildOpenAPISpec, registerControllerForDocs, clearRegisteredRoutes, type OpenAPIInfo, type SwaggerOptions, } from './openapi-builder';
-export { SwaggerAdapter, type SwaggerAdapterOptions } from './swagger.adapter';
-export { swaggerUIHtml, redocHtml } from './ui';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGpE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,OAAO,EACP,aAAa,EACb,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAG9E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA"}

package/dist/index.js

@@ -1,345 +0,0 @@
-import "reflect-metadata";
-import { Logger as D, METADATA as T, joinPaths as C } from "@forinda/kickjs";
-import { Router as L } from "express";
-var H = {
-  name: "zod",
-  supports(e) {
-    return e != null && typeof e == "object" && typeof e.safeParse == "function" && typeof e.toJSONSchema == "function";
-  },
-  toJsonSchema(e) {
-    const { $schema: t, ...a } = e.toJSONSchema();
-    return a;
-  }
-}, i = {
-  OPERATION: /* @__PURE__ */ Symbol("kick:swagger:operation"),
-  RESPONSES: /* @__PURE__ */ Symbol("kick:swagger:responses"),
-  TAGS: /* @__PURE__ */ Symbol("kick:swagger:tags"),
-  BEARER_AUTH: /* @__PURE__ */ Symbol("kick:swagger:bearer"),
-  EXCLUDE: /* @__PURE__ */ Symbol("kick:swagger:exclude")
-};
-function Z(e) {
-  return (t, a) => {
-    Reflect.defineMetadata(i.OPERATION, e, t.constructor, a);
-  };
-}
-function Q(e) {
-  return (t, a) => {
-    const p = Reflect.getMetadata(i.RESPONSES, t.constructor, a) || [];
-    Reflect.defineMetadata(i.RESPONSES, [...p, e], t.constructor, a);
-  };
-}
-function V(...e) {
-  return (t, a) => {
-    a ? Reflect.defineMetadata(i.TAGS, e, t.constructor, a) : Reflect.defineMetadata(i.TAGS, e, t);
-  };
-}
-function K(e = "BearerAuth") {
-  return (t, a) => {
-    a ? Reflect.defineMetadata(i.BEARER_AUTH, e, t.constructor, a) : Reflect.defineMetadata(i.BEARER_AUTH, e, t);
-  };
-}
-function ee() {
-  return (e, t) => {
-    t ? Reflect.defineMetadata(i.EXCLUDE, !0, e.constructor, t) : Reflect.defineMetadata(i.EXCLUDE, !0, e);
-  };
-}
-var M = [];
-function F(e, t) {
-  M.push({
-    controllerClass: e,
-    mountPath: t
-  });
-}
-function x() {
-  M.length = 0;
-}
-function J(e = {}) {
-  const t = e.schemaParser ?? H, a = (o) => {
-    try {
-      return t.supports(o) ? t.toJsonSchema(o) : null;
-    } catch {
-      return null;
-    }
-  }, p = {};
-  let d = 0;
-  const m = (o, w) => {
-    let u = o.title || o.label || w || "";
-    if (u || (u = `Schema${++d}`), u = u.replace(/[^a-zA-Z0-9]/g, ""), !p[u]) {
-      const A = { ...o };
-      delete A.title, delete A.label, delete A.$schema, p[u] = A;
-    }
-    return { $ref: `#/components/schemas/${u}` };
-  }, r = {
-    openapi: "3.0.3",
-    info: {
-      title: e.info?.title || "API",
-      version: e.info?.version || "1.0.0",
-      ...e.info?.description ? { description: e.info.description } : {}
-    },
-    paths: {},
-    components: {
-      schemas: {},
-      securitySchemes: {}
-    },
-    tags: []
-  };
-  e.servers && (r.servers = e.servers);
-  const S = /* @__PURE__ */ new Set(), E = {};
-  for (const { controllerClass: o, mountPath: w } of M) {
-    if (Reflect.getMetadata(i.EXCLUDE, o)) continue;
-    const u = Reflect.getMetadata(T.ROUTES, o) || [], A = Reflect.getMetadata(i.TAGS, o) || [], I = Reflect.getMetadata(i.BEARER_AUTH, o);
-    for (const n of u) {
-      if (Reflect.getMetadata(i.EXCLUDE, o, n.handlerName)) continue;
-      const $ = C(w, n.path), P = $.replace(/:([a-zA-Z_]+)/g, "{$1}"), R = n.method.toLowerCase(), h = Reflect.getMetadata(i.OPERATION, o, n.handlerName) || {}, N = Reflect.getMetadata(i.RESPONSES, o, n.handlerName) || [], k = Reflect.getMetadata(i.TAGS, o, n.handlerName) || [], B = Reflect.getMetadata(i.BEARER_AUTH, o, n.handlerName), v = k.length > 0 ? k : A;
-      v.forEach((s) => S.add(s));
-      const c = {
-        ...v.length > 0 ? { tags: v } : {},
-        ...h.summary ? { summary: h.summary } : {},
-        ...h.description ? { description: h.description } : {},
-        ...h.operationId ? { operationId: h.operationId } : {},
-        ...h.deprecated ? { deprecated: !0 } : {},
-        parameters: [],
-        responses: {}
-      }, _ = $.match(/:([a-zA-Z_]+)/g) || [];
-      for (const s of _) {
-        const l = s.slice(1);
-        let y = { type: "string" };
-        if (n.validation?.params) {
-          const f = a(n.validation.params);
-          if (f?.properties && typeof f.properties == "object") {
-            const U = f.properties;
-            U[l] && (y = U[l]);
-          }
-        }
-        c.parameters.push({
-          name: l,
-          in: "path",
-          required: !0,
-          schema: y
-        });
-      }
-      if (n.validation?.query) {
-        const s = a(n.validation.query);
-        if (s?.properties && typeof s.properties == "object") {
-          const l = Array.isArray(s.required) ? s.required : [];
-          for (const [y, f] of Object.entries(s.properties)) c.parameters.push({
-            name: y,
-            in: "query",
-            required: l.includes(y),
-            schema: f
-          });
-        }
-      }
-      const g = Reflect.getMetadata(T.QUERY_PARAMS, o, n.handlerName);
-      if (g && (g.filterable?.length && c.parameters.push({
-        name: "filter",
-        in: "query",
-        required: !1,
-        description: `Filter fields: ${g.filterable.join(", ")}. Format: \`field:operator:value\`. Operators: eq, neq, gt, gte, lt, lte, contains, starts, ends, in, between`,
-        schema: {
-          type: "array",
-          items: { type: "string" }
-        },
-        style: "form",
-        explode: !0
-      }), g.sortable?.length && c.parameters.push({
-        name: "sort",
-        in: "query",
-        required: !1,
-        description: `Sort fields: ${g.sortable.join(", ")}. Format: \`field:asc\` or \`field:desc\``,
-        schema: {
-          type: "array",
-          items: { type: "string" }
-        },
-        style: "form",
-        explode: !0
-      }), g.searchable?.length && c.parameters.push({
-        name: "q",
-        in: "query",
-        required: !1,
-        description: `Search across: ${g.searchable.join(", ")}`,
-        schema: { type: "string" }
-      }), c.parameters.push({
-        name: "page",
-        in: "query",
-        required: !1,
-        description: "Page number (default: 1)",
-        schema: {
-          type: "integer",
-          minimum: 1,
-          default: 1
-        }
-      }, {
-        name: "limit",
-        in: "query",
-        required: !1,
-        description: "Items per page (default: 20, max: 100)",
-        schema: {
-          type: "integer",
-          minimum: 1,
-          maximum: 100,
-          default: 20
-        }
-      })), c.parameters.length === 0 && delete c.parameters, n.validation?.body && [
-        "post",
-        "put",
-        "patch"
-      ].includes(R)) {
-        const s = a(n.validation.body);
-        if (s) {
-          const l = m(s, n.validation.name || `${n.handlerName}Body`);
-          c.requestBody = {
-            required: !0,
-            content: { "application/json": { schema: l } }
-          };
-        }
-      }
-      const b = Reflect.getMetadata(T.FILE_UPLOAD, o, n.handlerName);
-      if (b) {
-        const s = b.fieldName ?? "file", l = {};
-        b.mode === "array" ? l[s] = {
-          type: "array",
-          items: {
-            type: "string",
-            format: "binary"
-          }
-        } : b.mode !== "none" && (l[s] = {
-          type: "string",
-          format: "binary"
-        }), c.requestBody = {
-          required: !0,
-          content: { "multipart/form-data": { schema: {
-            type: "object",
-            properties: l
-          } } }
-        };
-      }
-      if (N.length > 0) for (const s of N) c.responses[String(s.status)] = {
-        description: s.description || "",
-        ...s.schema ? (() => {
-          const l = typeof s.schema == "function" || typeof s.schema == "object" ? a(s.schema) : null, y = s.name || `${n.handlerName}Response${s.status}`, f = l ? m(l, y) : typeof s.schema == "object" ? s.schema : void 0;
-          return f ? { content: { "application/json": { schema: f } } } : {};
-        })() : {}
-      };
-      else {
-        const s = R === "post" ? "201" : R === "delete" ? "204" : "200";
-        c.responses[s] = { description: "Successful operation" }, n.validation?.body && (c.responses[422] = { description: "Validation error" });
-      }
-      const q = B || I;
-      q && (c.security = [{ [q]: [] }], E[q] = {
-        type: "http",
-        scheme: "bearer",
-        bearerFormat: "JWT"
-      }), r.paths[P] || (r.paths[P] = {}), r.paths[P][R] = c;
-    }
-  }
-  return r.tags = Array.from(S).map((o) => ({ name: o })), r.components.securitySchemes = E, e.bearerAuth && (E.BearerAuth || (r.components.securitySchemes.BearerAuth = {
-    type: "http",
-    scheme: "bearer",
-    bearerFormat: "JWT"
-  }), r.security = [{ BearerAuth: [] }]), r.components.schemas = p, Object.keys(r.components.schemas).length === 0 && delete r.components.schemas, Object.keys(r.components.securitySchemes).length === 0 && delete r.components.securitySchemes, Object.keys(r.components).length === 0 && delete r.components, r;
-}
-function j(e) {
-  return e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-}
-function G(e, t = "API Docs") {
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${j(t)}</title>
-  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
-</head>
-<body>
-  <div id="swagger-ui"></div>
-  <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"><\/script>
-  <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-standalone-preset.js"><\/script>
-  <script>
-    SwaggerUIBundle({
-      url: ${JSON.stringify(e).replace(/</g, "\\u003c")},
-      dom_id: '#swagger-ui',
-      deepLinking: true,
-      presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
-      plugins: [SwaggerUIBundle.plugins.DownloadUrl],
-      layout: 'StandaloneLayout',
-    });
-  <\/script>
-</body>
-</html>`;
-}
-function z(e, t = "API Docs") {
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${j(t)}</title>
-</head>
-<body>
-  <redoc spec-url="${j(e)}"></redoc>
-  <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"><\/script>
-</body>
-</html>`;
-}
-var O = D.for("SwaggerAdapter"), te = class {
-  name = "SwaggerAdapter";
-  constructor(e = {}) {
-    this.options = e;
-  }
-  afterStart({ server: e }) {
-    const t = e?.address?.();
-    if (!t || typeof t != "object") return;
-    const a = t.address === "::" || t.address === "0.0.0.0" ? "localhost" : t.address;
-    (!this.options.servers || this.options.servers.length === 0) && (this.options.servers = [{
-      url: `http://${a}:${t.port}`,
-      description: "HTTP server"
-    }]);
-    const p = this.options.adapters?.find((d) => d.name === "WsAdapter" && typeof d.getStats == "function");
-    if (p) {
-      const d = p.getStats();
-      for (const m of Object.keys(d.namespaces || {})) this.options.servers.push({
-        url: `ws://${a}:${t.port}${m}`,
-        description: `WebSocket: ${m}`
-      });
-    }
-  }
-  onRouteMount(e, t) {
-    F(e, t);
-  }
-  beforeMount({ app: e }) {
-    x();
-    const t = this.options.docsPath ?? "/docs", a = this.options.redocPath ?? "/redoc", p = this.options.specPath ?? "/openapi.json", d = L();
-    d.use((m, r, S) => {
-      r.setHeader("Content-Security-Policy", [
-        "default-src 'self'",
-        "script-src 'self' 'unsafe-inline' https://unpkg.com https://cdn.redoc.ly https://cdn.jsdelivr.net",
-        "style-src 'self' 'unsafe-inline' https://unpkg.com https://fonts.googleapis.com",
-        "font-src 'self' https://fonts.gstatic.com",
-        "img-src 'self' data: https://unpkg.com",
-        "connect-src 'self'"
-      ].join("; ")), S();
-    }), d.get(p, (m, r) => {
-      const S = J(this.options);
-      r.json(S);
-    }), d.get(t, (m, r) => {
-      r.type("html").send(G(p, this.options.info?.title));
-    }), d.get(a, (m, r) => {
-      r.type("html").send(z(p, this.options.info?.title));
-    }), e.use(d), O.info(`Swagger UI:  ${t}`), O.info(`ReDoc:       ${a}`), O.info(`OpenAPI spec: ${p}`);
-  }
-};
-export {
-  K as ApiBearerAuth,
-  ee as ApiExclude,
-  Z as ApiOperation,
-  Q as ApiResponse,
-  V as ApiTags,
-  te as SwaggerAdapter,
-  J as buildOpenAPISpec,
-  x as clearRegisteredRoutes,
-  z as redocHtml,
-  F as registerControllerForDocs,
-  G as swaggerUIHtml,
-  H as zodSchemaParser
-};

package/dist/openapi-builder.d.ts

@@ -1,36 +0,0 @@
-import 'reflect-metadata';
-import { type SchemaParser } from './schema-parser';
-export interface OpenAPIInfo {
-    title: string;
-    version: string;
-    description?: string;
-}
-export interface SwaggerOptions {
-    info?: Partial<OpenAPIInfo>;
-    servers?: {
-        url: string;
-        description?: string;
-    }[];
-    bearerAuth?: boolean;
-    /**
-     * Pluggable schema parser for converting validation schemas to JSON Schema.
-     * Defaults to `zodSchemaParser` which handles Zod v4+ schemas.
-     *
-     * Override this to use Yup, Joi, Valibot, ArkType, or any other library.
-     *
-     * @example
-     * ```ts
-     * new SwaggerAdapter({
-     *   schemaParser: myYupParser,
-     * })
-     * ```
-     */
-    schemaParser?: SchemaParser;
-}
-/** Register a controller for OpenAPI introspection (called by Application during route mounting) */
-export declare function registerControllerForDocs(controllerClass: any, mountPath: string): void;
-/** Clear all registered routes (for HMR) */
-export declare function clearRegisteredRoutes(): void;
-/** Build a full OpenAPI 3.0.3 spec from registered controllers and their decorators */
-export declare function buildOpenAPISpec(options?: SwaggerOptions): any;
-//# sourceMappingURL=openapi-builder.d.ts.map

package/dist/openapi-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi-builder.d.ts","sourceRoot":"","sources":["../src/openapi-builder.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAGzB,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEpE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC3B,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACjD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AASD,oGAAoG;AACpG,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEvF;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,cAAmB,GAAG,GAAG,CA6UlE"}

package/dist/schema-parser.d.ts

@@ -1,42 +0,0 @@
-/**
- * Interface for converting validation library schemas to JSON Schema.
- *
- * KickJS ships with a Zod parser by default. To use a different validation
- * library (Yup, Joi, Valibot, ArkType, etc.), implement this interface and
- * pass it to the SwaggerAdapter.
- *
- * @example
- * ```ts
- * import Joi from 'joi'
- * import joiToJson from 'joi-to-json'
- *
- * const joiParser: SchemaParser = {
- *   name: 'joi',
- *   supports: (schema) => Joi.isSchema(schema),
- *   toJsonSchema: (schema) => joiToJson(schema),
- * }
- *
- * new SwaggerAdapter({ schemaParser: joiParser })
- * ```
- */
-export interface SchemaParser {
-    /** Human-readable name for logging/debugging */
-    readonly name: string;
-    /**
-     * Return true if this parser can handle the given schema object.
-     * Called before `toJsonSchema` to allow graceful fallback.
-     */
-    supports(schema: unknown): boolean;
-    /**
-     * Convert a validation schema to a JSON Schema object.
-     * Should return a plain object conforming to JSON Schema draft-07 or later.
-     * Must not include the top-level `$schema` key — the builder adds it.
-     */
-    toJsonSchema(schema: unknown): Record<string, unknown>;
-}
-/**
- * Default schema parser for Zod v4+.
- * Uses Zod's built-in `.toJSONSchema()` instance method.
- */
-export declare const zodSchemaParser: SchemaParser;
-//# sourceMappingURL=schema-parser.d.ts.map

package/dist/schema-parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-parser.d.ts","sourceRoot":"","sources":["../src/schema-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAA;IAElC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,YAgB7B,CAAA"}

package/dist/swagger.adapter.d.ts

@@ -1,44 +0,0 @@
-import { type AppAdapter, type AdapterContext } from '@forinda/kickjs';
-import { registerControllerForDocs, clearRegisteredRoutes, type SwaggerOptions } from './openapi-builder';
-export interface SwaggerAdapterOptions extends SwaggerOptions {
-    /** Path to serve Swagger UI (default: '/docs') */
-    docsPath?: string;
-    /** Path to serve ReDoc (default: '/redoc') */
-    redocPath?: string;
-    /** Path to serve the raw JSON spec (default: '/openapi.json') */
-    specPath?: string;
-    /** Other adapters to discover (e.g., WsAdapter for WebSocket server URLs) */
-    adapters?: any[];
-}
-/**
- * Swagger adapter — auto-generates OpenAPI spec from decorators and serves docs.
- *
- * @example
- * ```ts
- * bootstrap({
- *   modules,
- *   adapters: [
- *     new SwaggerAdapter({
- *       info: { title: 'My API', version: '1.0.0' },
- *     }),
- *   ],
- * })
- * ```
- *
- * Endpoints:
- *   GET /docs         — Swagger UI
- *   GET /redoc        — ReDoc
- *   GET /openapi.json — Raw OpenAPI 3.0.3 spec
- */
-export declare class SwaggerAdapter implements AppAdapter {
-    private options;
-    name: string;
-    constructor(options?: SwaggerAdapterOptions);
-    /** Auto-detect server URLs from the running HTTP server and peer adapters */
-    afterStart({ server }: AdapterContext): void;
-    /** Collect controller metadata as routes are mounted */
-    onRouteMount(controllerClass: any, mountPath: string): void;
-    beforeMount({ app }: AdapterContext): void;
-}
-export { registerControllerForDocs, clearRegisteredRoutes };
-//# sourceMappingURL=swagger.adapter.d.ts.map

package/dist/swagger.adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"swagger.adapter.d.ts","sourceRoot":"","sources":["../src/swagger.adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EAEL,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAK1B,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,YAAW,UAAU;IAGnC,OAAO,CAAC,OAAO;IAF3B,IAAI,SAAmB;gBAEH,OAAO,GAAE,qBAA0B;IAEvD,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,IAAI;IA0B5C,wDAAwD;IACxD,YAAY,CAAC,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3D,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,IAAI;CA+C3C;AAGD,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/ui.d.ts

@@ -1,5 +0,0 @@
-/** Generate Swagger UI HTML that loads from CDN */
-export declare function swaggerUIHtml(specUrl: string, title?: string): string;
-/** Generate ReDoc HTML that loads from CDN */
-export declare function redocHtml(specUrl: string, title?: string): string;
-//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAUA,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,MAAM,CA4BzE;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,MAAM,CAgBrE"}