@dunx/http 2.2.0 → 2.3.0

package/dist/client.js

@@ -445,21 +445,21 @@ class HttpModule {
   }
 }
 export {
-  safeStringify,
-  retryAfterMs,
-  isRetryableStatus,
-  isPlainObject,
-  isJsonBody,
-  httpClient,
-  executeWithRetry,
-  backoffDelay,
-  HttpService,
-  HttpModule,
-  HttpClientOptions,
-  FetchTransportError,
+  DEFAULT_REQUEST_ID_HEADER,
   FetchError,
-  DEFAULT_REQUEST_ID_HEADER
+  FetchTransportError,
+  HttpClientOptions,
+  HttpModule,
+  HttpService,
+  backoffDelay,
+  executeWithRetry,
+  httpClient,
+  isJsonBody,
+  isPlainObject,
+  isRetryableStatus,
+  retryAfterMs,
+  safeStringify
 };
 
-//# debugId=67E96F658C57D72264756E2164756E21
+//# debugId=9448CCC7AF6FC82264756E2164756E21
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -10,6 +10,6 @@
     "import { Logger, RequestContext } from '@dunx/core';\nimport { UrlHelper, type ParamsType } from '@arkv/shared';\nimport type { HttpMethod } from '../route/marker.js';\nimport { FetchError, FetchTransportError } from './errors.js';\nimport { isJsonBody, safeStringify } from './json.js';\nimport { HttpClientOptions } from './options.js';\nimport { executeWithRetry, type RetryOptions } from './retry.js';\n\n/** The client speaks two more verbs than a route can declare. */\nexport type RequestMethod = HttpMethod | 'HEAD' | 'OPTIONS';\n\n/**\n * `@arkv/shared`'s own param type, imported rather than restated - a local copy\n * would drift from what `buildUrl` actually accepts, which is how `null` ended up\n * in the first draft of this file and `interpolate` would never have seen it.\n */\ntype Params = ParamsType;\n\n/**\n * `fetch`'s own body type, derived from its signature. `BodyInit` is not a global\n * here: the root tsconfig sets `lib: [\"ESNext\"]` with no DOM, so the name does not\n * exist even though the value does. Reading it off `typeof fetch` needs no lib and\n * cannot disagree with the runtime.\n */\ntype FetchBody = NonNullable<NonNullable<Parameters<typeof fetch>[1]>['body']>;\n\nexport type HeaderFactory = (params: {\n  /** Unix seconds, which is what every HMAC scheme signs. */\n  readonly timestamp: number;\n  readonly method: RequestMethod;\n  /** `pathname + search`, the part such schemes sign. */\n  readonly requestPath: string;\n  /** The serialised body, or `''`. */\n  readonly body: string;\n}) => Record<string, string>;\n\nexport interface RequestConfig<TRequest = unknown, TResponse = unknown> {\n  readonly method: RequestMethod;\n  /** Absolute, or relative to `baseUrl`. Omit when `baseUrl` plus `path` is enough. */\n  readonly url?: string | URL;\n  readonly payload?: TRequest;\n  readonly headers?: Readonly<Record<string, string>>;\n  /** Appended to the base, with `{param}` interpolated from `pathParams`. */\n  readonly path?: string;\n  readonly pathParams?: Params;\n  readonly queryParams?: Params;\n  /** Overrides the client's default budget. */\n  readonly timeoutMs?: number;\n  /** Called once per attempt, so a signature covers the body it is sent with. */\n  readonly headerFactory?: HeaderFactory;\n  /** Merged into the async context for this call, so its logs carry it. */\n  readonly flow?: string;\n  readonly retry?: RetryOptions<TResponse>;\n  /** Cancels the call. Combined with the timeout, whichever fires first. */\n  readonly signal?: AbortSignal;\n}\n\ntype BaseOptions<TRequest, TResponse> = Omit<\n  RequestConfig<TRequest, TResponse>,\n  'method' | 'url' | 'payload'\n>;\n\n/**\n * What `send` reads. Narrower than `RequestConfig` on purpose: `RetryOptions<T>` is\n * invariant in `T` - its `onSuccess` takes a `T` and its callbacks return one - so a\n * `RequestConfig<_, TResponse>` is not assignable to a `RequestConfig<_, unknown>`.\n * `send` never touches `retry`, so leaving it out is both true and assignable.\n */\ninterface SendConfig {\n  readonly method: RequestMethod;\n  readonly headers?: Readonly<Record<string, string>>;\n  readonly timeoutMs?: number;\n  readonly headerFactory?: HeaderFactory;\n  readonly signal?: AbortSignal;\n}\n\n/**\n * A `fetch` client with a per-request timeout, retry with backoff, request-id\n * propagation and one log line per call.\n *\n * `fetch` and nothing else: it is a Web standard Bun implements natively, so there\n * is no client dependency to justify - which is also why `axios` and `node-fetch`\n * are banned repo-wide. What this adds over calling `fetch` yourself is the parts\n * every caller otherwise reimplements slightly differently: the timeout, the\n * retry policy, `Retry-After`, url building, and a failure that says which call\n * failed.\n *\n * Extends `UrlHelper` from `@arkv/shared`, so `buildUrl` and `interpolate` are\n * available on the service, and there is one implementation of them across the\n * owner's projects rather than a fork per repo.\n */\nexport class HttpService extends UrlHelper {\n  constructor(\n    private readonly options: HttpClientOptions,\n    private readonly logger: Logger,\n    private readonly requestContext: RequestContext,\n  ) {\n    super();\n  }\n\n  async request<TRequest = unknown, TResponse = unknown>(\n    config: RequestConfig<TRequest, TResponse>,\n  ): Promise<TResponse> {\n    const url = this.urlFor(config);\n    const startedAt = Date.now();\n    let attempts = 0;\n    let status: number | undefined;\n\n    /**\n     * Serialised **once**, outside the retry loop. A body does not change between\n     * attempts - only the signature over it does, and `headerFactory` gets a fresh\n     * timestamp per attempt from `send`.\n     *\n     * Doing it inside meant a caller's own `JSON.stringify` failure, a circular\n     * payload, was treated as a retryable error: three attempts and eight seconds of\n     * backoff before surfacing a bug that no amount of retrying could fix. It also\n     * re-serialised a large body on every attempt.\n     */\n    const { body, serialised } = this.bodyFor(config.payload);\n\n    /**\n     * A stream body is consumed by the first attempt, so a second would send an\n     * empty one. Retrying is switched off rather than left to fail as a confusing\n     * \"body already used\" on the retry.\n     */\n    const replayable = !(config.payload instanceof ReadableStream);\n\n    const attempt = async (): Promise<TResponse> => {\n      attempts += 1;\n      const response = await this.send(config, url, body, serialised);\n      status = response.status;\n\n      if (!response.ok) {\n        throw new FetchError(\n          response.status,\n          response.statusText,\n          await readBody(response),\n          {\n            method: config.method,\n            url: url.href,\n            headers: response.headers,\n          },\n        );\n      }\n\n      return (await readBody(response)) as TResponse;\n    };\n\n    const describe = (): string => `${config.method} ${url.href}`;\n\n    try {\n      const result = await this.requestContext.runWithContext(\n        {\n          ...(config.flow === undefined ? {} : { flow: config.flow }),\n          event: config.path ?? url.pathname,\n        },\n        () =>\n          executeWithRetry(attempt, {\n            ...this.options.retry,\n            ...config.retry,\n            ...(replayable ? {} : { maxRetries: 0 }),\n          } as RetryOptions<TResponse>),\n      );\n\n      this.logger.debug(`${describe()} succeeded`, {\n        status,\n        attempts,\n        elapsedMs: Date.now() - startedAt,\n      });\n      return result;\n    } catch (error) {\n      this.logger.error(`${describe()} failed`, {\n        // `safeStringify`, not the error object: an upstream body can carry a cycle\n        // and this is the one place that must not throw while reporting a throw.\n        err: safeStringify(describeError(error)),\n        attempts,\n        elapsedMs: Date.now() - startedAt,\n      });\n      throw error;\n    }\n  }\n\n  get<TResponse = unknown>(\n    url?: string | URL,\n    options?: BaseOptions<never, TResponse>,\n  ): Promise<TResponse> {\n    return this.request<never, TResponse>({\n      method: 'GET',\n      ...options,\n      ...urlOf(url),\n    });\n  }\n\n  post<TRequest = unknown, TResponse = unknown>(\n    url?: string | URL,\n    payload?: TRequest,\n    options?: BaseOptions<TRequest, TResponse>,\n  ): Promise<TResponse> {\n    return this.request<TRequest, TResponse>({\n      method: 'POST',\n      ...options,\n      ...urlOf(url),\n      ...(payload === undefined ? {} : { payload }),\n    });\n  }\n\n  put<TRequest = unknown, TResponse = unknown>(\n    url?: string | URL,\n    payload?: TRequest,\n    options?: BaseOptions<TRequest, TResponse>,\n  ): Promise<TResponse> {\n    return this.request<TRequest, TResponse>({\n      method: 'PUT',\n      ...options,\n      ...urlOf(url),\n      ...(payload === undefined ? {} : { payload }),\n    });\n  }\n\n  patch<TRequest = unknown, TResponse = unknown>(\n    url?: string | URL,\n    payload?: TRequest,\n    options?: BaseOptions<TRequest, TResponse>,\n  ): Promise<TResponse> {\n    return this.request<TRequest, TResponse>({\n      method: 'PATCH',\n      ...options,\n      ...urlOf(url),\n      ...(payload === undefined ? {} : { payload }),\n    });\n  }\n\n  delete<TResponse = unknown>(\n    url?: string | URL,\n    options?: BaseOptions<never, TResponse>,\n  ): Promise<TResponse> {\n    return this.request<never, TResponse>({\n      method: 'DELETE',\n      ...options,\n      ...urlOf(url),\n    });\n  }\n\n  /**\n   * Yields each `data:` payload of a Server-Sent-Events response, consuming the\n   * terminating `[DONE]` sentinel rather than yielding it.\n   *\n   * **No retry**, deliberately: a partially consumed stream cannot be replayed, so\n   * retrying would re-deliver events the caller has already seen. The timeout\n   * covers the connect only - it is dropped once headers arrive, or a long-lived\n   * stream would be cut off mid-flight.\n   *\n   * Hand-rolled rather than delegated: Bun exposes no `EventSource` global and no\n   * SSE parser, which was measured rather than assumed.\n   */\n  async *streamSse<TRequest = unknown>(\n    config: Omit<RequestConfig<TRequest>, 'method' | 'retry'> & {\n      readonly method?: 'GET' | 'POST';\n    },\n  ): AsyncGenerator<string> {\n    const url = this.urlFor(config);\n    const method = config.method ?? 'POST';\n    const startedAt = Date.now();\n    const { body, serialised } = this.bodyFor(config.payload);\n\n    const response = await this.send(\n      { ...config, method },\n      url,\n      body,\n      serialised,\n      'text/event-stream',\n    );\n\n    if (!response.ok || response.body === null) {\n      throw new FetchError(\n        response.status,\n        response.statusText,\n        await readBody(response),\n        { method, url: url.href, headers: response.headers },\n      );\n    }\n\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      // Async iteration, not `getReader()`: it acquires the reader and releases it\n      // on completion, on `break`, and on the `return` below when `[DONE]` arrives -\n      // which is the case the manual form needed `releaseLock()` in a `finally` for.\n      for await (const chunk of response.body) {\n        buffer += decoder.decode(chunk, { stream: true });\n\n        let newline = buffer.indexOf('\\n');\n        while (newline !== -1) {\n          const line = buffer.slice(0, newline).trim();\n          buffer = buffer.slice(newline + 1);\n          newline = buffer.indexOf('\\n');\n\n          if (!line.startsWith('data:')) continue;\n          const data = line.slice(5).trim();\n          if (data === '[DONE]') return;\n          yield data;\n        }\n      }\n    } finally {\n      this.logger.debug(`SSE ${method} ${url.href} closed`, {\n        elapsedMs: Date.now() - startedAt,\n      });\n    }\n  }\n\n  /**\n   * Resolves the target, accepting the three forms a caller actually reaches for:\n   * an absolute url, a path relative to `baseUrl`, or `baseUrl` plus an explicit\n   * `path`.\n   *\n   * `get('/users')` is the one worth calling out. A relative first argument is what\n   * every HTTP client takes once a base url exists, and passing it straight to\n   * `buildUrl` throws `ERR_INVALID_URL` from inside `new URL()` - a message naming\n   * neither the call nor the missing base. So a first argument that is not an\n   * absolute url is treated as the path, which is what it reads as.\n   *\n   * `URL.canParse` decides, rather than a regex over `//` or `:` - it is the same\n   * parser `new URL` uses, so the two cannot disagree.\n   */\n  private urlFor(config: {\n    readonly url?: string | URL;\n    readonly path?: string;\n    readonly pathParams?: Params;\n    readonly queryParams?: Params;\n  }): URL {\n    const given = config.url === undefined ? undefined : String(config.url);\n    const absolute =\n      given !== undefined && given !== '' && URL.canParse(given)\n        ? given\n        : undefined;\n    const relative = given === '' || absolute !== undefined ? undefined : given;\n    const base = absolute ?? this.options.baseUrl;\n\n    if (base === undefined) {\n      throw new FetchTransportError(\n        { method: 'GET', url: given ?? config.path ?? '(none)' },\n        false,\n        {\n          cause: new Error(\n            'No url to call. Pass an absolute url, or set baseUrl on ' +\n              'HttpModule.forRoot and pass a path.',\n          ),\n        },\n      );\n    }\n\n    // An explicit `path` wins over a relative first argument, so a call cannot\n    // silently request two different paths.\n    const path = config.path ?? relative;\n\n    return this.buildUrl({\n      base,\n      ...(path === undefined ? {} : { path }),\n      ...(config.pathParams === undefined\n        ? {}\n        : { pathParams: config.pathParams }),\n      ...(config.queryParams === undefined\n        ? {}\n        : { queryParams: config.queryParams }),\n    });\n  }\n\n  /** `serialised` is what a `headerFactory` signs, and is `''` for no body. */\n  private bodyFor(payload: unknown): {\n    body: FetchBody | undefined;\n    serialised: string;\n    json: boolean;\n  } {\n    if (payload === undefined || payload === null) {\n      return { body: undefined, serialised: '', json: false };\n    }\n    if (!isJsonBody(payload)) {\n      return { body: payload as FetchBody, serialised: '', json: false };\n    }\n    // Plain `JSON.stringify`, deliberately not `safeStringify`: a cycle here must\n    // throw rather than be sent upstream as \"[Circular]\".\n    const serialised = JSON.stringify(payload);\n    return { body: serialised, serialised, json: true };\n  }\n\n  private async send(\n    config: SendConfig,\n    url: URL,\n    body: FetchBody | undefined,\n    serialised: string,\n    accept = 'application/json',\n  ): Promise<Response> {\n    const requestId =\n      this.options.requestIdHeader === undefined\n        ? undefined\n        : this.requestContext.getContext().requestId;\n\n    const headers: Record<string, string> = {\n      accept,\n      ...(serialised === '' ? {} : { 'content-type': 'application/json' }),\n      ...this.options.headers,\n      ...(requestId === undefined || this.options.requestIdHeader === undefined\n        ? {}\n        : { [this.options.requestIdHeader]: requestId }),\n      ...config.headerFactory?.({\n        timestamp: Math.floor(Date.now() / 1000),\n        method: config.method,\n        requestPath: url.pathname + url.search,\n        body: serialised,\n      }),\n      ...config.headers,\n    };\n\n    /**\n     * `AbortSignal.timeout` plus `AbortSignal.any`, rather than an\n     * `AbortController` with a `setTimeout` and a `clearTimeout` in a `finally`.\n     * Both are Web standards Bun implements, the timer is the runtime's to cancel,\n     * and combining the caller's signal with the budget is one call instead of a\n     * second listener that has to be removed.\n     */\n    const timeoutMs = config.timeoutMs ?? this.options.timeoutMs;\n    const signals = [\n      ...(timeoutMs > 0 ? [AbortSignal.timeout(timeoutMs)] : []),\n      ...(config.signal === undefined ? [] : [config.signal]),\n    ];\n\n    try {\n      return await fetch(url.href, {\n        method: config.method,\n        headers,\n        ...(body === undefined ? {} : { body }),\n        ...(signals.length === 0 ? {} : { signal: AbortSignal.any(signals) }),\n        ...this.options.fetchOptions,\n      });\n    } catch (error) {\n      // `fetch` reports a refused connection, a DNS failure and an abort all as\n      // exceptions with nothing naming the call. Wrapped so the message does.\n      const aborted =\n        error instanceof Error &&\n        (error.name === 'AbortError' || error.name === 'TimeoutError');\n      throw new FetchTransportError(\n        { method: config.method, url: url.href },\n        aborted,\n        { cause: error },\n      );\n    }\n  }\n}\nObject.defineProperty(HttpService, Symbol.for('dunx.deps'), {\n  value: () => [HttpClientOptions, Logger, RequestContext],\n});\n\nconst urlOf = (url?: string | URL): { url?: string | URL } =>\n  url === undefined ? {} : { url };\n\n/** JSON when the upstream said so or the body parses; text otherwise; undefined for empty. */\nconst readBody = async (response: Response): Promise<unknown> => {\n  const text = await response.text().catch(() => '');\n  if (text === '') return undefined;\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    return text;\n  }\n};\n\nconst describeError = (error: unknown): Record<string, unknown> => {\n  if (error instanceof FetchError) {\n    return {\n      name: error.name,\n      message: error.message,\n      status: error.status,\n      body: error.body,\n    };\n  }\n  if (error instanceof Error) {\n    return { name: error.name, message: error.message };\n  }\n  return { message: String(error) };\n};\n"
   ],
   "mappings": "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",
-  "debugId": "67E96F658C57D72264756E2164756E21",
+  "debugId": "9448CCC7AF6FC82264756E2164756E21",
   "names": []
 }

package/dist/health/registry.d.ts

@@ -18,6 +18,7 @@ export interface HealthCheckReport {
 export interface HealthReport {
     readonly status: ProbeState;
     readonly draining: boolean;
+    /** Measured on a monotonic clock, so it never goes backwards. */
     readonly uptimeMs: number;
     readonly checks: readonly HealthCheckReport[];
 }

package/dist/index.d.ts

@@ -9,7 +9,8 @@ export { buildContext, type RouteContext } from './server/context.js';
 export { preflight, withCors, type CorsOptions, type CorsOrigin, } from './server/cors.js';
 export { defaultErrorMapper, ErrorFilter, errorMapper, HttpError, isErrorFilter, toErrorMapper, ValidationError, type ErrorHandler, type ErrorMapper, type HttpErrorOptions, type InputSource, type ValidationIssue, } from './server/errors.js';
 export { HttpFactory, type HttpApp, type HttpOptions, } from './server/factory.js';
-export { REQUEST_ID_HEADER, RequestLoggingMiddleware, type RequestLoggingOptions, } from './server/request-logging.js';
+export { REQUEST_ID_HEADER } from './server/request-id.js';
+export { RequestLoggingMiddleware, type RequestLoggingOptions, } from './server/request-logging.js';
 export { compose, type Middleware, type Next, type RouteHandler, } from './server/middleware.js';
 export { assertNoCollisions, assertNoGatewayCollisions, buildRoutes, withUpgradeRoutes, type BunRoutes, type GuardResolver, type RouteMethod, type ServeRoutes, } from './server/routes.js';
 export type { AppSettings } from './server/settings.js';

package/dist/index.js

@@ -501,6 +501,7 @@ var defaultOnError = (error, socket) => {
 var reportedByMiddleware = () => {
   return;
 };
+var unreported = (middleware) => "Socket middleware is installed and none of it sets reportsErrors, so a " + "throwing gateway handler is reported nowhere: the console fallback is off " + "whenever middleware wraps the handler. Set reportsErrors on the one that " + "records a failure, or pass websocket.onError. Installed: " + `${middleware.map((entry) => entry.constructor.name).join(", ")}.`;
 var runtimeOf = (socket) => socket.data[RUNTIME];
 var isBinary = (value) => value instanceof ArrayBuffer || ArrayBuffer.isView(value);
 var replyRaw = (socket, value) => {
@@ -584,6 +585,7 @@ var buildWebSocket = (discovered, options = {}, middleware = []) => {
   ]));
   const gateways = [...wrapped.values()];
   const onError = options.onError ?? (middleware.length === 0 ? defaultOnError : reportedByMiddleware);
+  const reports = options.onError !== undefined || middleware.some((entry) => entry.reportsErrors === true);
   const { onError: _onError, ...socketOptions } = options;
   const run = (invoke, args, ws, then) => {
     try {
@@ -686,6 +688,7 @@ var buildWebSocket = (discovered, options = {}, middleware = []) => {
     websocket,
     routes: new Map(gateways.map((gateway) => [gateway.path, upgradeHandler(gateway)])),
     paths: [...byPath.keys()],
+    warnings: middleware.length > 0 && !reports ? [unreported(middleware)] : [],
     gateways: gateways.map((gateway) => ({
       name: gateway.name,
       path: gateway.path,
@@ -705,6 +708,7 @@ var elapsedMs = (started) => Math.round((Bun.nanoseconds() - started) / 1e6);
 class SocketLoggingMiddleware {
   logger;
   context;
+  reportsErrors = true;
   #level;
   #errorLevel;
   #events;
@@ -965,9 +969,28 @@ import {
   Logger as Logger2,
   RequestContext as RequestContext2
 } from "@dunx/core";
+
+// src/server/request-id.ts
 var REQUEST_ID_HEADER = "x-request-id";
 var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var traceId = (inbound) => inbound !== null && inbound.length === 36 && UUID.test(inbound) ? inbound : crypto.randomUUID();
+var ID = Symbol.for("dunx.http.requestId");
+
+class RequestIds {
+  static assign(req) {
+    const id = traceId(req.headers.get(REQUEST_ID_HEADER));
+    req[ID] = id;
+    return id;
+  }
+  static stamp(response, req) {
+    const id = req[ID];
+    if (id !== undefined)
+      response.headers.set(REQUEST_ID_HEADER, id);
+    return response;
+  }
+}
+
+// src/server/request-logging.ts
 var parse = (text, limit) => {
   if (limit === 0)
     return;
@@ -1020,7 +1043,7 @@ class RequestLoggingMiddleware {
       return this.#correlateIgnored ? this.#correlated(req, ctx, path, next) : next();
     }
     const started = Bun.nanoseconds();
-    const requestId = traceId(req.headers.get(REQUEST_ID_HEADER));
+    const requestId = RequestIds.assign(req);
     const scope = {
       requestId,
       method: ctx.method,
@@ -1048,7 +1071,7 @@ class RequestLoggingMiddleware {
     });
   }
   #correlated(req, ctx, path, next) {
-    const requestId = traceId(req.headers.get(REQUEST_ID_HEADER));
+    const requestId = RequestIds.assign(req);
     const stamp = (response) => {
       response.headers.set(REQUEST_ID_HEADER, requestId);
       return response;
@@ -1302,7 +1325,7 @@ var buildFallback = (middleware = [], onError = defaultErrorMapper, cors, notFou
     try {
       return await compose(middleware, unmatchedContext(req, notFound === "public"), miss)(req);
     } catch (error) {
-      return onError(error, req);
+      return RequestIds.stamp(onError(error, req), req);
     }
   };
   return cors ? withCors(cors, run) : run;
@@ -1359,7 +1382,7 @@ var buildRoutes = (discovered, middleware = [], onError = defaultErrorMapper, co
       try {
         return await chained(req);
       } catch (error) {
-        return onError(error, req);
+        return RequestIds.stamp(onError(error, req), req);
       }
     };
     const byMethod = routes[route.path] ??= {};
@@ -1610,6 +1633,9 @@ class HttpFactory {
     assertNoCollisions(discovered);
     const gateways = discoverGateways(modules, (token) => app.get(token));
     const websocket = gateways.length > 0 ? buildWebSocket(gateways, options.websocket, HttpFactory.#socketMiddleware(app, root, options)) : undefined;
+    for (const warning of websocket?.warnings ?? []) {
+      app.get(Logger4).warn(warning);
+    }
     return new HttpApplication(app, discovered, options, root, websocket);
   }
   static #socketMiddleware(app, root, options) {
@@ -2152,7 +2178,7 @@ Object.defineProperty(HealthOptions, Symbol.for("dunx.deps"), {
 class HealthRegistry {
   options;
   readiness_;
-  #startedAt = Date.now();
+  #startedAt = performance.now();
   constructor(options, readiness_) {
     this.options = options;
     this.readiness_ = readiness_;
@@ -2172,7 +2198,7 @@ class HealthRegistry {
     return {
       status: worst(checks),
       draining: this.readiness_.draining,
-      uptimeMs: Date.now() - this.#startedAt,
+      uptimeMs: Math.round(performance.now() - this.#startedAt),
       checks
     };
   }
@@ -2439,106 +2465,106 @@ __runInitializers(_init, 1, HealthModule);
 __decoratorMetadata(_init, HealthModule);
 let _HealthModule = HealthModule;
 export {
-  withUpgradeRoutes,
-  withCors,
-  toErrorMapper,
-  routesOf,
-  preflight,
-  observe,
-  normalizePrefix,
-  normalizePath,
-  metaOf,
-  metaKey,
-  meta,
-  mergeMeta,
-  joinPath,
-  isGateway,
-  isErrorFilter,
-  guardsOf,
-  gatewaysOf,
-  errorMapper,
-  encodeRelay,
-  encode,
-  discoverRoutes,
-  discoverGateways,
-  discoverGateway,
-  defaultRelayUrl,
-  defaultErrorMapper,
-  decodeRelay,
-  decode,
-  composeSocket,
-  compose,
-  buildWebSocket,
-  buildRuntime,
-  buildRoutes,
-  buildGateways,
-  buildContext,
-  assertNoGatewayCollisions,
-  assertNoCollisions,
-  ValidationError,
-  UseGuards,
-  UNMATCHED,
-  ThrottleStore,
-  ThrottleOptions,
-  ThrottleModule,
-  ThrottleGuard,
-  Throttle,
-  THROTTLE,
-  StaticOptions,
-  StaticModule,
-  StaticFiles,
-  SocketLoggingMiddleware,
-  SkipThrottle,
-  SKIP_THROTTLE,
-  Roles,
-  RequestLoggingMiddleware,
-  RedisThrottleStore,
-  RedisRelay,
-  RedisIndicator,
-  ReadinessOptions,
-  Readiness,
-  ROLES,
-  REQUEST_ID_HEADER,
-  QueryProbe,
-  Put,
-  Public,
-  PubSub,
-  Post,
-  PingProbe,
-  Patch,
-  PUBLIC,
-  OnUpgrade,
-  OnPong,
-  OnPing,
-  OnOpen,
-  OnMessage,
-  OnDrain,
-  OnClose,
-  MemoryThrottleStore,
-  MemoryOptions,
-  MemoryIndicator,
-  HttpStatusCode,
-  HttpFactory,
-  HttpError,
-  HealthRegistry,
-  HealthOptions,
-  HealthModule,
-  HealthIndicator,
-  HealthController,
-  HandlerKind,
-  HIDDEN,
-  Get,
-  Gateway,
-  ErrorFilter,
-  DiskOptions,
-  DiskIndicator,
-  Delete,
-  DatabaseIndicator,
-  DEFAULT_RELAY_CHANNEL,
-  Controller,
+  ApiHidden,
   ClientAddress,
-  ApiHidden
+  Controller,
+  DEFAULT_RELAY_CHANNEL,
+  DatabaseIndicator,
+  Delete,
+  DiskIndicator,
+  DiskOptions,
+  ErrorFilter,
+  Gateway,
+  Get,
+  HIDDEN,
+  HandlerKind,
+  HealthController,
+  HealthIndicator,
+  HealthModule,
+  HealthOptions,
+  HealthRegistry,
+  HttpError,
+  HttpFactory,
+  HttpStatusCode,
+  MemoryIndicator,
+  MemoryOptions,
+  MemoryThrottleStore,
+  OnClose,
+  OnDrain,
+  OnMessage,
+  OnOpen,
+  OnPing,
+  OnPong,
+  OnUpgrade,
+  PUBLIC,
+  Patch,
+  PingProbe,
+  Post,
+  PubSub,
+  Public,
+  Put,
+  QueryProbe,
+  REQUEST_ID_HEADER,
+  ROLES,
+  Readiness,
+  ReadinessOptions,
+  RedisIndicator,
+  RedisRelay,
+  RedisThrottleStore,
+  RequestLoggingMiddleware,
+  Roles,
+  SKIP_THROTTLE,
+  SkipThrottle,
+  SocketLoggingMiddleware,
+  StaticFiles,
+  StaticModule,
+  StaticOptions,
+  THROTTLE,
+  Throttle,
+  ThrottleGuard,
+  ThrottleModule,
+  ThrottleOptions,
+  ThrottleStore,
+  UNMATCHED,
+  UseGuards,
+  ValidationError,
+  assertNoCollisions,
+  assertNoGatewayCollisions,
+  buildContext,
+  buildGateways,
+  buildRoutes,
+  buildRuntime,
+  buildWebSocket,
+  compose,
+  composeSocket,
+  decode,
+  decodeRelay,
+  defaultErrorMapper,
+  defaultRelayUrl,
+  discoverGateway,
+  discoverGateways,
+  discoverRoutes,
+  encode,
+  encodeRelay,
+  errorMapper,
+  gatewaysOf,
+  guardsOf,
+  isErrorFilter,
+  isGateway,
+  joinPath,
+  mergeMeta,
+  meta,
+  metaKey,
+  metaOf,
+  normalizePath,
+  normalizePrefix,
+  observe,
+  preflight,
+  routesOf,
+  toErrorMapper,
+  withCors,
+  withUpgradeRoutes
 };
 
-//# debugId=80302AC7A1BB24E664756E2164756E21
+//# debugId=30A653C61AAD581564756E2164756E21
 //# sourceMappingURL=index.js.map