@veloxts/core 0.2.0 → 0.3.0

package/dist/app.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Main VeloxTS application class
+ * Provides Fastify wrapper with plugin system and lifecycle management
+ * @module app
+ */
+import { type FastifyInstance } from 'fastify';
+import type { PluginOptions, VeloxPlugin } from './plugin.js';
+import type { ShutdownHandler } from './types.js';
+import type { FrozenVeloxAppConfig, VeloxAppConfig } from './utils/config.js';
+/**
+ * Main VeloxTS application instance
+ *
+ * Wraps Fastify with additional features:
+ * - Type-safe plugin system
+ * - Request-scoped context
+ * - Graceful shutdown handling
+ * - Lifecycle management
+ *
+ * @example
+ * ```typescript
+ * const app = await createVeloxApp({
+ *   port: 3210,
+ *   logger: true
+ * });
+ *
+ * await app.register(myPlugin);
+ * await app.start();
+ * ```
+ */
+export declare class VeloxApp {
+    private readonly _server;
+    private readonly _config;
+    private readonly _lifecycle;
+    private _isRunning;
+    private _address;
+    /**
+     * Creates a new VeloxApp instance
+     *
+     * @param config - Application configuration
+     * @internal
+     */
+    constructor(config: VeloxAppConfig);
+    /**
+     * Underlying Fastify server instance
+     *
+     * Provides direct access to Fastify for advanced usage.
+     * Most users won't need this - use VeloxApp methods instead.
+     *
+     * @example
+     * ```typescript
+     * // Access Fastify decorators
+     * app.server.hasDecorator('db');
+     *
+     * // Use Fastify hooks directly
+     * app.server.addHook('onRequest', async (request, reply) => {
+     *   console.log('Request received:', request.url);
+     * });
+     * ```
+     */
+    get server(): FastifyInstance;
+    /**
+     * Application configuration (readonly, frozen)
+     */
+    get config(): FrozenVeloxAppConfig;
+    /**
+     * Check if server is currently running
+     */
+    get isRunning(): boolean;
+    /**
+     * Server address (host:port) if running, null otherwise
+     */
+    get address(): string | null;
+    /**
+     * Async initialization (called by factory function)
+     *
+     * @internal - This method is public for factory access but should not be called directly.
+     * Use createVeloxApp() instead.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Sets up request context decorator
+     *
+     * Adds `request.context` property to all requests via onRequest hook
+     *
+     * @internal
+     */
+    private _setupContext;
+    /**
+     * Sets up global error handling
+     *
+     * Ensures VeloxErrors are serialized with proper status codes
+     *
+     * @internal
+     */
+    private _setupErrorHandling;
+    /**
+     * Sets up graceful shutdown handlers for process signals
+     *
+     * @internal
+     */
+    private _setupGracefulShutdown;
+    /**
+     * Registers a plugin with the application
+     *
+     * Plugins must be registered before calling `start()`
+     *
+     * @template Options - Type of options the plugin accepts
+     * @param plugin - Plugin to register
+     * @param options - Options to pass to the plugin
+     * @throws {VeloxError} If plugin metadata is invalid
+     *
+     * @example
+     * ```typescript
+     * await app.use(databasePlugin, {
+     *   connectionString: 'postgresql://...'
+     * });
+     * ```
+     */
+    use<Options extends PluginOptions>(plugin: VeloxPlugin<Options>, options?: Options): Promise<void>;
+    /**
+     * Registers routes with the application
+     *
+     * This is a convenience method that passes the Fastify server
+     * to a route registration function. Designed to work seamlessly
+     * with @veloxts/router's registerRestRoutes.
+     *
+     * Routes must be registered before calling `start()`.
+     *
+     * @param registrar - Function that registers routes on the server
+     *
+     * @example
+     * ```typescript
+     * import { registerRestRoutes } from '@veloxts/router';
+     *
+     * // Fluent registration
+     * app.routes((server) => {
+     *   registerRestRoutes(server, [userProcedures, postProcedures], { prefix: '/api' });
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Or with the helper from @veloxts/router
+     * import { createRoutesRegistrar } from '@veloxts/router';
+     *
+     * app.routes(createRoutesRegistrar([users, posts], { prefix: '/api' }));
+     * ```
+     */
+    routes(registrar: (server: FastifyInstance) => void): this;
+    /**
+     * Starts the server and begins listening for requests
+     *
+     * @throws {VeloxError} If server is already running or fails to start
+     *
+     * @example
+     * ```typescript
+     * await app.start();
+     * console.log(`Server listening on ${app.address}`);
+     * ```
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the server gracefully
+     *
+     * - Stops accepting new requests
+     * - Waits for in-flight requests to complete
+     * - Executes shutdown handlers
+     * - Closes the server
+     *
+     * @throws {VeloxError} If server is not running or fails to stop
+     *
+     * @example
+     * ```typescript
+     * await app.stop();
+     * console.log('Server stopped');
+     * ```
+     */
+    stop(): Promise<void>;
+    /**
+     * Adds a shutdown handler
+     *
+     * Shutdown handlers are called when the server stops, either via `stop()`
+     * or when receiving SIGINT/SIGTERM signals
+     *
+     * @param handler - Async function to call during shutdown
+     *
+     * @example
+     * ```typescript
+     * app.onShutdown(async () => {
+     *   await database.disconnect();
+     *   console.log('Database connection closed');
+     * });
+     * ```
+     */
+    onShutdown(handler: ShutdownHandler): void;
+}
+/**
+ * Creates a new VeloxTS application instance
+ *
+ * This is the main entry point for creating a VeloxTS app.
+ * The function is async to allow for async initialization.
+ *
+ * @param config - Application configuration
+ * @returns Promise resolving to VeloxApp instance
+ *
+ * @example
+ * ```typescript
+ * const app = await createVeloxApp({
+ *   port: 3210,
+ *   host: '0.0.0.0',
+ *   logger: true
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With default configuration
+ * const app = await createVeloxApp();
+ * await app.start(); // Listens on port 3210
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom Fastify options
+ * const app = await createVeloxApp({
+ *   port: 4000,
+ *   fastify: {
+ *     requestTimeout: 30000,
+ *     bodyLimit: 1048576 * 10, // 10MB
+ *   }
+ * });
+ * ```
+ */
+export declare function createVeloxApp(config?: VeloxAppConfig): Promise<VeloxApp>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAgB,EAAE,KAAK,eAAe,EAA6B,MAAM,SAAS,CAAC;AAKnF,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAuB;IAEvC;;;;;OAKG;gBACS,MAAM,EAAE,cAAc;IA4BlC;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAWrB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;;;;;;;;;;;;;;OAgBG;IACG,GAAG,CAAC,OAAO,SAAS,aAAa,EACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAK1D;;;;;;;;;;OAUG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;;;;;;;;;;;;;;OAeG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;CAG3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,cAAc,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAInF"}

package/dist/app.js

@@ -0,0 +1,380 @@
+/**
+ * Main VeloxTS application class
+ * Provides Fastify wrapper with plugin system and lifecycle management
+ * @module app
+ */
+import fastify from 'fastify';
+import fp from 'fastify-plugin';
+import { createContext } from './context.js';
+import { isVeloxError, VeloxError } from './errors.js';
+import { validatePluginMetadata } from './plugin.js';
+import { mergeConfig, validateConfig } from './utils/config.js';
+import { LifecycleManager } from './utils/lifecycle.js';
+/**
+ * Main VeloxTS application instance
+ *
+ * Wraps Fastify with additional features:
+ * - Type-safe plugin system
+ * - Request-scoped context
+ * - Graceful shutdown handling
+ * - Lifecycle management
+ *
+ * @example
+ * ```typescript
+ * const app = await createVeloxApp({
+ *   port: 3210,
+ *   logger: true
+ * });
+ *
+ * await app.register(myPlugin);
+ * await app.start();
+ * ```
+ */
+export class VeloxApp {
+    _server;
+    _config;
+    _lifecycle;
+    _isRunning = false;
+    _address = null;
+    /**
+     * Creates a new VeloxApp instance
+     *
+     * @param config - Application configuration
+     * @internal
+     */
+    constructor(config) {
+        // Merge user config with defaults and validate
+        const merged = mergeConfig(config);
+        // Validate and freeze configuration
+        this._config = validateConfig(merged);
+        // Create Fastify instance
+        const fastifyOptions = {
+            logger: this._config.logger,
+            ...this._config.fastify,
+        };
+        this._server = fastify(fastifyOptions);
+        // Initialize lifecycle manager
+        this._lifecycle = new LifecycleManager();
+        // Set up context decorator
+        this._setupContext();
+        // Set up error handling
+        this._setupErrorHandling();
+        // Set up graceful shutdown
+        this._setupGracefulShutdown();
+    }
+    /**
+     * Underlying Fastify server instance
+     *
+     * Provides direct access to Fastify for advanced usage.
+     * Most users won't need this - use VeloxApp methods instead.
+     *
+     * @example
+     * ```typescript
+     * // Access Fastify decorators
+     * app.server.hasDecorator('db');
+     *
+     * // Use Fastify hooks directly
+     * app.server.addHook('onRequest', async (request, reply) => {
+     *   console.log('Request received:', request.url);
+     * });
+     * ```
+     */
+    get server() {
+        return this._server;
+    }
+    /**
+     * Application configuration (readonly, frozen)
+     */
+    get config() {
+        return this._config;
+    }
+    /**
+     * Check if server is currently running
+     */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * Server address (host:port) if running, null otherwise
+     */
+    get address() {
+        return this._address;
+    }
+    /**
+     * Async initialization (called by factory function)
+     *
+     * @internal - This method is public for factory access but should not be called directly.
+     * Use createVeloxApp() instead.
+     */
+    async initialize() {
+        // Keep empty - ready() must be called in start() after plugins are registered
+        // This is a Fastify constraint: plugins must be registered before ready()
+    }
+    /**
+     * Sets up request context decorator
+     *
+     * Adds `request.context` property to all requests via onRequest hook
+     *
+     * @internal
+     */
+    _setupContext() {
+        // Create context for each request via direct assignment
+        // TypeScript's declaration merging provides type safety
+        this._server.addHook('onRequest', async (request, reply) => {
+            // Direct assignment is ~100-400ns faster than Object.defineProperty
+            // We use a mutable type assertion here because this is the framework's
+            // initialization code - the readonly constraint is for user code safety
+            request.context = createContext(request, reply);
+        });
+    }
+    /**
+     * Sets up global error handling
+     *
+     * Ensures VeloxErrors are serialized with proper status codes
+     *
+     * @internal
+     */
+    _setupErrorHandling() {
+        this._server.setErrorHandler(async (error, request, reply) => {
+            try {
+                // Only log server errors (5xx), not client errors (4xx)
+                const statusCode = isVeloxError(error)
+                    ? error.statusCode
+                    : typeof error === 'object' && error !== null && 'statusCode' in error
+                        ? error.statusCode
+                        : 500;
+                if (statusCode >= 500) {
+                    request.log.error(error);
+                }
+                // Handle VeloxError instances (fast path - most common case)
+                if (isVeloxError(error)) {
+                    return reply.status(error.statusCode).send(error.toJSON());
+                }
+                // Handle other errors
+                const message = error instanceof Error ? error.message : 'Internal Server Error';
+                const name = error instanceof Error ? error.name : 'Error';
+                return reply.status(statusCode).send({
+                    error: name,
+                    message,
+                    statusCode,
+                });
+            }
+            catch (handlerError) {
+                // Last resort error handling - prevents unhandled rejections
+                console.error('Critical error in error handler:', handlerError);
+                if (!reply.sent) {
+                    return reply.status(500).send({
+                        error: 'InternalServerError',
+                        message: 'Internal Server Error',
+                        statusCode: 500,
+                    });
+                }
+            }
+        });
+    }
+    /**
+     * Sets up graceful shutdown handlers for process signals
+     *
+     * @internal
+     */
+    _setupGracefulShutdown() {
+        this._lifecycle.setupSignalHandlers(async () => {
+            await this.stop();
+        });
+    }
+    /**
+     * Registers a plugin with the application
+     *
+     * Plugins must be registered before calling `start()`
+     *
+     * @template Options - Type of options the plugin accepts
+     * @param plugin - Plugin to register
+     * @param options - Options to pass to the plugin
+     * @throws {VeloxError} If plugin metadata is invalid
+     *
+     * @example
+     * ```typescript
+     * await app.use(databasePlugin, {
+     *   connectionString: 'postgresql://...'
+     * });
+     * ```
+     */
+    async use(plugin, options) {
+        // Validate plugin metadata
+        validatePluginMetadata(plugin);
+        // Wrap plugin with fastify-plugin for proper encapsulation
+        const wrappedPlugin = fp(plugin.register, {
+            name: plugin.name,
+            dependencies: plugin.dependencies,
+            fastify: '5.x',
+        });
+        // Register with Fastify
+        try {
+            await this._server.register(wrappedPlugin, options ?? {});
+        }
+        catch (error) {
+            throw new VeloxError(`Failed to register plugin "${plugin.name}": ${error instanceof Error ? error.message : String(error)}`, 500, 'PLUGIN_REGISTRATION_ERROR');
+        }
+    }
+    /**
+     * Registers routes with the application
+     *
+     * This is a convenience method that passes the Fastify server
+     * to a route registration function. Designed to work seamlessly
+     * with @veloxts/router's registerRestRoutes.
+     *
+     * Routes must be registered before calling `start()`.
+     *
+     * @param registrar - Function that registers routes on the server
+     *
+     * @example
+     * ```typescript
+     * import { registerRestRoutes } from '@veloxts/router';
+     *
+     * // Fluent registration
+     * app.routes((server) => {
+     *   registerRestRoutes(server, [userProcedures, postProcedures], { prefix: '/api' });
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Or with the helper from @veloxts/router
+     * import { createRoutesRegistrar } from '@veloxts/router';
+     *
+     * app.routes(createRoutesRegistrar([users, posts], { prefix: '/api' }));
+     * ```
+     */
+    routes(registrar) {
+        registrar(this._server);
+        return this;
+    }
+    /**
+     * Starts the server and begins listening for requests
+     *
+     * @throws {VeloxError} If server is already running or fails to start
+     *
+     * @example
+     * ```typescript
+     * await app.start();
+     * console.log(`Server listening on ${app.address}`);
+     * ```
+     */
+    async start() {
+        if (this._isRunning) {
+            throw new VeloxError('Server is already running', 500, 'SERVER_ALREADY_RUNNING');
+        }
+        try {
+            // Ensure Fastify is ready before listening (must be after plugin registration)
+            await this._server.ready();
+            // Start listening
+            const address = await this._server.listen({
+                port: this._config.port,
+                host: this._config.host,
+            });
+            this._isRunning = true;
+            this._address = address;
+            this._server.log.info(`Server listening on ${address}`);
+        }
+        catch (error) {
+            throw new VeloxError(`Failed to start server: ${error instanceof Error ? error.message : String(error)}`, 500, 'SERVER_START_ERROR');
+        }
+    }
+    /**
+     * Stops the server gracefully
+     *
+     * - Stops accepting new requests
+     * - Waits for in-flight requests to complete
+     * - Executes shutdown handlers
+     * - Closes the server
+     *
+     * @throws {VeloxError} If server is not running or fails to stop
+     *
+     * @example
+     * ```typescript
+     * await app.stop();
+     * console.log('Server stopped');
+     * ```
+     */
+    async stop() {
+        if (!this._isRunning) {
+            throw new VeloxError('Server is not running', 500, 'SERVER_NOT_RUNNING');
+        }
+        try {
+            // Execute shutdown handlers
+            await this._lifecycle.executeShutdownHandlers();
+            // Clean up signal handlers to prevent memory leaks in tests
+            this._lifecycle.cleanupSignalHandlers();
+            // Close server
+            await this._server.close();
+            this._isRunning = false;
+            this._address = null;
+            this._server.log.info('Server stopped');
+        }
+        catch (error) {
+            throw new VeloxError(`Failed to stop server: ${error instanceof Error ? error.message : String(error)}`, 500, 'SERVER_STOP_ERROR');
+        }
+    }
+    /**
+     * Adds a shutdown handler
+     *
+     * Shutdown handlers are called when the server stops, either via `stop()`
+     * or when receiving SIGINT/SIGTERM signals
+     *
+     * @param handler - Async function to call during shutdown
+     *
+     * @example
+     * ```typescript
+     * app.onShutdown(async () => {
+     *   await database.disconnect();
+     *   console.log('Database connection closed');
+     * });
+     * ```
+     */
+    onShutdown(handler) {
+        this._lifecycle.addShutdownHandler(handler);
+    }
+}
+/**
+ * Creates a new VeloxTS application instance
+ *
+ * This is the main entry point for creating a VeloxTS app.
+ * The function is async to allow for async initialization.
+ *
+ * @param config - Application configuration
+ * @returns Promise resolving to VeloxApp instance
+ *
+ * @example
+ * ```typescript
+ * const app = await createVeloxApp({
+ *   port: 3210,
+ *   host: '0.0.0.0',
+ *   logger: true
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With default configuration
+ * const app = await createVeloxApp();
+ * await app.start(); // Listens on port 3210
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom Fastify options
+ * const app = await createVeloxApp({
+ *   port: 4000,
+ *   fastify: {
+ *     requestTimeout: 30000,
+ *     bodyLimit: 1048576 * 10, // 10MB
+ *   }
+ * });
+ * ```
+ */
+export async function createVeloxApp(config = {}) {
+    const app = new VeloxApp(config);
+    await app.initialize();
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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