vitek-plugin 0.1.2-beta.6 → 0.2.1-beta

package/dist/core/file-system/watch-api-dir.js

@@ -9,32 +9,57 @@ import { ROUTE_FILE_PATTERN, MIDDLEWARE_FILE_PATTERN } from '../../shared/consta
  * Creates a watcher for the API directory using Node.js fs.watch
  * Returns a function to stop watching
  */
-export function watchApiDirectory(apiDir, callback) {
+export function watchApiDirectory(apiDir, callback, options = {}) {
     if (!fs.existsSync(apiDir)) {
         return { close: () => { } };
     }
+    const debounceMs = options.debounceMs ?? 0;
+    let pending = [];
+    let timer = null;
+    const flush = () => {
+        if (timer != null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        const toEmit = pending;
+        pending = [];
+        for (const { event, filePath } of toEmit) {
+            callback(event, filePath);
+        }
+    };
+    const schedule = (event, filePath) => {
+        pending.push({ event, filePath });
+        if (debounceMs <= 0) {
+            flush();
+            return;
+        }
+        if (timer != null)
+            clearTimeout(timer);
+        timer = setTimeout(flush, debounceMs);
+    };
     const watcher = fs.watch(apiDir, { recursive: true }, (eventType, filename) => {
         if (!filename)
             return;
         const filePath = path.join(apiDir, filename);
-        // Ignore if it's not a route file or relevant middleware
         const isRouteFile = ROUTE_FILE_PATTERN.test(filename);
         const isMiddlewareFile = MIDDLEWARE_FILE_PATTERN.test(filename);
         if (!isRouteFile && !isMiddlewareFile) {
             return;
         }
-        // Normalize event type
         let normalizedEvent;
         if (eventType === 'rename') {
-            // rename can be add or unlink, check if it exists
             normalizedEvent = fs.existsSync(filePath) ? 'add' : 'unlink';
         }
         else {
             normalizedEvent = eventType;
         }
-        callback(normalizedEvent, filePath);
+        schedule(normalizedEvent, filePath);
     });
     return {
-        close: () => watcher.close(),
+        close: () => {
+            if (timer != null)
+                clearTimeout(timer);
+            watcher.close();
+        },
     };
 }

package/dist/core/file-system/watch-api-dir.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watch-api-dir.test.d.ts.map

package/dist/core/file-system/watch-api-dir.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-api-dir.test.d.ts","sourceRoot":"","sources":["../../../src/core/file-system/watch-api-dir.test.ts"],"names":[],"mappings":""}

package/dist/core/file-system/watch-api-dir.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import { watchApiDirectory } from './watch-api-dir.js';
+describe('watch-api-dir', () => {
+    let tmpDir;
+    let apiDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(process.cwd(), 'watch-api-'));
+        apiDir = path.join(tmpDir, 'api');
+        fs.mkdirSync(apiDir, { recursive: true });
+    });
+    afterEach(() => {
+        try {
+            fs.rmSync(tmpDir, { recursive: true });
+        }
+        catch {
+            // ignore
+        }
+    });
+    it('returns watcher with no-op close when apiDir does not exist', () => {
+        const watcher = watchApiDirectory(path.join(tmpDir, 'nonexistent'), () => { });
+        expect(watcher).toBeDefined();
+        expect(typeof watcher.close).toBe('function');
+        watcher.close();
+    });
+    it('returns watcher with close when apiDir exists', () => {
+        const watcher = watchApiDirectory(apiDir, () => { });
+        expect(watcher).toBeDefined();
+        expect(typeof watcher.close).toBe('function');
+        watcher.close();
+    });
+    it('accepts debounceMs option', () => {
+        const watcher = watchApiDirectory(apiDir, () => { }, { debounceMs: 100 });
+        expect(watcher).toBeDefined();
+        watcher.close();
+    });
+});

package/dist/core/generation/run-file-generation.d.ts

@@ -17,6 +17,8 @@ export interface RunFileGenerationOptions {
         info?: (message: string) => void;
         warn?: (message: string) => void;
     };
+    /** Callback when generation fails (e.g. OpenAPI). Does not run for types/services write errors. */
+    onGenerationError?: (error: Error) => void;
 }
 export declare function runFileGeneration(options: RunFileGenerationOptions): Promise<void>;
 //# sourceMappingURL=run-file-generation.d.ts.map

package/dist/core/generation/run-file-generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-file-generation.d.ts","sourceRoot":"","sources":["../../../src/core/generation/run-file-generation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,EAA4C,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgBvG,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAS/E;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;CACH;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFxF"}
+{"version":3,"file":"run-file-generation.d.ts","sourceRoot":"","sources":["../../../src/core/generation/run-file-generation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,EAA4C,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgBvG,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAS/E;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;IACF,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC5C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFxF"}

package/dist/core/generation/run-file-generation.js

@@ -28,6 +28,7 @@ export async function runFileGeneration(options) {
     const logServices = logger?.servicesGenerated ?? (() => { });
     const logInfo = logger?.info ?? (() => { });
     const logWarn = logger?.warn ?? (() => { });
+    const onGenerationError = options.onGenerationError;
     const isTypeScript = isTypeScriptProject(root);
     const srcDir = path.join(root, 'src');
     if (schema.length > 0) {
@@ -81,7 +82,9 @@ export async function runFileGeneration(options) {
             logInfo(`API docs at: ./${path.relative(root, apiDocsPath).replace(/\\/g, '/')} → http://localhost:${serverPort}/api-docs.html`);
         }
         catch (error) {
-            logWarn(`Failed to generate OpenAPI spec: ${error instanceof Error ? error.message : String(error)}`);
+            const err = error instanceof Error ? error : new Error(String(error));
+            logWarn(`Failed to generate OpenAPI spec: ${err.message}`);
+            onGenerationError?.(err);
         }
     }
 }

package/dist/core/introspection/manifest.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedRoute } from '../routing/route-parser.js';
+import type { ParsedSocket } from '../routing/socket-parser.js';
+export interface VitekManifest {
+    routes: Array<{
+        method: string;
+        pattern: string;
+        params: string[];
+        file: string;
+    }>;
+    middlewares: Array<{
+        basePattern: string;
+        path: string;
+    }>;
+    sockets: Array<{
+        pattern: string;
+        params: string[];
+        file: string;
+    }>;
+}
+export declare function getManifest(root: string, apiDir: string): VitekManifest;
+export declare function getRoutes(root: string, apiDir: string): ParsedRoute[];
+export declare function getSockets(root: string, apiDir: string): ParsedSocket[];
+export declare function writeManifest(root: string, apiDir: string, outDir: string): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/introspection/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/introspection/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,WAAW,EAAE,KAAK,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBvE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAIrE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAIvE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAMR"}

package/dist/core/introspection/manifest.js

@@ -0,0 +1,41 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { scanApiDirectory } from '../file-system/scan-api-dir.js';
+export function getManifest(root, apiDir) {
+    const fullApiDir = path.isAbsolute(apiDir) ? apiDir : path.resolve(root, apiDir);
+    const scanResult = scanApiDirectory(fullApiDir);
+    return {
+        routes: scanResult.routes.map((r) => ({
+            method: r.method,
+            pattern: r.pattern,
+            params: r.params,
+            file: path.relative(root, r.file).replace(/\\/g, '/'),
+        })),
+        middlewares: scanResult.middlewares.map((m) => ({
+            basePattern: m.basePattern,
+            path: path.relative(root, m.path).replace(/\\/g, '/'),
+        })),
+        sockets: scanResult.sockets.map((s) => ({
+            pattern: s.pattern,
+            params: s.params,
+            file: path.relative(root, s.file).replace(/\\/g, '/'),
+        })),
+    };
+}
+export function getRoutes(root, apiDir) {
+    const fullApiDir = path.isAbsolute(apiDir) ? apiDir : path.resolve(root, apiDir);
+    const scanResult = scanApiDirectory(fullApiDir);
+    return scanResult.routes;
+}
+export function getSockets(root, apiDir) {
+    const fullApiDir = path.isAbsolute(apiDir) ? apiDir : path.resolve(root, apiDir);
+    const scanResult = scanApiDirectory(fullApiDir);
+    return scanResult.sockets;
+}
+export function writeManifest(root, apiDir, outDir) {
+    const manifest = getManifest(root, apiDir);
+    const manifestPath = path.join(outDir, 'vitek-manifest.json');
+    fs.mkdirSync(outDir, { recursive: true });
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+    return manifestPath;
+}

package/dist/core/introspection/manifest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.test.d.ts.map

package/dist/core/introspection/manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.test.d.ts","sourceRoot":"","sources":["../../../src/core/introspection/manifest.test.ts"],"names":[],"mappings":""}

package/dist/core/introspection/manifest.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import { getManifest, getRoutes, getSockets, writeManifest } from './manifest.js';
+describe('manifest', () => {
+    let rootDir;
+    let apiDir;
+    beforeEach(() => {
+        rootDir = fs.mkdtempSync(path.join(process.cwd(), 'vitek-manifest-test-'));
+        apiDir = path.join(rootDir, 'src', 'api');
+        fs.mkdirSync(apiDir, { recursive: true });
+        fs.writeFileSync(path.join(apiDir, 'health.get.ts'), 'export default () => ({});');
+    });
+    afterEach(() => {
+        try {
+            fs.rmSync(rootDir, { recursive: true });
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    });
+    it('getManifest returns routes, middlewares, sockets', () => {
+        const manifest = getManifest(rootDir, 'src/api');
+        expect(manifest).toHaveProperty('routes');
+        expect(manifest).toHaveProperty('middlewares');
+        expect(manifest).toHaveProperty('sockets');
+        expect(Array.isArray(manifest.routes)).toBe(true);
+        expect(Array.isArray(manifest.middlewares)).toBe(true);
+        expect(Array.isArray(manifest.sockets)).toBe(true);
+        expect(manifest.routes.length).toBeGreaterThan(0);
+    });
+    it('getRoutes returns ParsedRoute[]', () => {
+        const routes = getRoutes(rootDir, 'src/api');
+        expect(Array.isArray(routes)).toBe(true);
+        routes.forEach((r) => {
+            expect(r).toHaveProperty('method');
+            expect(r).toHaveProperty('pattern');
+            expect(r).toHaveProperty('params');
+            expect(r).toHaveProperty('file');
+        });
+    });
+    it('getSockets returns ParsedSocket[]', () => {
+        const sockets = getSockets(rootDir, 'src/api');
+        expect(Array.isArray(sockets)).toBe(true);
+    });
+    it('getManifest with non-existent apiDir returns empty arrays', () => {
+        const manifest = getManifest(rootDir, 'non-existent-dir');
+        expect(manifest.routes).toEqual([]);
+        expect(manifest.middlewares).toEqual([]);
+        expect(manifest.sockets).toEqual([]);
+    });
+    it('writeManifest writes vitek-manifest.json', () => {
+        const outDir = path.join(rootDir, 'dist');
+        const written = writeManifest(rootDir, 'src/api', outDir);
+        expect(written).toBe(path.join(outDir, 'vitek-manifest.json'));
+        expect(fs.existsSync(written)).toBe(true);
+        const content = JSON.parse(fs.readFileSync(written, 'utf-8'));
+        expect(content).toHaveProperty('routes');
+        expect(content).toHaveProperty('middlewares');
+        expect(content).toHaveProperty('sockets');
+    });
+});

package/dist/core/middleware/get-applicable-middlewares.d.ts

@@ -9,7 +9,14 @@ import type { Middleware } from '../routing/route-types.js';
 export interface LoadedMiddleware {
     middleware: Middleware[];
     basePattern: string;
+    /** Optional path matcher for global middleware (basePattern ''). Only routes matching one of these patterns get this middleware. E.g. ['protected/*', 'admin'] */
+    pathPatterns?: string[];
 }
+/**
+ * Returns true if routePattern matches a single path pattern.
+ * Pattern may be exact ('admin') or prefix with * ('admin/*'). No leading slash.
+ */
+export declare function matchPathPattern(routePattern: string, configPattern: string): boolean;
 /**
  * Returns the middlewares applicable to a route, ordered from most generic to most specific
  */

package/dist/core/middleware/get-applicable-middlewares.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-applicable-middlewares.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/get-applicable-middlewares.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAuCD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,YAAY,EAAE,MAAM,GACnB,UAAU,EAAE,CAUd"}
+{"version":3,"file":"get-applicable-middlewares.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/get-applicable-middlewares.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,kKAAkK;IAClK,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAQrF;AA+BD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,YAAY,EAAE,MAAM,GACnB,UAAU,EAAE,CAUd"}

package/dist/core/middleware/get-applicable-middlewares.js

@@ -2,35 +2,43 @@
  * Determines which middlewares are applicable to a route based on the pattern
  * Core logic - no dependencies
  */
+/**
+ * Returns true if routePattern matches a single path pattern.
+ * Pattern may be exact ('admin') or prefix with * ('admin/*'). No leading slash.
+ */
+export function matchPathPattern(routePattern, configPattern) {
+    const route = routePattern.replace(/^\/+|\/+$/g, '');
+    const pattern = configPattern.replace(/^\/+|\/+$/g, '');
+    if (pattern.endsWith('/*')) {
+        const prefix = pattern.slice(0, -2);
+        return route === prefix || route.startsWith(prefix + '/');
+    }
+    return route === pattern || route.startsWith(pattern + '/');
+}
 /**
  * Checks if a middleware base pattern applies to a route pattern
  * A middleware applies if its basePattern is a prefix of the routePattern
- *
- * Examples:
- * - basePattern: "" → applies to all routes (global)
- * - basePattern: "posts" → applies to "posts", "posts/:id", "posts/:id/comments", etc
- * - basePattern: "posts/:id" → applies to "posts/:id", "posts/:id/comments", but not to "posts"
+ * For global middleware (basePattern '') with pathPatterns, applies only if route matches one of them.
  */
-function isMiddlewareApplicable(basePattern, routePattern) {
-    // Global middleware (empty basePattern) applies to all routes
+function isMiddlewareApplicable(loaded, routePattern) {
+    const { basePattern, pathPatterns } = loaded;
+    // Global middleware (empty basePattern)
     if (basePattern === '') {
+        if (pathPatterns != null && pathPatterns.length > 0) {
+            return pathPatterns.some((p) => matchPathPattern(routePattern, p));
+        }
         return true;
     }
     // If route is empty (root), only global middleware applies
     if (routePattern === '') {
         return false;
     }
-    // Normalize patterns for comparison (remove leading/trailing slashes)
     const normalizedBase = basePattern.replace(/^\/+|\/+$/g, '');
     const normalizedRoute = routePattern.replace(/^\/+|\/+$/g, '');
-    // Check if basePattern is an exact prefix of routePattern
-    // Or if route starts with basePattern followed by /
-    if (normalizedRoute === normalizedBase) {
+    if (normalizedRoute === normalizedBase)
         return true;
-    }
-    if (normalizedRoute.startsWith(normalizedBase + '/')) {
+    if (normalizedRoute.startsWith(normalizedBase + '/'))
         return true;
-    }
     return false;
 }
 /**
@@ -39,7 +47,7 @@ function isMiddlewareApplicable(basePattern, routePattern) {
 export function getApplicableMiddlewares(middlewares, routePattern) {
     const applicable = [];
     for (const loadedMiddleware of middlewares) {
-        if (isMiddlewareApplicable(loadedMiddleware.basePattern, routePattern)) {
+        if (isMiddlewareApplicable(loadedMiddleware, routePattern)) {
             applicable.push(...loadedMiddleware.middleware);
         }
     }

package/dist/core/middleware/get-applicable-middlewares.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { getApplicableMiddlewares } from './get-applicable-middlewares.js';
+import { getApplicableMiddlewares, matchPathPattern } from './get-applicable-middlewares.js';
 function noopMiddleware() {
     return async (_ctx, next) => next();
 }
@@ -71,4 +71,39 @@ describe('getApplicableMiddlewares', () => {
         ];
         expect(getApplicableMiddlewares(middlewares, 'posts/1')).toEqual([mw1, mw2]);
     });
+    describe('global middleware with pathPatterns', () => {
+        it('applies only to routes matching pathPatterns when set', () => {
+            const globalMw = noopMiddleware();
+            const middlewares = [
+                { basePattern: '', middleware: [globalMw], pathPatterns: ['protected/*', 'admin'] },
+            ];
+            expect(getApplicableMiddlewares(middlewares, 'protected')).toEqual([globalMw]);
+            expect(getApplicableMiddlewares(middlewares, 'protected/1')).toEqual([globalMw]);
+            expect(getApplicableMiddlewares(middlewares, 'admin')).toEqual([globalMw]);
+            expect(getApplicableMiddlewares(middlewares, 'admin/users')).toEqual([globalMw]);
+            expect(getApplicableMiddlewares(middlewares, 'posts')).toEqual([]);
+            expect(getApplicableMiddlewares(middlewares, 'health')).toEqual([]);
+        });
+        it('global without pathPatterns still applies to all routes', () => {
+            const globalMw = noopMiddleware();
+            const middlewares = [
+                { basePattern: '', middleware: [globalMw] },
+            ];
+            expect(getApplicableMiddlewares(middlewares, 'posts')).toEqual([globalMw]);
+            expect(getApplicableMiddlewares(middlewares, 'any/route')).toEqual([globalMw]);
+        });
+    });
+});
+describe('matchPathPattern', () => {
+    it('matches exact pattern', () => {
+        expect(matchPathPattern('admin', 'admin')).toBe(true);
+        expect(matchPathPattern('admin/users', 'admin')).toBe(true);
+        expect(matchPathPattern('posts', 'admin')).toBe(false);
+    });
+    it('matches glob pattern with /*', () => {
+        expect(matchPathPattern('protected', 'protected/*')).toBe(true);
+        expect(matchPathPattern('protected/1', 'protected/*')).toBe(true);
+        expect(matchPathPattern('protected/1/2', 'protected/*')).toBe(true);
+        expect(matchPathPattern('posts', 'protected/*')).toBe(false);
+    });
 });

package/dist/core/openapi/generate.d.ts

@@ -1,83 +1,7 @@
-/**
- * OpenAPI/Swagger specification generation
- * Core logic - no Vite dependencies
- */
-export type RouteForDocs = {
-    pattern: string;
-    method: string;
-    params: string[];
-    file: string;
-    bodyType?: string;
-    queryType?: string;
-};
-/**
- * OpenAPI Info object
- */
-export interface OpenApiInfo {
-    title: string;
-    version: string;
-    description?: string;
-}
-/**
- * OpenAPI Server object
- */
-export interface OpenApiServer {
-    url: string;
-    description?: string;
-}
-/**
- * OpenAPI specification options
- */
-export interface OpenApiOptions {
-    /** API information. Uses defaults if not provided. */
-    info?: OpenApiInfo;
-    /** Server URLs for the API. Defaults to current URL if not provided. */
-    servers?: OpenApiServer[];
-    /** Base path for API routes. Defaults to "/api". */
-    apiBasePath?: string;
-}
-/**
- * JSDoc metadata extracted from a route file
- */
-export interface RouteMetadata {
-    summary?: string;
-    description?: string;
-    tags?: string[];
-    deprecated?: boolean;
-    responses?: Record<string, ResponseMetadata>;
-    bodyDescription?: string;
-    queryDescription?: string;
-    paramDescriptions?: Record<string, string>;
-}
-/**
- * Response metadata from JSDoc
- */
-export interface ResponseMetadata {
-    description: string;
-    type?: string;
-    example?: unknown;
-}
-/**
- * Generates a complete OpenAPI 3.0 specification
- */
+import { type RouteForDocs, type OpenApiOptions } from './types.js';
+export type { RouteForDocs, OpenApiInfo, OpenApiServer, OpenApiOptions, RouteMetadata, ResponseMetadata, ApiDocsHtmlOptions } from './types.js';
 export declare function generateOpenApiSpec(routes: RouteForDocs[], options: OpenApiOptions): object;
-/**
- * Generates the OpenAPI JSON file
- */
 export declare function generateOpenApiFile(outputPath: string, routes: RouteForDocs[], options: OpenApiOptions): Promise<void>;
-/**
- * Generates Swagger UI HTML
- */
 export declare function generateSwaggerUiHtml(apiJsonPath: string, title?: string): string;
-/**
- * Options for combined API docs (REST + WebSockets)
- */
-export interface ApiDocsHtmlOptions {
-    /** Path to AsyncAPI JSON (e.g. /asyncapi.json). When set, adds WebSockets tab. */
-    asyncApiJsonPath?: string;
-}
-/**
- * Generates combined API documentation HTML with optional REST (Swagger) and WebSockets (AsyncAPI) tabs
- */
-export declare function generateApiDocsHtml(openApiJsonPath: string, title: string, options?: ApiDocsHtmlOptions): string;
+export declare function generateApiDocsHtml(openApiJsonPath: string, title: string, options?: import('./types.js').ApiDocsHtmlOptions): string;
 //# sourceMappingURL=generate.d.ts.map

package/dist/core/openapi/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/core/openapi/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAiB3F;AAgdD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAA4B,GAAG,MAAM,CAwBtG;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAuER"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/core/openapi/generate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1F,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhJ,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAiB3F;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAA4B,GAAG,MAAM,CAwBtG;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,OAAO,YAAY,EAAE,kBAAuB,GACpD,MAAM,CAuER"}