@ledgerhq/live-network 3.0.0 → 3.1.0

package/README.md

@@ -1,7 +1,12 @@
 # live-network
 
-> [!NOTE]
-> **Status: STABLE** — Production-ready; API is considered stable.
+> [!WARNING]
+> **Status: DEPRECATED**
+> Inside Ledger Live, use [RTK Query](https://redux-toolkit.js.org/rtk-query/overview) instead.
+> Outside Ledger Live, use plain [`fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch)
+> or [`axios`](https://axios-http.com/) directly.
+> This package was extracted to ts-libs to unblock the migration of its dependents, not because it is
+> the recommended path. No new consumers, please.
 
 `@ledgerhq/live-network` is the shared network layer for Ledger Live. It wraps the underlying HTTP client with Ledger-specific logging, error normalisation, and request optimisation utilities so all services in the monorepo make network calls consistently.
 

package/lib/state.d.ts

@@ -6,9 +6,7 @@ type NetworkState = {
     getCallsRetry: number;
 };
 declare global {
-    interface GlobalThis {
-        __ledgerLiveNetworkState?: NetworkState;
-    }
+    var __ledgerLiveNetworkState: NetworkState | undefined;
 }
 export declare function getNetworkState(): Readonly<NetworkState>;
 export type { NetworkState };

package/lib/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,wBAAwB,CAAC,EAAE,YAAY,CAAC;KACzC;CACF;AAUD,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAGxD;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,wBAAwB,EAAE,YAAY,GAAG,SAAS,CAAC;CACxD;AAUD,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAGxD;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/lib/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":";;;AAcA,MAAM,QAAQ,GAAiB;IAC7B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,EAAE;IACvB,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF;IACE,UAAU,CAAC,wBAAwB,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,OAAO,UAAU,CAAC,wBAAwB,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":";;;AAYA,MAAM,QAAQ,GAAiB;IAC7B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,EAAE;IACvB,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF;IACE,UAAU,CAAC,wBAAwB,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,OAAO,UAAU,CAAC,wBAAwB,CAAC;AAC7C,CAAC"}

package/lib-es/state.d.ts

@@ -6,9 +6,7 @@ type NetworkState = {
     getCallsRetry: number;
 };
 declare global {
-    interface GlobalThis {
-        __ledgerLiveNetworkState?: NetworkState;
-    }
+    var __ledgerLiveNetworkState: NetworkState | undefined;
 }
 export declare function getNetworkState(): Readonly<NetworkState>;
 export type { NetworkState };

package/lib-es/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,wBAAwB,CAAC,EAAE,YAAY,CAAC;KACzC;CACF;AAUD,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAGxD;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,wBAAwB,EAAE,YAAY,GAAG,SAAS,CAAC;CACxD;AAUD,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAGxD;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/lib-es/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAcA,MAAM,QAAQ,GAAiB;IAC7B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,EAAE;IACvB,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,UAAU,CAAC,wBAAwB,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,OAAO,UAAU,CAAC,wBAAwB,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAYA,MAAM,QAAQ,GAAiB;IAC7B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,EAAE;IACvB,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,UAAU,CAAC,wBAAwB,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,OAAO,UAAU,CAAC,wBAAwB,CAAC;AAC7C,CAAC"}

package/package.json

@@ -1,98 +1,131 @@
 {
   "name": "@ledgerhq/live-network",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Ledger Live network and cache utilities",
   "keywords": [
     "Ledger"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/LedgerHQ/ledger-live.git"
-  },
+  "homepage": "https://github.com/LedgerHQ/ts-libs/tree/main/libs/live-network",
   "bugs": {
-    "url": "https://github.com/LedgerHQ/ledger-live/issues"
+    "url": "https://github.com/LedgerHQ/ts-libs/issues"
   },
-  "homepage": "https://github.com/LedgerHQ/ledger-live/tree/develop/libs/network",
-  "publishConfig": {
-    "access": "public"
+  "license": "Apache-2.0",
+  "files": [
+    "lib",
+    "lib-es",
+    "src",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LedgerHQ/ts-libs.git"
   },
+  "main": "lib/index.js",
+  "module": "lib-es/index.js",
+  "types": "lib/index.d.ts",
   "typesVersions": {
     "*": {
+      "network": [
+        "lib/network.d.ts"
+      ],
+      "cache": [
+        "lib/cache.d.ts"
+      ],
+      "errors": [
+        "lib/errors.d.ts"
+      ],
+      "batcher": [
+        "lib/batcher/index.d.ts"
+      ],
+      "batcher/types": [
+        "lib/batcher/types.d.ts"
+      ],
+      "batcher/index": [
+        "lib/batcher/index.d.ts"
+      ],
       "lib/*": [
         "lib/*"
       ],
       "lib-es/*": [
         "lib-es/*"
-      ],
-      "batcher": [
-        "lib/batcher/index"
-      ],
-      "*": [
-        "lib/*",
-        "lib/batcher/*"
       ]
     }
   },
   "exports": {
-    "./lib/*": "./lib/*.js",
-    "./lib/*.js": "./lib/*.js",
-    "./lib-es/*": "./lib-es/*.js",
-    "./lib-es/*.js": "./lib-es/*.js",
+    ".": {
+      "@ledgerhq/source": "./src/index.ts",
+      "import": "./lib-es/index.js",
+      "require": "./lib/index.js",
+      "default": "./lib/index.js"
+    },
+    "./network": {
+      "@ledgerhq/source": "./src/network.ts",
+      "import": "./lib-es/network.js",
+      "require": "./lib/network.js",
+      "default": "./lib/network.js"
+    },
+    "./cache": {
+      "@ledgerhq/source": "./src/cache.ts",
+      "import": "./lib-es/cache.js",
+      "require": "./lib/cache.js",
+      "default": "./lib/cache.js"
+    },
+    "./errors": {
+      "@ledgerhq/source": "./src/errors.ts",
+      "import": "./lib-es/errors.js",
+      "require": "./lib/errors.js",
+      "default": "./lib/errors.js"
+    },
     "./batcher": {
       "@ledgerhq/source": "./src/batcher/index.ts",
+      "import": "./lib-es/batcher/index.js",
       "require": "./lib/batcher/index.js",
-      "default": "./lib-es/batcher/index.js"
+      "default": "./lib/batcher/index.js"
     },
-    "./batcher/*": {
-      "@ledgerhq/source": "./src/batcher/*.ts",
-      "require": "./lib/batcher/*.js",
-      "default": "./lib-es/batcher/*.js"
+    "./batcher/types": {
+      "@ledgerhq/source": "./src/batcher/types.ts",
+      "import": "./lib-es/batcher/types.js",
+      "require": "./lib/batcher/types.js",
+      "default": "./lib/batcher/types.js"
     },
-    "./*": {
-      "@ledgerhq/source": "./src/*.ts",
-      "require": "./lib/*.js",
-      "default": "./lib-es/*.js"
-    },
-    "./*.js": {
-      "@ledgerhq/source": "./src/*.ts",
-      "require": "./lib/*.js",
-      "default": "./lib-es/*.js"
-    },
-    ".": {
-      "@ledgerhq/source": "./src/index.ts",
-      "require": "./lib/index.js",
-      "default": "./lib-es/index.js"
+    "./batcher/index": {
+      "@ledgerhq/source": "./src/batcher/index.ts",
+      "import": "./lib-es/batcher/index.js",
+      "require": "./lib/batcher/index.js",
+      "default": "./lib/batcher/index.js"
     },
+    "./lib/*": "./lib/*.js",
+    "./lib-es/*": "./lib-es/*.js",
     "./package.json": "./package.json"
   },
-  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "lru-cache": "^7.14.1",
-    "@ledgerhq/live-promise": "^0.3.0",
-    "@ledgerhq/logs": "^6.17.0"
+    "@ledgerhq/live-promise": "0.4.0",
+    "@ledgerhq/logs": "6.19.0"
   },
   "peerDependencies": {
     "axios": "1.13.5"
   },
   "devDependencies": {
-    "@types/invariant": "^2.2.35",
+    "@swc/core": "1.16.1",
+    "@swc/jest": "0.2.39",
     "@types/jest": "30.0.0",
-    "@types/node": "24.12.0",
+    "@types/node": "26.4.0",
     "axios": "1.13.5",
-    "jest": "30.2.0",
-    "@swc/jest": "0.2.39",
-    "@swc/core": "1.15.11"
+    "jest": "30.5.0",
+    "jest-sonar": "0.2.16",
+    "oxlint": "1.80.0",
+    "typescript": "7.0.2"
   },
   "scripts": {
-    "clean": "rimraf lib lib-es",
+    "clean": "rm -rf lib lib-es",
     "build": "tsc --project tsconfig.build.json && tsc --project tsconfig.build.json -m esnext --moduleResolution bundler --outDir lib-es",
-    "prewatch": "pnpm build",
-    "watch": "tsc --watch --project tsconfig.build.json",
-    "watch:es": "tsc --watch --project tsconfig.build.json -m esnext --moduleResolution bundler --outDir lib-es",
-    "lint": "oxlint -c ../oxc-live-libs/.oxlintrc.json ./src",
-    "lint:fix": "pnpm lint --fix",
+    "lint": "oxlint ./src",
+    "typecheck": "tsc --noEmit",
     "test": "jest",
-    "coverage": "jest --coverage",
-    "unimported": "unimported"
+    "coverage": "jest --coverage"
   }
 }

package/src/batcher/index.test.ts

@@ -0,0 +1,36 @@
+import { makeBatcher } from "./index";
+
+beforeEach(() => jest.useFakeTimers());
+afterEach(() => jest.useRealTimers());
+
+describe("makeBatcher", () => {
+  it("coalesces one tick of calls into a single request and fans the results out", async () => {
+    const request = jest.fn(async (inputs: number[], prefix: string) =>
+      inputs.map(i => `${prefix}${i}`),
+    );
+    const batcher = makeBatcher(request, "x");
+
+    const batch = Promise.all([batcher(1), batcher(2)]);
+    expect(request).not.toHaveBeenCalled();
+    await jest.advanceTimersByTimeAsync(0);
+    await expect(batch).resolves.toEqual(["x1", "x2"]);
+
+    const next = batcher(3);
+    await jest.advanceTimersByTimeAsync(0);
+    await expect(next).resolves.toBe("x3");
+    expect(request.mock.calls).toEqual([
+      [[1, 2], "x"],
+      [[3], "x"],
+    ]);
+  });
+
+  it("rejects every waiter of a failed batch", async () => {
+    const error = new Error("down");
+    const batcher = makeBatcher<number, null, number>(() => Promise.reject(error), null);
+
+    const settled = Promise.all([batcher(1), batcher(2)].map(p => p.catch(e => e)));
+    await jest.advanceTimersByTimeAsync(0);
+
+    await expect(settled).resolves.toEqual([error, error]);
+  });
+});

package/src/cache.test.ts

@@ -0,0 +1,67 @@
+import { hours, makeLRUCache, minutes, seconds } from "./cache";
+
+it("builds ttl options", () => {
+  expect([seconds(30), seconds(1, 5), minutes(2), hours(2), hours(1, 3)]).toEqual([
+    { max: 100, ttl: 30_000 },
+    { max: 5, ttl: 1_000 },
+    { max: 100, ttl: 120_000 },
+    { max: 100, ttl: 7_200_000 },
+    { max: 3, ttl: 3_600_000 },
+  ]);
+});
+
+describe("makeLRUCache", () => {
+  let calls = 0;
+  const f = jest.fn(async (k: string) => `${k}${++calls}`);
+
+  beforeEach(() => {
+    calls = 0;
+    f.mockClear();
+  });
+
+  it("memoizes per extracted key and invalidates on demand", async () => {
+    const cached = makeLRUCache(f, k => k);
+
+    await expect(cached("a")).resolves.toBe("a1");
+    await expect(cached("a")).resolves.toBe("a1");
+    await expect(cached("b")).resolves.toBe("b2");
+    await expect(cached.force("a")).resolves.toBe("a3");
+    await expect(cached("a")).resolves.toBe("a3");
+
+    cached.hydrate("a", "hydrated");
+    await expect(cached("a")).resolves.toBe("hydrated");
+
+    cached.clear("a");
+    await expect(cached("a")).resolves.toBe("a4");
+    await expect(cached("b")).resolves.toBe("b2");
+
+    cached.reset();
+    await expect(cached("b")).resolves.toBe("b5");
+    expect(f).toHaveBeenCalledTimes(5);
+  });
+
+  it("collapses concurrent calls onto one promise, and uses one key without an extractor", () => {
+    const cached = makeLRUCache(f);
+
+    expect(cached("a")).toBe(cached("b"));
+    expect(f).toHaveBeenCalledTimes(1);
+  });
+
+  it.each([false, true])("does not memoize a rejection (force: %s)", async force => {
+    const rejectingOnce = jest.fn<Promise<string>, [string]>();
+    rejectingOnce.mockRejectedValueOnce(new Error("boom")).mockResolvedValue("ok");
+    const cached = makeLRUCache(rejectingOnce, k => k);
+
+    await expect(force ? cached.force("a") : cached("a")).rejects.toThrow("boom");
+    await expect(cached("a")).resolves.toBe("ok");
+  });
+
+  it("defaults to ttlAutopurge when no max is given", async () => {
+    const cached = makeLRUCache(f, k => k, { ttl: 20 });
+
+    await expect(cached("a")).resolves.toBe("a1");
+    await expect(cached("a")).resolves.toBe("a1");
+    await new Promise(resolve => setTimeout(resolve, 40));
+    await expect(cached("a")).resolves.toBe("a2");
+  });
+});

package/src/errors.test.ts

@@ -13,7 +13,7 @@ describe("live-network error classes", () => {
     });
     it("assigns extra fields", () => {
       const e = new LedgerAPI4xx("err", { status: 404 });
-      expect((e as Record<string, unknown>).status).toBe(404);
+      expect(e).toHaveProperty("status", 404);
     });
   });
 
@@ -29,7 +29,7 @@ describe("live-network error classes", () => {
     });
     it("assigns extra fields", () => {
       const e = new LedgerAPI5xx("err", { status: 503 });
-      expect((e as Record<string, unknown>).status).toBe(503);
+      expect(e).toHaveProperty("status", 503);
     });
   });
 
@@ -43,5 +43,9 @@ describe("live-network error classes", () => {
     it("accepts a custom message", () => {
       expect(new NetworkDown("timeout").message).toBe("timeout");
     });
+    it("assigns extra fields", () => {
+      const e = new NetworkDown("down", { url: "/v1/thing" });
+      expect(e).toHaveProperty("url", "/v1/thing");
+    });
   });
 });

package/src/index.test.ts

@@ -0,0 +1,20 @@
+import network, {
+  getNetworkState,
+  LedgerAPI4xx,
+  LedgerAPI5xx,
+  NetworkDown,
+  setNetworkState,
+} from "./index";
+import { newImplementation } from "./network";
+
+jest.mock("axios");
+
+it("re-exports the public API", () => {
+  expect(network).toBe(newImplementation);
+  expect([getNetworkState(), setNetworkState({})]).toEqual([expect.any(Object), undefined]);
+  expect([LedgerAPI4xx, LedgerAPI5xx, NetworkDown].map(E => new E().name)).toEqual([
+    "LedgerAPI4xx",
+    "LedgerAPI5xx",
+    "NetworkDown",
+  ]);
+});

package/src/network.test.ts

@@ -1,6 +1,14 @@
 import axios, { AxiosHeaders } from "axios";
 import { getNetworkState } from "./state";
-import network, { requestInterceptor, responseInterceptor, setNetworkState } from "./network";
+import network, {
+  errorInterceptor,
+  newImplementation,
+  requestInterceptor,
+  responseInterceptor,
+  setNetworkState,
+} from "./network";
+import type { LiveNetworkRequest } from "./network";
+import { LedgerAPI4xx, LedgerAPI5xx } from "./errors";
 import * as logs from "@ledgerhq/logs";
 
 jest.mock("axios");
@@ -192,3 +200,177 @@ describe("network", () => {
     });
   });
 });
+
+type InterceptedError = Parameters<typeof errorInterceptor>[0];
+
+const PRISTINE = { ...getNetworkState() };
+
+const asError = (props: Partial<InterceptedError> = {}): InterceptedError =>
+  Object.assign(
+    new Error("failed"),
+    { isAxiosError: true, toJSON: () => ({}), cause: undefined },
+    props,
+  );
+
+const failing = (
+  status: number,
+  data: unknown,
+  config: { baseURL?: string; method?: string; metadata?: { startTime: number } } = {},
+): InterceptedError =>
+  asError({
+    response: {
+      status,
+      statusText: "",
+      data,
+      headers: {},
+      config: { url: "/u", method: "get", headers: new AxiosHeaders(), ...config },
+    },
+  });
+
+const settle = async (promise: Promise<unknown>): Promise<unknown> => {
+  const settled = promise.catch(e => e);
+  await jest.runAllTimersAsync();
+  return settled;
+};
+
+describe("interceptors", () => {
+  afterEach(() => {
+    jest.clearAllMocks();
+    setNetworkState(PRISTINE);
+  });
+
+  it("rethrows an error carrying no response config", () => {
+    const error = asError();
+    expect(() => errorInterceptor(error)).toThrow(error);
+  });
+
+  it.each<[number, jest.Constructable]>([
+    [404, LedgerAPI4xx],
+    [500, LedgerAPI5xx],
+    [0, LedgerAPI5xx],
+  ])("maps status %i to the matching typed error", (status, Expected) => {
+    expect(() => errorInterceptor(failing(status, { message: "m" }))).toThrow(Expected);
+  });
+
+  it.each<[unknown, string]>([
+    [{ message: "m" }, "m"],
+    [{ error_message: "em" }, "em"],
+    [{ error: "e" }, "e"],
+    [{ msg: "s" }, "s"],
+    [{ errors: [{ message: "nested" }] }, "nested"],
+    [{ errors: ["plain"] }, "plain"],
+    [{ errors: [] }, "API HTTP 400 /u"],
+    [null, "API HTTP 400 /u"],
+    [{ unknown: 1 }, "API HTTP 400 /u"],
+    [JSON.stringify({ message: JSON.stringify({ message: "deep" }) }), "deep"],
+    [
+      JSON.stringify({ message: `JsDefined(${JSON.stringify({ message: "wrapped" })})` }),
+      "wrapped",
+    ],
+    [JSON.stringify({ message: JSON.stringify({ message: { message: "twice" } }) }), "twice"],
+    [JSON.stringify([{ message: JSON.stringify({ message: "first" }) }]), "first"],
+    [JSON.stringify({ message: '{"code":1}' }), '{"code":1}'],
+    [JSON.stringify({ message: { notAString: true } }), "API HTTP 400 /u"],
+    [JSON.stringify({ message: JSON.stringify({ message: "" }) }), "API HTTP 400 /u"],
+    ["<html>not json</html>", "API HTTP 400 /u"],
+  ])("derives the message of %j", (data, message) => {
+    expect(() => errorInterceptor(failing(400, data))).toThrow(message);
+  });
+
+  it("logs the failure, including the body only when debugHttpResponse is on", () => {
+    const spy = jest.spyOn(logs, "log");
+    const data = { message: "boom" };
+    const throwing = () =>
+      errorInterceptor(
+        failing(500, data, {
+          baseURL: "https://api",
+          method: undefined,
+          metadata: { startTime: Date.now() - 1234 },
+        }),
+      );
+
+    expect(throwing).toThrow("boom");
+    expect(spy).toHaveBeenLastCalledWith(
+      "network-error",
+      expect.stringMatching(/^500 {2}https:\/\/api\/u \(1[0-9]{3}ms\): boom$/),
+      {},
+    );
+
+    setNetworkState({ debugHttpResponse: true });
+    expect(throwing).toThrow("boom");
+    expect(spy).toHaveBeenLastCalledWith("network-error", expect.any(String), { data });
+  });
+
+  it("logs a request and its response without a baseURL", () => {
+    const spy = jest.spyOn(logs, "log");
+    setNetworkState({ enableNetworkLogs: true });
+    const config = { url: "/u", headers: new AxiosHeaders() };
+
+    requestInterceptor(config);
+    responseInterceptor({ config, data: "d", status: 200, statusText: "", headers: {} });
+
+    expect(spy.mock.calls.map(call => call[1])).toEqual([
+      " /u",
+      expect.stringMatching(/^200 undefined \/u \(\d+ms\)$/),
+    ]);
+  });
+
+  it("never sets a User-Agent header outside of node", () => {
+    Object.defineProperty(globalThis, "window", { value: {}, configurable: true });
+
+    setNetworkState({ ledgerClientVersion: "web/1" });
+    expect(axios.defaults.headers.common).toMatchObject({ "X-Ledger-Client-Version": "web/1" });
+    expect(axios.defaults.headers.common["User-Agent"]).toBeUndefined();
+
+    setNetworkState({ ledgerClientVersion: "" });
+    expect(axios.defaults.headers.common["X-Ledger-Client-Version"]).toBeUndefined();
+
+    Object.defineProperty(globalThis, "window", { value: undefined, configurable: true });
+  });
+});
+
+describe("request implementations", () => {
+  beforeEach(() => jest.useFakeTimers());
+
+  afterEach(() => {
+    jest.useRealTimers();
+    jest.clearAllMocks();
+    setNetworkState(PRISTINE);
+  });
+
+  it("defaults to GET with the configured timeout and returns the response essentials", async () => {
+    setNetworkState({ getCallsTimeout: 42 });
+    const headers = new AxiosHeaders();
+    mockedAxios.mockResolvedValue({ data: "d", status: 200, headers });
+
+    await expect(newImplementation({ url: "/u" })).resolves.toEqual({
+      data: "d",
+      status: 200,
+      headers,
+    });
+    expect(mockedAxios).toHaveBeenCalledWith({ url: "/u", method: "GET", timeout: 42 });
+  });
+
+  it.each<[LiveNetworkRequest<never>, unknown, number]>([
+    [{ method: "POST" }, new Error("x"), 1],
+    [{ method: "GET", timeout: 1 }, { status: 404 }, 1],
+    [{ method: "GET", timeout: 1 }, { status: 503 }, 3],
+    [{ method: "GET", timeout: 1 }, new Error("x"), 3],
+  ])("issues %j on %j exactly %i time(s)", async (request, error, calls) => {
+    mockedAxios.mockRejectedValue(error);
+
+    await expect(settle(newImplementation({ url: "/u", ...request }))).resolves.toBe(error);
+    expect(mockedAxios).toHaveBeenCalledTimes(calls);
+  });
+
+  it.each<["GET" | "POST", number]>([
+    ["POST", 1],
+    ["GET", 3],
+  ])("retries a status-less %s through the deprecated export %i time(s)", async (method, calls) => {
+    const error = new Error("x");
+    mockedAxios.mockRejectedValue(error);
+
+    await expect(settle(network({ url: "/u", method, timeout: 1 }))).resolves.toBe(error);
+    expect(mockedAxios).toHaveBeenCalledTimes(calls);
+  });
+});

package/src/state.ts

@@ -7,9 +7,7 @@ type NetworkState = {
 };
 
 declare global {
-  interface GlobalThis {
-    __ledgerLiveNetworkState?: NetworkState;
-  }
+  var __ledgerLiveNetworkState: NetworkState | undefined;
 }
 
 const defaults: NetworkState = {

package/.unimportedrc.json

@@ -1,14 +0,0 @@
-{
-  "entry": [
-    "src/batcher/index.ts",
-    "src/batcher/types.ts",
-    "src/cache.ts",
-    "src/index.ts",
-    "src/network.ts"
-  ],
-  "ignoreUnimported": [],
-  "ignoreUnresolved": [
-    "@jest/expect-utils",
-    "@jest/get-type",
-    "jest-util"]
-}

package/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License
-
-Copyright (c) 2017-present Ledger https://www.ledger.com/
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/jest.config.js

@@ -1,20 +0,0 @@
-module.exports = {
-  testEnvironment: "node",
-  transform: {
-    "^.+\\.(t|j)sx?$": [
-      "@swc/jest",
-      {
-        jsc: {
-          target: "esnext",
-        },
-      },
-    ],
-  },
-  testPathIgnorePatterns: ["lib/", "lib-es/"],
-  coverageReporters: ["json", ["lcov", { file: "lcov.info", projectRoot: "../../" }], "text"],
-  reporters: [
-    "default",
-    ...(process.env.CI ? ["github-actions"] : []),
-    ["jest-sonar", { outputName: "sonar-executionTests-report.xml", reportedFilePath: "absolute" }],
-  ],
-};