@fixback/node 0.2.0 → 0.3.0

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -10,4 +10,4 @@
  * ever drift. Do not hand-edit this line to a value other than `package.json`'s
  * version.
  */
-export declare const NODE_SDK_VERSION = "0.2.0";
+export declare const NODE_SDK_VERSION = "0.3.0";

package/dist/version.js

@@ -13,5 +13,5 @@ exports.NODE_SDK_VERSION = void 0;
  * ever drift. Do not hand-edit this line to a value other than `package.json`'s
  * version.
  */
-exports.NODE_SDK_VERSION = "0.2.0";
+exports.NODE_SDK_VERSION = "0.3.0";
 //# sourceMappingURL=version.js.map

package/dist/wire.d.ts

@@ -87,22 +87,16 @@ export interface ServerErrorPayload {
     readonly errorFrames?: readonly CapturedFrame[];
     readonly server?: ServerContext;
 }
-/** The JSON batch envelope `POST`ed to `/api/errors` — a non-empty array of errors. */
+/**
+ * The JSON batch envelope `POST`ed to `/api/errors` — a non-empty array of errors.
+ * The transport types its request body with this, so the envelope shape is checked
+ * against the endpoint's contract rather than assembled inline.
+ *
+ * The endpoint's *response* is deliberately not modelled: the transport reads only
+ * the status and `Retry-After` (ADR-0026's partial-failure results are for the
+ * dashboard, not the SDK), and an unread shape would be a contract to keep in
+ * lock-step for nothing.
+ */
 export interface ServerErrorBatch {
     readonly errors: readonly ServerErrorPayload[];
 }
-/** The per-item accept/reject result the endpoint returns (ADR-0026 partial-failure). */
-export type ServerErrorItemResult = {
-    readonly accepted: true;
-    readonly issueId: string;
-    readonly folded: boolean;
-    readonly feedbackId?: string;
-} | {
-    readonly accepted: false;
-    readonly reason: string;
-};
-/** The endpoint's response body — `results` on `201`, or a `message` on a shed `429`. */
-export interface ServerErrorResponse {
-    readonly results?: readonly ServerErrorItemResult[];
-    readonly message?: string;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fixback/node",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The Fixback backend error SDK for Node servers — one-call init, batched secret-key capture, process handlers, and Express + NestJS adapters.",
   "license": "MIT",
   "type": "module",
@@ -27,7 +27,6 @@
   },
   "files": [
     "dist",
-    "src",
     "README.md",
     "LICENSE"
   ],
@@ -45,13 +44,13 @@
     "url": "git+https://github.com/wemuda/fixback.git",
     "directory": "packages/node"
   },
-  "homepage": "https://github.com/wemuda/fixback/tree/master/packages/node#readme",
-  "bugs": "https://github.com/wemuda/fixback/issues",
+  "homepage": "https://docs.fixback.dev/sdk/node",
+  "bugs": "https://docs.fixback.dev",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@fixback/sdk-core": "0.2.0"
+    "@fixback/sdk-core": "0.3.0"
   },
   "peerDependencies": {
     "@nestjs/common": ">=10.0.0",
@@ -82,8 +81,11 @@
     "typescript": "5.9.3",
     "vitest": "^4.1.10"
   },
+  "engines": {
+    "node": ">=20.12"
+  },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && node scripts/finalize-cjs.mjs",
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/finalize-cjs.mjs dist",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"

package/src/client.test.ts

@@ -1,272 +0,0 @@
-import { computeFingerprint } from "@fixback/sdk-core";
-import { afterEach, describe, expect, it } from "vitest";
-
-import {
-  captureException as moduleCaptureException,
-  captureMessage as moduleCaptureMessage,
-  close as moduleClose,
-  FixbackClient,
-  getClient,
-  init,
-} from "./client";
-import { resolveConfig } from "./config";
-import { runWithRequestStore } from "./context";
-import type { CaptureTransport } from "./transport";
-import type { ServerErrorPayload } from "./wire";
-
-function recorder(): { enqueued: ServerErrorPayload[]; transport: CaptureTransport } {
-  const enqueued: ServerErrorPayload[] = [];
-  return {
-    enqueued,
-    transport: {
-      enqueue: (payload) => enqueued.push(payload),
-      flush: async () => {},
-      close: async () => {},
-    },
-  };
-}
-
-function client(options: Parameters<typeof resolveConfig>[0], transport: CaptureTransport) {
-  return new FixbackClient(resolveConfig(options), { transport });
-}
-
-/** A tiny process stand-in so module tests never attach handlers to the real process. */
-function fakeProcess() {
-  const map = new Map<string, Array<(...args: unknown[]) => void>>();
-  return {
-    on(event: string, listener: (...args: unknown[]) => void) {
-      map.set(event, [...(map.get(event) ?? []), listener]);
-      return this;
-    },
-    removeListener(event: string, listener: (...args: unknown[]) => void) {
-      map.set(event, (map.get(event) ?? []).filter((l) => l !== listener));
-      return this;
-    },
-    listeners(event: string) {
-      return [...(map.get(event) ?? [])];
-    },
-  };
-}
-
-describe("FixbackClient.captureException", () => {
-  it("enqueues a payload with a fingerprint, handled:true, environment, release and frames", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk", environment: "production", release: "1.2.3" }, transport);
-
-    c.captureException(new TypeError("boom"));
-
-    expect(enqueued).toHaveLength(1);
-    const payload = enqueued[0]!;
-    expect(typeof payload.errorSignature).toBe("string");
-    expect(payload.errorSignature.length).toBeGreaterThan(0);
-    expect(payload.handled).toBe(true);
-    expect(payload.environment).toBe("production");
-    expect(payload.release).toBe("1.2.3");
-    expect(payload.errorFrames?.length ?? 0).toBeGreaterThan(0);
-    // The error class / message never travel on the wire (no server slot; untrusted).
-    const asRecord = payload as unknown as Record<string, unknown>;
-    expect(asRecord.type).toBeUndefined();
-    expect(asRecord.value).toBeUndefined();
-  });
-
-  it("fingerprints via the shared core — the same error yields a stable key", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    const err = new Error("same");
-    err.stack = "Error: same\n    at fn (/srv/app/a.js:1:1)";
-    c.captureException(err);
-    c.captureException(err);
-    expect(enqueued[0]!.errorSignature).toBe(enqueued[1]!.errorSignature);
-    expect(enqueued[0]!.errorSignature).toBe(computeFingerprint("Error", "same", err.stack));
-  });
-
-  it("attaches the in-flight request's server context from AsyncLocalStorage", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    runWithRequestStore(
-      {
-        req: { method: "POST", route: { path: "/pay/:id" }, path: "/pay/42" },
-        res: { statusCode: 500 },
-        requestId: "r-1",
-        user: "u-9",
-      },
-      () => c.captureException(new Error("x")),
-    );
-    expect(enqueued[0]!.server).toEqual({
-      method: "POST",
-      route: "/pay/:id",
-      statusCode: 500,
-      requestId: "r-1",
-      user: "u-9",
-    });
-  });
-
-  it("lets an explicit context override merge over the request context (Nest filter status)", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    runWithRequestStore(
-      { req: { method: "GET", route: { path: "/x" } }, res: { statusCode: 200 } },
-      () => c.captureException(new Error("x"), { handled: true, server: { statusCode: 503 } }),
-    );
-    expect(enqueued[0]!.server?.statusCode).toBe(503);
-    expect(enqueued[0]!.server?.method).toBe("GET");
-  });
-
-  it("captures a non-Error throwable without throwing", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    expect(() => c.captureException("string failure")).not.toThrow();
-    expect(enqueued[0]!.errorSignature.length).toBeGreaterThan(0);
-  });
-
-  it("scrubs credentials and query strings out of frame urls before transport", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    const err = new Error("x");
-    err.stack = "Error: x\n    at h (https://user:pass@cdn.ex.com/a.js?token=abc123:1:1)";
-    c.captureException(err);
-    const file = enqueued[0]!.errorFrames?.[0]?.file ?? "";
-    expect(file).not.toContain("token=abc123");
-    expect(file).not.toContain("user:pass@");
-    expect(file).toContain("cdn.ex.com/a.js");
-  });
-
-  it("is private-by-default — never carries cookies, auth headers or the concrete path", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    runWithRequestStore(
-      {
-        req: {
-          method: "GET",
-          route: { path: "/u/:id" },
-          path: "/u/42",
-          headers: { cookie: "session=secret-cookie", authorization: "Bearer sk_leak" },
-        },
-        res: { statusCode: 500 },
-      },
-      () => c.captureException(new Error("x")),
-    );
-    const json = JSON.stringify(enqueued[0]);
-    expect(json).not.toContain("secret-cookie");
-    expect(json).not.toContain("sk_leak");
-    expect(json).not.toContain("/u/42");
-    expect(json).toContain("/u/:id");
-  });
-
-  it("does nothing when the client is disabled (fail-quiet gate)", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "" }, transport); // no key → inert
-    c.captureException(new Error("x"));
-    expect(enqueued).toHaveLength(0);
-  });
-});
-
-describe("FixbackClient beforeSend", () => {
-  it("runs the hook so it can redact the event", () => {
-    const { enqueued, transport } = recorder();
-    const c = new FixbackClient(
-      resolveConfig({
-        secretKey: "sk",
-        beforeSend: (event) => {
-          event.server = { ...event.server, user: "[redacted]" };
-          return event;
-        },
-      }),
-      { transport },
-    );
-    runWithRequestStore(
-      { req: { method: "GET", route: { path: "/x" } }, user: "real-user" },
-      () => c.captureException(new Error("x")),
-    );
-    expect(enqueued[0]!.server?.user).toBe("[redacted]");
-  });
-
-  it("drops the event entirely when the hook returns null", () => {
-    const { enqueued, transport } = recorder();
-    const c = new FixbackClient(resolveConfig({ secretKey: "sk", beforeSend: () => null }), {
-      transport,
-    });
-    c.captureException(new Error("dropped"));
-    expect(enqueued).toHaveLength(0);
-  });
-
-  it("keeps the scrubbed event when the hook throws (a buggy hook never breaks capture)", () => {
-    const { enqueued, transport } = recorder();
-    const c = new FixbackClient(
-      resolveConfig({
-        secretKey: "sk",
-        beforeSend: () => {
-          throw new Error("hook bug");
-        },
-      }),
-      { transport },
-    );
-    expect(() => c.captureException(new Error("survives"))).not.toThrow();
-    expect(enqueued).toHaveLength(1);
-  });
-});
-
-describe("FixbackClient.captureMessage", () => {
-  it("files a handled message with no frames; groups by message text", () => {
-    const { enqueued, transport } = recorder();
-    const c = client({ secretKey: "sk" }, transport);
-    c.captureMessage("cache miss storm", "warning");
-    c.captureMessage("cache miss storm");
-    c.captureMessage("something else");
-    expect(enqueued[0]!.handled).toBe(true);
-    expect(enqueued[0]!.errorFrames).toBeUndefined();
-    expect(enqueued[1]!.errorSignature).toBe(enqueued[0]!.errorSignature);
-    expect(enqueued[2]!.errorSignature).not.toBe(enqueued[0]!.errorSignature);
-  });
-});
-
-describe("module singleton API", () => {
-  afterEach(async () => {
-    await moduleClose();
-  });
-
-  it("init sets the active client, installs process handlers, and delegates captures", () => {
-    const { enqueued, transport } = recorder();
-    const proc = fakeProcess();
-    const active = init({ secretKey: "sk" }, { transport, process: proc, onFatalError: () => {} });
-    expect(getClient()).toBe(active);
-    expect(proc.listeners("uncaughtException")).toHaveLength(1);
-    expect(proc.listeners("unhandledRejection")).toHaveLength(1);
-    moduleCaptureException(new Error("via module"));
-    moduleCaptureMessage("hello");
-    expect(enqueued).toHaveLength(2);
-  });
-
-  it("removes the process handlers and clears the client on close", async () => {
-    const proc = fakeProcess();
-    init({ secretKey: "sk" }, { transport: recorder().transport, process: proc, onFatalError: () => {} });
-    expect(proc.listeners("uncaughtException")).toHaveLength(1);
-    await moduleClose();
-    expect(proc.listeners("uncaughtException")).toHaveLength(0);
-    expect(getClient()).toBeNull();
-  });
-
-  it("closes the previous client and removes its handlers when init is called again", () => {
-    let closed = 0;
-    const first: CaptureTransport = {
-      enqueue: () => {},
-      flush: async () => {},
-      close: async () => {
-        closed += 1;
-      },
-    };
-    const proc1 = fakeProcess();
-    init({ secretKey: "sk" }, { transport: first, process: proc1, onFatalError: () => {} });
-    init({ secretKey: "sk" }, { transport: recorder().transport, process: fakeProcess(), onFatalError: () => {} });
-    expect(closed).toBe(1);
-    expect(proc1.listeners("uncaughtException")).toHaveLength(0);
-  });
-
-  it("no-ops (never throws) when disabled — no handlers, no capture", () => {
-    const proc = fakeProcess();
-    init({ secretKey: "" }, { transport: recorder().transport, process: proc, onFatalError: () => {} });
-    expect(proc.listeners("uncaughtException")).toHaveLength(0);
-    expect(() => moduleCaptureException(new Error("x"))).not.toThrow();
-    expect(() => moduleCaptureMessage("x")).not.toThrow();
-  });
-});

package/src/client.ts

@@ -1,262 +0,0 @@
-/**
- * The `FixbackClient` and the module-level singleton API (`init`, `captureException`,
- * `captureMessage`, `flush`, `close`) — the SDK's capture surface.
- *
- * A capture distils the error, fingerprints it with the **shared core**
- * (`@fixback/sdk-core`, so the key matches the browser SDK — ADR-0028), attaches the
- * in-flight request's {@link ServerContext} from AsyncLocalStorage, runs the scrub
- * choke point and the project's `beforeSend`, then hands a {@link ServerErrorPayload}
- * to the batched transport. Every step is wrapped so a capture **never throws into
- * the host** (story 34): a misbehaving hook, an unserialisable error, or a transport
- * hiccup is swallowed, and the server keeps running.
- */
-
-import { computeFingerprint, scrubUrl } from "@fixback/sdk-core";
-
-import { type InitOptions, resolveConfig, type ResolvedConfig } from "./config";
-import { currentServerContext } from "./context";
-import { installProcessHandlers, type ProcessLike } from "./process";
-import { extractError, extractStructuredFrames } from "./stack";
-import { type CaptureTransport, Transport } from "./transport";
-import type { FixbackErrorEvent, ServerContext, ServerErrorPayload, Severity } from "./wire";
-
-export type { BeforeSend, FixbackErrorEvent, ServerContext, Severity } from "./wire";
-export type { InitOptions } from "./config";
-export type { CaptureTransport } from "./transport";
-
-/** Optional per-capture context — override `handled` or add/override server context. */
-export interface CaptureContext {
-  /** Override the handled flag (defaults to `true` for a manual/caught capture). */
-  readonly handled?: boolean;
-  /** Server context to merge over what the request scope provides (e.g. a filter's status). */
-  readonly server?: ServerContext;
-}
-
-/** The minimal capture surface the framework adapters file through (satisfied by {@link FixbackClient}). */
-export interface CaptureClient {
-  captureException(error: unknown, context?: CaptureContext): void;
-}
-
-/** Advanced/testing seam: supply a custom {@link CaptureTransport} or process. */
-export interface ClientDeps {
-  readonly transport?: CaptureTransport;
-  /** The process to attach handlers to (defaults to the real `process`). */
-  readonly process?: ProcessLike;
-  /** Override Node's default fatal behaviour after a sole-listener uncaught exception. */
-  readonly onFatalError?: (error: unknown) => void;
-}
-
-type MutablePayload = { -readonly [K in keyof ServerErrorPayload]: ServerErrorPayload[K] };
-
-/** Merge two server contexts, the override winning; `undefined` when both are empty. */
-function mergeServerContext(
-  base: ServerContext | undefined,
-  override: ServerContext | undefined,
-): ServerContext | undefined {
-  if (!base && !override) return undefined;
-  const merged: Record<string, unknown> = { ...(base ?? {}), ...(override ?? {}) };
-  for (const key of Object.keys(merged)) {
-    if (merged[key] === undefined) delete merged[key];
-  }
-  return Object.keys(merged).length > 0 ? (merged as ServerContext) : undefined;
-}
-
-export class FixbackClient {
-  private readonly config: ResolvedConfig;
-  private readonly transport: CaptureTransport | null;
-
-  constructor(config: ResolvedConfig, deps: ClientDeps = {}) {
-    this.config = config;
-    this.transport =
-      deps.transport ??
-      (config.enabled
-        ? new Transport({
-            endpoint: config.errorsEndpoint,
-            secretKey: config.secretKey,
-            maxBatchSize: config.maxBatchSize,
-            maxQueueSize: config.maxQueueSize,
-            flushIntervalMs: config.flushIntervalMs,
-            timeoutMs: config.timeoutMs,
-          })
-        : null);
-  }
-
-  /** Whether this client will capture (its secret key resolved and the gate is on). */
-  get enabled(): boolean {
-    return this.config.enabled;
-  }
-
-  /** The header the request-context middleware reads a correlation id from. */
-  get requestIdHeader(): string {
-    return this.config.requestIdHeader;
-  }
-
-  /**
-   * Report a caught or manually-observed error. `handled` defaults to `true`; the
-   * process handlers pass `handled: false` for an uncaught crash.
-   */
-  captureException(error: unknown, context: CaptureContext = {}): void {
-    const { type, value, stack } = extractError(error);
-    const frames = extractStructuredFrames(stack);
-    this.dispatch(
-      {
-        errorSignature: computeFingerprint(type, value, stack),
-        type,
-        value,
-        handled: context.handled ?? true,
-        errorFrames: frames.length > 0 ? frames : undefined,
-      },
-      context,
-    );
-  }
-
-  /** Report a noteworthy non-error condition, grouped by its message text. */
-  captureMessage(message: string, level: Severity = "info", context: CaptureContext = {}): void {
-    const value = typeof message === "string" ? message : String(message);
-    this.dispatch(
-      {
-        errorSignature: computeFingerprint("Message", value),
-        type: "Message",
-        value,
-        level,
-        handled: context.handled ?? true,
-      },
-      context,
-    );
-  }
-
-  /** Flush the transport's buffer now. Resolves even when the SDK is disabled. */
-  flush(): Promise<void> {
-    return this.transport?.flush() ?? Promise.resolve();
-  }
-
-  /** Stop the transport (its timer) and drain what remains. */
-  close(): Promise<void> {
-    return this.transport?.close() ?? Promise.resolve();
-  }
-
-  /** Assemble, scrub, run `beforeSend`, and enqueue — swallowing any failure. */
-  private dispatch(
-    partial: Pick<FixbackErrorEvent, "errorSignature" | "type" | "value" | "handled"> &
-      Partial<Pick<FixbackErrorEvent, "level" | "errorFrames">>,
-    context: CaptureContext,
-  ): void {
-    if (!this.config.enabled || !this.transport) return;
-    try {
-      const event: FixbackErrorEvent = {
-        errorSignature: partial.errorSignature,
-        type: partial.type,
-        value: partial.value,
-        handled: partial.handled,
-        level: partial.level,
-        environment: this.config.environment,
-        release: this.config.release,
-        errorFrames: partial.errorFrames,
-        server: mergeServerContext(currentServerContext(), context.server),
-      };
-      if (this.config.scrub) applyDefaultScrub(event);
-      const finalised = this.runBeforeSend(event);
-      if (!finalised) return; // dropped at the choke point — no transport
-      this.transport.enqueue(toPayload(finalised));
-    } catch {
-      // Capture must never throw into the host (story 34).
-    }
-  }
-
-  /** Run the project hook after the default scrubbers; a throwing hook is a no-op. */
-  private runBeforeSend(event: FixbackErrorEvent): FixbackErrorEvent | null {
-    const hook = this.config.beforeSend;
-    if (!hook) return event;
-    try {
-      return hook(event) ?? null;
-    } catch {
-      return event; // a buggy hook never breaks the report path nor leaks unscrubbed data
-    }
-  }
-}
-
-/** The built-in default scrub: re-sweep frame URLs through the shared-core scrubber. */
-function applyDefaultScrub(event: FixbackErrorEvent): void {
-  if (event.errorFrames && event.errorFrames.length > 0) {
-    event.errorFrames = event.errorFrames.map((frame) => ({
-      ...frame,
-      file: scrubUrl(frame.file),
-    }));
-  }
-}
-
-/** Project the event onto the wire payload, dropping the event-only fields. */
-function toPayload(event: FixbackErrorEvent): ServerErrorPayload {
-  const payload: MutablePayload = { errorSignature: event.errorSignature };
-  if (event.handled !== undefined) payload.handled = event.handled;
-  if (event.environment !== undefined) payload.environment = event.environment;
-  if (event.release !== undefined) payload.release = event.release;
-  if (event.occurrences !== undefined) payload.occurrences = event.occurrences;
-  if (event.errorFrames && event.errorFrames.length > 0) payload.errorFrames = event.errorFrames;
-  if (event.server) payload.server = event.server;
-  return payload;
-}
-
-// --- Module-level singleton API ----------------------------------------------
-
-let activeClient: FixbackClient | null = null;
-let activeUninstall: (() => void) | null = null;
-
-/**
- * Initialise the SDK: resolve the config, replace any previous client (closing it and
- * removing its process handlers), install the polite process handlers, and return the
- * active {@link FixbackClient}. Fail-quiet — a missing secret key yields an inert
- * client (no handlers, no transport) rather than throwing.
- */
-export function init(options: InitOptions, deps?: ClientDeps): FixbackClient {
-  const previousClient = activeClient;
-  const previousUninstall = activeUninstall;
-  if (previousUninstall) previousUninstall();
-  if (previousClient) void previousClient.close();
-
-  const config = resolveConfig(options);
-  const client = new FixbackClient(config, deps);
-  activeClient = client;
-  activeUninstall =
-    config.enabled && (config.captureUncaughtException || config.captureUnhandledRejection)
-      ? installProcessHandlers(
-          client,
-          {
-            captureUncaughtException: config.captureUncaughtException,
-            captureUnhandledRejection: config.captureUnhandledRejection,
-          },
-          { process: deps?.process, onFatalError: deps?.onFatalError },
-        )
-      : null;
-  return client;
-}
-
-/** The active client set by {@link init}, or `null` before the first `init`. */
-export function getClient(): FixbackClient | null {
-  return activeClient;
-}
-
-/** Report a caught/manual error through the active client (no-op before `init`). */
-export function captureException(error: unknown, context?: CaptureContext): void {
-  activeClient?.captureException(error, context);
-}
-
-/** Report a message through the active client (no-op before `init`). */
-export function captureMessage(message: string, level?: Severity, context?: CaptureContext): void {
-  activeClient?.captureMessage(message, level, context);
-}
-
-/** Flush the active client's buffer (no-op before `init`). */
-export function flush(): Promise<void> {
-  return activeClient?.flush() ?? Promise.resolve();
-}
-
-/** Close and clear the active client, removing its process handlers (no-op before `init`). */
-export function close(): Promise<void> {
-  const current = activeClient;
-  const uninstall = activeUninstall;
-  activeClient = null;
-  activeUninstall = null;
-  if (uninstall) uninstall();
-  return current?.close() ?? Promise.resolve();
-}