BREAKING CHANGE(service): expand service lifecycle management with instance-aware hooks, startup timeouts, labels, readiness waits, and auto-restart support

ts/taskbuffer.interfaces.ts

@@ -100,7 +100,8 @@ export type TServiceEventType =
   | 'degraded'
   | 'recovered'
   | 'retrying'
-  | 'healthCheck';
+  | 'healthCheck'
+  | 'autoRestarting';
 
 export interface IServiceEvent {
   type: TServiceEventType;
@@ -124,6 +125,8 @@ export interface IServiceStatus {
   lastError?: string;
   retryCount: number;
   dependencies: string[];
+  labels?: Record<string, string>;
+  hasInstance?: boolean;
 }
 
 export interface IRetryConfig {
@@ -146,17 +149,27 @@ export interface IHealthCheckConfig {
   failuresBeforeDegraded?: number;
   /** Consecutive failures before marking failed. Default: 5 */
   failuresBeforeFailed?: number;
+  /** Auto-restart the service when it transitions to failed. Default: false */
+  autoRestart?: boolean;
+  /** Maximum number of auto-restart attempts. 0 = unlimited. Default: 3 */
+  maxAutoRestarts?: number;
+  /** Base delay in ms before first auto-restart. Default: 5000 */
+  autoRestartDelayMs?: number;
+  /** Backoff multiplier per auto-restart attempt. Default: 2 */
+  autoRestartBackoffFactor?: number;
 }
 
 export interface IServiceOptions<T = any> {
   name: string;
   start: () => Promise<T>;
-  stop: () => Promise<void>;
-  healthCheck?: () => Promise<boolean>;
+  stop: (instance: T) => Promise<void>;
+  healthCheck?: (instance: T) => Promise<boolean>;
   criticality?: TServiceCriticality;
   dependencies?: string[];
   retry?: IRetryConfig;
   healthCheckConfig?: IHealthCheckConfig;
+  startupTimeoutMs?: number;
+  labels?: Record<string, string>;
 }
 
 export interface IServiceManagerOptions {