@engjts/nexus 0.1.0

package/dist/deployment/graceful-shutdown.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Graceful Shutdown Manager
+ * Handles zero-downtime deployment with proper connection draining
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GracefulShutdownManager = void 0;
+exports.createGracefulShutdown = createGracefulShutdown;
+const events_1 = require("events");
+/**
+ * Graceful Shutdown Manager
+ * Ensures zero-downtime deployments by:
+ * 1. Stopping new connections
+ * 2. Waiting for ongoing requests to complete
+ * 3. Running cleanup hooks in order
+ * 4. Closing the server gracefully
+ */
+class GracefulShutdownManager extends events_1.EventEmitter {
+    server;
+    options;
+    isShuttingDown = false;
+    activeConnections = new Map();
+    hooks = [];
+    connectionCounter = 0;
+    shutdownPromise;
+    constructor(options = {}) {
+        super();
+        this.options = {
+            timeout: options.timeout ?? 30000,
+            stopAcceptingConnections: options.stopAcceptingConnections ?? true,
+            signals: options.signals ?? ['SIGTERM', 'SIGINT'],
+            healthCheck: options.healthCheck ?? (async () => ({ status: 'healthy' })),
+            hooks: options.hooks ?? [],
+            onShutdownStart: options.onShutdownStart ?? (() => { }),
+            onShutdownComplete: options.onShutdownComplete ?? (() => { }),
+            verbose: options.verbose ?? false
+        };
+        this.hooks = [...this.options.hooks].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }
+    /**
+     * Attach to an HTTP server
+     */
+    attach(server) {
+        this.server = server;
+        // Register signal handlers
+        for (const signal of this.options.signals) {
+            process.on(signal, () => {
+                this.log(`Received ${signal}, initiating graceful shutdown...`);
+                this.shutdown();
+            });
+        }
+        // Track connections
+        server.on('connection', (socket) => {
+            const connectionId = `conn_${++this.connectionCounter}`;
+            socket.__connectionId = connectionId;
+            socket.on('close', () => {
+                this.activeConnections.delete(connectionId);
+            });
+        });
+        return this;
+    }
+    /**
+     * Register a connection as active (called when request starts)
+     */
+    trackRequest(_connectionId, info) {
+        const requestId = `req_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        this.activeConnections.set(requestId, {
+            id: requestId,
+            startTime: Date.now(),
+            path: info.path,
+            method: info.method
+        });
+        return requestId;
+    }
+    /**
+     * Mark a request as complete
+     */
+    untrackRequest(requestId) {
+        this.activeConnections.delete(requestId);
+    }
+    /**
+     * Add a shutdown hook
+     */
+    addHook(hook) {
+        this.hooks.push(hook);
+        this.hooks.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        return this;
+    }
+    /**
+     * Check if shutdown is in progress
+     */
+    isInShutdown() {
+        return this.isShuttingDown;
+    }
+    /**
+     * Get the current health status
+     */
+    async getHealthStatus() {
+        if (this.isShuttingDown) {
+            return {
+                status: 'draining',
+                details: {
+                    activeConnections: this.activeConnections.size,
+                    shutdownInProgress: true
+                }
+            };
+        }
+        return this.options.healthCheck();
+    }
+    /**
+     * Get active connections count
+     */
+    getActiveConnectionsCount() {
+        return this.activeConnections.size;
+    }
+    /**
+     * Get active connections details
+     */
+    getActiveConnections() {
+        return Array.from(this.activeConnections.values());
+    }
+    /**
+     * Initiate graceful shutdown
+     */
+    async shutdown() {
+        if (this.shutdownPromise) {
+            return this.shutdownPromise;
+        }
+        this.isShuttingDown = true;
+        this.emit('shutdown:start');
+        this.shutdownPromise = this.performShutdown();
+        return this.shutdownPromise;
+    }
+    async performShutdown() {
+        const startTime = Date.now();
+        try {
+            // Notify shutdown start
+            await this.options.onShutdownStart();
+            this.log('Shutdown initiated');
+            // Stop accepting new connections
+            if (this.server && this.options.stopAcceptingConnections) {
+                await this.stopAcceptingConnections();
+            }
+            // Wait for active connections to drain
+            await this.drainConnections();
+            // Run shutdown hooks
+            await this.runHooks();
+            // Close server
+            if (this.server) {
+                await this.closeServer();
+            }
+            const duration = Date.now() - startTime;
+            this.log(`Shutdown completed in ${duration}ms`);
+            await this.options.onShutdownComplete();
+            this.emit('shutdown:complete', { duration });
+        }
+        catch (error) {
+            this.log(`Shutdown error: ${error}`);
+            this.emit('shutdown:error', error);
+            throw error;
+        }
+        finally {
+            // Force exit if still running after timeout
+            setTimeout(() => {
+                this.log('Forcing exit after timeout');
+                process.exit(1);
+            }, 5000).unref();
+            process.exit(0);
+        }
+    }
+    async stopAcceptingConnections() {
+        return new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.on('request', (_req, res) => {
+                // Return 503 for new requests during shutdown
+                res.writeHead(503, {
+                    'Content-Type': 'application/json',
+                    'Connection': 'close',
+                    'Retry-After': '30'
+                });
+                res.end(JSON.stringify({
+                    error: 'Service Unavailable',
+                    message: 'Server is shutting down',
+                    retryAfter: 30
+                }));
+            });
+            this.log('Stopped accepting new connections');
+            resolve();
+        });
+    }
+    async drainConnections() {
+        const startTime = Date.now();
+        const checkInterval = 100; // Check every 100ms
+        this.log(`Waiting for ${this.activeConnections.size} active connections to drain...`);
+        return new Promise((resolve) => {
+            const check = () => {
+                const elapsed = Date.now() - startTime;
+                if (this.activeConnections.size === 0) {
+                    this.log('All connections drained');
+                    resolve();
+                    return;
+                }
+                if (elapsed >= this.options.timeout) {
+                    this.log(`Timeout reached with ${this.activeConnections.size} connections still active`);
+                    // Log remaining connections
+                    for (const conn of this.activeConnections.values()) {
+                        this.log(`  - ${conn.method} ${conn.path} (started ${Date.now() - conn.startTime}ms ago)`);
+                    }
+                    resolve();
+                    return;
+                }
+                setTimeout(check, checkInterval);
+            };
+            check();
+        });
+    }
+    async runHooks() {
+        this.log(`Running ${this.hooks.length} shutdown hooks...`);
+        for (const hook of this.hooks) {
+            const hookTimeout = hook.timeout ?? 10000;
+            const startTime = Date.now();
+            try {
+                this.log(`Running hook: ${hook.name}`);
+                await Promise.race([
+                    hook.handler(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Hook timeout: ${hook.name}`)), hookTimeout))
+                ]);
+                const duration = Date.now() - startTime;
+                this.log(`Hook completed: ${hook.name} (${duration}ms)`);
+            }
+            catch (error) {
+                this.log(`Hook failed: ${hook.name} - ${error.message}`);
+                this.emit('hook:error', { hook: hook.name, error });
+            }
+        }
+    }
+    async closeServer() {
+        return new Promise((resolve, reject) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close((err) => {
+                if (err) {
+                    this.log(`Error closing server: ${err.message}`);
+                    reject(err);
+                }
+                else {
+                    this.log('Server closed');
+                    resolve();
+                }
+            });
+        });
+    }
+    log(message) {
+        if (this.options.verbose) {
+            console.log(`[GracefulShutdown] ${message}`);
+        }
+    }
+}
+exports.GracefulShutdownManager = GracefulShutdownManager;
+/**
+ * Create a graceful shutdown manager
+ */
+function createGracefulShutdown(options) {
+    return new GracefulShutdownManager(options);
+}
+//# sourceMappingURL=graceful-shutdown.js.map

package/dist/deployment/graceful-shutdown.js.map

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

package/dist/deployment/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deployment Module
+ *
+ * Provides production-ready deployment features:
+ * - Graceful shutdown with connection draining
+ * - Multi-process clustering
+ * - Environment-based configuration
+ * - Docker support
+ */
+export { GracefulShutdownManager, createGracefulShutdown, type GracefulShutdownOptions, type ShutdownHook, type ActiveConnection } from './graceful-shutdown';
+export { ClusterManager, createCluster, runClustered, type ClusterOptions, type WorkerInfo, type ClusterStats } from './cluster';
+export { ConfigManager, defineConfig, env, requireEnv, type Environment, type ConfigDefinition, type ConfigOptions, type BaseConfig, type ServerConfig, type DatabaseConfig, type LoggingConfig, type SecurityConfig, type CacheConfig, type SessionConfig } from './config';
+export { DockerGenerator, createDocker, generateDockerFiles, type DockerOptions, type ComposeService, type ComposeConfig } from './docker';
+//# sourceMappingURL=index.d.ts.map

package/dist/deployment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACH,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACH,cAAc,EACd,aAAa,EACb,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACH,aAAa,EACb,YAAY,EACZ,GAAG,EACH,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EACrB,MAAM,UAAU,CAAC"}

package/dist/deployment/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Deployment Module
+ *
+ * Provides production-ready deployment features:
+ * - Graceful shutdown with connection draining
+ * - Multi-process clustering
+ * - Environment-based configuration
+ * - Docker support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDockerFiles = exports.createDocker = exports.DockerGenerator = exports.requireEnv = exports.env = exports.defineConfig = exports.ConfigManager = exports.runClustered = exports.createCluster = exports.ClusterManager = exports.createGracefulShutdown = exports.GracefulShutdownManager = void 0;
+// Graceful Shutdown
+var graceful_shutdown_1 = require("./graceful-shutdown");
+Object.defineProperty(exports, "GracefulShutdownManager", { enumerable: true, get: function () { return graceful_shutdown_1.GracefulShutdownManager; } });
+Object.defineProperty(exports, "createGracefulShutdown", { enumerable: true, get: function () { return graceful_shutdown_1.createGracefulShutdown; } });
+// Clustering
+var cluster_1 = require("./cluster");
+Object.defineProperty(exports, "ClusterManager", { enumerable: true, get: function () { return cluster_1.ClusterManager; } });
+Object.defineProperty(exports, "createCluster", { enumerable: true, get: function () { return cluster_1.createCluster; } });
+Object.defineProperty(exports, "runClustered", { enumerable: true, get: function () { return cluster_1.runClustered; } });
+// Configuration
+var config_1 = require("./config");
+Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return config_1.ConfigManager; } });
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_1.defineConfig; } });
+Object.defineProperty(exports, "env", { enumerable: true, get: function () { return config_1.env; } });
+Object.defineProperty(exports, "requireEnv", { enumerable: true, get: function () { return config_1.requireEnv; } });
+// Docker
+var docker_1 = require("./docker");
+Object.defineProperty(exports, "DockerGenerator", { enumerable: true, get: function () { return docker_1.DockerGenerator; } });
+Object.defineProperty(exports, "createDocker", { enumerable: true, get: function () { return docker_1.createDocker; } });
+Object.defineProperty(exports, "generateDockerFiles", { enumerable: true, get: function () { return docker_1.generateDockerFiles; } });
+//# sourceMappingURL=index.js.map

package/dist/deployment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/deployment/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,oBAAoB;AACpB,yDAM6B;AALzB,4HAAA,uBAAuB,OAAA;AACvB,2HAAA,sBAAsB,OAAA;AAM1B,aAAa;AACb,qCAOmB;AANf,yGAAA,cAAc,OAAA;AACd,wGAAA,aAAa,OAAA;AACb,uGAAA,YAAY,OAAA;AAMhB,gBAAgB;AAChB,mCAekB;AAdd,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA;AACZ,6FAAA,GAAG,OAAA;AACH,oGAAA,UAAU,OAAA;AAad,SAAS;AACT,mCAOkB;AANd,yGAAA,eAAe,OAAA;AACf,sGAAA,YAAY,OAAA;AACZ,6GAAA,mBAAmB,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Nexus Framework - Modern async-first web framework
+ *
+ * Main entry point - exports all public APIs
+ */
+export { Application, createApp } from './core/application';
+export * from './core/types';
+export { Router } from './core/router';
+export { FileRouter, createFileRouter, useFileRoutes } from './core/router/file-router';
+export type { FileRouterOptions, FileRouteClass, RouteModule } from './core/router/file-router';
+export { MiddlewareExecutor, logger, cors, errorHandler } from './core/middleware';
+export { ContextImpl, parseBody } from './core/context';
+export { ContextPool } from './core/context-pool';
+export { ContextStore, RequestStore, StoreRegistry, RequestStoreRegistry, createStoreRegistry, type StoreListener, type DisposeCallback, type StoreConstructor, type StateOf, type StoreOptions, type RequestStoreConstructor, type RequestStateOf } from './core/store';
+export { PluginManager, PluginBuilder, definePlugin, createPlugin, type NexusPlugin, type SimplePlugin, type PluginFactory, type PluginMeta, type PluginContext, type PluginLogger, type PluginPhase, type PluginPriority, type PluginRouteExtension, type RegisteredPlugin } from './core/plugin';
+export { AdapterRegistry, type LoggerAdapter, type CacheAdapter, type SessionAdapter } from './core/adapter';
+export { BufferPool, StreamUtils } from './core/performance/buffer-pool';
+export { MiddlewareOptimizer, PerformanceMonitor } from './core/performance/middleware-optimizer';
+export * from './security';
+export * from './database';
+export { ObservabilityCenter } from './advanced/observability/ObservabilityCenter';
+export { createObservabilityMiddleware } from './advanced/observability/createObservabilityMiddleware';
+export type { ObservabilityOptions } from './advanced/observability/types';
+export { SentryClient, initSentry, getSentry, createSentryMiddleware, createSentryErrorHandler, captureException, captureMessage, addBreadcrumb, setUser, setTag, setExtra, withSpan, } from './advanced/sentry';
+export type { SentryOptions, SentryUser, SentryBreadcrumb, SentryEvent, SentryTransaction, SentrySpan, SentryMiddlewareOptions, SeverityLevel, } from './advanced/sentry/types';
+export { GracefulShutdownManager, createGracefulShutdown, type GracefulShutdownOptions, type ShutdownHook, type ActiveConnection, ClusterManager, createCluster, runClustered, type ClusterOptions, type WorkerInfo, type ClusterStats, ConfigManager, defineConfig, env, requireEnv, type Environment, type ConfigDefinition, type ConfigOptions, type BaseConfig, type ServerConfig, type DatabaseConfig, type LoggingConfig, type SecurityConfig, type CacheConfig, type SessionConfig, DockerGenerator, createDocker, generateDockerFiles, type DockerOptions, type ComposeService, type ComposeConfig } from './deployment';
+export { swagger } from './advanced/swagger/swagger';
+export { SwaggerGenerator } from './advanced/swagger/SwaggerGenerator';
+export { createSwagger } from './advanced/swagger/createSwagger';
+export type { SwaggerConfig, SwaggerInfo, SwaggerTheme, SecurityScheme, OpenAPISpec, OpenAPISchema, OpenAPIOperation, OpenAPIParameter, OpenAPIRequestBody, OpenAPIResponse } from './advanced/swagger/types';
+export type { PostmanConfig, PostmanAuth, PostmanCollection, PostmanEnvironment } from './advanced/postman/types';
+export { postman } from './advanced/postman/postman';
+export { playground, type PlaygroundConfig } from './advanced/playground';
+export { TestClient } from './advanced/testing/harness';
+export { staticFiles } from './advanced/static';
+export { WebSocketGateway, type WebSocketContext, type WebSocketRoute, type WebSocketRouteConfig } from './advanced/realtime/websocket';
+export { MultiTierCache, InMemoryCacheStore, RedisCacheStore, createRedisCache, type CacheStore, type CacheEntry, type CacheSetOptions, type CacheTierConfig, type CacheWrapOptions, type MemoizeOptions, type RedisCacheConfig, type RedisClientLike } from './advanced/cache';
+export { z } from 'zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Nexus Framework - Modern async-first web framework
+ *
+ * Main entry point - exports all public APIs
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireEnv = exports.env = exports.defineConfig = exports.ConfigManager = exports.runClustered = exports.createCluster = exports.ClusterManager = exports.createGracefulShutdown = exports.GracefulShutdownManager = exports.withSpan = exports.setExtra = exports.setTag = exports.setUser = exports.addBreadcrumb = exports.captureMessage = exports.captureException = exports.createSentryErrorHandler = exports.createSentryMiddleware = exports.getSentry = exports.initSentry = exports.SentryClient = exports.createObservabilityMiddleware = exports.ObservabilityCenter = exports.PerformanceMonitor = exports.MiddlewareOptimizer = exports.StreamUtils = exports.BufferPool = exports.AdapterRegistry = exports.createPlugin = exports.definePlugin = exports.PluginBuilder = exports.PluginManager = exports.createStoreRegistry = exports.RequestStoreRegistry = exports.StoreRegistry = exports.RequestStore = exports.ContextStore = exports.ContextPool = exports.parseBody = exports.ContextImpl = exports.errorHandler = exports.cors = exports.logger = exports.MiddlewareExecutor = exports.useFileRoutes = exports.createFileRouter = exports.FileRouter = exports.Router = exports.createApp = exports.Application = void 0;
+exports.z = exports.createRedisCache = exports.RedisCacheStore = exports.InMemoryCacheStore = exports.MultiTierCache = exports.WebSocketGateway = exports.staticFiles = exports.TestClient = exports.playground = exports.postman = exports.createSwagger = exports.SwaggerGenerator = exports.swagger = exports.generateDockerFiles = exports.createDocker = exports.DockerGenerator = void 0;
+// =============================================================================
+// CORE
+// =============================================================================
+// Application
+var application_1 = require("./core/application");
+Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return application_1.Application; } });
+Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return application_1.createApp; } });
+// Core types
+__exportStar(require("./core/types"), exports);
+// Router
+var router_1 = require("./core/router");
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_1.Router; } });
+// File-Based Router (Next.js style)
+var file_router_1 = require("./core/router/file-router");
+Object.defineProperty(exports, "FileRouter", { enumerable: true, get: function () { return file_router_1.FileRouter; } });
+Object.defineProperty(exports, "createFileRouter", { enumerable: true, get: function () { return file_router_1.createFileRouter; } });
+Object.defineProperty(exports, "useFileRoutes", { enumerable: true, get: function () { return file_router_1.useFileRoutes; } });
+// Middleware
+var middleware_1 = require("./core/middleware");
+Object.defineProperty(exports, "MiddlewareExecutor", { enumerable: true, get: function () { return middleware_1.MiddlewareExecutor; } });
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return middleware_1.logger; } });
+Object.defineProperty(exports, "cors", { enumerable: true, get: function () { return middleware_1.cors; } });
+Object.defineProperty(exports, "errorHandler", { enumerable: true, get: function () { return middleware_1.errorHandler; } });
+// Context
+var context_1 = require("./core/context");
+Object.defineProperty(exports, "ContextImpl", { enumerable: true, get: function () { return context_1.ContextImpl; } });
+Object.defineProperty(exports, "parseBody", { enumerable: true, get: function () { return context_1.parseBody; } });
+var context_pool_1 = require("./core/context-pool");
+Object.defineProperty(exports, "ContextPool", { enumerable: true, get: function () { return context_pool_1.ContextPool; } });
+// =============================================================================
+// STATE MANAGEMENT
+// =============================================================================
+// ContextStore - Global singleton stores
+// RequestStore - Per-request scoped stores
+var store_1 = require("./core/store");
+Object.defineProperty(exports, "ContextStore", { enumerable: true, get: function () { return store_1.ContextStore; } });
+Object.defineProperty(exports, "RequestStore", { enumerable: true, get: function () { return store_1.RequestStore; } });
+Object.defineProperty(exports, "StoreRegistry", { enumerable: true, get: function () { return store_1.StoreRegistry; } });
+Object.defineProperty(exports, "RequestStoreRegistry", { enumerable: true, get: function () { return store_1.RequestStoreRegistry; } });
+Object.defineProperty(exports, "createStoreRegistry", { enumerable: true, get: function () { return store_1.createStoreRegistry; } });
+// =============================================================================
+// PLUGIN SYSTEM
+// =============================================================================
+var plugin_1 = require("./core/plugin");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugin_1.PluginManager; } });
+Object.defineProperty(exports, "PluginBuilder", { enumerable: true, get: function () { return plugin_1.PluginBuilder; } });
+Object.defineProperty(exports, "definePlugin", { enumerable: true, get: function () { return plugin_1.definePlugin; } });
+Object.defineProperty(exports, "createPlugin", { enumerable: true, get: function () { return plugin_1.createPlugin; } });
+// =============================================================================
+// ADAPTERS
+// =============================================================================
+var adapter_1 = require("./core/adapter");
+Object.defineProperty(exports, "AdapterRegistry", { enumerable: true, get: function () { return adapter_1.AdapterRegistry; } });
+// =============================================================================
+// PERFORMANCE
+// =============================================================================
+var buffer_pool_1 = require("./core/performance/buffer-pool");
+Object.defineProperty(exports, "BufferPool", { enumerable: true, get: function () { return buffer_pool_1.BufferPool; } });
+Object.defineProperty(exports, "StreamUtils", { enumerable: true, get: function () { return buffer_pool_1.StreamUtils; } });
+var middleware_optimizer_1 = require("./core/performance/middleware-optimizer");
+Object.defineProperty(exports, "MiddlewareOptimizer", { enumerable: true, get: function () { return middleware_optimizer_1.MiddlewareOptimizer; } });
+Object.defineProperty(exports, "PerformanceMonitor", { enumerable: true, get: function () { return middleware_optimizer_1.PerformanceMonitor; } });
+// =============================================================================
+// SECURITY
+// =============================================================================
+__exportStar(require("./security"), exports);
+// =============================================================================
+// DATABASE
+// =============================================================================
+__exportStar(require("./database"), exports);
+// =============================================================================
+// OBSERVABILITY & MONITORING
+// =============================================================================
+var ObservabilityCenter_1 = require("./advanced/observability/ObservabilityCenter");
+Object.defineProperty(exports, "ObservabilityCenter", { enumerable: true, get: function () { return ObservabilityCenter_1.ObservabilityCenter; } });
+var createObservabilityMiddleware_1 = require("./advanced/observability/createObservabilityMiddleware");
+Object.defineProperty(exports, "createObservabilityMiddleware", { enumerable: true, get: function () { return createObservabilityMiddleware_1.createObservabilityMiddleware; } });
+// Sentry Integration
+var sentry_1 = require("./advanced/sentry");
+Object.defineProperty(exports, "SentryClient", { enumerable: true, get: function () { return sentry_1.SentryClient; } });
+Object.defineProperty(exports, "initSentry", { enumerable: true, get: function () { return sentry_1.initSentry; } });
+Object.defineProperty(exports, "getSentry", { enumerable: true, get: function () { return sentry_1.getSentry; } });
+Object.defineProperty(exports, "createSentryMiddleware", { enumerable: true, get: function () { return sentry_1.createSentryMiddleware; } });
+Object.defineProperty(exports, "createSentryErrorHandler", { enumerable: true, get: function () { return sentry_1.createSentryErrorHandler; } });
+Object.defineProperty(exports, "captureException", { enumerable: true, get: function () { return sentry_1.captureException; } });
+Object.defineProperty(exports, "captureMessage", { enumerable: true, get: function () { return sentry_1.captureMessage; } });
+Object.defineProperty(exports, "addBreadcrumb", { enumerable: true, get: function () { return sentry_1.addBreadcrumb; } });
+Object.defineProperty(exports, "setUser", { enumerable: true, get: function () { return sentry_1.setUser; } });
+Object.defineProperty(exports, "setTag", { enumerable: true, get: function () { return sentry_1.setTag; } });
+Object.defineProperty(exports, "setExtra", { enumerable: true, get: function () { return sentry_1.setExtra; } });
+Object.defineProperty(exports, "withSpan", { enumerable: true, get: function () { return sentry_1.withSpan; } });
+// =============================================================================
+// DEPLOYMENT & PRODUCTION
+// =============================================================================
+var deployment_1 = require("./deployment");
+// Graceful Shutdown
+Object.defineProperty(exports, "GracefulShutdownManager", { enumerable: true, get: function () { return deployment_1.GracefulShutdownManager; } });
+Object.defineProperty(exports, "createGracefulShutdown", { enumerable: true, get: function () { return deployment_1.createGracefulShutdown; } });
+// Clustering
+Object.defineProperty(exports, "ClusterManager", { enumerable: true, get: function () { return deployment_1.ClusterManager; } });
+Object.defineProperty(exports, "createCluster", { enumerable: true, get: function () { return deployment_1.createCluster; } });
+Object.defineProperty(exports, "runClustered", { enumerable: true, get: function () { return deployment_1.runClustered; } });
+// Configuration
+Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return deployment_1.ConfigManager; } });
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return deployment_1.defineConfig; } });
+Object.defineProperty(exports, "env", { enumerable: true, get: function () { return deployment_1.env; } });
+Object.defineProperty(exports, "requireEnv", { enumerable: true, get: function () { return deployment_1.requireEnv; } });
+// Docker
+Object.defineProperty(exports, "DockerGenerator", { enumerable: true, get: function () { return deployment_1.DockerGenerator; } });
+Object.defineProperty(exports, "createDocker", { enumerable: true, get: function () { return deployment_1.createDocker; } });
+Object.defineProperty(exports, "generateDockerFiles", { enumerable: true, get: function () { return deployment_1.generateDockerFiles; } });
+// =============================================================================
+// API DOCUMENTATION & TESTING
+// =============================================================================
+// Swagger
+var swagger_1 = require("./advanced/swagger/swagger");
+Object.defineProperty(exports, "swagger", { enumerable: true, get: function () { return swagger_1.swagger; } });
+var SwaggerGenerator_1 = require("./advanced/swagger/SwaggerGenerator");
+Object.defineProperty(exports, "SwaggerGenerator", { enumerable: true, get: function () { return SwaggerGenerator_1.SwaggerGenerator; } });
+var createSwagger_1 = require("./advanced/swagger/createSwagger");
+Object.defineProperty(exports, "createSwagger", { enumerable: true, get: function () { return createSwagger_1.createSwagger; } });
+var postman_1 = require("./advanced/postman/postman");
+Object.defineProperty(exports, "postman", { enumerable: true, get: function () { return postman_1.postman; } });
+// API Playground
+var playground_1 = require("./advanced/playground");
+Object.defineProperty(exports, "playground", { enumerable: true, get: function () { return playground_1.playground; } });
+// Testing Utilities
+var harness_1 = require("./advanced/testing/harness");
+Object.defineProperty(exports, "TestClient", { enumerable: true, get: function () { return harness_1.TestClient; } });
+// =============================================================================
+// ADVANCED FEATURES
+// =============================================================================
+// Static File Serving
+var static_1 = require("./advanced/static");
+Object.defineProperty(exports, "staticFiles", { enumerable: true, get: function () { return static_1.staticFiles; } });
+// WebSocket / Realtime
+var websocket_1 = require("./advanced/realtime/websocket");
+Object.defineProperty(exports, "WebSocketGateway", { enumerable: true, get: function () { return websocket_1.WebSocketGateway; } });
+// Cache System
+var cache_1 = require("./advanced/cache");
+Object.defineProperty(exports, "MultiTierCache", { enumerable: true, get: function () { return cache_1.MultiTierCache; } });
+Object.defineProperty(exports, "InMemoryCacheStore", { enumerable: true, get: function () { return cache_1.InMemoryCacheStore; } });
+Object.defineProperty(exports, "RedisCacheStore", { enumerable: true, get: function () { return cache_1.RedisCacheStore; } });
+Object.defineProperty(exports, "createRedisCache", { enumerable: true, get: function () { return cache_1.createRedisCache; } });
+// =============================================================================
+// UTILITIES
+// =============================================================================
+// Re-export Zod for convenience
+var zod_1 = require("zod");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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