@dangao/bun-server 0.1.2 → 0.1.4

package/dist/swagger/swagger-module.d.ts

@@ -0,0 +1,37 @@
+import type { SwaggerOptions } from './types';
+/**
+ * Swagger 模块配置
+ */
+export interface SwaggerModuleOptions extends SwaggerOptions {
+    /**
+     * Swagger UI 路径
+     * @default '/swagger'
+     */
+    uiPath?: string;
+    /**
+     * Swagger JSON 路径
+     * @default '/swagger.json'
+     */
+    jsonPath?: string;
+    /**
+     * Swagger UI 标题
+     */
+    uiTitle?: string;
+    /**
+     * 是否启用 Swagger UI
+     * @default true
+     */
+    enableUI?: boolean;
+}
+/**
+ * Swagger 模块
+ * 提供 API 文档生成和 Swagger UI
+ */
+export declare class SwaggerModule {
+    /**
+     * 创建 Swagger 模块
+     * @param options - 模块配置
+     */
+    static forRoot(options: SwaggerModuleOptions): typeof SwaggerModule;
+}
+//# sourceMappingURL=swagger-module.d.ts.map

package/dist/swagger/swagger-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger-module.d.ts","sourceRoot":"","sources":["../../src/swagger/swagger-module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,qBAQa,aAAa;IACxB;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,aAAa;CAkC3E"}

package/dist/swagger/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Swagger/OpenAPI 类型定义
+ */
+/**
+ * Swagger 信息配置
+ */
+export interface SwaggerInfo {
+    title: string;
+    version: string;
+    description?: string;
+    contact?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+}
+/**
+ * Swagger 配置
+ */
+export interface SwaggerOptions {
+    info: SwaggerInfo;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    basePath?: string;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+/**
+ * API 操作元数据
+ */
+export interface ApiOperationMetadata {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    deprecated?: boolean;
+}
+/**
+ * API 参数元数据
+ */
+export interface ApiParamMetadata {
+    name: string;
+    description?: string;
+    required?: boolean;
+    schema?: {
+        type?: string;
+        format?: string;
+        enum?: unknown[];
+        default?: unknown;
+    };
+    in: 'query' | 'path' | 'header' | 'cookie';
+}
+/**
+ * API 请求体元数据
+ */
+export interface ApiBodyMetadata {
+    description?: string;
+    required?: boolean;
+    schema?: {
+        type?: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+    examples?: Record<string, unknown>;
+}
+/**
+ * API 响应元数据
+ */
+export interface ApiResponseMetadata {
+    status: number;
+    description?: string;
+    schema?: {
+        type?: string;
+        properties?: Record<string, unknown>;
+    };
+    examples?: Record<string, unknown>;
+}
+/**
+ * API 标签元数据
+ */
+export interface ApiTagMetadata {
+    name: string;
+    description?: string;
+}
+/**
+ * Swagger 路径项
+ */
+export interface SwaggerPathItem {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    parameters?: Array<{
+        name: string;
+        in: 'query' | 'path' | 'header' | 'cookie';
+        description?: string;
+        required?: boolean;
+        schema?: {
+            type?: string;
+            format?: string;
+            enum?: unknown[];
+            default?: unknown;
+        };
+    }>;
+    requestBody?: {
+        description?: string;
+        required?: boolean;
+        content?: {
+            'application/json'?: {
+                schema?: {
+                    type?: string;
+                    properties?: Record<string, unknown>;
+                    required?: string[];
+                };
+                examples?: Record<string, unknown>;
+            };
+        };
+    };
+    responses?: Record<string, {
+        description?: string;
+        content?: {
+            'application/json'?: {
+                schema?: {
+                    type?: string;
+                    properties?: Record<string, unknown>;
+                };
+                examples?: Record<string, unknown>;
+            };
+        };
+    }>;
+    deprecated?: boolean;
+}
+/**
+ * Swagger 文档结构
+ */
+export interface SwaggerDocument {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+        contact?: {
+            name?: string;
+            email?: string;
+            url?: string;
+        };
+        license?: {
+            name: string;
+            url?: string;
+        };
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    paths: Record<string, {
+        get?: SwaggerPathItem;
+        post?: SwaggerPathItem;
+        put?: SwaggerPathItem;
+        delete?: SwaggerPathItem;
+        patch?: SwaggerPathItem;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/swagger/types.ts"],"names":[],"mappings":"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"}

package/dist/swagger/ui.d.ts

@@ -0,0 +1,13 @@
+import type { Middleware } from '../middleware';
+import { SwaggerExtension } from './swagger-extension';
+/**
+ * 创建 Swagger UI 中间件
+ * @param extension - Swagger 扩展实例
+ * @param options - 配置选项
+ */
+export declare function createSwaggerUIMiddleware(extension: SwaggerExtension, options?: {
+    uiPath?: string;
+    jsonPath?: string;
+    title?: string;
+}): Middleware;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAmDvD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,UAAU,CA+BZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",