npm - @davaux/swagger - Versions diffs - 0.8.0 → 0.8.1 - Mend

@davaux/swagger 0.8.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,40 @@
+import type { MiddlewareFn } from 'davaux';
+/** OpenAPI metadata used in the `info` block of the generated spec. */
+export interface SwaggerInfo {
+    title?: string;
+    version?: string;
+    description?: string;
+}
+export interface SwaggerOptions {
+    /**
+     * Directory containing compiled route files to introspect.
+     * In production: the davaux build output directory (default: './dist').
+     * In development: './.davaux/routes' (the dev server's compiled output).
+     */
+    routesDir: string;
+    /** OpenAPI info block. */
+    info?: SwaggerInfo;
+    /** URL path for the Swagger UI page. Default: '/docs' */
+    path?: string;
+    /** URL path for the raw OpenAPI JSON spec. Default: '/openapi.json' */
+    specPath?: string;
+}
+/**
+ * OpenAPI/Swagger middleware. Introspects compiled route files to build an
+ * OpenAPI 3.0 spec and serves it at `specPath` (default: `/openapi.json`),
+ * plus a Swagger UI page at `path` (default: `/docs`).
+ *
+ * The spec is generated once on the first request and cached for the lifetime
+ * of the process. When `zod-to-json-schema` is installed, mutating routes that
+ * export a `*Schema` named export will have their request body documented
+ * automatically.
+ *
+ * @example
+ * import { swagger } from '@davaux/swagger'
+ * export default swagger({
+ *   routesDir: './dist/routes',
+ *   info: { title: 'My API', version: '1.0.0' },
+ * })
+ */
+export declare function swagger(options: SwaggerOptions): MiddlewareFn;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1C,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAwID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CA2B7D"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,163 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+const TYPE_TO_METHOD = {
+    get: 'get',
+    post: 'post',
+    put: 'put',
+    patch: 'patch',
+    delete: 'delete',
+    head: 'head',
+    options: 'options',
+    page: undefined, // HTML page routes are not API endpoints
+};
+function toOpenApiPath(pattern) {
+    return pattern
+        .replace(/:(\w+)/g, '{$1}') // :id → {id}
+        .replace(/\*(\w+)/g, '{$1}'); // *slug → {slug} (catch-all)
+}
+function buildInfo(info) {
+    return {
+        title: info?.title ?? 'API',
+        version: info?.version ?? '1.0.0',
+        ...(info?.description ? { description: info.description } : {}),
+    };
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function swaggerHtml(specPath, title) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${escapeHtml(title)}</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui.css" integrity="sha384-rcbEi6xgdPk0iWkAQzT2F3FeBJXdG+ydrawGlfHAFIZG7wU6aKbQaRewysYpmrlW" crossorigin="anonymous" />
+</head>
+<body>
+<div id="swagger-ui"></div>
+<script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui-bundle.js" integrity="sha384-NXtFPpN61oWCuN4D42K6Zd5Rt2+uxeIT36R7kpXBuY9tLnZorzrJ4ykpqwJfgjpZ" crossorigin="anonymous"></script>
+<script>
+window.onload = () => {
+  SwaggerUIBundle({
+    url: ${JSON.stringify(specPath)},
+    dom_id: '#swagger-ui',
+    presets: [SwaggerUIBundle.presets.apis, SwaggerUIBundle.SwaggerUIStandalonePreset],
+    layout: 'StandaloneLayout',
+    deepLinking: true,
+  })
+}
+</script>
+</body>
+</html>`;
+}
+async function buildSpec(options) {
+    const routesDir = resolve(options.routesDir);
+    if (!existsSync(routesDir)) {
+        console.warn(`[@davaux/swagger] routesDir not found: ${routesDir} — serving empty spec`);
+        return { openapi: '3.0.0', info: buildInfo(options.info), paths: {} };
+    }
+    const { scanRoutes } = await import('davaux/scanner');
+    const { routes } = await scanRoutes(routesDir);
+    const paths = {};
+    for (const route of routes) {
+        const method = TYPE_TO_METHOD[route.type];
+        if (!method)
+            continue;
+        const openApiPath = toOpenApiPath(route.urlPattern);
+        if (!paths[openApiPath])
+            paths[openApiPath] = {};
+        const parameters = route.params.map((param) => ({
+            name: param,
+            in: 'path',
+            required: true,
+            schema: { type: 'string' },
+        }));
+        const operation = {
+            parameters,
+            responses: {
+                '200': { description: 'Success' },
+                '400': { description: 'Bad Request' },
+                '500': { description: 'Internal Server Error' },
+            },
+        };
+        // For mutating methods, try to extract the first named *Schema export from the
+        // compiled route module and convert it to a JSON Schema request body.
+        // Requires zod-to-json-schema to be installed — silently skipped otherwise.
+        if (method !== 'get' && method !== 'head' && method !== 'options') {
+            try {
+                const mod = (await import(route.filePath));
+                const schemaEntry = Object.entries(mod).find(([k]) => k.endsWith('Schema'));
+                if (schemaEntry) {
+                    // Dynamic import by variable so TypeScript doesn't statically resolve
+                    // the optional peer dep (zod-to-json-schema may not be installed).
+                    const depId = 'zod-to-json-schema';
+                    const ztjs = (await import(depId));
+                    operation.requestBody = {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: ztjs.zodToJsonSchema(schemaEntry[1], { target: 'openapi3' }),
+                            },
+                        },
+                    };
+                }
+            }
+            catch {
+                // zod-to-json-schema not installed or module import failed — skip
+            }
+        }
+        paths[openApiPath][method] = operation;
+    }
+    return {
+        openapi: '3.0.0',
+        info: buildInfo(options.info),
+        paths,
+    };
+}
+/**
+ * OpenAPI/Swagger middleware. Introspects compiled route files to build an
+ * OpenAPI 3.0 spec and serves it at `specPath` (default: `/openapi.json`),
+ * plus a Swagger UI page at `path` (default: `/docs`).
+ *
+ * The spec is generated once on the first request and cached for the lifetime
+ * of the process. When `zod-to-json-schema` is installed, mutating routes that
+ * export a `*Schema` named export will have their request body documented
+ * automatically.
+ *
+ * @example
+ * import { swagger } from '@davaux/swagger'
+ * export default swagger({
+ *   routesDir: './dist/routes',
+ *   info: { title: 'My API', version: '1.0.0' },
+ * })
+ */
+export function swagger(options) {
+    const docsPath = options.path ?? '/docs';
+    const specPath = options.specPath ?? '/openapi.json';
+    const title = options.info?.title ?? 'API Docs';
+    // Spec is generated once on the first request and cached for the process lifetime.
+    let specPromise = null;
+    return async (ctx, next) => {
+        const pathname = ctx.req.url?.split('?')[0] ?? '/';
+        if (pathname === specPath) {
+            if (!specPromise)
+                specPromise = buildSpec(options);
+            const spec = await specPromise;
+            ctx.res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+            ctx.res.end(JSON.stringify(spec, null, 2));
+            return;
+        }
+        if (pathname === docsPath) {
+            ctx.res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            ctx.res.end(swaggerHtml(specPath, title));
+            return;
+        }
+        return next();
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@davaux/swagger",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Auto-generated OpenAPI/Swagger documentation for Davaux APIs",
   "type": "module",
   "author": "David L Dyess II",
@@ -13,6 +13,9 @@
     "url": "https://codeberg.org/davaux/davaux/issues"
   },
   "homepage": "https://codeberg.org/davaux/davaux#readme",
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -24,7 +27,7 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "davaux": ">=0.8.0"
+    "davaux": ">=0.8.1"
   },
   "peerDependenciesMetadata": {
     "zod-to-json-schema": {
@@ -36,4 +39,4 @@
     "davaux": "*",
     "typescript": "^6.0.3"
   }
-}
+}

package/CLAUDE.md DELETED Viewed

@@ -1,95 +0,0 @@
-<!-- pka-generated -->
-# @davaux/swagger
-> Generated by Project Knowledge Analyzer on 2026-06-06T21:53:10.470Z
-## Overview
-Auto-generated OpenAPI/Swagger documentation for Davaux APIs
-**Version**: 0.8.0
-**Author**: David L Dyess II
-**License**: MIT
-**Repository**: https://codeberg.org/davaux/davaux#readme
-## Tech Stack
-- **Language**: TypeScript
-- **Module System**: ESM (`type: module`)
-## Commands
-- `npm run build` — tsc
-- `npm run typecheck` — tsc --noEmit
-## Project Structure
-```
-├── CLAUDE.md
-├── README.md
-├── package.json
-├── tsconfig.json
-└── src/
-    └── index.ts
-```
-## Entry Points
-- `src/index.ts`
-## Files by Type
-### Documentation (2)
-- `CLAUDE.md`
-- `README.md`
-### Config (2)
-- `package.json`
-- `tsconfig.json`
-### Module (1)
-- `src/index.ts`
-## Git
-- **Branch**: main
-- **Last Commit**: chore: Add alpha status note to README
-- **Author**: David Dyess II
-- **Date**: 2026-06-06 15:52:27 -0600
-- **Remote**: https://codeberg.org/davaux/davaux.git
-### Recent Commits
-```
-f527031 chore: Add alpha status note to README
-90c819e chore: Add repo info to package.json files
-b200d9d feat(davaux)!: Add OmlCacheConfig - opt-in with includes option or opt-out with excludes option; Fix OML implementation to follow OML spec - use output instead of return
-3bce0c2 chore: Update and add READMEs to packages; update ROADMAP
-fc27c20 fix(davaux): Remove old dist folder on new builds; fix server port per DavauxConfig
-c760659 feat(davaux): Add minify CSS in production builds
-c899ab8 fix(davaux): Added method JS and JSX extenstion to scanner
-7d99f04 feat(davaux): Add support for declarative partial updates
-3b47f37 chore: Bump package versions to 0.8.0
-aa0460f chore: Add CHANGELOG.md
-```
-## Dependencies
-### Development
-@types/node, davaux, typescript
-## Exported Symbols
-**`src/index.ts`**
-`swagger`, `SwaggerInfo`, `SwaggerOptions`

package/src/index.ts DELETED Viewed

@@ -1,205 +0,0 @@
-import { existsSync } from 'node:fs'
-import { resolve } from 'node:path'
-import type { MiddlewareFn } from 'davaux'
-/** OpenAPI metadata used in the `info` block of the generated spec. */
-export interface SwaggerInfo {
-  title?: string
-  version?: string
-  description?: string
-}
-export interface SwaggerOptions {
-  /**
-   * Directory containing compiled route files to introspect.
-   * In production: the davaux build output directory (default: './dist').
-   * In development: './.davaux/routes' (the dev server's compiled output).
-   */
-  routesDir: string
-  /** OpenAPI info block. */
-  info?: SwaggerInfo
-  /** URL path for the Swagger UI page. Default: '/docs' */
-  path?: string
-  /** URL path for the raw OpenAPI JSON spec. Default: '/openapi.json' */
-  specPath?: string
-}
-const TYPE_TO_METHOD: Record<string, string | undefined> = {
-  get: 'get',
-  post: 'post',
-  put: 'put',
-  patch: 'patch',
-  delete: 'delete',
-  head: 'head',
-  options: 'options',
-  page: undefined, // HTML page routes are not API endpoints
-}
-function toOpenApiPath(pattern: string): string {
-  return pattern
-    .replace(/:(\w+)/g, '{$1}') // :id → {id}
-    .replace(/\*(\w+)/g, '{$1}') // *slug → {slug} (catch-all)
-}
-function buildInfo(info?: SwaggerInfo): object {
-  return {
-    title: info?.title ?? 'API',
-    version: info?.version ?? '1.0.0',
-    ...(info?.description ? { description: info.description } : {}),
-  }
-}
-function escapeHtml(s: string): string {
-  return s
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-}
-function swaggerHtml(specPath: string, title: string): string {
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>${escapeHtml(title)}</title>
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui.css" integrity="sha384-rcbEi6xgdPk0iWkAQzT2F3FeBJXdG+ydrawGlfHAFIZG7wU6aKbQaRewysYpmrlW" crossorigin="anonymous" />
-</head>
-<body>
-<div id="swagger-ui"></div>
-<script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.18.2/swagger-ui-bundle.js" integrity="sha384-NXtFPpN61oWCuN4D42K6Zd5Rt2+uxeIT36R7kpXBuY9tLnZorzrJ4ykpqwJfgjpZ" crossorigin="anonymous"></script>
-<script>
-window.onload = () => {
-  SwaggerUIBundle({
-    url: ${JSON.stringify(specPath)},
-    dom_id: '#swagger-ui',
-    presets: [SwaggerUIBundle.presets.apis, SwaggerUIBundle.SwaggerUIStandalonePreset],
-    layout: 'StandaloneLayout',
-    deepLinking: true,
-  })
-}
-</script>
-</body>
-</html>`
-}
-async function buildSpec(options: SwaggerOptions): Promise<object> {
-  const routesDir = resolve(options.routesDir)
-  if (!existsSync(routesDir)) {
-    console.warn(`[@davaux/swagger] routesDir not found: ${routesDir} — serving empty spec`)
-    return { openapi: '3.0.0', info: buildInfo(options.info), paths: {} }
-  }
-  const { scanRoutes } = await import('davaux/scanner')
-  const { routes } = await scanRoutes(routesDir)
-  const paths: Record<string, Record<string, unknown>> = {}
-  for (const route of routes) {
-    const method = TYPE_TO_METHOD[route.type]
-    if (!method) continue
-    const openApiPath = toOpenApiPath(route.urlPattern)
-    if (!paths[openApiPath]) paths[openApiPath] = {}
-    const parameters = route.params.map((param) => ({
-      name: param,
-      in: 'path',
-      required: true,
-      schema: { type: 'string' },
-    }))
-    const operation: Record<string, unknown> = {
-      parameters,
-      responses: {
-        '200': { description: 'Success' },
-        '400': { description: 'Bad Request' },
-        '500': { description: 'Internal Server Error' },
-      },
-    }
-    // For mutating methods, try to extract the first named *Schema export from the
-    // compiled route module and convert it to a JSON Schema request body.
-    // Requires zod-to-json-schema to be installed — silently skipped otherwise.
-    if (method !== 'get' && method !== 'head' && method !== 'options') {
-      try {
-        const mod = (await import(route.filePath)) as Record<string, unknown>
-        const schemaEntry = Object.entries(mod).find(([k]) => k.endsWith('Schema'))
-        if (schemaEntry) {
-          // Dynamic import by variable so TypeScript doesn't statically resolve
-          // the optional peer dep (zod-to-json-schema may not be installed).
-          const depId = 'zod-to-json-schema'
-          const ztjs = (await import(depId)) as {
-            zodToJsonSchema: (schema: unknown, opts?: { target: string }) => unknown
-          }
-          operation.requestBody = {
-            required: true,
-            content: {
-              'application/json': {
-                schema: ztjs.zodToJsonSchema(schemaEntry[1], { target: 'openapi3' }),
-              },
-            },
-          }
-        }
-      } catch {
-        // zod-to-json-schema not installed or module import failed — skip
-      }
-    }
-    paths[openApiPath][method] = operation
-  }
-  return {
-    openapi: '3.0.0',
-    info: buildInfo(options.info),
-    paths,
-  }
-}
-/**
- * OpenAPI/Swagger middleware. Introspects compiled route files to build an
- * OpenAPI 3.0 spec and serves it at `specPath` (default: `/openapi.json`),
- * plus a Swagger UI page at `path` (default: `/docs`).
- *
- * The spec is generated once on the first request and cached for the lifetime
- * of the process. When `zod-to-json-schema` is installed, mutating routes that
- * export a `*Schema` named export will have their request body documented
- * automatically.
- *
- * @example
- * import { swagger } from '@davaux/swagger'
- * export default swagger({
- *   routesDir: './dist/routes',
- *   info: { title: 'My API', version: '1.0.0' },
- * })
- */
-export function swagger(options: SwaggerOptions): MiddlewareFn {
-  const docsPath = options.path ?? '/docs'
-  const specPath = options.specPath ?? '/openapi.json'
-  const title = options.info?.title ?? 'API Docs'
-  // Spec is generated once on the first request and cached for the process lifetime.
-  let specPromise: Promise<object> | null = null
-  return async (ctx, next) => {
-    const pathname = ctx.req.url?.split('?')[0] ?? '/'
-    if (pathname === specPath) {
-      if (!specPromise) specPromise = buildSpec(options)
-      const spec = await specPromise
-      ctx.res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' })
-      ctx.res.end(JSON.stringify(spec, null, 2))
-      return
-    }
-    if (pathname === docsPath) {
-      ctx.res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
-      ctx.res.end(swaggerHtml(specPath, title))
-      return
-    }
-    return next()
-  }
-}

package/tsconfig.json DELETED Viewed

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "skipLibCheck": true,
-    "lib": ["ESNext"],
-    "types": ["node"]
-  },
-  "include": ["src/**/*"]
-}