stratal 0.0.16 → 0.0.18

package/dist/logger-c0ftIK4G.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-c0ftIK4G.mjs","names":[],"sources":["../src/di/decorators/inject-param.decorator.ts","../src/di/decorators.ts","../src/di/tokens.ts","../src/logger/logger.tokens.ts","../src/logger/contracts/log-level.ts","../src/logger/services/logger.service.ts","../src/logger/formatters/json-formatter.ts","../src/logger/formatters/pretty-formatter.ts","../src/logger/transports/base-transport.ts","../src/logger/transports/console-transport.ts"],"sourcesContent":["/**\n * Method Parameter Injection Decorator\n *\n * Enables DI for controller method parameters. Parameters marked with\n * @InjectParam(token) are resolved from the request-scoped container\n * at method invocation time.\n *\n * @example\n * ```typescript\n * @Route({ response: userSchema })\n * async show(\n *   ctx: RouterContext,\n *   @InjectParam(UserService) userService: UserService,\n *   @InjectParam(CacheService) cache: CacheService\n * ): Promise<Response> {\n *   // userService and cache auto-resolved from request container\n * }\n * ```\n */\nimport type InjectionToken from 'tsyringe/dist/typings/providers/injection-token'\n\n/**\n * Metadata key for storing parameter injection information\n */\nexport const INJECT_PARAM_METADATA_KEY = Symbol.for('stratal:inject:param')\n\n/**\n * Describes a parameter injection\n */\nexport interface ParamInjection {\n  /** Parameter index in the method signature (0-based) */\n  index: number\n  /** DI token to resolve */\n  token: InjectionToken\n}\n\n/**\n * Mark a method parameter for DI injection\n *\n * The parameter will be resolved from the request-scoped container\n * when the controller method is invoked.\n *\n * @param token - DI token to resolve (class or symbol)\n *\n * @example With class token\n * ```typescript\n * async show(\n *   ctx: RouterContext,\n *   @InjectParam(UserService) userService: UserService\n * ) { }\n * ```\n *\n * @example With symbol token\n * ```typescript\n * async show(\n *   ctx: RouterContext,\n *   @InjectParam(DI_TOKENS.Cache) cache: ICacheService\n * ) { }\n * ```\n */\nexport function InjectParam<T>(token: InjectionToken<T>): ParameterDecorator {\n  return (target: object, propertyKey: string | symbol | undefined, parameterIndex: number) => {\n    if (propertyKey === undefined) {\n      throw new Error('@InjectParam can only be used on method parameters, not constructor parameters')\n    }\n\n    const existingInjections: ParamInjection[] =\n      (Reflect.getMetadata(INJECT_PARAM_METADATA_KEY, target, propertyKey) as ParamInjection[] | undefined) ?? []\n\n    existingInjections.push({\n      index: parameterIndex,\n      token,\n    })\n\n    Reflect.defineMetadata(INJECT_PARAM_METADATA_KEY, existingInjections, target, propertyKey)\n  }\n}\n\n/**\n * Get method parameter injections\n *\n * @param target - Controller prototype\n * @param propertyKey - Method name\n * @returns Array of parameter injections sorted by index\n */\nexport function getMethodInjections(target: object, propertyKey: string | symbol): ParamInjection[] {\n  const injections: ParamInjection[] =\n    (Reflect.getMetadata(INJECT_PARAM_METADATA_KEY, target, propertyKey) as ParamInjection[] | undefined) ?? []\n\n  return injections.sort((a, b) => a.index - b.index)\n}\n","/**\n * DI Decorators\n *\n * Provides decorators for dependency injection:\n * - @Transient: Mark classes as injectable (lifecycle controlled at registration)\n * - @InjectParam: Inject dependencies into method parameters\n *\n * Lifecycle (Singleton, Request, Transient) is controlled at registration time\n * via the `scope` property in module providers or Container.register().\n */\nimport { injectable } from 'tsyringe'\nimport type InjectionToken from 'tsyringe/dist/typings/providers/injection-token'\n\n// Re-export method parameter injection\nexport {\n  InjectParam,\n  getMethodInjections,\n  type ParamInjection,\n  INJECT_PARAM_METADATA_KEY,\n} from './decorators/inject-param.decorator'\n\n/**\n * Mark a class as injectable\n *\n * This decorator wraps tsyringe's `@injectable` decorator and optionally\n * associates a token with the class. The actual lifecycle (Singleton, Request,\n * Transient) is determined at registration time, not decoration time.\n *\n * **Lifecycle Control:**\n * - Use `scope: Scope.Singleton` in module providers for singleton\n * - Use `scope: Scope.Request` in module providers for request-scoped\n * - Default is Transient (new instance per resolution)\n *\n * @param token - Optional DI token for service resolution\n *\n * @example Basic usage (no token)\n * ```typescript\n * @Transient()\n * export class UserService {\n *   constructor(@inject(DI_TOKENS.Database) private db: DatabaseService) {}\n * }\n *\n * // In module:\n * @Module({\n *   providers: [UserService]  // Transient by default\n * })\n * ```\n *\n * @example With token\n * ```typescript\n * @Transient(DI_TOKENS.ConnectionManager)\n * export class ConnectionManager implements Disposable {\n *   // ...\n * }\n *\n * // In Application.ts:\n * container.register(DI_TOKENS.ConnectionManager, ConnectionManager, Scope.Request)\n * ```\n *\n * @example Singleton via provider scope\n * ```typescript\n * @Transient()\n * export class ConsumerRegistry {\n *   // ...\n * }\n *\n * // In module:\n * @Module({\n *   providers: [\n *     { provide: DI_TOKENS.ConsumerRegistry, useClass: ConsumerRegistry, scope: Scope.Singleton }\n *   ]\n * })\n * ```\n */\nexport function Transient<T>(token?: InjectionToken<T>) {\n  return function <TFunction extends abstract new (...args: never[]) => unknown>(target: TFunction): TFunction {\n    const targetConstructor = target as unknown as new (...args: unknown[]) => T\n    injectable<T>({ token })(targetConstructor)\n    return target\n  }\n}\n","/**\n * Token for the Container instance\n * Used for injecting the Container into services that need dynamic resolution\n */\nexport const CONTAINER_TOKEN = Symbol.for('stratal:di:container')\n\nexport const DI_TOKENS = {\n  // Cloudflare\n  CloudflareEnv: Symbol.for('stratal:cloudflare:env'),\n  ExecutionContext: Symbol.for('stratal:execution:context'),\n\n  // Infrastructure\n  Container: CONTAINER_TOKEN,\n  Application: Symbol.for('stratal:application'),\n  ModuleRegistry: Symbol.for('stratal:module:registry'),\n  ExceptionHandler: Symbol.for('stratal:exception:handler'),\n  Database: Symbol.for('stratal:database:service'),\n  Queue: Symbol.for('stratal:queue:manager'),\n  ConsumerRegistry: Symbol.for('stratal:consumer:registry'),\n  Cron: Symbol.for('stratal:cron:manager'),\n  EventRegistry: Symbol.for('stratal:event:registry'),\n  Quarry: Symbol.for('stratal:quarry'),\n\n  // Context\n  /**\n   * AuthContext: Use for services that need user authentication (userId).\n   */\n  AuthContext: Symbol.for('stratal:auth:context'),\n\n  // Workers\n  DurableObjectState: Symbol.for('stratal:durable:object:state'),\n  DurableObjectId: Symbol.for('stratal:durable:object:id'),\n} as const\n\nexport type DIToken = typeof DI_TOKENS[keyof typeof DI_TOKENS]\n","/**\n * Dependency Injection Tokens for Logger Module\n *\n * Symbol-based tokens ensure type-safe dependency injection\n * and prevent naming collisions.\n */\nexport const LOGGER_TOKENS = {\n  /**\n   * Main logger service facade\n   */\n  LoggerService: Symbol.for('stratal:logger:service'),\n\n  /**\n   * Log formatter (JSON or Pretty)\n   */\n  Formatter: Symbol.for('stratal:logger:formatter'),\n\n  /**\n   * Array of active transports\n   */\n  Transports: Symbol.for('stratal:logger:transports'),\n\n  /**\n   * Individual transport tokens (for factory registration)\n   */\n  ConsoleTransport: Symbol.for('stratal:logger:console:transport'),\n\n  /**\n   * Configured log level for filtering\n   */\n  LogLevelOptions: Symbol.for('stratal:logger:log:level:options'),\n} as const\n","/**\n * Log severity levels\n * Ordered from least to most severe\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Map log levels to numeric priorities (for filtering)\n * Higher numbers = more severe = higher priority\n */\nexport const LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n  [LogLevel.DEBUG]: 0,\n  [LogLevel.INFO]: 1,\n  [LogLevel.WARN]: 2,\n  [LogLevel.ERROR]: 3,\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport type { InternalLogContext, LogContext, LogEntry } from '../contracts'\nimport { LOG_LEVEL_PRIORITY, LogLevel } from '../contracts/log-level'\nimport type { ILogFormatter } from '../formatters/formatter.interface'\nimport { LOGGER_TOKENS } from '../logger.tokens'\nimport type { ILogTransport } from '../transports/transport.interface'\n\n/**\n * Logger Service\n *\n * Main logging facade.\n *\n * **Features:**\n * - Async logging via ctx.waitUntil() for non-blocking performance\n * - Multi-transport support (console, future Sentry/Cloudflare Analytics)\n * - Configurable formatters (JSON production, Pretty development)\n * - Log level filtering based on environment\n *\n * **Architecture:**\n * - Transports and formatters injected via DI\n *\n * @example Basic usage\n * ```typescript\n * @Transient()\n * export class UserService {\n *   constructor(\n *     @inject(LOGGER_TOKENS.LoggerService)\n *     private readonly logger: LoggerService\n *   ) {}\n *\n *   async createUser(input: CreateUserInput) {\n *     this.logger.info('Creating user', { email: input.email })\n *   }\n * }\n * ```\n */\n@Transient()\nexport class LoggerService {\n  constructor(\n    @inject(LOGGER_TOKENS.LogLevelOptions)\n    private readonly logLevel: LogLevel,\n\n    @inject(DI_TOKENS.ExecutionContext)\n    private readonly executionContext: globalThis.ExecutionContext,\n\n    @inject(LOGGER_TOKENS.Formatter)\n    private readonly formatter: ILogFormatter,\n\n    @inject(LOGGER_TOKENS.Transports)\n    private readonly transports: ILogTransport[],\n  ) { }\n\n  /**\n   * Log debug message (development only)\n   */\n  debug(message: string, context?: LogContext): void {\n    this.log(LogLevel.DEBUG, message, context)\n  }\n\n  /**\n   * Log info message\n   */\n  info(message: string, context?: LogContext): void {\n    this.log(LogLevel.INFO, message, context)\n  }\n\n  /**\n   * Log warning message\n   */\n  warn(message: string, context?: LogContext): void {\n    this.log(LogLevel.WARN, message, context)\n  }\n\n  /**\n   * Log error message\n   * Accepts Error object or custom context\n   */\n  error(message: string, contextOrError?: LogContext | Error): void {\n    let context: LogContext | undefined\n    let error: Error | undefined\n\n    if (contextOrError instanceof Error) {\n      error = contextOrError\n    } else {\n      context = contextOrError\n    }\n\n    this.log(LogLevel.ERROR, message, context, error)\n  }\n\n  /**\n   * Core logging implementation\n   * Enriches context, formats message, dispatches to transports\n   * Uses ctx.waitUntil() for async non-blocking processing\n   */\n  private log(\n    level: LogLevel,\n    message: string,\n    userContext?: LogContext,\n    error?: Error\n  ): void {\n    // Filter by configured log level\n    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.logLevel]) {\n      return\n    }\n\n    // Build complete log entry with enriched context\n    const entry: LogEntry = {\n      level,\n      message,\n      context: this.enrichContext(userContext ?? {}),\n      error: error ? this.serializeError(error) : undefined,\n    }\n\n    // Format once for all transports\n    const formatted = this.formatter.format(entry)\n\n    // Dispatch to all transports asynchronously\n    const writePromises = this.transports.map(transport =>\n      transport.write(entry, formatted).catch((err: unknown) => {\n        // Swallow transport errors to prevent log failure from crashing app\n        console.error(`Transport ${transport.name} failed:`, err)\n      })\n    )\n\n    // Use waitUntil to ensure logs complete even after response sent\n    const allWrites = Promise.all(writePromises)\n    try {\n      this.executionContext.waitUntil(allWrites)\n    } catch (error) {\n      if (!(error instanceof Error) || !error.message.includes('global scope')) {\n        throw error\n      }\n    }\n  }\n\n  /**\n   * Enrich log context with request info and timestamp\n   * Context enrichment can be extended by application modules\n   */\n  private enrichContext(userContext: LogContext): InternalLogContext {\n    return {\n      ...userContext,\n      timestamp: Date.now(),\n    }\n  }\n\n  /**\n   * Serialize Error object for transport\n   */\n  private serializeError(error: Error): { message: string; stack?: string; name?: string } {\n    return {\n      message: error.message,\n      stack: error.stack,\n      name: error.name,\n    }\n  }\n}\n","import type { LogEntry } from '../contracts'\nimport type { ILogFormatter } from './formatter.interface'\n\n/**\n * JSON Formatter\n *\n * Produces structured JSON logs for production environments.\n * Optimized for log aggregation systems (Cloudflare Analytics, Datadog, etc.)\n *\n * Output format:\n * {\n *   \"level\": \"info\",\n *   \"message\": \"User logged in\",\n *   \"timestamp\": 1234567890,\n *   \"userId\": \"user_456\",\n *   \"error\": { \"message\": \"...\", \"stack\": \"...\" }\n * }\n */\nexport class JsonFormatter implements ILogFormatter {\n  format(entry: LogEntry): string {\n    const output = {\n      level: entry.level,\n      message: entry.message,\n      ...entry.context,\n      ...(entry.error && { error: entry.error }),\n    }\n\n    return JSON.stringify(output)\n  }\n}\n","import type { LogEntry } from '../contracts'\nimport { LogLevel } from '../contracts'\nimport type { ILogFormatter } from './formatter.interface'\n\n/**\n * Pretty Formatter\n *\n * Human-readable colored output for development environments.\n * Uses ANSI color codes for terminal output.\n *\n * Output format:\n * [2024-01-15 10:30:45] INFO: User logged in\n *   userId: user_456\n */\nexport class PrettyFormatter implements ILogFormatter {\n  private readonly colors: Record<LogLevel, string> = {\n    [LogLevel.DEBUG]: '\\x1b[36m', // Cyan\n    [LogLevel.INFO]: '\\x1b[32m', // Green\n    [LogLevel.WARN]: '\\x1b[33m', // Yellow\n    [LogLevel.ERROR]: '\\x1b[31m', // Red\n  }\n\n  private readonly reset = '\\x1b[0m'\n\n  format(entry: LogEntry): string {\n    const color = this.colors[entry.level]\n    const timestamp = new Date(entry.context.timestamp).toISOString()\n    const levelStr = entry.level.toUpperCase().padEnd(5)\n\n    let output = `${color}[${timestamp}] ${levelStr}${this.reset}: ${entry.message}`\n\n    // Add context (exclude timestamp)\n    const { timestamp: _, ...contextWithoutTimestamp } = entry.context\n    const contextEntries = Object.entries(contextWithoutTimestamp)\n\n    if (contextEntries.length > 0) {\n      output += '\\n'\n      contextEntries.forEach(([key, value]) => {\n        output += `  ${key}: ${JSON.stringify(value)}\\n`\n      })\n    }\n\n    // Add error stack if present\n    if (entry.error?.stack) {\n      output += `\\n${entry.error.stack}\\n`\n    }\n\n    return output.trimEnd()\n  }\n}\n","import type { ILogTransport } from './transport.interface'\nimport type { LogEntry } from '../contracts'\n\n/**\n * Base Transport\n *\n * Abstract base class providing shared transport logic.\n * Reduces code duplication across transport implementations.\n */\nexport abstract class BaseTransport implements ILogTransport {\n  abstract readonly name: string\n\n  /**\n   * Write log entry - must be implemented by concrete transports\n   */\n  abstract write(entry: LogEntry, formatted: string): Promise<void>\n\n  /**\n   * Handle transport errors gracefully\n   * Logs to console.error as fallback to prevent log loss\n   *\n   * @param error - Error that occurred during write\n   * @param entry - Log entry that failed\n   */\n  protected handleError(error: unknown, entry: LogEntry): void {\n    console.error(`[${this.name}] Failed to write log:`, {\n      error: error instanceof Error ? error.message : String(error),\n      logMessage: entry.message,\n      level: entry.level,\n    })\n  }\n}\n","import { Transient } from '../../di/decorators'\nimport { LOGGER_TOKENS } from '../logger.tokens'\nimport { BaseTransport } from './base-transport'\nimport type { LogEntry } from '../contracts'\nimport { LogLevel } from '../contracts'\n\n/**\n * Console Transport\n *\n * Writes logs to console using appropriate console methods.\n * Maps log levels to console.debug, console.info, console.warn, console.error.\n *\n * Thread-safe for Cloudflare Workers environment.\n */\n@Transient(LOGGER_TOKENS.ConsoleTransport)\nexport class ConsoleTransport extends BaseTransport {\n  readonly name = 'console'\n\n  write(entry: LogEntry, formatted: string): Promise<void> {\n    try {\n      const consoleMethod = this.getConsoleMethod(entry.level)\n      consoleMethod(formatted)\n    } catch (error) {\n      this.handleError(error, entry)\n    }\n\n    return Promise.resolve()\n  }\n\n  /**\n   * Map log level to console method\n   */\n  private getConsoleMethod(level: LogLevel): typeof console.log {\n    switch (level) {\n      case LogLevel.DEBUG:\n        return console.debug\n      case LogLevel.INFO:\n        return console.info\n      case LogLevel.WARN:\n        return console.warn\n      case LogLevel.ERROR:\n        return console.error\n      default:\n        return console.log\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/module/index.d.mts

@@ -1,6 +1,5 @@
-import { $t as Container, _t as MiddlewareConfigEntry, at as ExistingProvider, ct as ModuleClass, dt as OnInitialize, ft as OnShutdown, ht as ValueProvider, it as DynamicModule, lt as ModuleContext, mt as RegistryEntry, nt as AsyncModuleOptions, ot as FactoryProvider, pt as Provider, rt as ClassProvider, st as InjectionToken, ut as ModuleOptions } from "../index-BJWm863C.mjs";
-import { t as Constructor } from "../types-DahElfUw.mjs";
-import { i as LoggerService } from "../index-Dp6A5ywM.mjs";
+import { Cn as OnShutdown, En as ValueProvider, Qt as ModuleRegistry, Sn as OnInitialize, Tn as RegistryEntry, _n as InjectionToken, bn as ModuleOptions, fn as AsyncModuleOptions, gn as FactoryProvider, hn as ExistingProvider, mn as DynamicModule, pn as ClassProvider, vn as ModuleClass, wn as Provider, xn as OnException, yn as ModuleContext } from "../index-BrmS34sa.mjs";
+import { t as Constructor } from "../types-CN0zONAZ.mjs";
 
 //#region src/module/module.decorator.d.ts
 declare const MODULE_OPTIONS_KEY: unique symbol;
@@ -29,120 +28,5 @@ declare function getModuleOptions(target: Constructor): ModuleOptions | undefine
  */
 declare function isModuleClass(target: unknown): target is Constructor;
 //#endregion
-//#region src/module/module-registry.d.ts
-/**
- * ModuleRegistry - manages module lifecycle
- *
- * @example
- * ```typescript
- * const registry = new ModuleRegistry(container, logger)
- * registry.register(AppModule)  // Traverses imports recursively
- * await registry.initialize()
- * // ... application running ...
- * await registry.shutdown()
- * ```
- */
-declare class ModuleRegistry {
-  private readonly container;
-  private readonly logger;
-  private modules;
-  private registeredClasses;
-  private initialized;
-  private allControllers;
-  private allConsumers;
-  private allJobs;
-  private allListeners;
-  private allCommands;
-  private allSeeders;
-  private allMiddlewareConfigs;
-  constructor(container: Container, logger: LoggerService);
-  /**
-   * Register a module (static or dynamic)
-   *
-   * @param moduleOrDynamic - Module class decorated with `@Module` or DynamicModule from configure()
-   */
-  register(moduleOrDynamic: ModuleClass | DynamicModule): void;
-  /**
-   * Register multiple modules in order
-   */
-  registerAll(modules: (ModuleClass | DynamicModule)[]): void;
-  /**
-   * Initialize all modules (call configure and onInitialize hooks)
-   */
-  initialize(): Promise<void>;
-  /**
-   * Get all controllers registered from all modules
-   */
-  getAllControllers(): Constructor[];
-  /**
-   * Get all consumers registered from all modules
-   */
-  getAllConsumers(): Constructor[];
-  /**
-   * Get all jobs registered from all modules
-   */
-  getAllJobs(): Constructor[];
-  /**
-   * Get all listeners registered from all modules
-   */
-  getAllListeners(): Constructor[];
-  /**
-   * Get all commands registered from all modules
-   */
-  getAllCommands(): Constructor[];
-  /**
-   * Get all seeders registered from all modules
-   */
-  getAllSeeders(): Constructor[];
-  /**
-   * Get all middleware configurations from all modules
-   */
-  getAllMiddlewareConfigs(): MiddlewareConfigEntry[];
-  /**
-   * Shutdown all modules (call onShutdown hooks in reverse order)
-   */
-  shutdown(): Promise<void>;
-  /**
-   * Type guard for MiddlewareConfigurable
-   */
-  private hasMiddlewareConfigurable;
-  /**
-   * Type guard for OnInitialize
-   */
-  private hasOnInitialize;
-  /**
-   * Type guard for OnShutdown
-   */
-  private hasOnShutdown;
-  /**
-   * Resolve module class and options from static or dynamic module
-   *
-   * For DynamicModules, merges the decorator metadata (consumers, controllers, jobs)
-   * with the DynamicModule options (providers, imports). This ensures modules using
-   * forRoot/forRootAsync patterns still have their decorator-defined consumers registered.
-   */
-  private resolveModule;
-  /**
-   * Type guard for DynamicModule
-   */
-  private isDynamicModule;
-  /**
-   * Register a single provider in the container
-   */
-  private registerProvider;
-  /**
-   * Check if a class is a `Command` and collect it for auto-wiring
-   */
-  private collectIfCommand;
-  /**
-   * Check if a class is a `Seeder` and collect it for auto-wiring
-   */
-  private collectIfSeeder;
-  /**
-   * Check if a class is a `@Listener()` and collect it for auto-wiring
-   */
-  private collectIfListener;
-}
-//#endregion
-export { AsyncModuleOptions, ClassProvider, DynamicModule, ExistingProvider, FactoryProvider, InjectionToken, MODULE_OPTIONS_KEY, Module, ModuleClass, ModuleContext, ModuleOptions, ModuleRegistry, OnInitialize, OnShutdown, Provider, RegistryEntry, ValueProvider, getModuleOptions, isModuleClass };
+export { AsyncModuleOptions, ClassProvider, DynamicModule, ExistingProvider, FactoryProvider, InjectionToken, MODULE_OPTIONS_KEY, Module, ModuleClass, ModuleContext, ModuleOptions, ModuleRegistry, OnException, OnInitialize, OnShutdown, Provider, RegistryEntry, ValueProvider, getModuleOptions, isModuleClass };
 //# sourceMappingURL=index.d.mts.map

package/dist/module/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/module/module.decorator.ts","../../src/module/module-registry.ts"],"mappings":";;;;;cAea,kBAAA;;;AAyBb;;;;;;;;;;;;;iBAAgB,MAAA,CAAO,OAAA,EAAS,aAAA,uCACa,IAAA,uBAA2B,MAAA,EAAQ,SAAA,KAAY,SAAA;;;;iBAmB5E,gBAAA,CAAiB,MAAA,EAAQ,WAAA,GAAc,aAAA;;;;iBAOvC,aAAA,CAAc,MAAA,YAAkB,MAAA,IAAU,WAAA;;;;;;;;;;;;;;;cCd7C,cAAA;EAAA,iBAeQ,SAAA;EAAA,iBACA,MAAA;EAAA,QAfX,OAAA;EAAA,QACA,iBAAA;EAAA,QACA,WAAA;EAAA,QAGA,cAAA;EAAA,QACA,YAAA;EAAA,QACA,OAAA;EAAA,QACA,YAAA;EAAA,QACA,WAAA;EAAA,QACA,UAAA;EAAA,QACA,oBAAA;cAGW,SAAA,EAAW,SAAA,EACX,MAAA,EAAQ,aAAA;EDFwC;;;;;ECUnE,QAAA,CAAS,eAAA,EAAiB,WAAA,GAAc,aAAA;;;;EAyDxC,WAAA,CAAY,OAAA,GAAU,WAAA,GAAc,aAAA;EAjFX;;;EA0FnB,UAAA,CAAA,GAAc,OAAA;EAlEM;;;EAyG1B,iBAAA,CAAA,GAAqB,WAAA;EAvCD;;;EA8CpB,eAAA,CAAA,GAAmB,WAAA;EAcA;;;EAPnB,UAAA,CAAA,GAAc,WAAA;EAmCI;;;EA5BlB,eAAA,CAAA,GAAmB,WAAA;EAtIA;;;EA6InB,cAAA,CAAA,GAAkB,WAAA;EAvJV;;;EA8JR,aAAA,CAAA,GAAiB,WAAA;EA1JT;;;EAiKR,uBAAA,CAAA,GAA2B,qBAAA;EA5JG;;;EAmKxB,QAAA,CAAA,GAAY,OAAA;EA1JlB;;;EAAA,QAqLQ,yBAAA;EA5HR;;;EAAA,QAwIQ,eAAA;EA/HF;;;EAAA,QA2IE,aAAA;EA7FR;;;;;;;EAAA,QA6GQ,aAAA;EAjFR;;;EAAA,QAgHQ,eAAA;EAlGF;;;EAAA,QA8GE,gBAAA;EA3DA;;;EAAA,QA+FA,gBAAA;EAAA;;;EAAA,QAWA,eAAA;EAUiB;;;EAAA,QAAjB,iBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/module/module.decorator.ts"],"mappings":";;;;cAea,kBAAA;AAyBb;;;;;;;;;;;;;;;AAAA,iBAAgB,MAAA,CAAO,OAAA,EAAS,aAAA,uCACa,IAAA,uBAA2B,MAAA,EAAQ,SAAA,KAAY,SAAA;;AAmB5F;;iBAAgB,gBAAA,CAAiB,MAAA,EAAQ,WAAA,GAAc,aAAA;;;;iBAOvC,aAAA,CAAc,MAAA,YAAkB,MAAA,IAAU,WAAA"}

package/dist/module/index.mjs

@@ -1,12 +1,2 @@
-import "../errors-CtCi1wn6.mjs";
-import "../decorate-D5j-d9_z.mjs";
-import "../logger-BR1-s1Um.mjs";
-import { a as isModuleClass, i as getModuleOptions, n as MODULE_OPTIONS_KEY, r as Module, t as ModuleRegistry } from "../module-BgdxxzBe.mjs";
-import "../events-CXl-o1Ad.mjs";
-import "../colors-DJaRDXoS.mjs";
-import "../command-BvCOD6df.mjs";
-import "../is-command-BfCgWAcQ.mjs";
-import "../is-seeder-CebjZCDn.mjs";
-import "../middleware-C0Ebzswy.mjs";
-import "../router-context-BEJe9HEB.mjs";
+import { C as getModuleOptions, S as Module, t as ModuleRegistry, w as isModuleClass, x as MODULE_OPTIONS_KEY } from "../module-C3YZ-kZN.mjs";
 export { MODULE_OPTIONS_KEY, Module, ModuleRegistry, getModuleOptions, isModuleClass };