@navios/core 0.5.1 → 0.7.0

package/src/logger/utils/cli-colors.util.d.mts

@@ -0,0 +1,10 @@
+export declare const clc: {
+    bold: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    red: (text: string) => string;
+    magentaBright: (text: string) => string;
+    cyanBright: (text: string) => string;
+};
+export declare const yellow: (text: string) => string;
+//# sourceMappingURL=cli-colors.util.d.mts.map

package/src/logger/utils/cli-colors.util.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-colors.util.d.mts","sourceRoot":"","sources":["cli-colors.util.mts"],"names":[],"mappings":"AAMA,eAAO,MAAM,GAAG;iBAHwC,MAAM;kBAAN,MAAM;mBAAN,MAAM;gBAAN,MAAM;0BAAN,MAAM;uBAAN,MAAM;CAU7D,CAAA;AACD,eAAO,MAAM,MAAM,SAXqC,MAAM,WAa7D,CAAA"}

package/src/logger/utils/filter-log-levelts.util.d.mts

@@ -0,0 +1,6 @@
+import type { LogLevel } from '../log-levels.mjs';
+/**
+ * @publicApi
+ */
+export declare function filterLogLevels(parseableString?: string): LogLevel[];
+//# sourceMappingURL=filter-log-levelts.util.d.mts.map

package/src/logger/utils/filter-log-levelts.util.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-log-levelts.util.d.mts","sourceRoot":"","sources":["filter-log-levelts.util.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAKjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,eAAe,SAAK,GAAG,QAAQ,EAAE,CAoBhE"}

package/src/logger/utils/index.d.mts

@@ -0,0 +1,6 @@
+export * from './cli-colors.util.mjs';
+export * from './filter-log-levelts.util.mjs';
+export * from './is-log-level.util.mjs';
+export * from './is-log-level-enabled.mjs';
+export * from './shared.utils.mjs';
+//# sourceMappingURL=index.d.mts.map

package/src/logger/utils/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA"}

package/src/logger/utils/is-log-level-enabled.d.mts

@@ -0,0 +1,8 @@
+import type { LogLevel } from '../log-levels.mjs';
+/**
+ * Checks if target level is enabled.
+ * @param targetLevel target level
+ * @param logLevels array of enabled log levels
+ */
+export declare function isLogLevelEnabled(targetLevel: LogLevel, logLevels: LogLevel[] | undefined): boolean;
+//# sourceMappingURL=is-log-level-enabled.d.mts.map

package/src/logger/utils/is-log-level-enabled.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-log-level-enabled.d.mts","sourceRoot":"","sources":["is-log-level-enabled.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAWjD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,QAAQ,EACrB,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,GAChC,OAAO,CAaT"}

package/src/logger/utils/is-log-level.util.d.mts

@@ -0,0 +1,6 @@
+import type { LogLevel } from '../log-levels.mjs';
+/**
+ * @publicApi
+ */
+export declare function isLogLevel(maybeLogLevel: any): maybeLogLevel is LogLevel;
+//# sourceMappingURL=is-log-level.util.d.mts.map

package/src/logger/utils/is-log-level.util.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-log-level.util.d.mts","sourceRoot":"","sources":["is-log-level.util.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIjD;;GAEG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,GAAG,GAAG,aAAa,IAAI,QAAQ,CAExE"}

package/src/logger/utils/shared.utils.d.mts

@@ -0,0 +1,14 @@
+export declare const isUndefined: (obj: any) => obj is undefined;
+export declare const isObject: (fn: any) => fn is object;
+export declare const isPlainObject: (fn: any) => fn is object;
+export declare const addLeadingSlash: (path?: string) => string;
+export declare const normalizePath: (path?: string) => string;
+export declare const stripEndSlash: (path: string) => string;
+export declare const isFunction: (val: any) => val is Function;
+export declare const isString: (val: any) => val is string;
+export declare const isNumber: (val: any) => val is number;
+export declare const isConstructor: (val: any) => boolean;
+export declare const isNil: (val: any) => val is null | undefined;
+export declare const isEmpty: (array: any) => boolean;
+export declare const isSymbol: (val: any) => val is symbol;
+//# sourceMappingURL=shared.utils.d.mts.map

package/src/logger/utils/shared.utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.utils.d.mts","sourceRoot":"","sources":["shared.utils.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,SAClB,CAAA;AAE5B,eAAO,MAAM,QAAQ,GAAI,IAAI,GAAG,KAAG,EAAE,IAAI,MACH,CAAA;AAEtC,eAAO,MAAM,aAAa,GAAI,IAAI,GAAG,KAAG,EAAE,IAAI,MAiB7C,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAKxC,CAAA;AAER,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAKrC,CAAA;AAET,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,WAC6B,CAAA;AAEvE,eAAO,MAAM,UAAU,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,QAClB,CAAA;AAC3B,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,MAAiC,CAAA;AAC5E,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,MAAiC,CAAA;AAC5E,eAAO,MAAM,aAAa,GAAI,KAAK,GAAG,KAAG,OAAgC,CAAA;AACzE,eAAO,MAAM,KAAK,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,IAAI,GAAG,SACb,CAAA;AAClC,eAAO,MAAM,OAAO,GAAI,OAAO,GAAG,KAAG,OAAuC,CAAA;AAC5E,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,MAAiC,CAAA"}

package/src/metadata/controller.metadata.d.mts

@@ -0,0 +1,13 @@
+import type { ClassType, ClassTypeWithInstance, InjectionToken } from '@navios/di';
+import type { CanActivate } from '../interfaces/index.mjs';
+import type { HandlerMetadata } from './handler.metadata.mjs';
+export declare const ControllerMetadataKey: unique symbol;
+export interface ControllerMetadata {
+    endpoints: Set<HandlerMetadata>;
+    guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
+    customAttributes: Map<string | symbol, any>;
+}
+export declare function getControllerMetadata(target: ClassType, context: ClassDecoratorContext): ControllerMetadata;
+export declare function extractControllerMetadata(target: ClassType): ControllerMetadata;
+export declare function hasControllerMetadata(target: ClassType): boolean;
+//# sourceMappingURL=controller.metadata.d.mts.map

package/src/metadata/controller.metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.metadata.d.mts","sourceRoot":"","sources":["controller.metadata.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,eAAO,MAAM,qBAAqB,eAAkC,CAAA;AAEpE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC/B,MAAM,EAAE,GAAG,CACT,qBAAqB,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAC5E,CAAA;IACD,gBAAgB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,qBAAqB,GAC7B,kBAAkB,CAwBpB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,GAChB,kBAAkB,CAWpB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAMhE"}

package/src/metadata/handler.metadata.d.mts

@@ -0,0 +1,18 @@
+import type { HttpMethod } from '@navios/builder';
+import type { ClassTypeWithInstance, InjectionToken } from '@navios/di';
+import type { AbstractHttpHandlerAdapterInterface, CanActivate, HttpHeader } from '../interfaces/index.mjs';
+export declare const EndpointMetadataKey: unique symbol;
+export interface HandlerMetadata<Config = null> {
+    classMethod: string;
+    url: string;
+    successStatusCode: number;
+    adapterToken: InjectionToken<AbstractHttpHandlerAdapterInterface, undefined> | ClassTypeWithInstance<AbstractHttpHandlerAdapterInterface> | null;
+    headers: Partial<Record<HttpHeader, number | string | string[] | undefined>>;
+    httpMethod: HttpMethod;
+    config: Config;
+    guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
+    customAttributes: Map<string | symbol, any>;
+}
+export declare function getAllEndpointMetadata(context: ClassMethodDecoratorContext | ClassDecoratorContext): Set<HandlerMetadata<any>>;
+export declare function getEndpointMetadata<Config = any>(target: Function, context: ClassMethodDecoratorContext): HandlerMetadata<Config>;
+//# sourceMappingURL=handler.metadata.d.mts.map

package/src/metadata/handler.metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.metadata.d.mts","sourceRoot":"","sources":["handler.metadata.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEvE,OAAO,KAAK,EACV,mCAAmC,EACnC,WAAW,EACX,UAAU,EACX,MAAM,yBAAyB,CAAA;AAEhC,eAAO,MAAM,mBAAmB,eAAgC,CAAA;AAEhE,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,IAAI;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EACR,cAAc,CAAC,mCAAmC,EAAE,SAAS,CAAC,GAC9D,qBAAqB,CAAC,mCAAmC,CAAC,GAC1D,IAAI,CAAA;IACR,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAA;IAC5E,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,GAAG,CACT,qBAAqB,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAC5E,CAAA;IACD,gBAAgB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5C;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,2BAA2B,GAAG,qBAAqB,GAC3D,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAa3B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAG,GAAG,EAC9C,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,2BAA2B,GACnC,eAAe,CAAC,MAAM,CAAC,CA+BzB"}

package/src/metadata/index.d.mts

@@ -0,0 +1,4 @@
+export * from './controller.metadata.mjs';
+export * from './handler.metadata.mjs';
+export * from './module.metadata.mjs';
+//# sourceMappingURL=index.d.mts.map

package/src/metadata/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA"}

package/src/metadata/module.metadata.d.mts

@@ -0,0 +1,13 @@
+import type { ClassType, ClassTypeWithInstance, InjectionToken } from '@navios/di';
+import type { CanActivate } from '../index.mjs';
+export declare const ModuleMetadataKey: unique symbol;
+export interface ModuleMetadata {
+    controllers: Set<ClassType>;
+    imports: Set<ClassType>;
+    guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
+    customAttributes: Map<string | symbol, any>;
+}
+export declare function getModuleMetadata(target: ClassType, context: ClassDecoratorContext): ModuleMetadata;
+export declare function extractModuleMetadata(target: ClassType): ModuleMetadata;
+export declare function hasModuleMetadata(target: ClassType): boolean;
+//# sourceMappingURL=module.metadata.d.mts.map

package/src/metadata/module.metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.metadata.d.mts","sourceRoot":"","sources":["module.metadata.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,eAAO,MAAM,iBAAiB,eAAkC,CAAA;AAEhE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IAC3B,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACvB,MAAM,EAAE,GAAG,CACT,qBAAqB,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAC5E,CAAA;IACD,gBAAgB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAwBhB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CASvE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAG5D"}

package/src/navios.application.d.mts

@@ -0,0 +1,210 @@
+import type { ClassTypeWithInstance } from '@navios/di';
+import { Container } from '@navios/di';
+import type { AbstractHttpListenOptions, NaviosModule } from './interfaces/index.mjs';
+import type { LoggerService, LogLevel } from './logger/index.mjs';
+import type { NaviosEnvironmentOptions } from './navios.environment.mjs';
+/**
+ * Options for configuring the Navios application context.
+ * These options control dependency injection and logging behavior.
+ */
+export interface NaviosApplicationContextOptions {
+    /**
+     * Specifies the logger to use. Pass `false` to turn off logging.
+     *
+     * - `LoggerService` instance: Use a custom logger implementation
+     * - `LogLevel[]`: Enable specific log levels (e.g., ['error', 'warn', 'log'])
+     * - `false`: Disable logging completely
+     */
+    logger?: LoggerService | LogLevel[] | false;
+    /**
+     * Specifies a custom container to use. Useful for testing.
+     * If not provided, a new Container will be created.
+     */
+    container?: Container;
+}
+/**
+ * Complete options for creating a Navios application.
+ * Extends NaviosApplicationContextOptions with adapter configuration.
+ */
+export interface NaviosApplicationOptions extends NaviosApplicationContextOptions {
+    /**
+     * HTTP adapter environment(s) to use for the application.
+     * Can be a single adapter or an array of adapters.
+     *
+     * @example
+     * ```typescript
+     * adapter: defineFastifyEnvironment()
+     * // or
+     * adapter: [defineFastifyEnvironment(), defineBunEnvironment()]
+     * ```
+     */
+    adapter: NaviosEnvironmentOptions | NaviosEnvironmentOptions[];
+}
+/**
+ * Main application class for Navios.
+ *
+ * This class represents a Navios application instance and provides methods
+ * for initializing, configuring, and managing the HTTP server.
+ *
+ * @example
+ * ```typescript
+ * const app = await NaviosFactory.create(AppModule, {
+ *   adapter: defineFastifyEnvironment(),
+ * })
+ *
+ * app.setGlobalPrefix('/api')
+ * app.enableCors({ origin: ['http://localhost:3000'] })
+ * await app.init()
+ * await app.listen({ port: 3000, host: '0.0.0.0' })
+ * ```
+ */
+export declare class NaviosApplication {
+    private environment;
+    private moduleLoader;
+    private httpApplication;
+    private logger;
+    protected container: Container;
+    private appModule;
+    private options;
+    /**
+     * Indicates whether the application has been initialized.
+     * Set to `true` after `init()` completes successfully.
+     */
+    isInitialized: boolean;
+    /**
+     * Sets up the application with the provided module and options.
+     * This is called automatically by NaviosFactory.create().
+     *
+     * @param appModule - The root application module
+     * @param options - Application configuration options
+     * @internal
+     */
+    setup(appModule: ClassTypeWithInstance<NaviosModule>, options?: NaviosApplicationOptions): Promise<void>;
+    /**
+     * Gets the dependency injection container used by this application.
+     *
+     * @returns The Container instance
+     */
+    getContainer(): Container;
+    /**
+     * Initializes the application.
+     *
+     * This method:
+     * - Loads all modules and their dependencies
+     * - Sets up the HTTP server if an adapter is configured
+     * - Calls onModuleInit hooks on all modules
+     * - Marks the application as initialized
+     *
+     * Must be called before `listen()`.
+     *
+     * @throws Error if app module is not set
+     *
+     * @example
+     * ```typescript
+     * const app = await NaviosFactory.create(AppModule, {
+     *   adapter: defineFastifyEnvironment(),
+     * })
+     * await app.init()
+     * await app.listen({ port: 3000 })
+     * ```
+     */
+    init(): Promise<void>;
+    private initModules;
+    /**
+     * Enables CORS (Cross-Origin Resource Sharing) for the application.
+     *
+     * @param options - CORS configuration options (adapter-specific)
+     * @throws Error if HTTP application is not set
+     *
+     * @example
+     * ```typescript
+     * app.enableCors({
+     *   origin: ['http://localhost:3000', 'https://example.com'],
+     *   methods: ['GET', 'POST', 'PUT', 'DELETE'],
+     *   credentials: true,
+     * })
+     * ```
+     */
+    enableCors(options: any): void;
+    /**
+     * Enables multipart/form-data support for file uploads.
+     *
+     * @param options - Multipart configuration options (adapter-specific)
+     * @throws Error if HTTP application is not set
+     *
+     * @example
+     * ```typescript
+     * app.enableMultipart({
+     *   limits: {
+     *     fileSize: 1024 * 1024 * 10, // 10MB
+     *   },
+     * })
+     * ```
+     */
+    enableMultipart(options: any): void;
+    /**
+     * Sets a global prefix for all routes.
+     *
+     * @param prefix - The prefix to prepend to all route URLs (e.g., '/api')
+     * @throws Error if HTTP application is not set
+     *
+     * @example
+     * ```typescript
+     * app.setGlobalPrefix('/api/v1')
+     * // All routes will be prefixed with /api/v1
+     * ```
+     */
+    setGlobalPrefix(prefix: string): void;
+    /**
+     * Gets the underlying HTTP server instance.
+     *
+     * The type of the returned server depends on the adapter used:
+     * - Fastify adapter: Returns FastifyInstance
+     * - Bun adapter: Returns Bun.Server
+     *
+     * @returns The HTTP server instance
+     * @throws Error if HTTP application is not set
+     *
+     * @example
+     * ```typescript
+     * const server = app.getServer()
+     * // Use adapter-specific server methods
+     * ```
+     */
+    getServer(): any;
+    /**
+     * Starts the HTTP server and begins listening for requests.
+     *
+     * @param options - Listen options (port, host, etc.)
+     * @throws Error if HTTP application is not set
+     *
+     * @example
+     * ```typescript
+     * await app.listen({ port: 3000, host: '0.0.0.0' })
+     * ```
+     */
+    listen(options: AbstractHttpListenOptions): Promise<void>;
+    /**
+     * Disposes of application resources.
+     *
+     * Cleans up the HTTP server and module loader.
+     * This method is called automatically by `close()`.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Closes the application and cleans up all resources.
+     *
+     * This is an alias for `dispose()`.
+     *
+     * @example
+     * ```typescript
+     * // Graceful shutdown
+     * process.on('SIGTERM', async () => {
+     *   await app.close()
+     *   process.exit(0)
+     * })
+     * ```
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=navios.application.d.mts.map

package/src/navios.application.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navios.application.d.mts","sourceRoot":"","sources":["navios.application.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAsB,MAAM,YAAY,CAAA;AAE1D,OAAO,KAAK,EAEV,yBAAyB,EACzB,YAAY,EACb,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAOxE;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAA;IAE3C;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,wBACf,SAAQ,+BAA+B;IACvC;;;;;;;;;;OAUG;IACH,OAAO,EAAE,wBAAwB,GAAG,wBAAwB,EAAE,CAAA;CAC/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,MAAM,CAEZ;IACF,SAAS,CAAC,SAAS,YAAoB;IAEvC,OAAO,CAAC,SAAS,CAAmD;IACpE,OAAO,CAAC,OAAO,CAEd;IAED;;;OAGG;IACH,aAAa,UAAQ;IAErB;;;;;;;OAOG;IACG,KAAK,CACT,SAAS,EAAE,qBAAqB,CAAC,YAAY,CAAC,EAC9C,OAAO,GAAE,wBAER;IASH;;;;OAIG;IACH,YAAY;IAIZ;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,IAAI;YAiBI,WAAW;IAKzB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,OAAO,EAAE,GAAG;IAOvB;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,OAAO,EAAE,GAAG;IAO5B;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM;IAO9B;;;;;;;;;;;;;;;OAeG;IACH,SAAS;IAOT;;;;;;;;;;OAUG;IACG,MAAM,CAAC,OAAO,EAAE,yBAAyB;IAO/C;;;;;OAKG;IACG,OAAO;IASb;;;;;;;;;;;;;OAaG;IACG,KAAK;CAGZ"}

package/src/navios.application.mts

@@ -15,19 +15,65 @@ import { Logger } from './logger/index.mjs'
 import { NaviosEnvironment } from './navios.environment.mjs'
 import { ModuleLoaderService } from './services/index.mjs'
 
+/**
+ * Options for configuring the Navios application context.
+ * These options control dependency injection and logging behavior.
+ */
 export interface NaviosApplicationContextOptions {
   /**
-   * Specifies the logger to use.  Pass `false` to turn off logging.
+   * Specifies the logger to use. Pass `false` to turn off logging.
+   * 
+   * - `LoggerService` instance: Use a custom logger implementation
+   * - `LogLevel[]`: Enable specific log levels (e.g., ['error', 'warn', 'log'])
+   * - `false`: Disable logging completely
    */
   logger?: LoggerService | LogLevel[] | false
+
+  /**
+   * Specifies a custom container to use. Useful for testing.
+   * If not provided, a new Container will be created.
+   */
+  container?: Container
 }
 
+/**
+ * Complete options for creating a Navios application.
+ * Extends NaviosApplicationContextOptions with adapter configuration.
+ */
 export interface NaviosApplicationOptions
   extends NaviosApplicationContextOptions {
-  // Fastify server options will be handled by FastifyApplicationService
+  /**
+   * HTTP adapter environment(s) to use for the application.
+   * Can be a single adapter or an array of adapters.
+   * 
+   * @example
+   * ```typescript
+   * adapter: defineFastifyEnvironment()
+   * // or
+   * adapter: [defineFastifyEnvironment(), defineBunEnvironment()]
+   * ```
+   */
   adapter: NaviosEnvironmentOptions | NaviosEnvironmentOptions[]
 }
 
+/**
+ * Main application class for Navios.
+ * 
+ * This class represents a Navios application instance and provides methods
+ * for initializing, configuring, and managing the HTTP server.
+ * 
+ * @example
+ * ```typescript
+ * const app = await NaviosFactory.create(AppModule, {
+ *   adapter: defineFastifyEnvironment(),
+ * })
+ * 
+ * app.setGlobalPrefix('/api')
+ * app.enableCors({ origin: ['http://localhost:3000'] })
+ * await app.init()
+ * await app.listen({ port: 3000, host: '0.0.0.0' })
+ * ```
+ */
 @Injectable()
 export class NaviosApplication {
   private environment = inject(NaviosEnvironment)
@@ -43,8 +89,20 @@ export class NaviosApplication {
     adapter: [],
   }
 
+  /**
+   * Indicates whether the application has been initialized.
+   * Set to `true` after `init()` completes successfully.
+   */
   isInitialized = false
 
+  /**
+   * Sets up the application with the provided module and options.
+   * This is called automatically by NaviosFactory.create().
+   * 
+   * @param appModule - The root application module
+   * @param options - Application configuration options
+   * @internal
+   */
   async setup(
     appModule: ClassTypeWithInstance<NaviosModule>,
     options: NaviosApplicationOptions = {
@@ -58,10 +116,37 @@ export class NaviosApplication {
     }
   }
 
+  /**
+   * Gets the dependency injection container used by this application.
+   * 
+   * @returns The Container instance
+   */
   getContainer() {
     return this.container
   }
 
+  /**
+   * Initializes the application.
+   * 
+   * This method:
+   * - Loads all modules and their dependencies
+   * - Sets up the HTTP server if an adapter is configured
+   * - Calls onModuleInit hooks on all modules
+   * - Marks the application as initialized
+   * 
+   * Must be called before `listen()`.
+   * 
+   * @throws Error if app module is not set
+   * 
+   * @example
+   * ```typescript
+   * const app = await NaviosFactory.create(AppModule, {
+   *   adapter: defineFastifyEnvironment(),
+   * })
+   * await app.init()
+   * await app.listen({ port: 3000 })
+   * ```
+   */
   async init() {
     if (!this.appModule) {
       throw new Error('App module is not set. Call setAppModule() first.')
@@ -84,6 +169,21 @@ export class NaviosApplication {
     await this.httpApplication?.onModulesInit(modules)
   }
 
+  /**
+   * Enables CORS (Cross-Origin Resource Sharing) for the application.
+   * 
+   * @param options - CORS configuration options (adapter-specific)
+   * @throws Error if HTTP application is not set
+   * 
+   * @example
+   * ```typescript
+   * app.enableCors({
+   *   origin: ['http://localhost:3000', 'https://example.com'],
+   *   methods: ['GET', 'POST', 'PUT', 'DELETE'],
+   *   credentials: true,
+   * })
+   * ```
+   */
   enableCors(options: any) {
     if (!this.httpApplication) {
       throw new Error('HTTP application is not set')
@@ -91,6 +191,21 @@ export class NaviosApplication {
     this.httpApplication.enableCors(options)
   }
 
+  /**
+   * Enables multipart/form-data support for file uploads.
+   * 
+   * @param options - Multipart configuration options (adapter-specific)
+   * @throws Error if HTTP application is not set
+   * 
+   * @example
+   * ```typescript
+   * app.enableMultipart({
+   *   limits: {
+   *     fileSize: 1024 * 1024 * 10, // 10MB
+   *   },
+   * })
+   * ```
+   */
   enableMultipart(options: any) {
     if (!this.httpApplication) {
       throw new Error('HTTP application is not set')
@@ -98,6 +213,18 @@ export class NaviosApplication {
     this.httpApplication.enableMultipart(options)
   }
 
+  /**
+   * Sets a global prefix for all routes.
+   * 
+   * @param prefix - The prefix to prepend to all route URLs (e.g., '/api')
+   * @throws Error if HTTP application is not set
+   * 
+   * @example
+   * ```typescript
+   * app.setGlobalPrefix('/api/v1')
+   * // All routes will be prefixed with /api/v1
+   * ```
+   */
   setGlobalPrefix(prefix: string) {
     if (!this.httpApplication) {
       throw new Error('HTTP application is not set')
@@ -105,6 +232,22 @@ export class NaviosApplication {
     this.httpApplication.setGlobalPrefix(prefix)
   }
 
+  /**
+   * Gets the underlying HTTP server instance.
+   * 
+   * The type of the returned server depends on the adapter used:
+   * - Fastify adapter: Returns FastifyInstance
+   * - Bun adapter: Returns Bun.Server
+   * 
+   * @returns The HTTP server instance
+   * @throws Error if HTTP application is not set
+   * 
+   * @example
+   * ```typescript
+   * const server = app.getServer()
+   * // Use adapter-specific server methods
+   * ```
+   */
   getServer() {
     if (!this.httpApplication) {
       throw new Error('HTTP application is not set')
@@ -112,6 +255,17 @@ export class NaviosApplication {
     return this.httpApplication.getServer()
   }
 
+  /**
+   * Starts the HTTP server and begins listening for requests.
+   * 
+   * @param options - Listen options (port, host, etc.)
+   * @throws Error if HTTP application is not set
+   * 
+   * @example
+   * ```typescript
+   * await app.listen({ port: 3000, host: '0.0.0.0' })
+   * ```
+   */
   async listen(options: AbstractHttpListenOptions) {
     if (!this.httpApplication) {
       throw new Error('HTTP application is not set')
@@ -119,6 +273,12 @@ export class NaviosApplication {
     await this.httpApplication.listen(options)
   }
 
+  /**
+   * Disposes of application resources.
+   * 
+   * Cleans up the HTTP server and module loader.
+   * This method is called automatically by `close()`.
+   */
   async dispose() {
     if (this.httpApplication) {
       await this.httpApplication.dispose()
@@ -128,6 +288,20 @@ export class NaviosApplication {
     }
   }
 
+  /**
+   * Closes the application and cleans up all resources.
+   * 
+   * This is an alias for `dispose()`.
+   * 
+   * @example
+   * ```typescript
+   * // Graceful shutdown
+   * process.on('SIGTERM', async () => {
+   *   await app.close()
+   *   process.exit(0)
+   * })
+   * ```
+   */
   async close() {
     await this.dispose()
   }

package/src/navios.environment.d.mts

@@ -0,0 +1,11 @@
+import type { AnyInjectableType, InjectionToken } from '@navios/di';
+export interface NaviosEnvironmentOptions {
+    httpTokens?: Map<InjectionToken<any, undefined>, AnyInjectableType>;
+}
+export declare class NaviosEnvironment {
+    private httpTokens;
+    setupHttpEnvironment(tokens: Map<InjectionToken<any, undefined>, AnyInjectableType>): void;
+    getHttpToken(token: InjectionToken<any, undefined>): AnyInjectableType | undefined;
+    hasHttpSetup(): boolean;
+}
+//# sourceMappingURL=navios.environment.d.mts.map

package/src/navios.environment.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navios.environment.d.mts","sourceRoot":"","sources":["navios.environment.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAInE,MAAM,WAAW,wBAAwB;IAEvC,UAAU,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAA;CACpE;AAED,qBACa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAGf;IAEH,oBAAoB,CAClB,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAKhE,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC;IAIlD,YAAY;CAGb"}