@engjts/nexus 0.1.0

package/dist/advanced/swagger/swagger.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swagger = swagger;
+const generateSwaggerUI_1 = require("./generateSwaggerUI");
+const generateSpec_1 = require("./generateSpec");
+// ============================================
+// SWAGGER FEATURE (PLUGIN)
+// ============================================
+/**
+ * Create Swagger feature plugin for Nexus
+ *
+ * @example
+ * ```typescript
+ * // Minimal setup - auto-detects everything
+ * app.feature(swagger());
+ *
+ * // With custom info
+ * app.feature(swagger({
+ *   info: {
+ *     title: 'My Awesome API',
+ *     version: '2.0.0',
+ *     description: 'API documentation'
+ *   }
+ * }));
+ *
+ * // Full configuration
+ * app.feature(swagger({
+ *   path: '/api-docs',
+ *   specPath: '/swagger.json',
+ *   theme: 'dark',
+ *   securitySchemes: {
+ *     bearerAuth: {
+ *       type: 'http',
+ *       scheme: 'bearer',
+ *       bearerFormat: 'JWT'
+ *     }
+ *   }
+ * }));
+ * ```
+ */
+function swagger(config = {}) {
+    const resolvedConfig = {
+        path: '/docs',
+        specPath: '/openapi.json',
+        docExpansion: 'list',
+        filter: true,
+        tryItOutEnabled: true,
+        persistAuthorization: true,
+        ...config,
+        info: {
+            title: 'API Documentation',
+            version: '1.0.0',
+            ...config.info
+        }
+    };
+    // Storage for routes - will be populated when app registers routes
+    const routes = [];
+    const schemas = new Map();
+    let serverUrl = '';
+    let appInstance = null;
+    return {
+        name: 'swagger',
+        version: '1.0.0',
+        install(app) {
+            appInstance = app;
+            // Cast to extended interface for swagger-specific properties
+            const swaggerApp = app;
+            // Hook into route registration to capture routes with metadata
+            const originalRoute = app.route.bind(app);
+            const originalGet = app.get.bind(app);
+            const originalPost = app.post.bind(app);
+            const originalPut = app.put.bind(app);
+            const originalDelete = app.delete.bind(app);
+            const originalPatch = app.patch.bind(app);
+            // Override route method to capture metadata
+            app.route = function (routeConfig) {
+                routes.push({
+                    method: routeConfig.method,
+                    path: routeConfig.path,
+                    schema: routeConfig.schema,
+                    meta: routeConfig.meta
+                });
+                return originalRoute(routeConfig);
+            };
+            // Override HTTP method shortcuts
+            const wrapMethod = (method, original) => {
+                return function (pathOrRoute, handlerOrConfig) {
+                    // Class-based routing
+                    if (typeof pathOrRoute === 'object' && 'pathName' in pathOrRoute) {
+                        const route = pathOrRoute;
+                        routes.push({
+                            method,
+                            path: route.pathName,
+                            schema: route.schema?.(),
+                            meta: route.meta?.()
+                        });
+                        return original(pathOrRoute);
+                    }
+                    const path = pathOrRoute;
+                    if (typeof handlerOrConfig !== 'function' && handlerOrConfig) {
+                        routes.push({
+                            method,
+                            path,
+                            schema: handlerOrConfig.schema,
+                            meta: handlerOrConfig.meta
+                        });
+                    }
+                    else {
+                        routes.push({ method, path });
+                    }
+                    return original(path, handlerOrConfig);
+                };
+            };
+            app.get = wrapMethod('GET', originalGet);
+            app.post = wrapMethod('POST', originalPost);
+            app.put = wrapMethod('PUT', originalPut);
+            app.delete = wrapMethod('DELETE', originalDelete);
+            app.patch = wrapMethod('PATCH', originalPatch);
+            // Add swagger endpoints
+            const docsPath = resolvedConfig.path;
+            const specPath = resolvedConfig.specPath;
+            // Serve OpenAPI JSON spec
+            originalGet(specPath, async (ctx) => {
+                // Auto-detect server URL from request
+                if (!serverUrl && ctx.raw?.req) {
+                    const req = ctx.raw.req;
+                    const protocol = req.headers['x-forwarded-proto'] || 'http';
+                    const host = req.headers.host || 'localhost:3000';
+                    serverUrl = `${protocol}://${host}`;
+                }
+                // Combine intercepted routes with routes from router (for file-based routing)
+                const allRoutes = getAllRoutes(routes, appInstance, docsPath, specPath);
+                const spec = (0, generateSpec_1.generateSpec)(allRoutes, schemas, resolvedConfig, serverUrl);
+                return ctx.json(spec);
+            });
+            // Serve Swagger UI
+            originalGet(docsPath, async (_ctx) => {
+                const html = (0, generateSwaggerUI_1.generateSwaggerUI)(resolvedConfig);
+                return {
+                    statusCode: 200,
+                    headers: { 'Content-Type': 'text/html; charset=utf-8' },
+                    body: html
+                };
+            });
+            // Also serve at /docs/ (with trailing slash)
+            originalGet(docsPath + '/', async (_ctx) => {
+                const html = (0, generateSwaggerUI_1.generateSwaggerUI)(resolvedConfig);
+                return {
+                    statusCode: 200,
+                    headers: { 'Content-Type': 'text/html; charset=utf-8' },
+                    body: html
+                };
+            });
+            // Add schema registration method to app
+            swaggerApp.swaggerSchema = (name, schema) => {
+                schemas.set(name, schema);
+                return swaggerApp;
+            };
+            // Log swagger is enabled (check via environment or resolvedConfig)
+            if (process.env.DEBUG === 'true' || process.env.NODE_ENV === 'development') {
+                console.log(`📚 Swagger UI: ${docsPath}`);
+                console.log(`📄 OpenAPI Spec: ${specPath}`);
+            }
+        }
+    };
+}
+/**
+ * Get all routes by combining intercepted routes with routes from the router
+ * This ensures file-based routes are also included in Swagger docs
+ */
+function getAllRoutes(interceptedRoutes, app, docsPath, specPath) {
+    // Create a Set of already tracked route keys (method + path)
+    const trackedKeys = new Set(interceptedRoutes.map(r => `${r.method}:${r.path}`));
+    // Start with intercepted routes (filtered to exclude swagger routes)
+    const allRoutes = interceptedRoutes.filter(r => !r.path.startsWith(docsPath) && r.path !== specPath);
+    // Get routes from router (includes file-based routes)
+    if (app) {
+        const routerRoutes = app.getRoutes();
+        for (const route of routerRoutes) {
+            const key = `${route.method}:${route.path}`;
+            // Skip if already tracked or is swagger route
+            if (trackedKeys.has(key) ||
+                route.path.startsWith(docsPath) ||
+                route.path === specPath) {
+                continue;
+            }
+            allRoutes.push({
+                method: route.method,
+                path: route.path,
+                schema: route.schema,
+                meta: route.meta
+            });
+        }
+    }
+    // Sort routes by path for consistent ordering
+    return allRoutes.sort((a, b) => a.path.localeCompare(b.path));
+}
+//# sourceMappingURL=swagger.js.map

package/dist/advanced/swagger/swagger.js.map

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

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

@@ -0,0 +1,210 @@
+import { Application } from '../../core/application';
+import { HTTPMethod, SchemaConfig, RouteMeta } from '../../core/types';
+/**
+ * Extended Application interface for Swagger plugin
+ */
+export interface SwaggerApplication extends Application {
+    swaggerSchema?: (name: string, schema: OpenAPISchema) => SwaggerApplication;
+    [key: string]: unknown;
+}
+/**
+ * OpenAPI Info object
+ */
+export interface SwaggerInfo {
+    title?: string;
+    version?: string;
+    description?: string;
+    termsOfService?: string;
+    contact?: {
+        name?: string;
+        url?: string;
+        email?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+}
+/**
+ * Custom theme for Swagger UI
+ */
+export interface SwaggerTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    headerColor?: string;
+    textColor?: string;
+    fontFamily?: string;
+}
+/**
+ * Swagger configuration options
+ */
+export interface SwaggerConfig {
+    /** Path to serve Swagger UI (default: /docs) */
+    path?: string;
+    /** Path to serve OpenAPI JSON spec (default: /openapi.json) */
+    specPath?: string;
+    /** API info - auto-detected from package.json if not provided */
+    info?: SwaggerInfo;
+    /** Server URLs - auto-detected if not provided */
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    /** Security schemes */
+    securitySchemes?: Record<string, SecurityScheme>;
+    /** Default security for all routes */
+    security?: Array<Record<string, string[]>>;
+    /** External docs */
+    externalDocs?: {
+        description?: string;
+        url: string;
+    };
+    /** Custom CSS for Swagger UI */
+    customCss?: string;
+    /** Custom favicon URL */
+    favicon?: string;
+    /** Theme: 'light' | 'dark' | custom theme object */
+    theme?: 'light' | 'dark' | SwaggerTheme;
+    /** Tags to group endpoints */
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Hide routes that don't have meta.tags */
+    hideUntagged?: boolean;
+    /** Sort tags alphabetically */
+    sortTags?: boolean;
+    /** Expand operations by default: 'list' | 'full' | 'none' */
+    docExpansion?: 'list' | 'full' | 'none';
+    /** Filter operations by tag */
+    filter?: boolean;
+    /** Try it out enabled by default */
+    tryItOutEnabled?: boolean;
+    /** Persist authorization */
+    persistAuthorization?: boolean;
+}
+/**
+ * Security scheme types
+ */
+export interface SecurityScheme {
+    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+    description?: string;
+    name?: string;
+    in?: 'query' | 'header' | 'cookie';
+    scheme?: string;
+    bearerFormat?: string;
+    flows?: OAuthFlows;
+    openIdConnectUrl?: string;
+}
+export interface OAuthFlows {
+    implicit?: OAuthFlow;
+    password?: OAuthFlow;
+    clientCredentials?: OAuthFlow;
+    authorizationCode?: OAuthFlow;
+}
+export interface OAuthFlow {
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    refreshUrl?: string;
+    scopes: Record<string, string>;
+}
+/**
+ * OpenAPI Schema object
+ */
+export interface OpenAPISchema {
+    type?: string;
+    format?: string;
+    properties?: Record<string, OpenAPISchema>;
+    items?: OpenAPISchema;
+    required?: string[];
+    enum?: any[];
+    description?: string;
+    example?: any;
+    default?: any;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    nullable?: boolean;
+    $ref?: string;
+}
+/**
+ * OpenAPI Operation object
+ */
+export interface OpenAPIOperation {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    parameters?: OpenAPIParameter[];
+    requestBody?: OpenAPIRequestBody;
+    responses: Record<string, OpenAPIResponse>;
+    deprecated?: boolean;
+    security?: Array<Record<string, string[]>>;
+}
+export interface OpenAPIParameter {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    description?: string;
+    required?: boolean;
+    schema: OpenAPISchema;
+    example?: any;
+}
+export interface OpenAPIRequestBody {
+    description?: string;
+    required?: boolean;
+    content: Record<string, {
+        schema: OpenAPISchema;
+        example?: any;
+    }>;
+}
+export interface OpenAPIResponse {
+    description: string;
+    content?: Record<string, {
+        schema: OpenAPISchema;
+        example?: any;
+    }>;
+    headers?: Record<string, {
+        description?: string;
+        schema: OpenAPISchema;
+    }>;
+}
+/**
+ * Full OpenAPI specification
+ */
+export interface OpenAPISpec {
+    openapi: string;
+    info: SwaggerInfo & {
+        title: string;
+        version: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, Record<string, OpenAPIOperation>>;
+    components?: {
+        schemas?: Record<string, OpenAPISchema>;
+        securitySchemes?: Record<string, SecurityScheme>;
+    };
+    security?: Array<Record<string, string[]>>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    externalDocs?: {
+        description?: string;
+        url: string;
+    };
+}
+/**
+ * Internal route storage with full config
+ */
+export interface StoredRoute {
+    method: HTTPMethod;
+    path: string;
+    schema?: SchemaConfig;
+    meta?: RouteMeta;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/advanced/swagger/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/advanced/swagger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/advanced/swagger/types.ts"],"names":[],"mappings":""}

package/dist/advanced/swagger/zodFieldToOpenAPI.d.ts

@@ -0,0 +1,6 @@
+import { OpenAPISchema } from './types';
+/**
+ * Convert individual Zod field to OpenAPI schema
+ */
+export declare function zodFieldToOpenAPI(field: any): OpenAPISchema;
+//# sourceMappingURL=zodFieldToOpenAPI.d.ts.map

package/dist/advanced/swagger/zodFieldToOpenAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodFieldToOpenAPI.d.ts","sourceRoot":"","sources":["../../../src/advanced/swagger/zodFieldToOpenAPI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC;;GAEG;AAGH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,aAAa,CAqF3D"}

package/dist/advanced/swagger/zodFieldToOpenAPI.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodFieldToOpenAPI = zodFieldToOpenAPI;
+const zodSchemaToOpenAPI_1 = require("./zodSchemaToOpenAPI");
+/**
+ * Convert individual Zod field to OpenAPI schema
+ */
+function zodFieldToOpenAPI(field) {
+    if (!field?._def) {
+        return { type: 'string' };
+    }
+    const def = field._def;
+    const typeName = def.typeName;
+    switch (typeName) {
+        case 'ZodString': {
+            const schema = { type: 'string' };
+            // Extract string constraints
+            for (const check of def.checks || []) {
+                if (check.kind === 'email')
+                    schema.format = 'email';
+                if (check.kind === 'url')
+                    schema.format = 'uri';
+                if (check.kind === 'uuid')
+                    schema.format = 'uuid';
+                if (check.kind === 'min')
+                    schema.minLength = check.value;
+                if (check.kind === 'max')
+                    schema.maxLength = check.value;
+                if (check.kind === 'regex')
+                    schema.pattern = check.regex.source;
+            }
+            return schema;
+        }
+        case 'ZodNumber': {
+            const schema = { type: 'number' };
+            // Extract number constraints
+            for (const check of def.checks || []) {
+                if (check.kind === 'int')
+                    schema.type = 'integer';
+                if (check.kind === 'min')
+                    schema.minimum = check.value;
+                if (check.kind === 'max')
+                    schema.maximum = check.value;
+            }
+            return schema;
+        }
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray':
+            return {
+                type: 'array',
+                items: zodFieldToOpenAPI(def.type)
+            };
+        case 'ZodObject':
+            return (0, zodSchemaToOpenAPI_1.zodSchemaToOpenAPI)(field);
+        case 'ZodEnum':
+            return {
+                type: 'string',
+                enum: def.values
+            };
+        case 'ZodOptional':
+        case 'ZodNullable':
+            return zodFieldToOpenAPI(def.innerType);
+        case 'ZodDefault':
+            const innerSchema = zodFieldToOpenAPI(def.innerType);
+            innerSchema.default = def.defaultValue();
+            return innerSchema;
+        case 'ZodLiteral':
+            return {
+                type: typeof def.value === 'number' ? 'number' :
+                    typeof def.value === 'boolean' ? 'boolean' : 'string',
+                enum: [def.value]
+            };
+        case 'ZodUnion':
+            // For simple unions, just use the first type
+            if (def.options?.length > 0) {
+                return zodFieldToOpenAPI(def.options[0]);
+            }
+            return { type: 'string' };
+        case 'ZodDate':
+            return { type: 'string', format: 'date-time' };
+        default:
+            return { type: 'string' };
+    }
+}
+//# sourceMappingURL=zodFieldToOpenAPI.js.map

package/dist/advanced/swagger/zodFieldToOpenAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodFieldToOpenAPI.js","sourceRoot":"","sources":["../../../src/advanced/swagger/zodFieldToOpenAPI.ts"],"names":[],"mappings":";;AAQA,8CAqFC;AA5FD,6DAA0D;AAE1D;;GAEG;AAGH,SAAgB,iBAAiB,CAAC,KAAU;IAC1C,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;IACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAE9B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAEjD,6BAA6B;YAC7B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;oBAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;gBACpD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;gBAChD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBAClD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;gBACzD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;gBACzD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;oBAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;YAClE,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAEjD,6BAA6B;YAC7B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;gBAClD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;gBACvD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;YACzD,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAE7B,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;aACnC,CAAC;QAEJ,KAAK,WAAW;YACd,OAAO,IAAA,uCAAkB,EAAC,KAAK,CAAC,CAAC;QAEnC,KAAK,SAAS;YACZ,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,GAAG,CAAC,MAAM;aACjB,CAAC;QAEJ,KAAK,aAAa,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE1C,KAAK,YAAY;YACf,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACrD,WAAW,CAAC,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;YACzC,OAAO,WAAW,CAAC;QAErB,KAAK,YAAY;YACf,OAAO;gBACL,IAAI,EAAE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAC9C,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;gBACvD,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;aAClB,CAAC;QAEJ,KAAK,UAAU;YACb,6CAA6C;YAC7C,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAE5B,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAEjD;YACE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/advanced/swagger/zodSchemaToOpenAPI.d.ts

@@ -0,0 +1,6 @@
+import { OpenAPISchema } from './types';
+/**
+ * Convert Zod schema to OpenAPI schema
+ */
+export declare function zodSchemaToOpenAPI(zodSchema: any): OpenAPISchema;
+//# sourceMappingURL=zodSchemaToOpenAPI.d.ts.map

package/dist/advanced/swagger/zodSchemaToOpenAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodSchemaToOpenAPI.d.ts","sourceRoot":"","sources":["../../../src/advanced/swagger/zodSchemaToOpenAPI.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKxC;;GAEG;AAGH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,GAAG,GAAG,aAAa,CAsChE"}

package/dist/advanced/swagger/zodSchemaToOpenAPI.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodSchemaToOpenAPI = zodSchemaToOpenAPI;
+const zodFieldToOpenAPI_1 = require("./zodFieldToOpenAPI");
+// ============================================
+// ZOD TO OPENAPI CONVERSION
+// ============================================
+/**
+ * Convert Zod schema to OpenAPI schema
+ */
+function zodSchemaToOpenAPI(zodSchema) {
+    if (!zodSchema) {
+        return { type: 'object' };
+    }
+    // If it's already an OpenAPI schema
+    if (zodSchema.type || zodSchema.$ref) {
+        return zodSchema;
+    }
+    try {
+        const shape = zodSchema._def?.shape?.() || zodSchema.shape;
+        if (shape) {
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = (0, zodFieldToOpenAPI_1.zodFieldToOpenAPI)(value);
+                // Check if field is required
+                const def = value?._def;
+                if (def?.typeName !== 'ZodOptional' && def?.typeName !== 'ZodDefault') {
+                    required.push(key);
+                }
+            }
+            return {
+                type: 'object',
+                properties,
+                required: required.length > 0 ? required : undefined
+            };
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return { type: 'object' };
+}
+//# sourceMappingURL=zodSchemaToOpenAPI.js.map

package/dist/advanced/swagger/zodSchemaToOpenAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodSchemaToOpenAPI.js","sourceRoot":"","sources":["../../../src/advanced/swagger/zodSchemaToOpenAPI.ts"],"names":[],"mappings":";;AAWA,gDAsCC;AAjDD,2DAAwD;AAGxD,+CAA+C;AAC/C,4BAA4B;AAC5B,+CAA+C;AAC/C;;GAEG;AAGH,SAAgB,kBAAkB,CAAC,SAAc;IAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,oCAAoC;IACpC,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,SAAS,CAAC,KAAK,CAAC;QAE3D,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,UAAU,GAAkC,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,GAAG,CAAC,GAAG,IAAA,qCAAiB,EAAC,KAAK,CAAC,CAAC;gBAE3C,6BAA6B;gBAC7B,MAAM,GAAG,GAAI,KAAa,EAAE,IAAI,CAAC;gBACjC,IAAI,GAAG,EAAE,QAAQ,KAAK,aAAa,IAAI,GAAG,EAAE,QAAQ,KAAK,YAAY,EAAE,CAAC;oBACtE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aACrD,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/advanced/swagger/zodToOpenAPI.d.ts

@@ -0,0 +1,6 @@
+import { OpenAPISchema } from './types';
+/**
+ * Extract specific field from Zod schema
+ */
+export declare function zodToOpenAPI(zodSchema: any, fieldName: string): OpenAPISchema | null;
+//# sourceMappingURL=zodToOpenAPI.d.ts.map

package/dist/advanced/swagger/zodToOpenAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToOpenAPI.d.ts","sourceRoot":"","sources":["../../../src/advanced/swagger/zodToOpenAPI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC;;GAEG;AAGH,wBAAgB,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAapF"}

package/dist/advanced/swagger/zodToOpenAPI.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodToOpenAPI = zodToOpenAPI;
+const zodFieldToOpenAPI_1 = require("./zodFieldToOpenAPI");
+/**
+ * Extract specific field from Zod schema
+ */
+function zodToOpenAPI(zodSchema, fieldName) {
+    if (!zodSchema)
+        return null;
+    try {
+        const shape = zodSchema._def?.shape?.() || zodSchema.shape;
+        if (shape && shape[fieldName]) {
+            return (0, zodFieldToOpenAPI_1.zodFieldToOpenAPI)(shape[fieldName]);
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return null;
+}
+//# sourceMappingURL=zodToOpenAPI.js.map

package/dist/advanced/swagger/zodToOpenAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToOpenAPI.js","sourceRoot":"","sources":["../../../src/advanced/swagger/zodToOpenAPI.ts"],"names":[],"mappings":";;AAQA,oCAaC;AApBD,2DAAwD;AAExD;;GAEG;AAGH,SAAgB,YAAY,CAAC,SAAc,EAAE,SAAiB;IAC5D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,SAAS,CAAC,KAAK,CAAC;QAC3D,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAA,qCAAiB,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}