inviton-backduck 1.0.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,302 @@
+# @inviton/backduck
+
+Runtime-agnostic utilities for building web servers with Express and Bun support.
+
+Write your server code once, and it will automatically adapt to the runtime environment (Node.js with Express or Bun native).
+
+## Features
+
+- **Universal Router**: Define routes once, run anywhere
+- **Controller-based routing** with automatic REST mapping
+- **Runtime detection** and automatic adaptation
+- **Type-safe** request/response handling
+- **Middleware support** with chaining
+- **Static file serving** with compression
+- **API Documentation Generation**: Automatic OpenAPI/Swagger and HTML docs from TypeScript controllers
+
+## Installation
+
+```bash
+npm install @inviton/backduck
+```
+
+### Peer Dependencies
+
+Depending on your runtime, install the appropriate peer dependencies:
+
+**For Node.js/Express:**
+```bash
+npm install express
+```
+
+**For Bun:**
+```bash
+# Bun automatically provides bun-types
+```
+
+## Quick Start
+
+### 1. Define a Controller
+
+```typescript
+import { Route, ControllerBase } from '@inviton/backduck';
+
+interface CreateProductArgs {
+  name: string;
+  price: number;
+}
+
+@Route('/products')
+export class ProductController extends ControllerBase {
+  // GET /products
+  async getAll() {
+    return { products: [] };
+  }
+
+  // GET /products/:id
+  async get(args: { id: number }) {
+    return { id: args.id, name: 'Product' };
+  }
+
+  // POST /products
+  async post(args: CreateProductArgs) {
+    return { id: 1, ...args };
+  }
+
+  // PUT /products/:id
+  async put(args: { id: number } & CreateProductArgs) {
+    return { id: args.id, name: args.name, price: args.price };
+  }
+
+  // DELETE /products/:id
+  async delete(args: { id: number }) {
+    return { success: true };
+  }
+}
+```
+
+### 2. Create Router and Register Controllers
+
+```typescript
+import { createRouter } from '@inviton/backduck';
+import { ProductController } from './controllers/ProductController';
+
+const router = createRouter();
+router.registerController(ProductController);
+```
+
+### 3. Create and Start Server
+
+```typescript
+import { createServer } from '@inviton/backduck';
+
+const server = createServer({
+  port: 3000,
+  apiRouters: {
+    '/api': router
+  }
+});
+
+await server.start();
+```
+
+That's it! Your server will automatically use Bun's native server if running under Bun, or Express if running under Node.js.
+
+## API Documentation Generation
+
+Generate OpenAPI/Swagger and HTML documentation from your TypeScript controllers:
+
+### 1. Create Configuration
+
+```typescript
+// apidoc-config.ts
+import type { ApiDocConfig as IApiDocConfig } from '@inviton/backduck';
+
+export const ApiDocConfig: typeof IApiDocConfig = {
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    description: 'API documentation',
+  },
+
+  getSourcePath: (serverDir, apiType) =>
+    path.join(serverDir, 'src', 'api', apiType === 'shopApi' ? 'shop' : 'admin'),
+
+  getOutputPath: (serverDir, format) =>
+    path.join(serverDir, 'docs', format),
+
+  output: {
+    specFilename: 'openapi.json',
+  },
+
+  patterns: {
+    controllerFiles: /Controller\.ts$/,
+  },
+
+  getHttpMethod: (methodName) => {
+    const map: Record<string, string> = {
+      getAll: 'GET',
+      get: 'GET',
+      post: 'POST',
+      put: 'PUT',
+      patch: 'PATCH',
+      delete: 'DELETE',
+    };
+    return map[methodName] || 'GET';
+  },
+
+  getCurrentServerUrl: () => process.env.API_URL || 'http://localhost:3000',
+};
+```
+
+### 2. Generate Documentation
+
+```typescript
+import { ApiDocGenerator } from '@inviton/backduck';
+import { ApiDocConfig } from './apidoc-config';
+
+const result = await ApiDocGenerator.generate({
+  config: ApiDocConfig,
+  serverDir: __dirname,
+  verbose: true,
+});
+
+console.log(`Generated ${result.endpointsCount} endpoints from ${result.controllersCount} controllers`);
+```
+
+## Decorators
+
+### @Route(path: string)
+
+Define the base route path for a controller:
+
+```typescript
+@Route('/users')
+class UserController extends ControllerBase {
+  // Routes will be /users, /users/:id, etc.
+}
+```
+
+### @Middleware(middleware)
+
+Add middleware to a controller or method:
+
+```typescript
+@Route('/admin')
+@Middleware(authMiddleware)
+class AdminController extends ControllerBase {
+  // All methods require authentication
+
+  @Middleware(adminOnlyMiddleware)
+  async delete(args: { id: number }) {
+    // This method requires both auth and admin
+  }
+}
+```
+
+### @ParseRequestArgs(parser)
+
+Custom request argument parsing:
+
+```typescript
+@Route('/search')
+class SearchController extends ControllerBase {
+  @ParseRequestArgs((req) => ({
+    query: req.query.q as string,
+    page: parseInt(req.query.page as string) || 1,
+  }))
+  async get(args: { query: string; page: number }) {
+    return { results: [], page: args.page };
+  }
+}
+```
+
+### @RequestSize(maxSizeInMB)
+
+Set maximum request body size:
+
+```typescript
+@Route('/upload')
+@RequestSize(50) // Allow up to 50MB
+class UploadController extends ControllerBase {
+  async post(args: { file: Buffer }) {
+    // Handle large file upload
+  }
+}
+```
+
+## Runtime Utilities
+
+The `RuntimeUtils` class provides helper methods for request parsing:
+
+```typescript
+import { RuntimeUtils, type WebRequest } from '@inviton/backduck';
+
+// Parse query parameters
+const id = RuntimeUtils.parseQueryNumber(req, 'id');
+const tags = RuntimeUtils.parseQueryStringArray(req, 'tags');
+const active = RuntimeUtils.parseQueryBoolean(req, 'active');
+const filters = RuntimeUtils.parseQueryJSON(req, 'filters');
+
+// Get client IP (handles proxies)
+const ip = RuntimeUtils.getIpAddress(req);
+```
+
+## HTTP Method Mapping
+
+Controller methods are automatically mapped to HTTP methods:
+
+| Method Name | HTTP Method | Route Pattern | Example |
+|------------|-------------|---------------|---------|
+| `getAll()` | GET | `/` | `GET /products` |
+| `get(args)` | GET | `/:id` | `GET /products/123` |
+| `post(args)` | POST | `/` | `POST /products` |
+| `put(args)` | PUT | `/:id` | `PUT /products/123` |
+| `patch(args)` | PATCH | `/:id` | `PATCH /products/123` |
+| `delete(args)` | DELETE | `/:id` | `DELETE /products/123` |
+
+Custom method names can be configured via the `ApiDocConfig.getHttpMethod()` function.
+
+## Static File Serving
+
+Serve static files with automatic compression:
+
+```typescript
+import { createServer } from '@inviton/backduck';
+
+const server = createServer({
+  port: 3000,
+  apiRouters: { '/api': router },
+  staticFiles: [
+    {
+      urlPath: '/assets',
+      fsPath: './public/assets',
+      cacheControl: 'public, max-age=31536000', // 1 year
+    },
+  ],
+});
+```
+
+## Runtime Detection
+
+```typescript
+import { RUNTIME, IS_BUN } from '@inviton/backduck';
+
+if (IS_BUN) {
+  console.log('Running on Bun!');
+} else {
+  console.log('Running on Node.js with Express');
+}
+```
+
+## License
+
+MIT
+
+## Author
+
+Inviton
+
+## Repository
+
+https://github.com/inviton/backduck

package/dist/apidoc/api-doc-generator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * API Documentation Generator
+ * Main class for generating OpenAPI and HTML documentation from TypeScript controllers
+ */
+import type { ApiDocConfig } from './config';
+/**
+ * Options for API documentation generation
+ */
+export interface ApiDocGeneratorOptions {
+    /** Configuration instance implementing ApiDocConfig interface */
+    config: typeof ApiDocConfig;
+    /** Server root directory path */
+    serverDir: string;
+    /** Run in dry-run mode (don't write files) */
+    dryRun?: boolean;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Only generate OpenAPI spec */
+    openApiOnly?: boolean;
+    /** Only generate HTML docs */
+    htmlOnly?: boolean;
+    /** Common type directories to pre-load for faster resolution */
+    commonTypeDirs?: string[];
+}
+/**
+ * Result of API documentation generation
+ */
+export interface ApiDocGenerationResult {
+    /** Number of controllers processed */
+    controllersCount: number;
+    /** Number of endpoints generated */
+    endpointsCount: number;
+    /** Number of unique types resolved */
+    typesCount: number;
+    /** Total generation time in milliseconds */
+    totalTime: number;
+    /** OpenAPI specification (if generated) */
+    openApiSpec?: any;
+    /** HTML documentation (if generated) */
+    htmlDoc?: string;
+}
+/**
+ * API Documentation Generator
+ * Generates OpenAPI and HTML documentation from TypeScript controllers
+ */
+export declare class ApiDocGenerator {
+    /**
+     * Generate API documentation
+     * @param options - Generation options with config and paths
+     * @returns Generation result with statistics
+     */
+    static generate(options: ApiDocGeneratorOptions): Promise<ApiDocGenerationResult>;
+    private static controllerToEndpointData;
+    private static controllerToHtmlEndpointData;
+    private static ensureDir;
+    private static cleanHtmlDir;
+}
+//# sourceMappingURL=api-doc-generator.d.ts.map

package/dist/apidoc/api-doc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-doc-generator.d.ts","sourceRoot":"","sources":["../../src/apidoc/api-doc-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAa7C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,iEAAiE;IACjE,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC3B;;;;OAIG;WACU,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuKvF,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAsBvC,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAsB3C,OAAO,CAAC,MAAM,CAAC,SAAS;IAMxB,OAAO,CAAC,MAAM,CAAC,YAAY;CAY3B"}

package/dist/apidoc/api-doc-generator.js

@@ -0,0 +1,201 @@
+/**
+ * API Documentation Generator
+ * Main class for generating OpenAPI and HTML documentation from TypeScript controllers
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { ControllerParser } from './controller-parser';
+import { HtmlGenerator } from './html-generator';
+import { OpenApiBuilder } from './openapi-builder';
+import { TypeResolver } from './type-resolver';
+/**
+ * API Documentation Generator
+ * Generates OpenAPI and HTML documentation from TypeScript controllers
+ */
+export class ApiDocGenerator {
+    /**
+     * Generate API documentation
+     * @param options - Generation options with config and paths
+     * @returns Generation result with statistics
+     */
+    static async generate(options) {
+        const startTime = performance.now();
+        const { config, serverDir, dryRun = false, verbose = false, openApiOnly = false, htmlOnly = false } = options;
+        // Initialize components
+        const controllerParser = new ControllerParser(serverDir);
+        const typeResolver = new TypeResolver(serverDir);
+        const openApiBuilder = new OpenApiBuilder();
+        const htmlGenerator = new HtmlGenerator();
+        // Pass TypeResolver to ControllerParser for service method JSDoc extraction
+        controllerParser.setTypeResolver(typeResolver);
+        // Pre-load common type definition directories
+        const commonTypeDirs = options.commonTypeDirs || [
+            path.join(serverDir, 'src', 'data'),
+            path.join(serverDir, 'src', 'services', 'types'),
+        ];
+        for (const dir of commonTypeDirs) {
+            if (fs.existsSync(dir)) {
+                const files = fs.readdirSync(dir, { recursive: false })
+                    .filter(f => typeof f === 'string' && f.endsWith('.ts'))
+                    .map(f => path.join(dir, String(f)));
+                for (const file of files) {
+                    try {
+                        typeResolver.addSourceFile(file);
+                    }
+                    catch {
+                        // Ignore errors for files that can't be loaded
+                    }
+                }
+            }
+        }
+        // Discover controllers
+        const controllers = controllerParser.parseAllControllers('shopApi');
+        if (controllers.length === 0) {
+            throw new Error('No controllers found');
+        }
+        // Pre-load all controller source files
+        const sourceFileCache = new Map();
+        for (const controller of controllers) {
+            try {
+                const sourceFile = controllerParser.addSourceFileAtPath(controller.filePath);
+                sourceFileCache.set(controller.filePath, sourceFile);
+                typeResolver.addSourceFile(controller.filePath);
+            }
+            catch {
+                // File might already be loaded or invalid
+            }
+        }
+        // Process endpoints
+        const openApiEndpoints = [];
+        const htmlEndpoints = [];
+        const processedTypes = new Set();
+        const typeCache = new Map();
+        for (const controller of controllers) {
+            const endpointInfo = controllerParser.parseEndpoint(controller.className, 'shopApi');
+            const fullPath = endpointInfo?.fullPath || `/api/shop${controller.routePath}`;
+            const controllerSourceFile = sourceFileCache.get(controller.filePath);
+            for (const method of controller.methods) {
+                // Resolve request type schema with caching
+                let requestSchema;
+                if (method.requestType) {
+                    const cached = typeCache.get(method.requestType);
+                    if (cached) {
+                        requestSchema = cached.schema;
+                    }
+                    else {
+                        const resolvedRequest = typeResolver.resolveType(method.requestType, controllerSourceFile);
+                        if (resolvedRequest) {
+                            requestSchema = typeResolver.typeToOpenApiSchema(resolvedRequest);
+                            processedTypes.add(method.requestType);
+                            typeCache.set(method.requestType, { resolved: resolvedRequest, schema: requestSchema });
+                        }
+                    }
+                }
+                // Resolve response type schema with caching
+                let responseSchema;
+                if (method.responseType) {
+                    const cached = typeCache.get(method.responseType);
+                    if (cached) {
+                        responseSchema = cached.schema;
+                    }
+                    else {
+                        const resolvedResponse = typeResolver.resolveType(method.responseType, controllerSourceFile);
+                        if (resolvedResponse) {
+                            responseSchema = typeResolver.typeToOpenApiSchema(resolvedResponse);
+                            processedTypes.add(method.responseType);
+                            typeCache.set(method.responseType, { resolved: resolvedResponse, schema: responseSchema });
+                        }
+                    }
+                }
+                // Create endpoint data
+                const openApiEndpoint = this.controllerToEndpointData(controller, method, fullPath, requestSchema, responseSchema);
+                const htmlEndpoint = this.controllerToHtmlEndpointData(controller, method, fullPath, requestSchema, responseSchema);
+                openApiEndpoints.push(openApiEndpoint);
+                htmlEndpoints.push(htmlEndpoint);
+            }
+        }
+        // Build documentation
+        const resolvedTypes = typeResolver.getAllResolvedTypes();
+        openApiBuilder.addSchemasFromResolvedTypes(resolvedTypes);
+        htmlGenerator.addSchemas(openApiBuilder.getSchemas());
+        let openApiSpec;
+        let htmlDoc;
+        if (!htmlOnly) {
+            openApiSpec = openApiBuilder.build(openApiEndpoints);
+        }
+        if (!openApiOnly) {
+            htmlDoc = htmlGenerator.generatePage(htmlEndpoints);
+        }
+        // Write files if not dry-run
+        if (!dryRun) {
+            if (openApiSpec) {
+                const swaggerDir = config.getOutputPath(serverDir, 'swagger');
+                this.ensureDir(swaggerDir);
+                fs.writeFileSync(path.join(swaggerDir, config.output.specFilename), JSON.stringify(openApiSpec, null, 2));
+            }
+            if (htmlDoc) {
+                const htmlDir = config.getOutputPath(serverDir, 'html');
+                this.ensureDir(htmlDir);
+                this.cleanHtmlDir(htmlDir);
+                fs.writeFileSync(path.join(htmlDir, 'index.html'), htmlDoc);
+            }
+        }
+        const totalTime = performance.now() - startTime;
+        return {
+            controllersCount: controllers.length,
+            endpointsCount: openApiEndpoints.length,
+            typesCount: processedTypes.size,
+            totalTime,
+            openApiSpec,
+            htmlDoc,
+        };
+    }
+    static controllerToEndpointData(controller, method, fullPath, requestSchema, responseSchema) {
+        return {
+            path: fullPath,
+            method: method.httpMethod,
+            summary: method.serviceDescription || method.description || undefined,
+            description: method.description || undefined,
+            tag: controller.tag || 'default',
+            auth: method.auth || { hasAuth: false },
+            requestSchema,
+            responseSchema,
+            requestTypeName: method.requestType || undefined,
+            responseTypeName: method.responseType || undefined,
+            operationId: `${method.name}_${controller.className}`,
+        };
+    }
+    static controllerToHtmlEndpointData(controller, method, fullPath, requestSchema, responseSchema) {
+        return {
+            path: fullPath,
+            method: method.httpMethod,
+            summary: method.serviceDescription || method.description || undefined,
+            description: method.description || undefined,
+            tag: controller.tag || 'default',
+            auth: method.auth,
+            requestSchema,
+            responseSchema,
+            requestTypeName: method.requestType || undefined,
+            responseTypeName: method.responseType || undefined,
+            operationId: `${method.name}_${controller.className}`,
+        };
+    }
+    static ensureDir(dirPath) {
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
+    static cleanHtmlDir(dirPath) {
+        if (!fs.existsSync(dirPath)) {
+            return;
+        }
+        const files = fs.readdirSync(dirPath);
+        for (const file of files) {
+            if (file.endsWith('.html')) {
+                fs.unlinkSync(path.join(dirPath, file));
+            }
+        }
+    }
+}
+//# sourceMappingURL=api-doc-generator.js.map

package/dist/apidoc/api-doc-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-doc-generator.js","sourceRoot":"","sources":["../../src/apidoc/api-doc-generator.ts"],"names":[],"mappings":"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"}