@seedcord/services 0.2.1 → 0.3.0

package/dist/index.mjs

@@ -107,124 +107,124 @@ ${parts.join(" ")}`;
     });
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.error(msg, ...args);
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.warn(msg, ...args);
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.info(msg, ...args);
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.http(msg, ...args);
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.verbose(msg, ...args);
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.debug(msg, ...args);
   }
   /**
-  * 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
-  */
+   * 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, ...args) {
     this.logger.silly(msg, ...args);
   }
   /**
-  * 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 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, msg, ...args) {
     const logger = this.instance(prefix);
     logger.error(msg, ...args);
   }
   /**
-  * 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 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, msg, ...args) {
     const logger = this.instance(prefix);
     logger.info(msg, ...args);
   }
   /**
-  * 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 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, msg, ...args) {
     const logger = this.instance(prefix);
     logger.warn(msg, ...args);
   }
   /**
-  * 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 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, msg, ...args) {
     const logger = this.instance(prefix);
     logger.debug(msg, ...args);
   }
   /**
-  * 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 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, msg, ...args) {
     const logger = this.instance(prefix);
     logger.silly(msg, ...args);
@@ -246,22 +246,22 @@ var CoordinatedLifecycle = class {
     this.phaseOrder.forEach((phase) => this.tasksMap.set(phase, []));
   }
   /**
-  * 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);
-  * ```
-  */
+   * 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, taskName, task, timeoutMs) {
     if (!this.canAddTask()) return;
     const tasks = this.tasksMap.get(phase);
@@ -274,12 +274,12 @@ var CoordinatedLifecycle = class {
     this.logger.debug(`${chalk.italic("Added")} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} to phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
   }
   /**
-  * 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
-  */
+   * 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, taskName) {
     if (!this.canRemoveTask()) return false;
     const tasks = this.tasksMap.get(phase);
@@ -294,8 +294,8 @@ var CoordinatedLifecycle = class {
     return removed;
   }
   /**
-  * Run all tasks in a specific phase
-  */
+   * Run all tasks in a specific phase
+   */
   async runPhase(phase) {
     const tasks = this.tasksMap.get(phase) ?? [];
     if (tasks.length === 0) {
@@ -315,8 +315,8 @@ var CoordinatedLifecycle = class {
     this.emit(`phase:${phase}:complete`);
   }
   /**
-  * Run a single task with timeout
-  */
+   * Run a single task with timeout
+   */
   async runTaskWithTimeout(phase, task) {
     this.logger.info(`${chalk.italic("Starting")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
     try {
@@ -335,14 +335,14 @@ var CoordinatedLifecycle = class {
     }
   }
   /**
-  * Subscribe to lifecycle events
-  */
+   * Subscribe to lifecycle events
+   */
   on(event, listener) {
     this.events.on(event, listener);
   }
   /**
-  * Unsubscribe from lifecycle events
-  */
+   * Unsubscribe from lifecycle events
+   */
   off(event, listener) {
     this.events.off(event, listener);
   }
@@ -427,41 +427,41 @@ var CoordinatedShutdown = class extends CoordinatedLifecycle {
     });
   }
   /**
-  * 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)
-  */
+   * 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, taskName, task, timeoutMs = 5e3) {
     super.addTask(phase, taskName, task, timeoutMs);
   }
   /**
-  * 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
-  */
+   * 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, taskName) {
     return super.removeTask(phase, taskName);
   }
   /**
-  * 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
-  * ```
-  */
+   * 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
+   * ```
+   */
   async run(exitCode = 0) {
     if (this.isShuttingDown) {
       this.logger.warn("Shutdown sequence already in progress");
@@ -488,14 +488,14 @@ var CoordinatedShutdown = class extends CoordinatedLifecycle {
     }
   }
   /**
-  * Subscribe to shutdown events
-  */
+   * Subscribe to shutdown events
+   */
   on(event, listener) {
     super.on(event, listener);
   }
   /**
-  * Unsubscribe from shutdown events
-  */
+   * Unsubscribe from shutdown events
+   */
   off(event, listener) {
     super.off(event, listener);
   }
@@ -531,9 +531,9 @@ var HealthCheck = class {
     shutdown.addTask(ShutdownPhase.StopServices, "stop-healthcheck-server", async () => await this.stop());
   }
   /**
-  * Starts the health check server.
-  * @returns Promise that resolves when the server is listening
-  */
+   * Starts the health check server.
+   * @returns Promise that resolves when the server is listening
+   */
   async init() {
     return new Promise((resolve, reject) => {
       this.server = createServer((req, res) => {
@@ -555,17 +555,25 @@ var HealthCheck = class {
         }
       });
       this.server.on("error", reject);
-      this.server.once("listening", () => resolve());
-      this.server.listen(this.port, () => {
-        this.logger.info(`${chalk.green.bold("\u2713")} Health check server listening on ${chalk.cyan(`http://localhost:${this.port}${this.path}`)}`);
+      this.server.once("listening", () => {
+        const address = this.host ?? "localhost";
+        this.logger.info(`${chalk.green.bold("\u2713")} Health check server listening on ${chalk.cyan(`http://${address}:${this.port}${this.path}`)}`);
+        resolve();
       });
+      if (this.host) {
+        this.logger.debug(`Binding health check server to ${this.host}`);
+        this.server.listen(this.port, this.host);
+      } else {
+        this.logger.debug("Binding health check server to all interfaces");
+        this.server.listen(this.port);
+      }
     });
   }
   /**
-  * Stops the health check server.
-  *
-  * @returns Promise that resolves when the server is closed
-  */
+   * Stops the health check server.
+   *
+   * @returns Promise that resolves when the server is closed
+   */
   stop() {
     if (this.server !== void 0) {
       const server = this.server;
@@ -591,6 +599,10 @@ _ts_decorate2([
   }),
   _ts_metadata2("design:type", String)
 ], HealthCheck.prototype, "path", void 0);
+_ts_decorate2([
+  Envapt("HEALTH_CHECK_HOST"),
+  _ts_metadata2("design:type", Object)
+], HealthCheck.prototype, "host", void 0);
 var CooldownManager = class {
   static {
     __name(this, "CooldownManager");
@@ -600,32 +612,32 @@ var CooldownManager = class {
   msg;
   map = /* @__PURE__ */ new Map();
   /**
-  * Creates a new CooldownManager instance.
-  *
-  * @param opts - Configuration options for the cooldown behavior
-  */
+   * Creates a new CooldownManager instance.
+   *
+   * @param opts - Configuration options for the cooldown behavior
+   */
   constructor(opts = {}) {
     this.window = opts.cooldown ?? 1e3;
     this.Err = opts.err ?? Error;
     this.msg = opts.message ?? "Cooldown active";
   }
   /**
-  * Records usage timestamp for a key without any cooldown checks.
-  *
-  * @param key - The unique identifier for the cooldown entry
-  */
+   * Records usage timestamp for a key without any cooldown checks.
+   *
+   * @param key - The unique identifier for the cooldown entry
+   */
   set(key) {
     this.map.set(key, Date.now());
   }
   /**
-  * 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
-  */
+   * 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) {
     const now = Date.now();
     const last = this.map.get(key);
@@ -639,20 +651,20 @@ var CooldownManager = class {
     this.map.set(key, now);
   }
   /**
-  * 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
-  */
+   * 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) {
     const last = this.map.get(key);
     return last !== void 0 && Date.now() - last < this.window;
   }
   /**
-  * Removes a key from the cooldown map.
-  *
-  * @param key - The unique identifier to remove (useful for manual resets)
-  */
+   * Removes a key from the cooldown map.
+   *
+   * @param key - The unique identifier to remove (useful for manual resets)
+   */
   clear(key) {
     this.map.delete(key);
   }
@@ -686,13 +698,13 @@ var CoordinatedStartup = class extends CoordinatedLifecycle {
     super("CoordinatedStartup", PHASE_ORDER2, StartupPhase);
   }
   /**
-  * 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)
-  */
+   * 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, taskName, task, timeoutMs = 1e4) {
     super.addTask(phase, taskName, task, timeoutMs);
   }
@@ -732,21 +744,21 @@ var CoordinatedStartup = class extends CoordinatedLifecycle {
     return results;
   }
   /**
-  * 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();
-  * ```
-  */
+   * 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();
+   * ```
+   */
   async run() {
     if (this.hasStarted) {
       this.logger.warn("Startup sequence has already completed");
@@ -773,26 +785,26 @@ var CoordinatedStartup = class extends CoordinatedLifecycle {
     }
   }
   /**
-  * Subscribe to startup events
-  */
+   * Subscribe to startup events
+   */
   on(event, listener) {
     super.on(event, listener);
   }
   /**
-  * Unsubscribe from startup events
-  */
+   * Unsubscribe from startup events
+   */
   off(event, listener) {
     super.off(event, listener);
   }
   /**
-  * Check if startup has completed
-  */
+   * Check if startup has completed
+   */
   get isReady() {
     return this.hasStarted;
   }
   /**
-  * Check if startup is currently running
-  */
+   * Check if startup is currently running
+   */
   get isRunning() {
     return this.isStartingUp;
   }