@scpxl/nodejs-framework 1.0.14 → 1.0.19

package/dist/index.d.ts

@@ -5,12 +5,16 @@ export * from './application/index.js';
 export * from './auth/index.js';
 export * from './cache/index.js';
 export * from './command/index.js';
+export * from './config/index.js';
 export * from './database/index.js';
+export * from './error/index.js';
 export * from './event/index.js';
-export * from './redis/index.js';
+export * from './lifecycle/index.js';
 export * from './logger/index.js';
 export * from './performance/index.js';
 export * from './queue/index.js';
+export * from './redis/index.js';
+export * from './request-context/index.js';
 export * from './services/index.js';
 export * from './util/index.js';
 export * from './webserver/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,SAAS,QAA2B,CAAC;AAE3C,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,CAAC;AAEhC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,SAAS,QAA2B,CAAC;AAE3C,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,CAAC;AAEhC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -7,12 +7,16 @@ export * from "./application/index.js";
 export * from "./auth/index.js";
 export * from "./cache/index.js";
 export * from "./command/index.js";
+export * from "./config/index.js";
 export * from "./database/index.js";
+export * from "./error/index.js";
 export * from "./event/index.js";
-export * from "./redis/index.js";
+export * from "./lifecycle/index.js";
 export * from "./logger/index.js";
 export * from "./performance/index.js";
 export * from "./queue/index.js";
+export * from "./redis/index.js";
+export * from "./request-context/index.js";
 export * from "./services/index.js";
 export * from "./util/index.js";
 export * from "./webserver/index.js";

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import { fileURLToPath } from 'url';\nimport path from 'node:path';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport { __dirname as baseDir };\n\nexport * from './api-requester/index.js';\nexport * from './application/index.js';\nexport * from './auth/index.js';\nexport * from './cache/index.js';\nexport * from './command/index.js';\nexport * from './database/index.js';\nexport * from './event/index.js';\nexport * from './redis/index.js';\nexport * from './logger/index.js';\nexport * from './performance/index.js';\nexport * from './queue/index.js';\nexport * from './services/index.js';\nexport * from './util/index.js';\nexport * from './webserver/index.js';\nexport * from './websocket/index.js';\n"],
-  "mappings": "AAAA,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAEjB,MAAM,aAAa,cAAc,YAAY,GAAG;AAChD,MAAM,YAAY,KAAK,QAAQ,UAAU;AAIzC,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["import { fileURLToPath } from 'url';\nimport path from 'node:path';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport { __dirname as baseDir };\n\nexport * from './api-requester/index.js';\nexport * from './application/index.js';\nexport * from './auth/index.js';\nexport * from './cache/index.js';\nexport * from './command/index.js';\nexport * from './config/index.js';\nexport * from './database/index.js';\nexport * from './error/index.js';\nexport * from './event/index.js';\nexport * from './lifecycle/index.js';\nexport * from './logger/index.js';\nexport * from './performance/index.js';\nexport * from './queue/index.js';\nexport * from './redis/index.js';\nexport * from './request-context/index.js';\nexport * from './services/index.js';\nexport * from './util/index.js';\nexport * from './webserver/index.js';\nexport * from './websocket/index.js';\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAEjB,MAAM,aAAa,cAAc,YAAY,GAAG;AAChD,MAAM,YAAY,KAAK,QAAQ,UAAU;AAIzC,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/lifecycle/exit.d.ts

@@ -0,0 +1,11 @@
+export type ExitCode = 0 | 1 | 2 | 130 | 137 | 143;
+export interface ExitOutcome {
+    code: ExitCode;
+    reason: string;
+    error?: unknown;
+}
+type ExitHandler = (outcome: ExitOutcome) => void;
+export declare function setExitHandler(next: ExitHandler): void;
+export declare function requestExit(outcome: ExitOutcome): void;
+export {};
+//# sourceMappingURL=exit.d.ts.map

package/dist/lifecycle/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/lifecycle/exit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;AAMlD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,QAE/C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,QAqB/C"}

package/dist/lifecycle/exit.js

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+let handler = /* @__PURE__ */ __name((outcome) => {
+  process.exit(outcome.code);
+}, "handler");
+function setExitHandler(next) {
+  handler = next;
+}
+__name(setExitHandler, "setExitHandler");
+function requestExit(outcome) {
+  const nodeEnv = process.env.NODE_ENV ?? "";
+  const isTestEnv = nodeEnv.toLowerCase() === "test" || "VITEST" in process.env || "VITEST_WORKER_ID" in process.env || process.argv.some((a) => a.includes("vitest")) || typeof globalThis.afterAll === "function";
+  if (isTestEnv) {
+    console.info(`[exit] (test env) code=${outcome.code} reason=${outcome.reason}`);
+    return;
+  }
+  try {
+    handler(outcome);
+  } catch (err) {
+    console.error("Exit handler failure", err);
+    process.exit(outcome.code);
+  }
+}
+__name(requestExit, "requestExit");
+export {
+  requestExit,
+  setExitHandler
+};
+//# sourceMappingURL=exit.js.map

package/dist/lifecycle/exit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lifecycle/exit.ts"],
+  "sourcesContent": ["export type ExitCode = 0 | 1 | 2 | 130 | 137 | 143;\n\nexport interface ExitOutcome {\n  code: ExitCode;\n  reason: string;\n  error?: unknown;\n}\n\ntype ExitHandler = (outcome: ExitOutcome) => void;\n\nlet handler: ExitHandler = outcome => {\n  process.exit(outcome.code);\n};\n\nexport function setExitHandler(next: ExitHandler) {\n  handler = next;\n}\n\nexport function requestExit(outcome: ExitOutcome) {\n  const nodeEnv = process.env.NODE_ENV ?? '';\n  const isTestEnv =\n    nodeEnv.toLowerCase() === 'test' ||\n    'VITEST' in process.env ||\n    'VITEST_WORKER_ID' in process.env ||\n    process.argv.some(a => a.includes('vitest')) ||\n    typeof (globalThis as any).afterAll === 'function';\n\n  if (isTestEnv) {\n    // Suppress real process exit during tests; vitest intercepts and would throw otherwise.\n    console.info(`[exit] (test env) code=${outcome.code} reason=${outcome.reason}`);\n    return;\n  }\n\n  try {\n    handler(outcome);\n  } catch (err) {\n    console.error('Exit handler failure', err);\n    process.exit(outcome.code);\n  }\n}\n"],
+  "mappings": ";;AAUA,IAAI,UAAuB,oCAAW;AACpC,UAAQ,KAAK,QAAQ,IAAI;AAC3B,GAF2B;AAIpB,SAAS,eAAe,MAAmB;AAChD,YAAU;AACZ;AAFgB;AAIT,SAAS,YAAY,SAAsB;AAChD,QAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,QAAM,YACJ,QAAQ,YAAY,MAAM,UAC1B,YAAY,QAAQ,OACpB,sBAAsB,QAAQ,OAC9B,QAAQ,KAAK,KAAK,OAAK,EAAE,SAAS,QAAQ,CAAC,KAC3C,OAAQ,WAAmB,aAAa;AAE1C,MAAI,WAAW;AAEb,YAAQ,KAAK,0BAA0B,QAAQ,IAAI,WAAW,QAAQ,MAAM,EAAE;AAC9E;AAAA,EACF;AAEA,MAAI;AACF,YAAQ,OAAO;AAAA,EACjB,SAAS,KAAK;AACZ,YAAQ,MAAM,wBAAwB,GAAG;AACzC,YAAQ,KAAK,QAAQ,IAAI;AAAA,EAC3B;AACF;AArBgB;",
+  "names": []
+}

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,7 @@
+export { LifecycleManager } from './lifecycle-manager.js';
+export { ShutdownController } from './shutdown-controller.js';
+export { requestExit, setExitHandler } from './exit.js';
+export type { ExitCode, ExitOutcome } from './exit.js';
+export type { Disposable, LifecycleHook, LifecycleConfig } from './types.js';
+export { LifecyclePhase } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGxD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/lifecycle/index.js

@@ -0,0 +1,12 @@
+import { LifecycleManager } from "./lifecycle-manager.js";
+import { ShutdownController } from "./shutdown-controller.js";
+import { requestExit, setExitHandler } from "./exit.js";
+import { LifecyclePhase } from "./types.js";
+export {
+  LifecycleManager,
+  LifecyclePhase,
+  ShutdownController,
+  requestExit,
+  setExitHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lifecycle/index.ts"],
+  "sourcesContent": ["// Main lifecycle management\nexport { LifecycleManager } from './lifecycle-manager.js';\nexport { ShutdownController } from './shutdown-controller.js';\n\n// Exit handling\nexport { requestExit, setExitHandler } from './exit.js';\n\n// Types and interfaces\nexport type { ExitCode, ExitOutcome } from './exit.js';\n\nexport type { Disposable, LifecycleHook, LifecycleConfig } from './types.js';\n\nexport { LifecyclePhase } from './types.js';\n"],
+  "mappings": "AACA,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AAGnC,SAAS,aAAa,sBAAsB;AAO5C,SAAS,sBAAsB;",
+  "names": []
+}

package/dist/lifecycle/lifecycle-manager.d.ts

@@ -0,0 +1,66 @@
+import { type Disposable, type LifecycleConfig, type LifecycleHook, LifecyclePhase, type ReadinessCheck, type ReadinessCheckResult } from './types.js';
+export declare class LifecycleManager {
+    private _phase;
+    private config;
+    private initHooks;
+    private startHooks;
+    private readyHooks;
+    private beforeShutdownHooks;
+    private shutdownHooks;
+    private disposables;
+    private intervals;
+    private timeouts;
+    private abortControllers;
+    private readinessChecks;
+    private _isReady;
+    constructor(config?: Partial<LifecycleConfig>);
+    get phase(): LifecyclePhase;
+    get isShuttingDown(): boolean;
+    get isReady(): boolean;
+    onInit(fn: LifecycleHook): () => void;
+    onStart(fn: LifecycleHook): () => void;
+    onReady(fn: LifecycleHook): () => void;
+    onBeforeShutdown(fn: LifecycleHook): () => void;
+    onShutdown(fn: LifecycleHook): () => void;
+    addReadinessCheck(name: string, check: ReadinessCheck): () => void;
+    trackDisposable(disposable: Disposable | {
+        dispose: Function;
+    }): Disposable;
+    trackInterval(id: NodeJS.Timeout): NodeJS.Timeout;
+    trackTimeout(id: NodeJS.Timeout): NodeJS.Timeout;
+    /**
+     * Track an AbortController for automatic cleanup on shutdown.
+     * When the lifecycle manager shuts down, it will call abort() on all tracked controllers.
+     * @param controller - The AbortController to track
+     * @returns The same AbortController for chaining
+     */
+    trackAbortController(controller: AbortController): AbortController;
+    /**
+     * Create and track a new AbortController.
+     * Convenience method that creates a new controller and automatically tracks it.
+     * @returns A new tracked AbortController
+     */
+    createAbortController(): AbortController;
+    initialize(): Promise<{
+        errors: unknown[];
+    }>;
+    start(): Promise<{
+        errors: unknown[];
+    }>;
+    ready(): Promise<{
+        errors: unknown[];
+    }>;
+    shutdown(): Promise<{
+        errors: unknown[];
+        timedOut: boolean;
+    }>;
+    private performShutdown;
+    private executeHooks;
+    private waitForReadiness;
+    private executeReadinessChecks;
+    getReadinessStatus(): Promise<{
+        ready: boolean;
+        checks: ReadinessCheckResult[];
+    }>;
+}
+//# sourceMappingURL=lifecycle-manager.d.ts.map

package/dist/lifecycle/lifecycle-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/lifecycle-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,gBAAgB,CAA8B;IAEtD,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAYjD,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,MAAM,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQrC,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQtC,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQtC,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQ/C,UAAU,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAQzC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,IAAI;IAOlE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE,GAAG,UAAU;IAM3E,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;IAKjD,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;IAKhD;;;;;OAKG;IACH,oBAAoB,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe;IAKlE;;;;OAIG;IACH,qBAAqB,IAAI,eAAe;IAKlC,UAAU,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAU5C,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAUvC,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAkBvC,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;YAgCrD,eAAe;YA4Cf,YAAY;YAYZ,gBAAgB;YAmChB,sBAAsB;IAiC9B,kBAAkB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;CAKxF"}

package/dist/lifecycle/lifecycle-manager.js

@@ -0,0 +1,280 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import {
+  LifecyclePhase
+} from "./types.js";
+class LifecycleManager {
+  static {
+    __name(this, "LifecycleManager");
+  }
+  _phase = LifecyclePhase.CREATED;
+  config;
+  initHooks = [];
+  startHooks = [];
+  readyHooks = [];
+  beforeShutdownHooks = [];
+  shutdownHooks = [];
+  disposables = /* @__PURE__ */ new Set();
+  intervals = /* @__PURE__ */ new Set();
+  timeouts = /* @__PURE__ */ new Set();
+  abortControllers = /* @__PURE__ */ new Set();
+  readinessChecks = /* @__PURE__ */ new Map();
+  _isReady = false;
+  constructor(config = {}) {
+    this.config = {
+      gracefulShutdown: {
+        timeoutMs: config.gracefulShutdown?.timeoutMs ?? 1e4
+      },
+      readiness: {
+        timeoutMs: config.readiness?.timeoutMs ?? 3e4,
+        checkIntervalMs: config.readiness?.checkIntervalMs ?? 100
+      }
+    };
+  }
+  get phase() {
+    return this._phase;
+  }
+  get isShuttingDown() {
+    return this._phase === LifecyclePhase.STOPPING || this._phase === LifecyclePhase.STOPPED;
+  }
+  get isReady() {
+    return this._isReady && this._phase === LifecyclePhase.RUNNING;
+  }
+  onInit(fn) {
+    this.initHooks.push(fn);
+    return () => {
+      const i = this.initHooks.indexOf(fn);
+      if (i >= 0) this.initHooks.splice(i, 1);
+    };
+  }
+  onStart(fn) {
+    this.startHooks.push(fn);
+    return () => {
+      const i = this.startHooks.indexOf(fn);
+      if (i >= 0) this.startHooks.splice(i, 1);
+    };
+  }
+  onReady(fn) {
+    this.readyHooks.push(fn);
+    return () => {
+      const i = this.readyHooks.indexOf(fn);
+      if (i >= 0) this.readyHooks.splice(i, 1);
+    };
+  }
+  onBeforeShutdown(fn) {
+    this.beforeShutdownHooks.push(fn);
+    return () => {
+      const i = this.beforeShutdownHooks.indexOf(fn);
+      if (i >= 0) this.beforeShutdownHooks.splice(i, 1);
+    };
+  }
+  onShutdown(fn) {
+    this.shutdownHooks.push(fn);
+    return () => {
+      const i = this.shutdownHooks.indexOf(fn);
+      if (i >= 0) this.shutdownHooks.splice(i, 1);
+    };
+  }
+  addReadinessCheck(name, check) {
+    this.readinessChecks.set(name, check);
+    return () => {
+      this.readinessChecks.delete(name);
+    };
+  }
+  trackDisposable(disposable) {
+    const d = "dispose" in disposable ? { dispose: /* @__PURE__ */ __name(() => disposable.dispose(), "dispose") } : disposable;
+    this.disposables.add(d);
+    return d;
+  }
+  trackInterval(id) {
+    this.intervals.add(id);
+    return id;
+  }
+  trackTimeout(id) {
+    this.timeouts.add(id);
+    return id;
+  }
+  /**
+   * Track an AbortController for automatic cleanup on shutdown.
+   * When the lifecycle manager shuts down, it will call abort() on all tracked controllers.
+   * @param controller - The AbortController to track
+   * @returns The same AbortController for chaining
+   */
+  trackAbortController(controller) {
+    this.abortControllers.add(controller);
+    return controller;
+  }
+  /**
+   * Create and track a new AbortController.
+   * Convenience method that creates a new controller and automatically tracks it.
+   * @returns A new tracked AbortController
+   */
+  createAbortController() {
+    const controller = new AbortController();
+    return this.trackAbortController(controller);
+  }
+  async initialize() {
+    if (this._phase !== LifecyclePhase.CREATED) {
+      return { errors: [] };
+    }
+    this._phase = LifecyclePhase.INITIALIZING;
+    const errors = await this.executeHooks(this.initHooks, "init");
+    return { errors };
+  }
+  async start() {
+    if (this._phase !== LifecyclePhase.INITIALIZING) {
+      return { errors: [] };
+    }
+    this._phase = LifecyclePhase.STARTING;
+    const errors = await this.executeHooks(this.startHooks, "start");
+    return { errors };
+  }
+  async ready() {
+    if (this._phase !== LifecyclePhase.STARTING) {
+      return { errors: [] };
+    }
+    this._phase = LifecyclePhase.RUNNING;
+    const errors = await this.executeHooks(this.readyHooks, "ready");
+    const readinessResult = await this.waitForReadiness();
+    if (readinessResult.errors.length > 0) {
+      errors.push(...readinessResult.errors);
+    }
+    this._isReady = readinessResult.ready;
+    return { errors };
+  }
+  async shutdown() {
+    if (this.isShuttingDown) {
+      return { errors: [], timedOut: false };
+    }
+    this._phase = LifecyclePhase.STOPPING;
+    const timeoutMs = this.config.gracefulShutdown.timeoutMs;
+    if (timeoutMs > 0) {
+      let completed = false;
+      let timedOut = false;
+      const shutdownPromise = this.performShutdown().then((result3) => {
+        completed = true;
+        return result3;
+      });
+      const timeoutPromise = new Promise((resolve) => {
+        setTimeout(() => {
+          if (!completed) {
+            timedOut = true;
+            resolve({ errors: ["Shutdown timeout exceeded"] });
+          }
+        }, timeoutMs);
+      });
+      const result2 = await Promise.race([shutdownPromise, timeoutPromise]);
+      this._phase = LifecyclePhase.STOPPED;
+      return { errors: result2.errors, timedOut };
+    }
+    const result = await this.performShutdown();
+    this._phase = LifecyclePhase.STOPPED;
+    return { errors: result.errors, timedOut: false };
+  }
+  async performShutdown() {
+    const errors = [];
+    const beforeShutdownErrors = await this.executeHooks(this.beforeShutdownHooks, "before-shutdown");
+    errors.push(...beforeShutdownErrors);
+    for (const controller of this.abortControllers) {
+      try {
+        controller.abort();
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    this.abortControllers.clear();
+    for (const id of this.intervals) {
+      clearInterval(id);
+    }
+    for (const id of this.timeouts) {
+      clearTimeout(id);
+    }
+    this.intervals.clear();
+    this.timeouts.clear();
+    for (const disposable of this.disposables) {
+      try {
+        await disposable.dispose();
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    this.disposables.clear();
+    const shutdownErrors = await this.executeHooks([...this.shutdownHooks].reverse(), "shutdown");
+    errors.push(...shutdownErrors);
+    return { errors };
+  }
+  async executeHooks(hooks, _phase) {
+    const errors = [];
+    for (const hook of hooks) {
+      try {
+        await hook();
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    return errors;
+  }
+  async waitForReadiness() {
+    if (this.readinessChecks.size === 0) {
+      return { ready: true, errors: [] };
+    }
+    const timeoutMs = this.config.readiness?.timeoutMs ?? 3e4;
+    const checkIntervalMs = this.config.readiness?.checkIntervalMs ?? 100;
+    const startTime = Date.now();
+    const errors = [];
+    while (Date.now() - startTime < timeoutMs) {
+      const results = await this.executeReadinessChecks();
+      const allReady = results.every((r) => r.ready);
+      if (allReady) {
+        return { ready: true, errors };
+      }
+      for (const result of results) {
+        if (!result.ready && result.error) {
+          const errorMessage = result.error.message;
+          if (!errors.some((e) => e?.message === errorMessage)) {
+            errors.push(result.error);
+          }
+        }
+      }
+      await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));
+    }
+    return { ready: false, errors: [...errors, new Error("Readiness check timeout exceeded")] };
+  }
+  async executeReadinessChecks() {
+    const checkEntries = Array.from(this.readinessChecks.entries());
+    const settledResults = await Promise.allSettled(
+      checkEntries.map(async ([name, check]) => {
+        try {
+          const result = await check();
+          return { name, ready: result };
+        } catch (error) {
+          return { name, ready: false, error };
+        }
+      })
+    );
+    return settledResults.map((settledResult, index) => {
+      const checkEntry = checkEntries.at(index);
+      if (!checkEntry) {
+        throw new Error(`Missing check entry at index ${index}`);
+      }
+      const [name] = checkEntry;
+      if (settledResult.status === "fulfilled") {
+        return settledResult.value;
+      }
+      return {
+        name,
+        ready: false,
+        error: settledResult.reason
+      };
+    });
+  }
+  async getReadinessStatus() {
+    const checks = await this.executeReadinessChecks();
+    const ready = this._isReady && this._phase === LifecyclePhase.RUNNING && checks.every((c) => c.ready);
+    return { ready, checks };
+  }
+}
+export {
+  LifecycleManager
+};
+//# sourceMappingURL=lifecycle-manager.js.map

package/dist/lifecycle/lifecycle-manager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lifecycle/lifecycle-manager.ts"],
+  "sourcesContent": ["import {\n  type Disposable,\n  type LifecycleConfig,\n  type LifecycleHook,\n  LifecyclePhase,\n  type ReadinessCheck,\n  type ReadinessCheckResult,\n} from './types.js';\n\nexport class LifecycleManager {\n  private _phase: LifecyclePhase = LifecyclePhase.CREATED;\n  private config: LifecycleConfig;\n\n  private initHooks: LifecycleHook[] = [];\n  private startHooks: LifecycleHook[] = [];\n  private readyHooks: LifecycleHook[] = [];\n  private beforeShutdownHooks: LifecycleHook[] = [];\n  private shutdownHooks: LifecycleHook[] = [];\n\n  private disposables = new Set<Disposable>();\n  private intervals = new Set<NodeJS.Timeout>();\n  private timeouts = new Set<NodeJS.Timeout>();\n  private abortControllers = new Set<AbortController>();\n\n  private readinessChecks = new Map<string, ReadinessCheck>();\n  private _isReady = false;\n\n  constructor(config: Partial<LifecycleConfig> = {}) {\n    this.config = {\n      gracefulShutdown: {\n        timeoutMs: config.gracefulShutdown?.timeoutMs ?? 10000,\n      },\n      readiness: {\n        timeoutMs: config.readiness?.timeoutMs ?? 30000,\n        checkIntervalMs: config.readiness?.checkIntervalMs ?? 100,\n      },\n    };\n  }\n\n  get phase(): LifecyclePhase {\n    return this._phase;\n  }\n\n  get isShuttingDown(): boolean {\n    return this._phase === LifecyclePhase.STOPPING || this._phase === LifecyclePhase.STOPPED;\n  }\n\n  get isReady(): boolean {\n    return this._isReady && this._phase === LifecyclePhase.RUNNING;\n  }\n\n  onInit(fn: LifecycleHook): () => void {\n    this.initHooks.push(fn);\n    return () => {\n      const i = this.initHooks.indexOf(fn);\n      if (i >= 0) this.initHooks.splice(i, 1);\n    };\n  }\n\n  onStart(fn: LifecycleHook): () => void {\n    this.startHooks.push(fn);\n    return () => {\n      const i = this.startHooks.indexOf(fn);\n      if (i >= 0) this.startHooks.splice(i, 1);\n    };\n  }\n\n  onReady(fn: LifecycleHook): () => void {\n    this.readyHooks.push(fn);\n    return () => {\n      const i = this.readyHooks.indexOf(fn);\n      if (i >= 0) this.readyHooks.splice(i, 1);\n    };\n  }\n\n  onBeforeShutdown(fn: LifecycleHook): () => void {\n    this.beforeShutdownHooks.push(fn);\n    return () => {\n      const i = this.beforeShutdownHooks.indexOf(fn);\n      if (i >= 0) this.beforeShutdownHooks.splice(i, 1);\n    };\n  }\n\n  onShutdown(fn: LifecycleHook): () => void {\n    this.shutdownHooks.push(fn);\n    return () => {\n      const i = this.shutdownHooks.indexOf(fn);\n      if (i >= 0) this.shutdownHooks.splice(i, 1);\n    };\n  }\n\n  addReadinessCheck(name: string, check: ReadinessCheck): () => void {\n    this.readinessChecks.set(name, check);\n    return () => {\n      this.readinessChecks.delete(name);\n    };\n  }\n\n  trackDisposable(disposable: Disposable | { dispose: Function }): Disposable {\n    const d: Disposable = 'dispose' in disposable ? { dispose: () => (disposable as any).dispose() } : disposable;\n    this.disposables.add(d);\n    return d;\n  }\n\n  trackInterval(id: NodeJS.Timeout): NodeJS.Timeout {\n    this.intervals.add(id);\n    return id;\n  }\n\n  trackTimeout(id: NodeJS.Timeout): NodeJS.Timeout {\n    this.timeouts.add(id);\n    return id;\n  }\n\n  /**\n   * Track an AbortController for automatic cleanup on shutdown.\n   * When the lifecycle manager shuts down, it will call abort() on all tracked controllers.\n   * @param controller - The AbortController to track\n   * @returns The same AbortController for chaining\n   */\n  trackAbortController(controller: AbortController): AbortController {\n    this.abortControllers.add(controller);\n    return controller;\n  }\n\n  /**\n   * Create and track a new AbortController.\n   * Convenience method that creates a new controller and automatically tracks it.\n   * @returns A new tracked AbortController\n   */\n  createAbortController(): AbortController {\n    const controller = new AbortController();\n    return this.trackAbortController(controller);\n  }\n\n  async initialize(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.CREATED) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.INITIALIZING;\n\n    const errors = await this.executeHooks(this.initHooks, 'init');\n    return { errors };\n  }\n\n  async start(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.INITIALIZING) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.STARTING;\n\n    const errors = await this.executeHooks(this.startHooks, 'start');\n    return { errors };\n  }\n\n  async ready(): Promise<{ errors: unknown[] }> {\n    if (this._phase !== LifecyclePhase.STARTING) {\n      return { errors: [] };\n    }\n    this._phase = LifecyclePhase.RUNNING;\n\n    const errors = await this.executeHooks(this.readyHooks, 'ready');\n\n    // Wait for readiness checks to pass\n    const readinessResult = await this.waitForReadiness();\n    if (readinessResult.errors.length > 0) {\n      errors.push(...readinessResult.errors);\n    }\n    this._isReady = readinessResult.ready;\n\n    return { errors };\n  }\n\n  async shutdown(): Promise<{ errors: unknown[]; timedOut: boolean }> {\n    if (this.isShuttingDown) {\n      return { errors: [], timedOut: false };\n    }\n    this._phase = LifecyclePhase.STOPPING;\n\n    const timeoutMs = this.config.gracefulShutdown.timeoutMs;\n    if (timeoutMs > 0) {\n      let completed = false;\n      let timedOut = false;\n      const shutdownPromise = this.performShutdown().then(result => {\n        completed = true;\n        return result;\n      });\n      const timeoutPromise = new Promise<{ errors: unknown[] }>(resolve => {\n        setTimeout(() => {\n          if (!completed) {\n            timedOut = true;\n            resolve({ errors: ['Shutdown timeout exceeded'] });\n          }\n        }, timeoutMs);\n      });\n      const result = await Promise.race([shutdownPromise, timeoutPromise]);\n      this._phase = LifecyclePhase.STOPPED;\n      return { errors: result.errors, timedOut };\n    }\n\n    const result = await this.performShutdown();\n    this._phase = LifecyclePhase.STOPPED;\n    return { errors: result.errors, timedOut: false };\n  }\n\n  private async performShutdown(): Promise<{ errors: unknown[] }> {\n    const errors: unknown[] = [];\n\n    // Execute before-shutdown hooks in registration order (FIFO)\n    const beforeShutdownErrors = await this.executeHooks(this.beforeShutdownHooks, 'before-shutdown');\n    errors.push(...beforeShutdownErrors);\n\n    // Abort all tracked AbortControllers\n    for (const controller of this.abortControllers) {\n      try {\n        controller.abort();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    this.abortControllers.clear();\n\n    // Clear intervals and timeouts\n    for (const id of this.intervals) {\n      clearInterval(id);\n    }\n    for (const id of this.timeouts) {\n      clearTimeout(id);\n    }\n    this.intervals.clear();\n    this.timeouts.clear();\n\n    // Dispose of tracked disposables\n    for (const disposable of this.disposables) {\n      try {\n        await disposable.dispose();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    this.disposables.clear();\n\n    // Execute shutdown hooks in reverse registration order (LIFO)\n    const shutdownErrors = await this.executeHooks([...this.shutdownHooks].reverse(), 'shutdown');\n    errors.push(...shutdownErrors);\n\n    return { errors };\n  }\n\n  private async executeHooks(hooks: LifecycleHook[], _phase: string): Promise<unknown[]> {\n    const errors: unknown[] = [];\n    for (const hook of hooks) {\n      try {\n        await hook();\n      } catch (e) {\n        errors.push(e);\n      }\n    }\n    return errors;\n  }\n\n  private async waitForReadiness(): Promise<{ ready: boolean; errors: unknown[] }> {\n    if (this.readinessChecks.size === 0) {\n      return { ready: true, errors: [] };\n    }\n\n    const timeoutMs = this.config.readiness?.timeoutMs ?? 30000;\n    const checkIntervalMs = this.config.readiness?.checkIntervalMs ?? 100;\n    const startTime = Date.now();\n    const errors: unknown[] = [];\n\n    while (Date.now() - startTime < timeoutMs) {\n      const results = await this.executeReadinessChecks();\n      const allReady = results.every(r => r.ready);\n\n      if (allReady) {\n        return { ready: true, errors };\n      }\n\n      // Collect unique errors from failed checks\n      for (const result of results) {\n        if (!result.ready && result.error) {\n          const errorMessage = result.error.message;\n          if (!errors.some(e => (e as Error)?.message === errorMessage)) {\n            errors.push(result.error);\n          }\n        }\n      }\n\n      // Wait before next check\n      await new Promise(resolve => setTimeout(resolve, checkIntervalMs));\n    }\n\n    return { ready: false, errors: [...errors, new Error('Readiness check timeout exceeded')] };\n  }\n\n  private async executeReadinessChecks(): Promise<ReadinessCheckResult[]> {\n    const checkEntries = Array.from(this.readinessChecks.entries());\n\n    const settledResults = await Promise.allSettled(\n      checkEntries.map(async ([name, check]) => {\n        try {\n          const result = await check();\n          return { name, ready: result };\n        } catch (error) {\n          return { name, ready: false, error: error as Error };\n        }\n      }),\n    );\n\n    return settledResults.map((settledResult, index) => {\n      const checkEntry = checkEntries.at(index);\n      if (!checkEntry) {\n        throw new Error(`Missing check entry at index ${index}`);\n      }\n      const [name] = checkEntry;\n\n      if (settledResult.status === 'fulfilled') {\n        return settledResult.value;\n      }\n\n      return {\n        name,\n        ready: false,\n        error: settledResult.reason as Error,\n      };\n    });\n  }\n\n  async getReadinessStatus(): Promise<{ ready: boolean; checks: ReadinessCheckResult[] }> {\n    const checks = await this.executeReadinessChecks();\n    const ready = this._isReady && this._phase === LifecyclePhase.RUNNING && checks.every(c => c.ready);\n    return { ready, checks };\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["result"]
+}

package/dist/lifecycle/shutdown-controller.d.ts

@@ -0,0 +1,15 @@
+import type { LifecycleManager } from './lifecycle-manager.js';
+import type { LifecycleHook } from './types.js';
+export declare class ShutdownController {
+    private lifecycle;
+    private _isShuttingDown;
+    private _hasInitiated;
+    constructor(lifecycle: LifecycleManager);
+    get isShuttingDown(): boolean;
+    register(fn: LifecycleHook): () => void;
+    initiate(_reason: string, _signal?: string): Promise<{
+        errors: unknown[];
+        timedOut: boolean;
+    }>;
+}
+//# sourceMappingURL=shutdown-controller.d.ts.map

package/dist/lifecycle/shutdown-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-controller.d.ts","sourceRoot":"","sources":["../../src/lifecycle/shutdown-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;gBAEV,SAAS,EAAE,gBAAgB;IAE/C,IAAI,cAAc,IAAI,OAAO,CAO5B;IAED,QAAQ,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAIjC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAerG"}

package/dist/lifecycle/shutdown-controller.js

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class ShutdownController {
+  constructor(lifecycle) {
+    this.lifecycle = lifecycle;
+  }
+  static {
+    __name(this, "ShutdownController");
+  }
+  _isShuttingDown = false;
+  _hasInitiated = false;
+  get isShuttingDown() {
+    if (this._hasInitiated) {
+      return this._isShuttingDown;
+    }
+    return this._isShuttingDown || this.lifecycle.isShuttingDown;
+  }
+  register(fn) {
+    return this.lifecycle.onShutdown(fn);
+  }
+  async initiate(_reason, _signal) {
+    if (this._isShuttingDown) {
+      return { errors: [], timedOut: false };
+    }
+    this._isShuttingDown = true;
+    this._hasInitiated = true;
+    try {
+      const result = await this.lifecycle.shutdown();
+      return result;
+    } finally {
+      this._isShuttingDown = false;
+    }
+  }
+}
+export {
+  ShutdownController
+};
+//# sourceMappingURL=shutdown-controller.js.map

package/dist/lifecycle/shutdown-controller.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lifecycle/shutdown-controller.ts"],
+  "sourcesContent": ["import type { LifecycleManager } from './lifecycle-manager.js';\nimport type { LifecycleHook } from './types.js';\n\nexport class ShutdownController {\n  private _isShuttingDown = false;\n  private _hasInitiated = false;\n\n  constructor(private lifecycle: LifecycleManager) {}\n\n  get isShuttingDown(): boolean {\n    if (this._hasInitiated) {\n      // If we've initiated shutdown, only check our own flag\n      return this._isShuttingDown;\n    }\n    // Otherwise, check both our flag and lifecycle state\n    return this._isShuttingDown || this.lifecycle.isShuttingDown;\n  }\n\n  register(fn: LifecycleHook): () => void {\n    return this.lifecycle.onShutdown(fn);\n  }\n\n  async initiate(_reason: string, _signal?: string): Promise<{ errors: unknown[]; timedOut: boolean }> {\n    if (this._isShuttingDown) {\n      return { errors: [], timedOut: false };\n    }\n\n    this._isShuttingDown = true;\n    this._hasInitiated = true;\n\n    try {\n      const result = await this.lifecycle.shutdown();\n      return result;\n    } finally {\n      this._isShuttingDown = false;\n    }\n  }\n}\n"],
+  "mappings": ";;AAGO,MAAM,mBAAmB;AAAA,EAI9B,YAAoB,WAA6B;AAA7B;AAAA,EAA8B;AAAA,EAPpD,OAGgC;AAAA;AAAA;AAAA,EACtB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAIxB,IAAI,iBAA0B;AAC5B,QAAI,KAAK,eAAe;AAEtB,aAAO,KAAK;AAAA,IACd;AAEA,WAAO,KAAK,mBAAmB,KAAK,UAAU;AAAA,EAChD;AAAA,EAEA,SAAS,IAA+B;AACtC,WAAO,KAAK,UAAU,WAAW,EAAE;AAAA,EACrC;AAAA,EAEA,MAAM,SAAS,SAAiB,SAAqE;AACnG,QAAI,KAAK,iBAAiB;AACxB,aAAO,EAAE,QAAQ,CAAC,GAAG,UAAU,MAAM;AAAA,IACvC;AAEA,SAAK,kBAAkB;AACvB,SAAK,gBAAgB;AAErB,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,UAAU,SAAS;AAC7C,aAAO;AAAA,IACT,UAAE;AACA,WAAK,kBAAkB;AAAA,IACzB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lifecycle/types.d.ts

@@ -0,0 +1,28 @@
+export interface Disposable {
+    dispose(): Promise<void> | void;
+}
+export declare enum LifecyclePhase {
+    CREATED = "created",
+    INITIALIZING = "initializing",
+    STARTING = "starting",
+    RUNNING = "running",
+    STOPPING = "stopping",
+    STOPPED = "stopped"
+}
+export type LifecycleHook = () => Promise<void> | void;
+export type ReadinessCheck = () => Promise<boolean> | boolean;
+export interface ReadinessCheckResult {
+    name: string;
+    ready: boolean;
+    error?: Error;
+}
+export interface LifecycleConfig {
+    gracefulShutdown: {
+        timeoutMs: number;
+    };
+    readiness?: {
+        timeoutMs?: number;
+        checkIntervalMs?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lifecycle/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH"}