@seedcord/services 0.6.0 → 0.7.0-next.0

package/dist/index.d.ts

@@ -1,656 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { ILogger, TypedExclude } from '@seedcord/types';
-import { IntClosedRange, UnionToTuple } from 'type-fest';
-
-/**
- * Configuration options for CooldownManager.
- */
-interface CooldownOptions {
-    /** Cooldown window in milliseconds (default 1000) */
-    cooldown?: number;
-    /** Custom error class to throw when a key is still cooling down */
-    err?: new (msg: string, ...args: any[]) => Error;
-    /** Message passed to the error constructor (default "Cooldown active") */
-    message?: string;
-}
-/**
- * Lightweight utility for per-key cooldowns.
- *
- * Manages time-based restrictions on operations by key,
- * useful for rate limiting, command cooldowns, and spam prevention.
- */
-declare class CooldownManager {
-    private readonly window;
-    private readonly Err;
-    private readonly msg;
-    private readonly map;
-    /**
-     * Creates a new CooldownManager instance.
-     *
-     * @param opts - Configuration options for the cooldown behavior
-     */
-    constructor(opts?: CooldownOptions);
-    /**
-     * Records usage timestamp for a key without any cooldown checks.
-     *
-     * @param key - The unique identifier for the cooldown entry
-     */
-    set(key: string): void;
-    /**
-     * Verifies cooldown status for a key and updates timestamp if not active.
-     *
-     * If the cooldown is still active, throws the configured error.
-     * If not active, updates the timestamp and returns successfully.
-     *
-     * @param key - The unique identifier to check cooldown for
-     * @throws An {@link Err} When the cooldown is still active for the given key
-     */
-    check(key: string): void;
-    /**
-     * Checks if a key is currently cooling down without updating timestamp.
-     *
-     * @param key - The unique identifier to check
-     * @returns True if the key is still cooling down, false otherwise
-     */
-    isActive(key: string): boolean;
-    /**
-     * Removes a key from the cooldown map.
-     *
-     * @param key - The unique identifier to remove (useful for manual resets)
-     */
-    clear(key: string): void;
-}
-
-declare enum SeedcordErrorCode {
-    ConfigMissingDiscordToken = 1001,
-    ConfigUnknownExceptionWebhookMissing = 1002,
-    ConfigUnknownExceptionWebhookInvalid = 1003,
-    LifecycleAddAfterCompletion = 1101,
-    LifecycleAddDuringRun = 1102,
-    LifecycleRemoveDuringRun = 1103,
-    LifecycleUnknownPhase = 1104,
-    LifecyclePhaseFailures = 1105,
-    LifecycleTaskTimeout = 1106,
-    CoreSingletonViolation = 1201,
-    CorePluginAfterInit = 1202,
-    CorePluginKeyExists = 1203,
-    CoreBotRoleMissing = 1204,
-    DecoratorInteractionEventFilter = 1301,
-    DecoratorMethodNotFound = 1302,
-    DecoratorCommandAlreadyRegistered = 1303,
-    DecoratorCommandGlobalWithGuilds = 1304,
-    DecoratorCommandGuildWithoutGuilds = 1305,
-    DecoratorInvalidMiddlewarePriority = 1306,
-    UtilHexInputType = 1401,
-    UtilHexInvalid = 1402,
-    UtilInvalidSlashRouteArgument = 1403,
-    PluginMongoServiceDecoratorMissing = 2101,
-    PluginMongoModelDecoratorMissing = 2102,
-    PluginMongoConnectionFailed = 2103,
-    PluginKpgServiceDecoratorMissing = 2201,
-    PluginKpgServiceTableMissing = 2202,
-    PluginKpgInvalidStepCount = 2203,
-    PluginKpgUnknownDirection = 2204,
-    PluginKpgUnresolvedMigrationsPath = 2205,
-    PluginKpgNoMigrationFiles = 2206,
-    PluginKpgInvalidMigrationModule = 2207,
-    PluginKpgNonErrorFailure = 2208
-}
-
-declare const messages: {
-    readonly 1001: () => string;
-    readonly 1002: () => string;
-    readonly 1003: () => string;
-    readonly 1101: () => string;
-    readonly 1102: () => string;
-    readonly 1103: () => string;
-    readonly 1104: (phase: unknown) => string;
-    readonly 1105: (phase: string, failures: number) => string;
-    readonly 1106: (taskName: string, timeout: number) => string;
-    readonly 1201: () => string;
-    readonly 1202: () => string;
-    readonly 1203: (key: string) => string;
-    readonly 1204: (guildId?: string) => string;
-    readonly 1301: () => string;
-    readonly 1302: () => string;
-    readonly 1303: (commandName: string, existingScope: string, requestedScope: string) => string;
-    readonly 1304: () => string;
-    readonly 1305: () => string;
-    readonly 1306: () => string;
-    readonly 1401: () => string;
-    readonly 1402: () => string;
-    readonly 1403: () => string;
-    readonly 2101: (className: string) => string;
-    readonly 2102: (className: string) => string;
-    readonly 2103: (databaseName?: string) => string;
-    readonly 2201: (className: string) => string;
-    readonly 2202: (className: string) => string;
-    readonly 2203: () => string;
-    readonly 2204: (direction: unknown) => string;
-    readonly 2205: (label: string) => string;
-    readonly 2206: () => string;
-    readonly 2207: (filePath: string) => string;
-    readonly 2208: (message: string) => string;
-};
-type SeedcordErrorArguments<TCode extends SeedcordErrorCode> = Parameters<(typeof messages)[TCode]>;
-declare function formatSeedcordErrorMessage<TCode extends SeedcordErrorCode>(code: TCode, args?: SeedcordErrorArguments<TCode>): string;
-
-type SeedcordErrorIdentifier = keyof typeof SeedcordErrorCode;
-interface SeedcordErrorOptions extends ErrorOptions {
-}
-declare class SeedcordError extends Error {
-    readonly code: SeedcordErrorCode;
-    readonly identifier: SeedcordErrorIdentifier;
-    constructor(code: SeedcordErrorCode, args?: SeedcordErrorArguments<SeedcordErrorCode>, options?: SeedcordErrorOptions);
-}
-declare class SeedcordTypeError extends TypeError {
-    readonly code: SeedcordErrorCode;
-    readonly identifier: SeedcordErrorIdentifier;
-    constructor(code: SeedcordErrorCode, args?: SeedcordErrorArguments<SeedcordErrorCode>, options?: SeedcordErrorOptions);
-}
-declare class SeedcordRangeError extends RangeError {
-    readonly code: SeedcordErrorCode;
-    readonly identifier: SeedcordErrorIdentifier;
-    constructor(code: SeedcordErrorCode, args?: SeedcordErrorArguments<SeedcordErrorCode>, options?: SeedcordErrorOptions);
-}
-declare const SeedcordErrors: {
-    readonly Error: typeof SeedcordError;
-    readonly TypeError: typeof SeedcordTypeError;
-    readonly RangeError: typeof SeedcordRangeError;
-};
-type AnySeedcordError = SeedcordError | SeedcordTypeError | SeedcordRangeError;
-declare function isSeedcordError(error: unknown): error is AnySeedcordError;
-
-/**
- * Logging service with console and file output support
- *
- * Provides structured logging with timestamps, levels, and labels.
- * Instances are cached by transport name for consistent formatting.
- */
-declare class Logger implements ILogger {
-    private logger;
-    private static readonly instances;
-    private static instance;
-    constructor(transportName: string);
-    private getFormatCustomizations;
-    private createConsoleTransport;
-    private initializeLogger;
-    /**
-     * Logs an error message with optional additional data.
-     *
-     * @param msg - The error message to log
-     * @param args - Additional data to include in the log entry
-     */
-    error(msg: string, ...args: unknown[]): void;
-    /**
-     * Logs a warning message with optional additional data.
-     *
-     * @param msg - The warning message to log
-     * @param args - Additional data to include in the log entry
-     */
-    warn(msg: string, ...args: unknown[]): void;
-    /**
-     * Logs an informational message with optional additional data.
-     *
-     * @param msg - The informational message to log
-     * @param args - Additional data to include in the log entry
-     */
-    info(msg: string, ...args: unknown[]): void;
-    /**
-     * Logs an HTTP-related message with optional additional data.
-     *
-     * @param msg - The HTTP message to log
-     * @param args - Additional data to include in the log entry
-     */
-    http(msg: string, ...args: unknown[]): void;
-    /**
-     * Logs a verbose message with optional additional data.
-     *
-     * @param msg - The verbose message to log
-     * @param args - Additional data to include in the log entry
-     */
-    verbose(msg: string, ...args: unknown[]): void;
-    /**
-     * Logs a debug message with optional additional data.
-     *
-     * @param msg - The debug message to log
-     * @param args - Additional data to include in the log entry
-     */
-    debug(msg: string, ...args: unknown[]): void;
-    /**
-     * Logs a silly/trace level message with optional additional data.
-     *
-     * @param msg - The silly message to log
-     * @param args - Additional data to include in the log entry
-     */
-    silly(msg: string, ...args: unknown[]): void;
-    /**
-     * Static method to log an error message with a specific prefix.
-     * Creates or retrieves a logger instance for the given prefix.
-     *
-     * @param prefix - The logger prefix/label to use
-     * @param msg - The error message to log
-     * @param args - Additional data to include in the log entry
-     */
-    static Error(prefix: string, msg: string, ...args: unknown[]): void;
-    /**
-     * Static method to log an informational message with a specific prefix.
-     * Creates or retrieves a logger instance for the given prefix.
-     *
-     * @param prefix - The logger prefix/label to use
-     * @param msg - The informational message to log
-     * @param args - Additional data to include in the log entry
-     */
-    static Info(prefix: string, msg: string, ...args: unknown[]): void;
-    /**
-     * Static method to log a warning message with a specific prefix.
-     * Creates or retrieves a logger instance for the given prefix.
-     *
-     * @param prefix - The logger prefix/label to use
-     * @param msg - The warning message to log
-     * @param args - Additional data to include in the log entry
-     */
-    static Warn(prefix: string, msg: string, ...args: unknown[]): void;
-    /**
-     * Static method to log a debug message with a specific prefix.
-     * Creates or retrieves a logger instance for the given prefix.
-     *
-     * @param prefix - The logger prefix/label to use
-     * @param msg - The debug message to log
-     * @param args - Additional data to include in the log entry
-     */
-    static Debug(prefix: string, msg: string, ...args: unknown[]): void;
-    /**
-     * Static method to log a silly/trace level message with a specific prefix.
-     * Creates or retrieves a logger instance for the given prefix.
-     *
-     * @param prefix - The logger prefix/label to use
-     * @param msg - The silly message to log
-     * @param args - Additional data to include in the log entry
-     */
-    static Silly(prefix: string, msg: string, ...args: unknown[]): void;
-}
-
-/** Actions that can occur during lifecycle phases */
-type LifecycleAction = 'start' | 'complete' | 'error';
-/**
- * Creates event names for lifecycle managers with phase numbers and actions
- * @typeParam Prefix - The prefix string for lifecycle events
- * @typeParam Phases - Array of phase numbers to generate events for
- */
-type PhaseEvents<Prefix extends string, Phases extends number[]> = `phase:${IntClosedRange<1, Phases['length']>}:${TypedExclude<LifecycleAction, 'error'>}` | `${Prefix}:${LifecycleAction}`;
-/** Base interface for a lifecycle task */
-interface LifecycleTask {
-    /** Name of the task */
-    name: string;
-    /** Function to execute the task */
-    task: () => Promise<void>;
-    /** Timeout for the task */
-    timeout: number;
-}
-
-/**
- * Abstract base class for coordinated lifecycle management (startup/shutdown)
- */
-declare abstract class CoordinatedLifecycle<TPhase extends number> {
-    protected readonly phaseOrder: TPhase[];
-    protected readonly phaseEnum: Record<number, string>;
-    protected readonly logger: Logger;
-    protected readonly events: EventEmitter<[never]>;
-    protected readonly tasksMap: Map<TPhase, LifecycleTask[]>;
-    protected constructor(loggerName: string, phaseOrder: TPhase[], phaseEnum: Record<number, string>);
-    /**
-     * Adds a lifecycle task to a specific phase.
-     *
-     * Tasks are executed in phase order during lifecycle operations.
-     * Each task has a timeout to prevent hanging operations.
-     *
-     * @param phase - The lifecycle phase to add the task to
-     * @param taskName - Unique name for the task (used for logging and removal)
-     * @param task - Async function to execute during the phase
-     * @param timeoutMs - Maximum time allowed for task execution in milliseconds
-     * @example
-     * ```typescript
-     * lifecycle.addTask(StartupPhase.Services, 'start-database', async () => {
-     *   await database.connect();
-     * }, 10000);
-     * ```
-     */
-    addTask(phase: TPhase, taskName: string, task: () => Promise<void>, timeoutMs: number): void;
-    /**
-     * Removes a lifecycle task from a specific phase.
-     *
-     * @param phase - The lifecycle phase to remove the task from
-     * @param taskName - Name of the task to remove
-     * @returns True if the task was found and removed, false otherwise
-     */
-    removeTask(phase: TPhase, taskName: string): boolean;
-    /**
-     * Run all tasks in a specific phase
-     */
-    protected runPhase(phase: TPhase): Promise<void>;
-    /**
-     * Run a single task with timeout
-     */
-    protected runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void>;
-    /**
-     * Subscribe to lifecycle events
-     */
-    on(event: string, listener: (...args: unknown[]) => void): void;
-    /**
-     * Unsubscribe from lifecycle events
-     */
-    off(event: string, listener: (...args: unknown[]) => void): void;
-    protected emit(event: string, ...args: unknown[]): boolean;
-    protected abstract canAddTask(): boolean;
-    protected abstract canRemoveTask(): boolean;
-    protected abstract getTaskType(): string;
-    protected abstract executeTasksInPhase(phase: TPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
-}
-
-/**
- * Shutdown phases for coordinated application shutdown.
- */
-declare enum ShutdownPhase {
-    /** Stop accepting new requests/interactions */
-    StopAcceptingRequests = 1,
-    /** Stop background services (health checks, etc.) */
-    StopServices = 2,
-    /** Disconnect from external resources (database, APIs) */
-    ExternalResources = 3,
-    /** Disconnect from Discord */
-    DiscordCleanup = 4,
-    /** Final cleanup tasks */
-    FinalCleanup = 5
-}
-/**
- * Event keys for coordinated shutdown phases
- */
-type CoordinatedShutdownEventKey = PhaseEvents<'shutdown', UnionToTuple<ShutdownPhase>>;
-/**
- * CoordinatedShutdown manages graceful application shutdown by executing registered tasks across defined phases.
- *
- * It listens for termination signals (SIGINT, SIGTERM) and runs tasks in parallel within each phase.
- * Tasks can be added or removed dynamically, and each task has an associated timeout.
- *
- * Enable or disable the shutdown mechanism via the SHUTDOWN_IS_ENABLED environment variable. It's disabled by default. I recommend enabling it in production environments.
- */
-declare class CoordinatedShutdown extends CoordinatedLifecycle<ShutdownPhase> {
-    private readonly isShutdownEnabled;
-    private isShuttingDown;
-    private exitCode;
-    constructor();
-    protected canAddTask(): boolean;
-    protected canRemoveTask(): boolean;
-    protected getTaskType(): string;
-    protected executeTasksInPhase(phase: ShutdownPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
-    private registerSignalHandlers;
-    /**
-     * Adds a task to a specific shutdown phase with timeout.
-     *
-     * @param phase - The shutdown phase from {@link ShutdownPhase}
-     * @param taskName - Unique identifier for the task
-     * @param task - Async function to execute
-     * @param timeoutMs - Task timeout in milliseconds (default: 5000)
-     */
-    addTask(phase: ShutdownPhase, taskName: string, task: () => Promise<void>, timeoutMs?: number): void;
-    /**
-     * Removes a task from a specific shutdown phase.
-     *
-     * @param phase - The shutdown phase to remove from
-     * @param taskName - Name of the task to remove
-     * @returns True if task was found and removed
-     */
-    removeTask(phase: ShutdownPhase, taskName: string): boolean;
-    /**
-     * Executes the coordinated shutdown sequence.
-     *
-     * Runs all registered tasks across shutdown phases in reverse order.
-     * Tasks within each phase are executed in parallel for faster shutdown.
-     * Process exits with the specified code when complete.
-     *
-     * @param exitCode - Process exit code (default: `0`)
-     * @returns Promise that resolves when shutdown is complete
-     * @example
-     * ```typescript
-     * shutdown.addTask(ShutdownPhase.Services, 'database', () => db.disconnect(), 5000);
-     * await shutdown.run(0); // Graceful shutdown
-     * ```
-     */
-    run(exitCode?: number): Promise<void>;
-    /**
-     * Subscribe to shutdown events
-     */
-    on(event: CoordinatedShutdownEventKey, listener: (...args: unknown[]) => void): void;
-    /**
-     * Unsubscribe from shutdown events
-     */
-    off(event: CoordinatedShutdownEventKey, listener: (...args: unknown[]) => void): void;
-}
-
-/**
- * HTTP health check service for monitoring bot status.
- *
- * Provides a simple HTTP endpoint that responds with JSON status
- * information, useful for container orchestration and monitoring.
- */
-declare class HealthCheck {
-    readonly logger: Logger;
-    /**
-     * Set `PORT` in your `.env` to change the default port (6956).
-     */
-    readonly port: number;
-    /**
-     * Set `HEALTH_CHECK_PATH` in your `.env` to change the default path (`/healthcheck`).
-     */
-    readonly path: string;
-    /**
-     * Set `HEALTH_CHECK_HOST` in your `.env` to change the host. Defaults to `null` (all interfaces).
-     */
-    readonly host: string | null;
-    private server?;
-    constructor(shutdown: CoordinatedShutdown);
-    /**
-     * Starts the health check server.
-     * @returns Promise that resolves when the server is listening
-     */
-    init(): Promise<void>;
-    /**
-     * Stops the health check server.
-     *
-     * @returns Promise that resolves when the server is closed
-     */
-    stop(): Promise<void>;
-}
-
-/** Tuple type used for all event payloads. */
-type SEArgsTuple = readonly unknown[];
-/** Convenience map for emitters that intentionally expose no events. */
-type SENoEvents = Record<never, SEArgsTuple>;
-/**
- * Accepts any object type and constrains every value to be a tuple.
- *
- * @typeParam TEvents - Map of event names to readonly tuple payloads
- */
-type SEEventMapLike<TEvents extends object> = {
-    [K in keyof TEvents]: SEArgsTuple;
-};
-/**
- * Narrows a provided event map to the keys that can be emitted or listened for.
- *
- * @typeParam TEvents - Map of event names to readonly tuple payloads
- * @internal
- */
-type SEEventKey<TEvents extends object> = Extract<keyof TEvents, string | symbol>;
-/**
- * Typed wrapper around Node.js {@link EventEmitter} enforcing tuple payloads per event name.
- *
- * @typeParam TEvents - Map of event names to readonly tuple payloads
- */
-declare class StrictEventEmitter<TEvents extends SEEventMapLike<TEvents>> extends EventEmitter {
-    /**
-     * Registers a persistent listener with tuple-safe arguments for the given event.
-     *
-     * @param event - The event name to attach to
-     * @param listener - Callback operating on the typed argument tuple for the event
-     * @returns This emitter instance for chaining
-     */
-    on<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, listener: (...args: TEvents[TEventKey]) => void): this;
-    /**
-     * Registers a one time listener that is removed after the first invocation.
-     *
-     * @param event - The event name to attach to
-     * @param listener - Callback operating on the typed argument tuple for the event
-     * @returns This emitter instance for chaining
-     */
-    once<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, listener: (...args: TEvents[TEventKey]) => void): this;
-    /**
-     * Removes a previously registered listener for the given event.
-     *
-     * @param event - The event name whose listener should be removed
-     * @param listener - Callback originally registered for the event
-     * @returns This emitter instance for chaining
-     */
-    off<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, listener: (...args: TEvents[TEventKey]) => void): this;
-    /**
-     * Alias of {@link StrictEventEmitter.on} for compatibility with Node.js EventEmitter APIs.
-     *
-     * @param event - The event name to attach to
-     * @param listener - Callback operating on the typed argument tuple for the event
-     * @returns This emitter instance for chaining
-     */
-    addListener<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, listener: (...args: TEvents[TEventKey]) => void): this;
-    /**
-     * Alias of {@link StrictEventEmitter.off} for compatibility with Node.js EventEmitter APIs.
-     *
-     * @param event - The event name whose listener should be removed
-     * @param listener - Callback originally registered for the event
-     * @returns This emitter instance for chaining
-     */
-    removeListener<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, listener: (...args: TEvents[TEventKey]) => void): this;
-    /**
-     * Emits an event with the strictly typed argument tuple for the event name.
-     *
-     * @param event - The event name to emit
-     * @param args - Tuple payload for the event
-     * @returns True when the event had listeners, false otherwise
-     */
-    emit<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, ...args: TEvents[TEventKey]): boolean;
-    /**
-     * Retrieves the listener list for a given event with the correct tuple signature.
-     *
-     * @param event - The event name to inspect
-     * @returns Array of listeners registered for the event
-     */
-    listeners<TEventKey extends SEEventKey<TEvents>>(event: TEventKey): ((...args: TEvents[TEventKey]) => void)[];
-    /**
-     * Counts listeners for an event without widening the return type of {@link EventEmitter.listenerCount}.
-     *
-     * @param event - The event name to inspect
-     * @returns The total number of listeners registered for the event
-     */
-    listenerCountTyped<TEventKey extends SEEventKey<TEvents>>(event: TEventKey): number;
-    /**
-     * Returns the list of event names known to the emitter with the mapped key type.
-     *
-     * @returns Array of event keys supported by the emitter
-     */
-    eventNamesTyped(): SEEventKey<TEvents>[];
-    /**
-     * Waits for an event to be emitted, resolving with the listener arguments tuple once triggered.
-     * Supports optional abort signals and timeouts for cancellation semantics.
-     *
-     * @param event - The event name to wait for
-     * @param opts - Optional abort signal or timeout in milliseconds
-     * @returns Promise resolving with the emitted argument tuple; rejects when aborted or timed out
-     */
-    waitFor<TEventKey extends SEEventKey<TEvents>>(event: TEventKey, opts?: {
-        signal?: AbortSignal;
-        timeoutMs?: number;
-    }): Promise<TEvents[TEventKey]>;
-}
-
-/**
- * Startup phases for coordinated initialization
- *
- * Defines the order in which different components are initialized during bot startup.
- */
-declare enum StartupPhase {
-    /** Validate environment variables and config files */
-    Validation = 1,
-    /** Discover plugin constructors via decorators or registry */
-    Discovery = 2,
-    /** Register plugin metadata and declared dependencies */
-    Registration = 3,
-    /** Inject and validate plugin-specific configuration */
-    Configuration = 4,
-    /** Instantiate plugin classes with Core and arguments */
-    Instantiation = 5,
-    /** Activate plugins by calling their init/setup effects */
-    Activation = 6,
-    /** Mark seedcord as ready and start handling interactions */
-    Ready = 7
-}
-/**
- * Event keys for coordinated startup phases
- */
-type CoordinatedStartupEventKey = PhaseEvents<'startup', UnionToTuple<StartupPhase>>;
-/**
- * Manages bot startup lifecycle with ordered phases
- *
- * Coordinates initialization of all bot components in a predictable sequence.
- * Tasks are executed within their designated phases to ensure proper dependency order.
- */
-declare class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase> {
-    private isStartingUp;
-    private hasStarted;
-    constructor();
-    /**
-     * Adds a task to a specific startup phase with timeout.
-     *
-     * @param phase - The startup phase from {@link StartupPhase}
-     * @param taskName - Unique identifier for the task
-     * @param task - Async function to execute
-     * @param timeoutMs - Task timeout in milliseconds (default: 10000)
-     */
-    addTask(phase: StartupPhase, taskName: string, task: () => Promise<void>, timeoutMs?: number): void;
-    protected canAddTask(): boolean;
-    protected canRemoveTask(): boolean;
-    protected getTaskType(): string;
-    protected executeTasksInPhase(phase: StartupPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
-    /**
-     * Executes the coordinated startup sequence.
-     *
-     * Runs all registered tasks across startup phases in the correct order.
-     * Each phase completes before the next phase begins. Tasks within a phase
-     * are executed sequentially to maintain predictable initialization.
-     *
-     * @returns Promise that resolves when startup is complete
-     * @throws An {@link Error} If startup fails or is called multiple times
-     * @example
-     * ```typescript
-     * const startup = new CoordinatedStartup();
-     * startup.addTask(StartupPhase.Services, 'database', () => db.connect(), 10000);
-     * await startup.run();
-     * ```
-     */
-    run(): Promise<void>;
-    /**
-     * Subscribe to startup events
-     */
-    on(event: CoordinatedStartupEventKey, listener: (...args: unknown[]) => void): void;
-    /**
-     * Unsubscribe from startup events
-     */
-    off(event: CoordinatedStartupEventKey, listener: (...args: unknown[]) => void): void;
-    /**
-     * Check if startup has completed
-     */
-    get isReady(): boolean;
-    /**
-     * Check if startup is currently running
-     */
-    get isRunning(): boolean;
-}
-
-export { type AnySeedcordError, CooldownManager, type CooldownOptions, CoordinatedLifecycle, CoordinatedShutdown, type CoordinatedShutdownEventKey, CoordinatedStartup, type CoordinatedStartupEventKey, HealthCheck, type LifecycleAction, type LifecycleTask, Logger, type PhaseEvents, type SEArgsTuple, type SEEventKey, type SEEventMapLike, type SENoEvents, SeedcordError, type SeedcordErrorArguments, SeedcordErrorCode, type SeedcordErrorIdentifier, type SeedcordErrorOptions, SeedcordErrors, SeedcordRangeError, SeedcordTypeError, ShutdownPhase, StartupPhase, StrictEventEmitter, formatSeedcordErrorMessage, isSeedcordError, messages as seedcordErrorMessages };