@navios/core 1.0.0 → 1.1.0

package/lib/{index-C0Sg16Eb.d.cts → index-3LcTrbxz.d.mts}

@@ -365,6 +365,10 @@ declare function getEndpointMetadata<Config = any>(target: Function, context: Cl
 //#region src/metadata/controller.metadata.d.mts
 declare const ControllerMetadataKey: unique symbol;
 interface ControllerMetadata {
+  /**
+   * The name of the controller class.
+   */
+  name: string;
   endpoints: Set<HandlerMetadata>;
   guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
   customAttributes: Map<string | symbol, any>;
@@ -376,6 +380,10 @@ declare function hasControllerMetadata(target: ClassType): boolean;
 //#region src/metadata/module.metadata.d.mts
 declare const ModuleMetadataKey: unique symbol;
 interface ModuleMetadata {
+  /**
+   * The name of the module class.
+   */
+  name: string;
   controllers: Set<ClassType>;
   imports: Set<ClassType>;
   guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
@@ -1307,6 +1315,50 @@ interface NaviosModule {
   onModuleInit?: () => Promise<void> | void;
 }
 //#endregion
+//#region src/interfaces/plugin-stage.d.mts
+/**
+ * Base stage names (without pre:/post: prefix)
+ */
+declare const PluginStageBase: {
+  readonly MODULES_TRAVERSE: "modules-traverse";
+  readonly ADAPTER_RESOLVE: "adapter-resolve";
+  readonly ADAPTER_SETUP: "adapter-setup";
+  readonly MODULES_INIT: "modules-init";
+  readonly READY: "ready";
+};
+type PluginStageBase = (typeof PluginStageBase)[keyof typeof PluginStageBase];
+/**
+ * Full stage names with pre:/post: prefix
+ */
+type PluginStage = `pre:${PluginStageBase}` | `post:${PluginStageBase}`;
+/**
+ * Helper to create pre stage name from base
+ */
+declare const preStage: <T extends PluginStageBase>(base: T) => `pre:${T}`;
+/**
+ * Helper to create post stage name from base
+ */
+declare const postStage: <T extends PluginStageBase>(base: T) => `post:${T}`;
+/**
+ * All stages as constants for direct access
+ */
+declare const PluginStages: {
+  readonly PRE_MODULES_TRAVERSE: "pre:modules-traverse";
+  readonly POST_MODULES_TRAVERSE: "post:modules-traverse";
+  readonly PRE_ADAPTER_RESOLVE: "pre:adapter-resolve";
+  readonly POST_ADAPTER_RESOLVE: "post:adapter-resolve";
+  readonly PRE_ADAPTER_SETUP: "pre:adapter-setup";
+  readonly POST_ADAPTER_SETUP: "post:adapter-setup";
+  readonly PRE_MODULES_INIT: "pre:modules-init";
+  readonly POST_MODULES_INIT: "post:modules-init";
+  readonly PRE_READY: "pre:ready";
+  readonly POST_READY: "post:ready";
+};
+/**
+ * All stages in execution order
+ */
+declare const PLUGIN_STAGES_ORDER: readonly PluginStage[];
+//#endregion
 //#region src/services/module-loader.service.d.mts
 /**
  * Extension definition for dynamically adding to the module tree.
@@ -1368,53 +1420,225 @@ declare class ModuleLoaderService {
   dispose(): void;
 }
 //#endregion
-//#region src/interfaces/plugin.interface.d.mts
+//#region src/interfaces/plugin-context.d.mts
+/**
+ * Container-only context available at early stages.
+ * Available at: pre:modules-traverse
+ */
+interface ContainerOnlyContext {
+  /**
+   * The dependency injection container.
+   */
+  container: Container;
+}
+/**
+ * Context with modules loaded.
+ * Available at: post:modules-traverse, pre:adapter-resolve
+ */
+interface ModulesLoadedContext extends ContainerOnlyContext {
+  /**
+   * All loaded modules with their metadata.
+   * Keys are module class names, values are their metadata.
+   */
+  modules: Map<string, ModuleMetadata>;
+  /**
+   * Module loader service for extending the module tree.
+   * Use `moduleLoader.extendModules()` to add controllers dynamically.
+   */
+  moduleLoader: ModuleLoaderService;
+}
+/**
+ * Full context with adapter available.
+ * Available at: post:adapter-resolve and all later stages
+ *
+ * @typeParam TAdapter - The adapter type, defaults to AbstractAdapterInterface
+ */
+interface FullPluginContext<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends ModulesLoadedContext {
+  /**
+   * The current adapter instance.
+   * Use type guards or cast to adapter-specific types for HTTP methods.
+   */
+  adapter: TAdapter;
+}
+/**
+ * Maps each plugin stage to its available context type.
+ *
+ * @typeParam TAdapter - The adapter type for stages that have adapter access
+ */
+interface PluginStageContextMap<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> {
+  'pre:modules-traverse': ContainerOnlyContext;
+  'post:modules-traverse': ModulesLoadedContext;
+  'pre:adapter-resolve': ModulesLoadedContext;
+  'post:adapter-resolve': FullPluginContext<TAdapter>;
+  'pre:adapter-setup': FullPluginContext<TAdapter>;
+  'post:adapter-setup': FullPluginContext<TAdapter>;
+  'pre:modules-init': FullPluginContext<TAdapter>;
+  'post:modules-init': FullPluginContext<TAdapter>;
+  'pre:ready': FullPluginContext<TAdapter>;
+  'post:ready': FullPluginContext<TAdapter>;
+}
+/**
+ * Helper type to get the context type for a specific stage.
+ *
+ * @typeParam S - The plugin stage
+ * @typeParam TAdapter - The adapter type for stages that have adapter access
+ *
+ * @example
+ * ```typescript
+ * type MyContext = ContextForStage<'pre:adapter-resolve'>
+ * // MyContext is ModulesLoadedContext (no adapter)
+ *
+ * type FullContext = ContextForStage<'post:modules-init', BunApplicationService>
+ * // FullContext has typed adapter
+ * ```
+ */
+type ContextForStage<S extends PluginStage, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> = PluginStageContextMap<TAdapter>[S];
 /**
  * Context provided to plugins during registration.
  *
- * This context gives plugins access to the application's modules,
- * adapter instance, DI container, and module loader.
+ * @deprecated Use stage-specific context types (ContainerOnlyContext,
+ * ModulesLoadedContext, FullPluginContext) for better type safety.
+ * This is an alias for FullPluginContext for backward compatibility.
  *
  * @typeParam TAdapter - The adapter type, defaults to AbstractAdapterInterface
+ */
+type PluginContext<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> = FullPluginContext<TAdapter>;
+//#endregion
+//#region src/interfaces/staged-plugin.interface.d.mts
+/**
+ * Base interface for staged plugins that target a specific lifecycle stage.
+ *
+ * @typeParam S - The target stage (e.g., 'pre:adapter-resolve')
+ * @typeParam TOptions - Plugin options type
+ * @typeParam TAdapter - Adapter type (only relevant for post-adapter stages)
  *
  * @example
  * ```typescript
- * // Generic plugin that works with any adapter
- * async register(context: PluginContext) {
- *   const modules = context.modules
- *   // ...
- * }
- *
- * // Adapter-specific plugin with typed adapter
- * async register(context: PluginContext<BunApplicationService>) {
- *   const server = context.adapter.getServer() // Typed as Bun.Server
- *   // ...
+ * const myPlugin: StagedPlugin<'pre:adapter-resolve', MyOptions> = {
+ *   name: 'my-plugin',
+ *   stage: 'pre:adapter-resolve',
+ *   register: (context, options) => {
+ *     // context is typed as ModulesLoadedContext
+ *   },
  * }
  * ```
  */
-interface PluginContext<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> {
+interface StagedPlugin<S extends PluginStage, TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> {
   /**
-   * All loaded modules with their metadata.
-   * Keys are module class names, values are their metadata.
+   * Plugin name for identification and logging.
    */
-  modules: Map<string, ModuleMetadata>;
+  readonly name: string;
   /**
-   * The current adapter instance.
-   * Use type guards or cast to adapter-specific types for HTTP methods.
+   * The lifecycle stage this plugin targets.
    */
-  adapter: TAdapter;
+  readonly stage: S;
   /**
-   * The dependency injection container.
+   * Called at the specified stage during application initialization.
+   *
+   * @param context - Stage-appropriate context
+   * @param options - Plugin-specific configuration options
    */
-  container: Container;
+  register(context: ContextForStage<S, TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs before module tree traversal.
+ * Context: container only
+ */
+interface PreModulesTraversePlugin<TOptions = unknown> extends StagedPlugin<'pre:modules-traverse', TOptions, never> {
+  register(context: ContainerOnlyContext, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs after module tree traversal.
+ * Context: container + modules + moduleLoader
+ */
+interface PostModulesTraversePlugin<TOptions = unknown> extends StagedPlugin<'post:modules-traverse', TOptions, never> {
+  register(context: ModulesLoadedContext, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs before adapter is resolved from container.
+ * Context: container + modules + moduleLoader (NO adapter yet!)
+ *
+ * Use this stage to modify registry/bindings before adapter instantiation.
+ */
+interface PreAdapterResolvePlugin<TOptions = unknown> extends StagedPlugin<'pre:adapter-resolve', TOptions, never> {
+  register(context: ModulesLoadedContext, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs after adapter is resolved.
+ * Context: full (container + modules + moduleLoader + adapter)
+ */
+interface PostAdapterResolvePlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'post:adapter-resolve', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs before adapter setup.
+ * Context: full
+ */
+interface PreAdapterSetupPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'pre:adapter-setup', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs after adapter setup.
+ * Context: full
+ */
+interface PostAdapterSetupPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'post:adapter-setup', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs before modules init (route registration).
+ * Context: full
+ */
+interface PreModulesInitPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'pre:modules-init', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs after modules init (route registration).
+ * Context: full
+ *
+ * This is the default stage for legacy NaviosPlugin implementations.
+ */
+interface PostModulesInitPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'post:modules-init', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs before adapter signals ready.
+ * Context: full
+ */
+interface PreReadyPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'pre:ready', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin that runs after adapter signals ready.
+ * Context: full - this is the final stage, app is fully initialized
+ */
+interface PostReadyPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> extends StagedPlugin<'post:ready', TOptions, TAdapter> {
+  register(context: FullPluginContext<TAdapter>, options: TOptions): Promise<void> | void;
+}
+/**
+ * Plugin definition for staged plugins.
+ *
+ * @typeParam S - The target stage
+ * @typeParam TOptions - Plugin options type
+ * @typeParam TAdapter - Adapter type
+ */
+interface StagedPluginDefinition<S extends PluginStage = PluginStage, TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> {
   /**
-   * Module loader service for extending the module tree.
-   * Use `moduleLoader.extendModules()` to add controllers dynamically.
+   * The staged plugin instance.
    */
-  moduleLoader: ModuleLoaderService;
+  plugin: StagedPlugin<S, TOptions, TAdapter>;
+  /**
+   * Options to pass to the plugin's register function.
+   */
+  options: TOptions;
 }
+//#endregion
+//#region src/interfaces/plugin.interface.d.mts
 /**
- * Base interface for Navios plugins.
+ * Base interface for Navios plugins (legacy).
+ *
+ * @deprecated Use staged plugins with explicit stage property instead.
+ * This interface maps to the `post:modules-init` stage.
+ * See `StagedPlugin` for the new pattern.
  *
  * Plugins are registered using `app.usePlugin()` and are initialized
  * after all modules are loaded but before the server starts listening.
@@ -1424,7 +1648,7 @@ interface PluginContext<TAdapter extends AbstractAdapterInterface = AbstractAdap
  *
  * @example
  * ```typescript
- * // Generic plugin
+ * // Legacy pattern (still works, maps to post:modules-init)
  * const myPlugin: NaviosPlugin<{ enabled: boolean }> = {
  *   name: 'my-plugin',
  *   register: async (context, options) => {
@@ -1434,13 +1658,15 @@ interface PluginContext<TAdapter extends AbstractAdapterInterface = AbstractAdap
  *   },
  * }
  *
- * // Adapter-specific plugin
- * const fastifyPlugin: NaviosPlugin<Options, FastifyApplicationService> = {
- *   name: 'fastify-plugin',
- *   register: async (context, options) => {
- *     const fastify = context.adapter.getServer() // Typed!
+ * // New pattern (recommended)
+ * import { definePostModulesInitPlugin } from '@navios/core'
+ *
+ * export const defineMyPlugin = definePostModulesInitPlugin()({
+ *   name: 'my-plugin',
+ *   register: async (context, options: { enabled: boolean }) => {
+ *     // ...
  *   },
- * }
+ * })
  * ```
  */
 interface NaviosPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> {
@@ -1453,25 +1679,36 @@ interface NaviosPlugin<TOptions = unknown, TAdapter extends AbstractAdapterInter
    *
    * @param context - The plugin context with access to modules and adapter
    * @param options - Plugin-specific configuration options
+   * @deprecated Use staged plugins with explicit stage property
    */
   register(context: PluginContext<TAdapter>, options: TOptions): Promise<void> | void;
 }
 /**
  * Plugin definition combining a plugin with its options.
  *
- * This is the type returned by plugin factory functions like `defineOpenApiPlugin()`.
+ * @deprecated Use `StagedPluginDefinition` for new plugins.
+ * This type is kept for backward compatibility with legacy plugins.
  *
  * @typeParam TOptions - The type of options the plugin accepts
  * @typeParam TAdapter - The adapter type the plugin requires
  *
  * @example
  * ```typescript
+ * // Legacy pattern
  * function defineMyPlugin(options: MyPluginOptions): PluginDefinition<MyPluginOptions> {
  *   return {
  *     plugin: myPlugin,
  *     options,
  *   }
  * }
+ *
+ * // New pattern (recommended)
+ * import { definePostModulesInitPlugin } from '@navios/core'
+ *
+ * export const defineMyPlugin = definePostModulesInitPlugin()({
+ *   name: 'my-plugin',
+ *   register: (context, options: MyPluginOptions) => { ... },
+ * })
  * ```
  */
 interface PluginDefinition<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> {
@@ -1484,6 +1721,11 @@ interface PluginDefinition<TOptions = unknown, TAdapter extends AbstractAdapterI
    */
   options: TOptions;
 }
+/**
+ * Union of legacy and staged plugin definitions.
+ * Used internally by `usePlugin()` to accept both patterns.
+ */
+type AnyPluginDefinition<TOptions = unknown, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface> = PluginDefinition<TOptions, TAdapter> | StagedPluginDefinition<PluginStage, TOptions, TAdapter>;
 //#endregion
 //#region src/decorators/header.decorator.d.mts
 /**
@@ -2456,7 +2698,16 @@ declare class NaviosApplication<Environment extends AdapterEnvironment = Default
   protected container: Container;
   private appModule;
   private options;
+  /**
+   * Plugin storage organized by stage for efficient execution.
+   * Each stage has a Set of plugin definitions.
+   */
   private plugins;
+  /**
+   * Queue of adapter configuration methods to apply after adapter resolution.
+   * Allows calling methods like enableCors() before init().
+   */
+  private pendingAdapterCalls;
   /**
    * Indicates whether the application has been initialized.
    * Set to `true` after `init()` completes successfully.
@@ -2466,6 +2717,9 @@ declare class NaviosApplication<Environment extends AdapterEnvironment = Default
    * Sets up the application with the provided module and options.
    * This is called automatically by NaviosFactory.create().
    *
+   * Note: Adapter resolution has been moved to init() to allow
+   * plugins to modify the container/registry before adapter instantiation.
+   *
    * @param appModule - The root application module
    * @param options - Application configuration options
    * @internal
@@ -2485,33 +2739,47 @@ declare class NaviosApplication<Environment extends AdapterEnvironment = Default
    */
   getAdapter(): Environment['adapter'];
   /**
-   * Registers a plugin to be initialized after modules are loaded.
+   * Registers one or more plugins for initialization during the application lifecycle.
    *
-   * Plugins are initialized in the order they are registered,
-   * after all modules are loaded but before the server starts listening.
+   * Plugins can target specific stages or use the legacy interface (defaults to post:modules-init).
+   * Plugins are executed in stage order, and within a stage in registration order.
    *
-   * @param definition - Plugin definition with options
+   * @param definitions - Single plugin definition or array of definitions
    * @returns this for method chaining
    *
    * @example
    * ```typescript
-   * import { defineOpenApiPlugin } from '@navios/openapi-fastify'
+   * // Single plugin (legacy or staged)
+   * app.usePlugin(defineOpenApiPlugin({ info: { title: 'My API', version: '1.0.0' } }))
    *
-   * app.usePlugin(defineOpenApiPlugin({
-   *   info: { title: 'My API', version: '1.0.0' },
-   * }))
+   * // Multiple plugins in one call
+   * app.usePlugin([
+   *   defineOtelPlugin({ serviceName: 'my-service' }),
+   *   defineOpenApiPlugin({ info: { title: 'My API', version: '1.0.0' } }),
+   * ])
+   *
+   * // Staged plugin with explicit stage
+   * app.usePlugin(definePreAdapterResolvePlugin({
+   *   name: 'early-setup',
+   *   register: (ctx) => { ... },
+   * })({}))
    * ```
    */
-  usePlugin<TOptions, TAdapter extends AbstractAdapterInterface>(definition: PluginDefinition<TOptions, TAdapter>): this;
+  usePlugin<TOptions, TAdapter extends AbstractAdapterInterface>(definitions: AnyPluginDefinition<TOptions, TAdapter> | AnyPluginDefinition<TOptions, TAdapter>[]): this;
+  /**
+   * Resolves the stage for a plugin definition.
+   * Staged plugins use their explicit stage, legacy plugins default to post:modules-init.
+   */
+  private resolvePluginStage;
   /**
    * Initializes the application.
    *
-   * This method:
-   * - Loads all modules and their dependencies
-   * - Sets up the adapter if one is configured
-   * - Calls onModuleInit hooks on all modules
-   * - Initializes registered plugins
-   * - Marks the application as initialized
+   * This method executes the following lifecycle stages:
+   * 1. pre:modules-traverse → Load modules → post:modules-traverse
+   * 2. pre:adapter-resolve → Resolve adapter → post:adapter-resolve
+   * 3. pre:adapter-setup → Setup adapter → post:adapter-setup
+   * 4. pre:modules-init → Initialize modules → post:modules-init
+   * 5. pre:ready → Ready signal → post:ready
    *
    * Must be called before `listen()`.
    *
@@ -2527,8 +2795,32 @@ declare class NaviosApplication<Environment extends AdapterEnvironment = Default
    * ```
    */
   init(): Promise<void>;
+  /**
+   * Wraps an operation with pre/post plugin stage execution.
+   *
+   * @param baseName - The base stage name (e.g., 'modules-traverse')
+   * @param operation - The operation to execute between pre/post stages
+   */
+  private wrapStage;
+  /**
+   * Executes all plugins registered for a specific stage.
+   *
+   * @param stage - The lifecycle stage to execute plugins for
+   */
+  private executePluginStage;
+  /**
+   * Builds the appropriate context object for a given stage.
+   *
+   * @param stage - The lifecycle stage
+   * @returns Context object with stage-appropriate properties
+   */
+  private buildContextForStage;
   private initModules;
-  private initPlugins;
+  /**
+   * Applies any pending adapter configuration calls that were queued
+   * before the adapter was resolved.
+   */
+  private applyPendingAdapterCalls;
   /**
    * Gets a service instance from the dependency injection container.
    *
@@ -3061,6 +3353,153 @@ declare function adapterSupports<TAdapter extends AbstractAdapterInterface, TMet
  */
 declare function assertAdapterSupports<TAdapter extends AbstractAdapterInterface, TMethod extends string>(adapter: TAdapter | null, method: TMethod): asserts adapter is TAdapter & Record<TMethod, (...args: unknown[]) => unknown>;
 //#endregion
+//#region src/utils/define-plugin.d.mts
+interface PluginConfig<TContext, TOptions> {
+  name: string;
+  register: (context: TContext, options: TOptions) => Promise<void> | void;
+}
+/**
+ * Define a plugin that runs before modules are traversed.
+ *
+ * Context: container only
+ *
+ * Use this stage for early DI setup before any modules are loaded.
+ *
+ * @example
+ * ```typescript
+ * export const defineEarlySetupPlugin = definePreModulesTraversePlugin({
+ *   name: 'early-setup',
+ *   register: (context, options: { key: string }) => {
+ *     context.container.addInstance(SomeToken, options.key)
+ *   },
+ * })
+ *
+ * // Usage
+ * app.usePlugin(defineEarlySetupPlugin({ key: 'value' }))
+ * ```
+ */
+declare const definePreModulesTraversePlugin: <TOptions, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<ContainerOnlyContext, TOptions>) => (options: TOptions) => StagedPluginDefinition<"pre:modules-traverse", TOptions, TAdapter>;
+/**
+ * Define a plugin that runs after modules are traversed.
+ *
+ * Context: container + modules + moduleLoader
+ *
+ * Use this stage to inspect loaded modules or extend the module tree.
+ *
+ * @example
+ * ```typescript
+ * export const defineModuleInspectorPlugin = definePostModulesTraversePlugin({
+ *   name: 'module-inspector',
+ *   register: (context, options) => {
+ *     console.log('Loaded modules:', context.modules.size)
+ *   },
+ * })
+ * ```
+ */
+declare const definePostModulesTraversePlugin: <TOptions, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<ModulesLoadedContext, TOptions>) => (options: TOptions) => StagedPluginDefinition<"post:modules-traverse", TOptions, TAdapter>;
+/**
+ * Define a plugin that runs before adapter is resolved from container.
+ *
+ * Context: container + modules + moduleLoader (NO adapter yet!)
+ *
+ * Use this stage to modify registry/bindings before adapter instantiation.
+ * This is ideal for instrumentation, service wrapping, or changing DI bindings.
+ *
+ * @example
+ * ```typescript
+ * export const defineOtelPlugin = definePreAdapterResolvePlugin({
+ *   name: 'otel',
+ *   register: (context, options: OtelOptions) => {
+ *     const registry = context.container.getRegistry()
+ *     // Modify registry before adapter is created
+ *   },
+ * })
+ *
+ * // Usage
+ * app.usePlugin(defineOtelPlugin({ serviceName: 'my-app' }))
+ * ```
+ */
+declare const definePreAdapterResolvePlugin: <TOptions, TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<ModulesLoadedContext, TOptions>) => (options: TOptions) => StagedPluginDefinition<"pre:adapter-resolve", TOptions, TAdapter>;
+/**
+ * Define a plugin that runs after adapter is resolved.
+ *
+ * Context: full (container + modules + moduleLoader + adapter)
+ *
+ * @example
+ * ```typescript
+ * export const defineAdapterConfigPlugin = definePostAdapterResolvePlugin<
+ *   { prefix: string },
+ *   BunApplicationServiceInterface
+ * >()({
+ *   name: 'adapter-config',
+ *   register: (context, options) => {
+ *     context.adapter.setGlobalPrefix(options.prefix)
+ *   },
+ * })
+ * ```
+ */
+declare function definePostAdapterResolvePlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"post:adapter-resolve", TOptions, TAdapter_1>;
+/**
+ * Define a plugin that runs before adapter setup.
+ *
+ * Context: full
+ */
+declare function definePreAdapterSetupPlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"pre:adapter-setup", TOptions, TAdapter_1>;
+/**
+ * Define a plugin that runs after adapter setup.
+ *
+ * Context: full
+ */
+declare function definePostAdapterSetupPlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"post:adapter-setup", TOptions, TAdapter_1>;
+/**
+ * Define a plugin that runs before modules init (route registration).
+ *
+ * Context: full
+ */
+declare function definePreModulesInitPlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"pre:modules-init", TOptions, TAdapter_1>;
+/**
+ * Define a plugin that runs after modules init (route registration).
+ *
+ * Context: full
+ *
+ * This is the default stage for legacy NaviosPlugin implementations.
+ *
+ * @example
+ * ```typescript
+ * export const defineOpenApiPlugin = definePostModulesInitPlugin<
+ *   BunApplicationServiceInterface
+ * >()({
+ *   name: 'openapi',
+ *   register: async (context, options: OpenApiOptions) => {
+ *     // Routes are registered, can generate OpenAPI docs
+ *   },
+ * })
+ * ```
+ */
+declare function definePostModulesInitPlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"post:modules-init", TOptions, TAdapter_1>;
+/**
+ * Define a plugin that runs before adapter signals ready.
+ *
+ * Context: full
+ */
+declare function definePreReadyPlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"pre:ready", TOptions, TAdapter_1>;
+/**
+ * Define a plugin that runs after adapter signals ready.
+ *
+ * Context: full - this is the final stage, app is fully initialized
+ *
+ * @example
+ * ```typescript
+ * export const defineStartupLogPlugin = definePostReadyPlugin()({
+ *   name: 'startup-log',
+ *   register: (context) => {
+ *     console.log('Application fully initialized!')
+ *   },
+ * })
+ * ```
+ */
+declare function definePostReadyPlugin<TAdapter extends AbstractAdapterInterface = AbstractAdapterInterface>(): <TOptions, TAdapter_1 extends AbstractAdapterInterface = AbstractAdapterInterface>(config: PluginConfig<FullPluginContext<TAdapter>, TOptions>) => (options: TOptions) => StagedPluginDefinition<"post:ready", TOptions, TAdapter_1>;
+//#endregion
 //#region src/attribute.factory.d.mts
 /**
  * Type for a class attribute decorator without a value.
@@ -3361,5 +3800,5 @@ declare class NaviosFactory {
   private static registerLoggerConfiguration;
 }
 //#endregion
-export { ProblemDetails as $, isUndefined as $t, GuardRunnerService as A, EndpointMetadataKey as An, DynamicHandler as At, NaviosApplication as B, EnvConfigProvider as Bn, ConsoleLogger as Bt, ExecutionContextInjectionToken as C, getModuleMetadata as Cn, NaviosModule as Ct, getRequestId as D, extractControllerMetadata as Dn, AbstractHttpListenOptions as Dt, generateRequestId as E, ControllerMetadataKey as En, CanActivate as Et, ArgumentGetter as F, EndpointParams as Fn, Logger as Ft, ValidationErrorResponderToken as G, ConfigServiceToken as Gn, isEmpty as Gt, ForbiddenResponderToken as H, ConfigService as Hn, LoggerService as Ht, HandlerContext as I, EndpointResult as In, LoggerOptions as It, InternalServerErrorResponderService as J, PathImpl as Jn, isNumber as Jt, ValidationErrorResponderService as K, ConfigServiceInterface as Kn, isFunction as Kt, InstanceResolution as L, Controller as Ln, LoggerOutput as Lt, AbstractHandlerAdapterService as M, getAllEndpointMetadata as Mn, HandlerResult as Mt, AbstractHandlerResult as N, getEndpointMetadata as Nn, StaticHandler as Nt, runWithRequestId as O, getControllerMetadata as On, AbstractHttpHandlerAdapterInterface as Ot, AbstractStaticHandler as P, Endpoint as Pn, AbstractHttpCorsOptions as Pt, ErrorResponse as Q, envString as Qn, isSymbol as Qt, InstanceResolverService as R, ControllerOptions as Rn, loggerOptionsSchema as Rt, ExecutionContext as S, getModuleCustomEntry as Sn, ModuleLoaderService as St, AdapterToken as T, ControllerMetadata as Tn, OmitIndexSignature as Tt, InternalServerErrorResponderToken as U, ConfigServiceOptions as Un, addLeadingSlash as Ut, NaviosApplicationOptions as V, provideConfig as Vn, ConsoleLoggerOptions as Vt, NotFoundResponderToken as W, ConfigServiceOptionsSchema as Wn, isConstructor as Wt, ErrorResponseProducerService as X, PathValue as Xn, isPlainObject as Xt, ForbiddenResponderService as Y, PathImpl2 as Yn, isObject as Yt, ErrorResponder as Z, envInt as Zn, isString as Zt, Request as _, getManagedMetadata as _n, Header as _t, RequestFactory as a, LOG_LEVELS as an, ForbiddenException as at, MultipartAdapterToken as b, ModuleMetadataKey as bn, PluginDefinition as bt, EndpointAdapterFactory as c, yellow as cn, UseGuards as ct, ClassAttribute as d, DefaultAdapterEnvironment as dn, Multipart as dt, normalizePath as en, FrameworkError as et, ClassSchemaAttribute as f, HttpAdapterEnvironment as fn, MultipartParams as ft, StreamAdapterToken as g, NaviosManagedMetadataKey as gn, HttpCode as gt, XmlStreamAdapterToken as h, ManagedMetadata as hn, ModuleOptions as ht, ReplyFactory as i, filterLogLevels as in, InternalServerErrorException as it, AbstractDynamicHandler as j, HandlerMetadata as jn, FormatArgumentsFn$1 as jt, setRequestIdEnabled as k, hasControllerMetadata as kn, ArgumentGetterFn as kt, AdapterFactory as l, AbstractHttpAdapterInterface as ln, Stream as lt, assertAdapterSupports as m, AbstractAdapterInterface as mn, Module as mt, XmlStreamAdapterFactory as n, isLogLevelEnabled as nn, UnauthorizedException as nt, MultipartAdapterFactory as o, LogLevel as on, BadRequestException as ot, adapterSupports as p, AbstractExecutionContext as pn, MultipartResult as pt, NotFoundResponderService as q, Path as qn, isNil as qt, StreamAdapterFactory as r, isLogLevel as rn, NotFoundException as rt, HttpAdapterFactory as s, clc as sn, HttpException as st, NaviosFactory as t, stripEndSlash as tn, ConflictException as tt, AttributeFactory as u, AdapterEnvironment as un, StreamParams as ut, Reply as v, hasManagedMetadata as vn, NaviosPlugin as vt, EndpointAdapterToken as w, hasModuleMetadata as wn, HttpHeader as wt, HttpAdapterToken as x, extractModuleMetadata as xn, ModuleExtension as xt, NaviosOptionsToken as y, ModuleMetadata as yn, PluginContext as yt, MultiInstanceResolution as z, ConfigProviderOptions as zn, LoggerInstance as zt };
-//# sourceMappingURL=index-C0Sg16Eb.d.cts.map
+export { InternalServerErrorResponderToken as $, ModuleMetadata as $n, PluginStageBase as $t, MultipartAdapterToken as A, isPlainObject as An, PathValue as Ar, PluginDefinition as At, GuardRunnerService as B, LogLevel as Bn, PreReadyPlugin as Bt, adapterSupports as C, addLeadingSlash as Cn, ConfigServiceOptions as Cr, MultipartResult as Ct, Request as D, isNil as Dn, Path as Dr, Header as Dt, StreamAdapterToken as E, isFunction as En, ConfigServiceInterface as Er, HttpCode as Et, AdapterToken as F, stripEndSlash as Fn, PostReadyPlugin as Ft, ArgumentGetter as G, DefaultAdapterEnvironment as Gn, FullPluginContext as Gt, AbstractHandlerAdapterService as H, yellow as Hn, StagedPluginDefinition as Ht, generateRequestId as I, isLogLevelEnabled as In, PreAdapterResolvePlugin as It, InstanceResolverService as J, AbstractAdapterInterface as Jn, PluginStageContextMap as Jt, HandlerContext as K, HttpAdapterEnvironment as Kn, ModulesLoadedContext as Kt, getRequestId as L, isLogLevel as Ln, PreAdapterSetupPlugin as Lt, ExecutionContext as M, isSymbol as Mn, envString as Mr, PostAdapterSetupPlugin as Mt, ExecutionContextInjectionToken as N, isUndefined as Nn, PostModulesInitPlugin as Nt, Reply as O, isNumber as On, PathImpl as Or, AnyPluginDefinition as Ot, EndpointAdapterToken as P, normalizePath as Pn, PostModulesTraversePlugin as Pt, ForbiddenResponderToken as Q, hasManagedMetadata as Qn, PluginStage as Qt, runWithRequestId as R, filterLogLevels as Rn, PreModulesInitPlugin as Rt, definePreReadyPlugin as S, LoggerService as Sn, ConfigService as Sr, MultipartParams as St, XmlStreamAdapterToken as T, isEmpty as Tn, ConfigServiceToken as Tr, ModuleOptions as Tt, AbstractHandlerResult as U, AbstractHttpAdapterInterface as Un, ContainerOnlyContext as Ut, AbstractDynamicHandler as V, clc as Vn, StagedPlugin as Vt, AbstractStaticHandler as W, AdapterEnvironment as Wn, ContextForStage as Wt, NaviosApplication as X, NaviosManagedMetadataKey as Xn, ModuleLoaderService as Xt, MultiInstanceResolution as Y, ManagedMetadata as Yn, ModuleExtension as Yt, NaviosApplicationOptions as Z, getManagedMetadata as Zn, PLUGIN_STAGES_ORDER as Zt, definePostReadyPlugin as _, LoggerOutput as _n, Controller as _r, HttpException as _t, RequestFactory as a, OmitIndexSignature as an, ControllerMetadata as ar, ForbiddenResponderService as at, definePreModulesInitPlugin as b, ConsoleLogger as bn, EnvConfigProvider as br, StreamParams as bt, EndpointAdapterFactory as c, AbstractHttpHandlerAdapterInterface as cn, getControllerMetadata as cr, ErrorResponse as ct, ClassAttribute as d, FormatArgumentsFn$1 as dn, HandlerMetadata as dr, ConflictException as dt, PluginStages as en, ModuleMetadataKey as er, NotFoundResponderToken as et, ClassSchemaAttribute as f, HandlerResult as fn, getAllEndpointMetadata as fr, UnauthorizedException as ft, definePostModulesTraversePlugin as g, LoggerOptions as gn, EndpointResult as gr, BadRequestException as gt, definePostModulesInitPlugin as h, Logger as hn, EndpointParams as hr, ForbiddenException as ht, ReplyFactory as i, HttpHeader as in, hasModuleMetadata as ir, InternalServerErrorResponderService as it, HttpAdapterToken as j, isString as jn, envInt as jr, PostAdapterResolvePlugin as jt, NaviosOptionsToken as k, isObject as kn, PathImpl2 as kr, NaviosPlugin as kt, AdapterFactory as l, ArgumentGetterFn as ln, hasControllerMetadata as lr, ProblemDetails as lt, definePostAdapterSetupPlugin as m, AbstractHttpCorsOptions as mn, Endpoint as mr, InternalServerErrorException as mt, XmlStreamAdapterFactory as n, preStage as nn, getModuleCustomEntry as nr, ValidationErrorResponderService as nt, MultipartAdapterFactory as o, CanActivate as on, ControllerMetadataKey as or, ErrorResponseProducerService as ot, definePostAdapterResolvePlugin as p, StaticHandler as pn, getEndpointMetadata as pr, NotFoundException as pt, InstanceResolution as q, AbstractExecutionContext as qn, PluginContext as qt, StreamAdapterFactory as r, NaviosModule as rn, getModuleMetadata as rr, NotFoundResponderService as rt, HttpAdapterFactory as s, AbstractHttpListenOptions as sn, extractControllerMetadata as sr, ErrorResponder as st, NaviosFactory as t, postStage as tn, extractModuleMetadata as tr, ValidationErrorResponderToken as tt, AttributeFactory as u, DynamicHandler as un, EndpointMetadataKey as ur, FrameworkError as ut, definePreAdapterResolvePlugin as v, loggerOptionsSchema as vn, ControllerOptions as vr, UseGuards as vt, assertAdapterSupports as w, isConstructor as wn, ConfigServiceOptionsSchema as wr, Module as wt, definePreModulesTraversePlugin as x, ConsoleLoggerOptions as xn, provideConfig as xr, Multipart as xt, definePreAdapterSetupPlugin as y, LoggerInstance as yn, ConfigProviderOptions as yr, Stream as yt, setRequestIdEnabled as z, LOG_LEVELS as zn, PreModulesTraversePlugin as zt };
+//# sourceMappingURL=index-3LcTrbxz.d.mts.map