@xyo-network/xl1-system-status 4.5.0 → 4.5.2

package/dist/node/ConsoleSystemStatusPublisher.d.ts

@@ -2,6 +2,7 @@ import type { Logger } from '@ariestools/sdk';
 import type { SystemStatusPublisher, SystemStatusRunner } from '@xyo-network/xl1-protocol/protocol-lib';
 /** Options for the console system-status publisher. */
 export interface ConsoleSystemStatusPublisherOptions {
+    /** Logger used by this instance and the providers it creates. */
     logger?: Logger;
 }
 /**
@@ -16,12 +17,16 @@ export interface ConsoleSystemStatusPublisherOptions {
  * actual services.
  */
 export declare class ConsoleSystemStatusPublisher implements SystemStatusPublisher {
+    /** Moniker implemented by this provider instance. */
     readonly moniker: "SystemStatusPublisher";
     private _started;
     private readonly options;
     private readonly status;
+    /** Creates a console observer for global status transitions. */
     constructor(status: SystemStatusRunner, options?: ConsoleSystemStatusPublisherOptions);
+    /** Enables logging and subscribes to subsequent global status transitions. */
     start(): void;
+    /** Disables output from the registered transition callback. */
     stop(): void;
 }
 //# sourceMappingURL=ConsoleSystemStatusPublisher.d.ts.map

package/dist/node/ConsoleSystemStatusPublisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConsoleSystemStatusPublisher.d.ts","sourceRoot":"","sources":["../../src/ConsoleSystemStatusPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAGvG,uDAAuD;AACvD,MAAM,WAAW,mCAAmC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,YAAW,qBAAqB;IACxE,QAAQ,CAAC,OAAO,0BAA+B;IAE/C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,mCAAwC;IAKzF,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;CAGb"}
+{"version":3,"file":"ConsoleSystemStatusPublisher.d.ts","sourceRoot":"","sources":["../../src/ConsoleSystemStatusPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAGvG,uDAAuD;AACvD,MAAM,WAAW,mCAAmC;IAClD,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,YAAW,qBAAqB;IACxE,qDAAqD;IACrD,QAAQ,CAAC,OAAO,0BAA+B;IAE/C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,gEAAgE;gBACpD,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,mCAAwC;IAKzF,8EAA8E;IAC9E,KAAK,IAAI,IAAI;IAUb,+DAA+D;IAC/D,IAAI,IAAI,IAAI;CAGb"}

package/dist/node/HttpSystemStatusPublisher.d.ts

@@ -2,13 +2,18 @@ import type { Logger } from '@ariestools/sdk';
 import type { SystemStatusPublisher, SystemStatusRunner, SystemStatusViewerMethods } from '@xyo-network/xl1-protocol/protocol-lib';
 /** Options for the HTTP system-status publisher. */
 export interface HttpSystemStatusPublisherOptions {
+    /** Optional host or interface on which the probe server listens. */
     host?: string;
+    /** Logger used by this instance and the providers it creates. */
     logger?: Logger;
+    /** TCP port on which the probe server listens. */
     port: number;
 }
 /** A resolved probe response (HTTP status code + JSON body). */
 export interface StatusProbeResponse {
+    /** JSON-serializable probe response body. */
     body: unknown;
+    /** HTTP status code returned for the probe route. */
     statusCode: number;
 }
 /**
@@ -32,13 +37,17 @@ export declare function resolveStatusProbe(status: SystemStatusViewerMethods, ur
  * thus `/healthz`) reflecting only the actual services.
  */
 export declare class HttpSystemStatusPublisher implements SystemStatusPublisher {
+    /** Moniker implemented by this provider instance. */
     readonly moniker: "SystemStatusPublisher";
     private _server;
     private _started;
     private readonly options;
     private readonly status;
+    /** Creates an HTTP probe publisher for the supplied status runner. */
     constructor(status: SystemStatusRunner, options: HttpSystemStatusPublisherOptions);
+    /** Starts the probe HTTP server and enables transition logging. */
     start(): Promise<void>;
+    /** Disables transition logging and closes the probe HTTP server. */
     stop(): Promise<void>;
     private handleRequest;
 }

package/dist/node/HttpSystemStatusPublisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpSystemStatusPublisher.d.ts","sourceRoot":"","sources":["../../src/HttpSystemStatusPublisher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EACV,qBAAqB,EAAE,kBAAkB,EAAE,yBAAyB,EACrE,MAAM,wCAAwC,CAAA;AAG/C,oDAAoD;AACpD,MAAM,WAAW,gCAAgC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAqBtG;AAOD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,QAAQ,CAAC,OAAO,0BAA+B;IAE/C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,gCAAgC;IAK3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,aAAa;CAItB"}
+{"version":3,"file":"HttpSystemStatusPublisher.d.ts","sourceRoot":"","sources":["../../src/HttpSystemStatusPublisher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EACV,qBAAqB,EAAE,kBAAkB,EAAE,yBAAyB,EACrE,MAAM,wCAAwC,CAAA;AAG/C,oDAAoD;AACpD,MAAM,WAAW,gCAAgC;IAC/C,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAA;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAqBtG;AAOD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,qDAAqD;IACrD,QAAQ,CAAC,OAAO,0BAA+B;IAE/C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,sEAAsE;gBAC1D,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,gCAAgC;IAKjF,mEAAmE;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,oEAAoE;IAC9D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,aAAa;CAItB"}

package/dist/node/index.mjs

@@ -1,14 +1,17 @@
 // src/ConsoleSystemStatusPublisher.ts
 import { SystemStatusPublisherMoniker } from "@xyo-network/xl1-protocol/protocol-lib";
 var ConsoleSystemStatusPublisher = class {
+  /** Moniker implemented by this provider instance. */
   moniker = SystemStatusPublisherMoniker;
   _started = false;
   options;
   status;
+  /** Creates a console observer for global status transitions. */
   constructor(status, options = {}) {
     this.status = status;
     this.options = options;
   }
+  /** Enables logging and subscribes to subsequent global status transitions. */
   start() {
     this._started = true;
     const { logger } = this.options;
@@ -18,6 +21,7 @@ var ConsoleSystemStatusPublisher = class {
       if (to === "started") logger?.log("All services started.");
     });
   }
+  /** Disables output from the registered transition callback. */
   stop() {
     this._started = false;
   }
@@ -53,15 +57,18 @@ var sendJson = (res, statusCode, body) => {
   res.end(JSON.stringify(body));
 };
 var HttpSystemStatusPublisher = class {
+  /** Moniker implemented by this provider instance. */
   moniker = SystemStatusPublisherMoniker2;
   _server;
   _started = false;
   options;
   status;
+  /** Creates an HTTP probe publisher for the supplied status runner. */
   constructor(status, options) {
     this.status = status;
     this.options = options;
   }
+  /** Starts the probe HTTP server and enables transition logging. */
   async start() {
     this._started = true;
     const {
@@ -87,6 +94,7 @@ var HttpSystemStatusPublisher = class {
     });
     this._server = server;
   }
+  /** Disables transition logging and closes the probe HTTP server. */
   async stop() {
     this._started = false;
     const server = this._server;

package/dist/node/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/ConsoleSystemStatusPublisher.ts", "../../src/HttpSystemStatusPublisher.ts"],
-  "sourcesContent": ["import type { Logger } from '@ariestools/sdk'\nimport type { SystemStatusPublisher, SystemStatusRunner } from '@xyo-network/xl1-protocol/protocol-lib'\nimport { SystemStatusPublisherMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\n/** Options for the console system-status publisher. */\nexport interface ConsoleSystemStatusPublisherOptions {\n  logger?: Logger\n}\n\n/**\n * Publishes system status to the console by subscribing to the Runner's global\n * status transitions.\n *\n * It is a plain start/stop observer \u2014 NOT a CreatableProvider \u2014 so it never\n * reports its own lifecycle into the Runner. A self-reporting publisher would\n * report itself `started` before any real service is up, falsely flipping the\n * aggregate status to `started` (and any HTTP `/healthz` derived from it to\n * 200). Being a plain observer keeps the global status reflecting only the\n * actual services.\n */\nexport class ConsoleSystemStatusPublisher implements SystemStatusPublisher {\n  readonly moniker = SystemStatusPublisherMoniker\n\n  private _started = false\n  private readonly options: ConsoleSystemStatusPublisherOptions\n  private readonly status: SystemStatusRunner\n\n  constructor(status: SystemStatusRunner, options: ConsoleSystemStatusPublisherOptions = {}) {\n    this.status = status\n    this.options = options\n  }\n\n  start(): void {\n    this._started = true\n    const { logger } = this.options\n    this.status.onGlobalTransition({}, (from, to) => {\n      if (!this._started) return\n      logger?.log(`System status: ${from} -> ${to}`)\n      if (to === 'started') logger?.log('All services started.')\n    })\n  }\n\n  stop(): void {\n    this._started = false\n  }\n}\n", "import type {\n  IncomingMessage, Server, ServerResponse,\n} from 'node:http'\nimport http from 'node:http'\n\nimport type { Logger } from '@ariestools/sdk'\nimport type {\n  SystemStatusPublisher, SystemStatusRunner, SystemStatusViewerMethods,\n} from '@xyo-network/xl1-protocol/protocol-lib'\nimport { SystemStatusPublisherMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\n/** Options for the HTTP system-status publisher. */\nexport interface HttpSystemStatusPublisherOptions {\n  host?: string\n  logger?: Logger\n  port: number\n}\n\n/** A resolved probe response (HTTP status code + JSON body). */\nexport interface StatusProbeResponse {\n  body: unknown\n  statusCode: number\n}\n\n/**\n * Pure routing for the status probe endpoints. Extracted from the HTTP server\n * so the routing logic is testable without binding a socket.\n */\nexport function resolveStatusProbe(status: SystemStatusViewerMethods, url: string): StatusProbeResponse {\n  switch (url) {\n    case '/healthz': {\n      const global = status.getGlobalStatus()\n      return { statusCode: global === 'started' ? 200 : 500, body: { status: global } }\n    }\n    case '/livez': {\n      return { statusCode: 200, body: { status: 'live' } }\n    }\n    case '/readyz': {\n      if (status.isShuttingDown()) return { statusCode: 503, body: { status: 'shutting-down' } }\n      if (status.isReady()) return { statusCode: 200, body: { status: 'ready' } }\n      return { statusCode: 503, body: { status: 'pending' } }\n    }\n    case '/status': {\n      return { statusCode: 200, body: status.snapshot() }\n    }\n    default: {\n      return { statusCode: 404, body: { status: 'not found' } }\n    }\n  }\n}\n\nconst sendJson = (res: ServerResponse, statusCode: number, body: unknown): void => {\n  res.writeHead(statusCode, { 'Content-Type': 'application/json' })\n  res.end(JSON.stringify(body))\n}\n\n/**\n * Publishes system status over HTTP with Kubernetes-style probes plus a richer\n * `/status` snapshot:\n * - `/healthz` \u2014 200 once the global status is `started`, otherwise 500.\n * - `/livez` \u2014 200 unconditionally while the process is running.\n * - `/readyz` \u2014 503 while shutting down, 200 once `isReady()`, else 503.\n * - `/status` \u2014 200 with the full status snapshot as JSON.\n *\n * It publishes to two sinks: the HTTP endpoints above, and the logger (it logs\n * each global status transition via the Runner's subscription).\n *\n * It is a plain start/stop observer (not a CreatableProvider) so it does not\n * report its own lifecycle into the Runner \u2014 keeping the global status (and\n * thus `/healthz`) reflecting only the actual services.\n */\nexport class HttpSystemStatusPublisher implements SystemStatusPublisher {\n  readonly moniker = SystemStatusPublisherMoniker\n\n  private _server: Server | undefined\n  private _started = false\n  private readonly options: HttpSystemStatusPublisherOptions\n  private readonly status: SystemStatusRunner\n\n  constructor(status: SystemStatusRunner, options: HttpSystemStatusPublisherOptions) {\n    this.status = status\n    this.options = options\n  }\n\n  async start(): Promise<void> {\n    this._started = true\n    const {\n      host, logger, port,\n    } = this.options\n    // Console sink: log every global status transition via the logger.\n    this.status.onGlobalTransition({}, (from, to) => {\n      if (!this._started) return\n      logger?.log(`System status: ${from} -> ${to}`)\n    })\n    const server = http.createServer((req, res) => this.handleRequest(req, res))\n    await new Promise<void>((resolve, reject) => {\n      server.once('error', reject)\n      server.listen(port, host, () => {\n        logger?.log(`System status HTTP server running on http://${host ?? 'localhost'}:${port}`)\n        logger?.log(' - /healthz')\n        logger?.log(' - /livez')\n        logger?.log(' - /readyz')\n        logger?.log(' - /status')\n        resolve()\n      })\n    })\n    this._server = server\n  }\n\n  async stop(): Promise<void> {\n    this._started = false\n    const server = this._server\n    this._server = undefined\n    if (server !== undefined) {\n      await new Promise<void>((resolve) => {\n        server.close(() => resolve())\n      })\n    }\n  }\n\n  private handleRequest(req: IncomingMessage, res: ServerResponse): void {\n    const { statusCode, body } = resolveStatusProbe(this.status, req.url ?? '')\n    sendJson(res, statusCode, body)\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Logger } from '@ariestools/sdk'\nimport type { SystemStatusPublisher, SystemStatusRunner } from '@xyo-network/xl1-protocol/protocol-lib'\nimport { SystemStatusPublisherMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\n/** Options for the console system-status publisher. */\nexport interface ConsoleSystemStatusPublisherOptions {\n  /** Logger used by this instance and the providers it creates. */\n  logger?: Logger\n}\n\n/**\n * Publishes system status to the console by subscribing to the Runner's global\n * status transitions.\n *\n * It is a plain start/stop observer \u2014 NOT a CreatableProvider \u2014 so it never\n * reports its own lifecycle into the Runner. A self-reporting publisher would\n * report itself `started` before any real service is up, falsely flipping the\n * aggregate status to `started` (and any HTTP `/healthz` derived from it to\n * 200). Being a plain observer keeps the global status reflecting only the\n * actual services.\n */\nexport class ConsoleSystemStatusPublisher implements SystemStatusPublisher {\n  /** Moniker implemented by this provider instance. */\n  readonly moniker = SystemStatusPublisherMoniker\n\n  private _started = false\n  private readonly options: ConsoleSystemStatusPublisherOptions\n  private readonly status: SystemStatusRunner\n\n  /** Creates a console observer for global status transitions. */\n  constructor(status: SystemStatusRunner, options: ConsoleSystemStatusPublisherOptions = {}) {\n    this.status = status\n    this.options = options\n  }\n\n  /** Enables logging and subscribes to subsequent global status transitions. */\n  start(): void {\n    this._started = true\n    const { logger } = this.options\n    this.status.onGlobalTransition({}, (from, to) => {\n      if (!this._started) return\n      logger?.log(`System status: ${from} -> ${to}`)\n      if (to === 'started') logger?.log('All services started.')\n    })\n  }\n\n  /** Disables output from the registered transition callback. */\n  stop(): void {\n    this._started = false\n  }\n}\n", "import type {\n  IncomingMessage, Server, ServerResponse,\n} from 'node:http'\nimport http from 'node:http'\n\nimport type { Logger } from '@ariestools/sdk'\nimport type {\n  SystemStatusPublisher, SystemStatusRunner, SystemStatusViewerMethods,\n} from '@xyo-network/xl1-protocol/protocol-lib'\nimport { SystemStatusPublisherMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\n/** Options for the HTTP system-status publisher. */\nexport interface HttpSystemStatusPublisherOptions {\n  /** Optional host or interface on which the probe server listens. */\n  host?: string\n  /** Logger used by this instance and the providers it creates. */\n  logger?: Logger\n  /** TCP port on which the probe server listens. */\n  port: number\n}\n\n/** A resolved probe response (HTTP status code + JSON body). */\nexport interface StatusProbeResponse {\n  /** JSON-serializable probe response body. */\n  body: unknown\n  /** HTTP status code returned for the probe route. */\n  statusCode: number\n}\n\n/**\n * Pure routing for the status probe endpoints. Extracted from the HTTP server\n * so the routing logic is testable without binding a socket.\n */\nexport function resolveStatusProbe(status: SystemStatusViewerMethods, url: string): StatusProbeResponse {\n  switch (url) {\n    case '/healthz': {\n      const global = status.getGlobalStatus()\n      return { statusCode: global === 'started' ? 200 : 500, body: { status: global } }\n    }\n    case '/livez': {\n      return { statusCode: 200, body: { status: 'live' } }\n    }\n    case '/readyz': {\n      if (status.isShuttingDown()) return { statusCode: 503, body: { status: 'shutting-down' } }\n      if (status.isReady()) return { statusCode: 200, body: { status: 'ready' } }\n      return { statusCode: 503, body: { status: 'pending' } }\n    }\n    case '/status': {\n      return { statusCode: 200, body: status.snapshot() }\n    }\n    default: {\n      return { statusCode: 404, body: { status: 'not found' } }\n    }\n  }\n}\n\nconst sendJson = (res: ServerResponse, statusCode: number, body: unknown): void => {\n  res.writeHead(statusCode, { 'Content-Type': 'application/json' })\n  res.end(JSON.stringify(body))\n}\n\n/**\n * Publishes system status over HTTP with Kubernetes-style probes plus a richer\n * `/status` snapshot:\n * - `/healthz` \u2014 200 once the global status is `started`, otherwise 500.\n * - `/livez` \u2014 200 unconditionally while the process is running.\n * - `/readyz` \u2014 503 while shutting down, 200 once `isReady()`, else 503.\n * - `/status` \u2014 200 with the full status snapshot as JSON.\n *\n * It publishes to two sinks: the HTTP endpoints above, and the logger (it logs\n * each global status transition via the Runner's subscription).\n *\n * It is a plain start/stop observer (not a CreatableProvider) so it does not\n * report its own lifecycle into the Runner \u2014 keeping the global status (and\n * thus `/healthz`) reflecting only the actual services.\n */\nexport class HttpSystemStatusPublisher implements SystemStatusPublisher {\n  /** Moniker implemented by this provider instance. */\n  readonly moniker = SystemStatusPublisherMoniker\n\n  private _server: Server | undefined\n  private _started = false\n  private readonly options: HttpSystemStatusPublisherOptions\n  private readonly status: SystemStatusRunner\n\n  /** Creates an HTTP probe publisher for the supplied status runner. */\n  constructor(status: SystemStatusRunner, options: HttpSystemStatusPublisherOptions) {\n    this.status = status\n    this.options = options\n  }\n\n  /** Starts the probe HTTP server and enables transition logging. */\n  async start(): Promise<void> {\n    this._started = true\n    const {\n      host, logger, port,\n    } = this.options\n    // Console sink: log every global status transition via the logger.\n    this.status.onGlobalTransition({}, (from, to) => {\n      if (!this._started) return\n      logger?.log(`System status: ${from} -> ${to}`)\n    })\n    const server = http.createServer((req, res) => this.handleRequest(req, res))\n    await new Promise<void>((resolve, reject) => {\n      server.once('error', reject)\n      server.listen(port, host, () => {\n        logger?.log(`System status HTTP server running on http://${host ?? 'localhost'}:${port}`)\n        logger?.log(' - /healthz')\n        logger?.log(' - /livez')\n        logger?.log(' - /readyz')\n        logger?.log(' - /status')\n        resolve()\n      })\n    })\n    this._server = server\n  }\n\n  /** Disables transition logging and closes the probe HTTP server. */\n  async stop(): Promise<void> {\n    this._started = false\n    const server = this._server\n    this._server = undefined\n    if (server !== undefined) {\n      await new Promise<void>((resolve) => {\n        server.close(() => resolve())\n      })\n    }\n  }\n\n  private handleRequest(req: IncomingMessage, res: ServerResponse): void {\n    const { statusCode, body } = resolveStatusProbe(this.status, req.url ?? '')\n    sendJson(res, statusCode, body)\n  }\n}\n"],
+  "mappings": "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",
   "names": ["SystemStatusPublisherMoniker"]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-system-status",
-  "version": "4.5.0",
+  "version": "4.5.2",
   "description": "XYO Layer One system status publishers (console + HTTP health endpoints)",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -35,12 +35,12 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol": "~4.5.0"
+    "@xyo-network/xl1-protocol": "~4.5.2"
   },
   "devDependencies": {
     "@ariestools/sdk": "~8.1.1",
-    "@ariestools/toolchain": "~8.7.16",
-    "@ariestools/tsconfig": "~8.7.16",
+    "@ariestools/toolchain": "~8.7.18",
+    "@ariestools/tsconfig": "~8.7.18",
     "@metamask/json-rpc-engine": "~10.5.0",
     "@opentelemetry/api": "~1.9.1",
     "@xyo-network/sdk": "~7.2.1",
@@ -53,7 +53,7 @@
     "vite": "~8.1.5",
     "vitest": "~4.1.10",
     "zod": "~4.4.3",
-    "@xyo-network/xl1-sdk": "~4.5.0"
+    "@xyo-network/xl1-sdk": "~4.5.2"
   },
   "peerDependencies": {
     "@ariestools/sdk": "^8.1"