@buenojs/bueno 0.8.5 → 0.8.7

package/dist/modules/index.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Module System
+ *
+ * NestJS-inspired module system with dependency injection,
+ * controllers, and provider management.
+ */
+import { Container, type ForwardRef, type Provider, type Token } from "../container";
+import { Router } from "../router";
+import { type Filter } from "./filters";
+import { type Guard } from "./guards";
+import { type Interceptor } from "./interceptors";
+import { ModuleLoader } from "./lazy";
+import { type ApplicationLifecycle, type BeforeApplicationShutdown, type FullLifecycle, LifecycleHookManager, type OnAfterRequest, type OnApplicationBootstrap, type OnApplicationShutdown, type OnBeforeRequest, type OnModuleDestroy, type OnModuleInit, type OnRequestError, type RequestLifecycle, ShutdownSignalHandler, isBeforeApplicationShutdown, isOnAfterRequest, isOnApplicationBootstrap, isOnApplicationShutdown, isOnBeforeRequest, isOnModuleDestroy, isOnModuleInit, isOnRequestError } from "./lifecycle";
+import { type Pipe } from "./pipes";
+export type Constructor = new (...args: unknown[]) => unknown;
+/**
+ * @deprecated Use individual lifecycle hook interfaces instead.
+ * Kept for backward compatibility.
+ */
+export interface LifecycleHooks {
+    onModuleInit?(): void | Promise<void>;
+    onModuleDestroy?(): void | Promise<void>;
+    onApplicationBootstrap?(): void | Promise<void>;
+    onApplicationShutdown?(): void | Promise<void>;
+}
+import { Controller, Injectable, Module, type ModuleMetadata } from "./metadata";
+export { Injectable, Controller, Module, type ModuleMetadata };
+/**
+ * Inject a dependency by token.
+ * Supports both Token and ForwardRef<Token> for circular dependency resolution.
+ *
+ * @param token - The injection token or a forward reference to the token
+ * @returns A parameter decorator that registers the injection metadata
+ *
+ * @example
+ * ```typescript
+ * // Regular injection
+ * constructor(@Inject(MY_TOKEN) private service: MyService) {}
+ *
+ * // Forward reference for circular dependency
+ * constructor(@Inject(forwardRef(() => ServiceB)) private serviceB: ServiceB) {}
+ * ```
+ */
+export declare function Inject(token: Token | ForwardRef<Token>): ParameterDecorator;
+export declare const Get: (path?: string) => MethodDecorator;
+export declare const Post: (path?: string) => MethodDecorator;
+export declare const Put: (path?: string) => MethodDecorator;
+export declare const Patch: (path?: string) => MethodDecorator;
+export declare const Delete: (path?: string) => MethodDecorator;
+export declare const Head: (path?: string) => MethodDecorator;
+export declare const Options: (path?: string) => MethodDecorator;
+export declare class AppModule {
+    private moduleClass;
+    private metadata;
+    private providers;
+    private controllers;
+    private visitedModules;
+    private lazyModules;
+    constructor(moduleClass: Constructor);
+    /**
+     * Process module and its imports recursively
+     * Skips lazy modules during initial processing
+     */
+    private processModule;
+    /**
+     * Get all collected providers
+     */
+    getProviders(): Provider[];
+    /**
+     * Get all collected controllers
+     */
+    getControllers(): Constructor[];
+    /**
+     * Get all lazy modules that were skipped during initial processing
+     */
+    getLazyModules(): Constructor[];
+}
+export declare class Application {
+    container: Container;
+    router: Router;
+    private appModule;
+    private lifecycleManager;
+    private shutdownHandler;
+    private server;
+    private providerInstances;
+    private controllerInstances;
+    private isInitialized;
+    private isShuttingDown;
+    private globalGuards;
+    private globalPipes;
+    private globalFilters;
+    private globalInterceptors;
+    private routeGuardMetadata;
+    private routePipeMetadata;
+    private routeFilterMetadata;
+    private routeInterceptorMetadata;
+    private moduleLoader;
+    private loadedLazyModules;
+    private websocketHandler;
+    constructor(moduleClass: Constructor);
+    /**
+     * Add global guards that apply to all routes
+     * Global guards run before controller and method guards
+     *
+     * @param guards - Guards to add
+     * @returns this (for chaining)
+     *
+     * @example
+     * ```typescript
+     * const app = createApp(AppModule);
+     * app.useGlobalGuards(AuthGuard);
+     * await app.listen(3000);
+     * ```
+     */
+    useGlobalGuards(...guards: Guard[]): this;
+    /**
+     * Get the list of global guards (live reference).
+     * Used by the GraphQL module to run guards on resolver methods.
+     */
+    getGlobalGuards(): Guard[];
+    /**
+     * Get the list of global interceptors (live reference).
+     * Used by the GraphQL module to run interceptors on resolver methods.
+     */
+    getGlobalInterceptors(): Interceptor[];
+    /**
+     * Register a WebSocket handler to be used when the server starts.
+     * Called by the GraphQL module to enable subscriptions on the same port.
+     *
+     * @example
+     * ```typescript
+     * app.setWebSocketHandler(subscriptionHandler.getWebSocketConfig());
+     * await app.listen(3000);
+     * ```
+     */
+    setWebSocketHandler(handler: Bun.WebSocketHandler<any>): void;
+    /**
+     * Add global pipes that apply to all parameters
+     * Global pipes run before parameter decorator pipes
+     *
+     * @param pipes - Pipes to add
+     * @returns this (for chaining)
+     *
+     * @example
+     * ```typescript
+     * const app = createApp(AppModule);
+     * app.useGlobalPipes(new ValidationPipe());
+     * await app.listen(3000);
+     * ```
+     */
+    useGlobalPipes(...pipes: Pipe[]): this;
+    /**
+     * Add global filters that apply to all routes
+     * Global filters run after controller and method filters
+     *
+     * @param filters - Filters to add
+     * @returns this (for chaining)
+     *
+     * @example
+     * ```typescript
+     * const app = createApp(AppModule);
+     * app.useGlobalFilters(new AllExceptionsFilter());
+     * await app.listen(3000);
+     * ```
+     */
+    useGlobalFilters(...filters: Filter[]): this;
+    /**
+     * Add global interceptors that apply to all routes
+     * Global interceptors run before controller and method interceptors
+     *
+     * @param interceptors - Interceptors to add
+     * @returns this (for chaining)
+     *
+     * @example
+     * ```typescript
+     * const app = createApp(AppModule);
+     * app.useGlobalInterceptors(new LoggingInterceptor());
+     * await app.listen(3000);
+     * ```
+     */
+    useGlobalInterceptors(...interceptors: Interceptor[]): this;
+    /**
+     * Register all providers in the container
+     */
+    private registerProviders;
+    /**
+     * Resolve all providers and register them with lifecycle manager
+     */
+    private resolveProviders;
+    /**
+     * Register all controllers and their routes
+     */
+    private registerControllers;
+    /**
+     * Register a single controller and its routes
+     */
+    private registerController;
+    /**
+     * Initialize the application
+     *
+     * Execution order:
+     * 1. Module Registration
+     * 2. Provider Resolution
+     * 3. onModuleInit() for each provider
+     * 4. Controller Registration
+     * 5. onApplicationBootstrap() for each provider
+     */
+    init(): Promise<void>;
+    /**
+     * Load a lazy module dynamically
+     * This is called by the ModuleLoader service when a lazy module is loaded
+     */
+    private loadLazyModule;
+    /**
+     * Get the ModuleLoader service for loading lazy modules
+     */
+    getModuleLoader(): ModuleLoader;
+    /**
+     * Setup graceful shutdown handlers
+     */
+    private setupShutdownHandlers;
+    /**
+     * Perform graceful shutdown
+     *
+     * Execution order:
+     * 1. Stop accepting new requests
+     * 2. beforeApplicationShutdown(signal)
+     * 3. Drain existing requests
+     * 4. onModuleDestroy() for each provider
+     * 5. onApplicationShutdown(signal)
+     */
+    shutdown(signal?: string): Promise<void>;
+    /**
+     * Start the HTTP server
+     */
+    listen(port?: number, hostname?: string): Promise<void>;
+    /**
+     * Handle request directly (for testing)
+     */
+    handle(request: Request): Promise<Response>;
+    /**
+     * Get the lifecycle manager for this application
+     */
+    getLifecycleManager(): LifecycleHookManager;
+    /**
+     * Check if the application is shutting down
+     */
+    isShuttingDownNow(): boolean;
+    /**
+     * Handle an exception using the filters system
+     * Filters are checked in order: method → class → global
+     */
+    private handleException;
+}
+/**
+ * Create an application from a module
+ */
+export declare function createApp(moduleClass: Constructor): Application;
+export { LifecycleHookManager, ShutdownSignalHandler, type OnModuleInit, type OnApplicationBootstrap, type OnModuleDestroy, type BeforeApplicationShutdown, type OnApplicationShutdown, type OnBeforeRequest, type OnAfterRequest, type OnRequestError, type ApplicationLifecycle, type RequestLifecycle, type FullLifecycle, isOnModuleInit, isOnApplicationBootstrap, isOnModuleDestroy, isBeforeApplicationShutdown, isOnApplicationShutdown, isOnBeforeRequest, isOnAfterRequest, isOnRequestError, };
+export { type CanActivate, type GuardFn, type Guard, type User, UseGuards, AuthGuard, RolesGuard, Roles, getClassGuards, getMethodGuards, getMethodRoles, executeGuards, createForbiddenResponse, } from "./guards";
+export { type PipeTransform, type PipeFn, type Pipe, type PipeContext, type ParameterMetadata, type ParameterPipeMetadata, UsePipes, Body, Query, Param, ValidationPipe, ParseIntPipe, ParseFloatPipe, ParseBoolPipe, DefaultValuePipe, TrimPipe, ParseJsonPipe, ParseArrayPipe, getMethodPipes, executePipes, extractParameterValue, createBadRequestResponse, isPipeTransform, isPipeFn, } from "./pipes";
+export { type ExceptionFilter, type FilterFn, type Filter, type ExecuteFiltersOptions, UseFilters, Catch, getClassFilters, getMethodFilters, getCatchType, canHandleException, isExceptionFilter, isFilterFn, executeFilter, findAndExecuteFilter, HttpExceptionFilter, ValidationFilter, NotFoundFilter, AllExceptionsFilter, createDefaultErrorResponse, createInternalErrorResponse, } from "./filters";
+export { type NestInterceptor, type InterceptorFn, type Interceptor, type CallHandler, type TransformResponse, type InterceptorExecutorOptions, UseInterceptors, LoggingInterceptor, TransformInterceptor, TimeoutInterceptor, CacheInterceptor, HeaderInterceptor, getClassInterceptors, getMethodInterceptors, executeInterceptors, isNestInterceptor, isInterceptorFn, } from "./interceptors";
+export { type LazyModuleLoader, type Constructor as LazyModuleConstructor, type ModuleLoaderFn, type LazyModuleMetadata, type LoadModuleOptions, LazyModuleLoaderImpl, LazyModule, ModuleLoader, MODULE_LOADER_TOKEN, getLazyMetadata, isLazyModule, LazyModuleRegistry, createLazyLoader, areAllLazyModulesLoaded, getUnloadedLazyModules, } from "./lazy";
+export { type ForwardRef, forwardRef, isForwardRef, resolveForwardRef, } from "../container";
+//# sourceMappingURL=index.d.ts.map

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

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