@prosopo/load-balancer 2.6.17 → 2.8.8

package/dist/balancer.js

@@ -0,0 +1,53 @@
+import { ProsopoEnvError } from "@prosopo/common";
+import { z } from "zod";
+const HardcodedProviderSchema = z.object({
+  address: z.string(),
+  url: z.string(),
+  datasetId: z.string(),
+  weight: z.number().optional().default(1).transform((val) => {
+    const weight = Math.round(val);
+    return Math.max(1, Math.min(100, weight));
+  })
+});
+const convertHostedProvider = (provider) => {
+  const providers = Object.values(provider).map(
+    (p) => HardcodedProviderSchema.parse(p)
+  );
+  return providers.sort((a, b) => a.url.localeCompare(b.url));
+};
+const getLoadBalancerUrl = (environment) => {
+  if (environment === "production") {
+    return "https://provider-list.prosopo.io/";
+  }
+  if (environment === "staging") {
+    return "https://provider-list.prosopo.io/staging.json";
+  }
+  throw new ProsopoEnvError("CONFIG.UNKNOWN_ENVIRONMENT", {
+    context: { environment }
+  });
+};
+const loadBalancer = async (environment) => {
+  if (environment === "development") {
+    return [
+      {
+        address: "5EjTA28bKSbFPPyMbUjNtArxyqjwq38r1BapVmLZShaqEedV",
+        url: "http://localhost:9229",
+        datasetId: "0x9f460e81ac9c71b486f796a21bb36e2263694756a6621134d110da217fd3ef25",
+        weight: 1
+      }
+    ];
+  }
+  const providers = await fetch(
+    getLoadBalancerUrl(environment),
+    {
+      method: "GET",
+      mode: "cors"
+    }
+  ).then((res) => res.json());
+  return convertHostedProvider(providers);
+};
+export {
+  convertHostedProvider,
+  getLoadBalancerUrl,
+  loadBalancer
+};

package/dist/balancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balancer.js","sourceRoot":"","sources":["../src/balancer.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;QAElB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC;CACH,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,QAAyB,EACH,EAAE;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACnD,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,CAChC,CAAC;IACF,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,WAA6B,EAAU,EAAE;IAC3E,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,mCAAmC,CAAC;IAC5C,CAAC;IACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,+CAA+C,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,eAAe,CAAC,4BAA4B,EAAE;QACvD,OAAO,EAAE,EAAE,WAAW,EAAE;KACxB,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAChC,WAA6B,EACE,EAAE;IACjC,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO;YACN;gBACC,OAAO,EAAE,kDAAkD;gBAC3D,GAAG,EAAE,uBAAuB;gBAC5B,SAAS,EACR,oEAAoE;gBACrE,MAAM,EAAE,CAAC;aACT;SACD,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAoB,MAAM,KAAK,CAC7C,kBAAkB,CAAC,WAAW,CAAC,EAC/B;QACC,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,MAAM;KACZ,CACD,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/dist/cjs/balancer.cjs

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const common = require("@prosopo/common");
+const zod = require("zod");
+const HardcodedProviderSchema = zod.z.object({
+  address: zod.z.string(),
+  url: zod.z.string(),
+  datasetId: zod.z.string(),
+  weight: zod.z.number().optional().default(1).transform((val) => {
+    const weight = Math.round(val);
+    return Math.max(1, Math.min(100, weight));
+  })
+});
+const convertHostedProvider = (provider) => {
+  const providers = Object.values(provider).map(
+    (p) => HardcodedProviderSchema.parse(p)
+  );
+  return providers.sort((a, b) => a.url.localeCompare(b.url));
+};
+const getLoadBalancerUrl = (environment) => {
+  if (environment === "production") {
+    return "https://provider-list.prosopo.io/";
+  }
+  if (environment === "staging") {
+    return "https://provider-list.prosopo.io/staging.json";
+  }
+  throw new common.ProsopoEnvError("CONFIG.UNKNOWN_ENVIRONMENT", {
+    context: { environment }
+  });
+};
+const loadBalancer = async (environment) => {
+  if (environment === "development") {
+    return [
+      {
+        address: "5EjTA28bKSbFPPyMbUjNtArxyqjwq38r1BapVmLZShaqEedV",
+        url: "http://localhost:9229",
+        datasetId: "0x9f460e81ac9c71b486f796a21bb36e2263694756a6621134d110da217fd3ef25",
+        weight: 1
+      }
+    ];
+  }
+  const providers = await fetch(
+    getLoadBalancerUrl(environment),
+    {
+      method: "GET",
+      mode: "cors"
+    }
+  ).then((res) => res.json());
+  return convertHostedProvider(providers);
+};
+exports.convertHostedProvider = convertHostedProvider;
+exports.getLoadBalancerUrl = getLoadBalancerUrl;
+exports.loadBalancer = loadBalancer;

package/dist/cjs/index.cjs

@@ -1,38 +1,10 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const common = require("@prosopo/common");
-const convertHostedProvider = (provider) => {
-  return Object.values(provider);
-};
-const loadBalancer = async (environment) => {
-  if (environment === "production") {
-    const providers = await fetch(
-      "https://provider-list.prosopo.io/",
-      {
-        method: "GET",
-        mode: "cors"
-      }
-    ).then((res) => res.json());
-    return convertHostedProvider(providers);
-  }
-  if (environment === "staging") {
-    const providers = await fetch(
-      "https://provider-list.prosopo.io/staging.json",
-      { method: "GET", mode: "cors" }
-    ).then((res) => res.json());
-    return convertHostedProvider(providers);
-  }
-  if (environment === "development") {
-    return [
-      {
-        address: "5EjTA28bKSbFPPyMbUjNtArxyqjwq38r1BapVmLZShaqEedV",
-        url: "http://localhost:9229",
-        datasetId: "0x9f460e81ac9c71b486f796a21bb36e2263694756a6621134d110da217fd3ef25"
-      }
-    ];
-  }
-  throw new common.ProsopoEnvError("CONFIG.UNKNOWN_ENVIRONMENT", {
-    context: { environment }
-  });
-};
-exports.loadBalancer = loadBalancer;
+const providers = require("./providers.cjs");
+const balancer = require("./balancer.cjs");
+exports._resetCache = providers._resetCache;
+exports.getRandomActiveProvider = providers.getRandomActiveProvider;
+exports.selectWeightedProvider = providers.selectWeightedProvider;
+exports.convertHostedProvider = balancer.convertHostedProvider;
+exports.getLoadBalancerUrl = balancer.getLoadBalancerUrl;
+exports.loadBalancer = balancer.loadBalancer;

package/dist/cjs/providers.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./index.cjs");
+const balancer = require("./balancer.cjs");
+let cachedProviders = [];
+function _resetCache() {
+  cachedProviders = [];
+}
+function selectWeightedProvider(providers, entropy) {
+  if (providers.length === 0) {
+    throw new Error("No providers available");
+  }
+  const totalWeight = providers.reduce((sum, p) => sum + p.weight, 0);
+  const randomValue = entropy % totalWeight;
+  let cumulativeWeight = 0;
+  for (const provider of providers) {
+    cumulativeWeight += provider.weight;
+    if (randomValue < cumulativeWeight) {
+      return provider;
+    }
+  }
+  const selectedProvider = providers[providers.length - 1];
+  if (!selectedProvider) {
+    throw new Error("No providers available");
+  }
+  return selectedProvider;
+}
+const getRandomActiveProvider = async (env, entropy) => {
+  if (cachedProviders.length === 0) {
+    cachedProviders = await balancer.loadBalancer(env);
+  }
+  const randomProviderObj = selectWeightedProvider(cachedProviders, entropy);
+  return {
+    providerAccount: randomProviderObj.address,
+    provider: {
+      url: randomProviderObj.url,
+      datasetId: randomProviderObj.datasetId
+    }
+  };
+};
+exports._resetCache = _resetCache;
+exports.getRandomActiveProvider = getRandomActiveProvider;
+exports.selectWeightedProvider = selectWeightedProvider;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./providers.js";
+export * from "./balancer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,38 +1,10 @@
-import { ProsopoEnvError } from "@prosopo/common";
-const convertHostedProvider = (provider) => {
-  return Object.values(provider);
-};
-const loadBalancer = async (environment) => {
-  if (environment === "production") {
-    const providers = await fetch(
-      "https://provider-list.prosopo.io/",
-      {
-        method: "GET",
-        mode: "cors"
-      }
-    ).then((res) => res.json());
-    return convertHostedProvider(providers);
-  }
-  if (environment === "staging") {
-    const providers = await fetch(
-      "https://provider-list.prosopo.io/staging.json",
-      { method: "GET", mode: "cors" }
-    ).then((res) => res.json());
-    return convertHostedProvider(providers);
-  }
-  if (environment === "development") {
-    return [
-      {
-        address: "5EjTA28bKSbFPPyMbUjNtArxyqjwq38r1BapVmLZShaqEedV",
-        url: "http://localhost:9229",
-        datasetId: "0x9f460e81ac9c71b486f796a21bb36e2263694756a6621134d110da217fd3ef25"
-      }
-    ];
-  }
-  throw new ProsopoEnvError("CONFIG.UNKNOWN_ENVIRONMENT", {
-    context: { environment }
-  });
-};
+import { _resetCache, getRandomActiveProvider, selectWeightedProvider } from "./providers.js";
+import { convertHostedProvider, getLoadBalancerUrl, loadBalancer } from "./balancer.js";
 export {
-  loadBalancer
+  _resetCache,
+  convertHostedProvider,
+  getLoadBalancerUrl,
+  getRandomActiveProvider,
+  loadBalancer,
+  selectWeightedProvider
 };

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,6 @@
+import type { EnvironmentTypes, RandomProvider } from "@prosopo/types";
+import { type HardcodedProvider } from "./index.js";
+export declare function _resetCache(): void;
+export declare function selectWeightedProvider(providers: HardcodedProvider[], entropy: number): HardcodedProvider;
+export declare const getRandomActiveProvider: (env: EnvironmentTypes, entropy: number) => Promise<RandomProvider>;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,KAAK,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAIlE,wBAAgB,WAAW,SAE1B;AAUD,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,OAAO,EAAE,MAAM,GACb,iBAAiB,CAyBnB;AAED,eAAO,MAAM,uBAAuB,QAC9B,gBAAgB,WACZ,MAAM,KACb,OAAO,CAAC,cAAc,CAexB,CAAC"}

package/dist/providers.js

@@ -0,0 +1,43 @@
+import "./index.js";
+import { loadBalancer } from "./balancer.js";
+let cachedProviders = [];
+function _resetCache() {
+  cachedProviders = [];
+}
+function selectWeightedProvider(providers, entropy) {
+  if (providers.length === 0) {
+    throw new Error("No providers available");
+  }
+  const totalWeight = providers.reduce((sum, p) => sum + p.weight, 0);
+  const randomValue = entropy % totalWeight;
+  let cumulativeWeight = 0;
+  for (const provider of providers) {
+    cumulativeWeight += provider.weight;
+    if (randomValue < cumulativeWeight) {
+      return provider;
+    }
+  }
+  const selectedProvider = providers[providers.length - 1];
+  if (!selectedProvider) {
+    throw new Error("No providers available");
+  }
+  return selectedProvider;
+}
+const getRandomActiveProvider = async (env, entropy) => {
+  if (cachedProviders.length === 0) {
+    cachedProviders = await loadBalancer(env);
+  }
+  const randomProviderObj = selectWeightedProvider(cachedProviders, entropy);
+  return {
+    providerAccount: randomProviderObj.address,
+    provider: {
+      url: randomProviderObj.url,
+      datasetId: randomProviderObj.datasetId
+    }
+  };
+};
+export {
+  _resetCache,
+  getRandomActiveProvider,
+  selectWeightedProvider
+};

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAeA,OAAO,EAA0B,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE,IAAI,eAAe,GAAwB,EAAE,CAAC;AAE9C,MAAM,UAAU,WAAW;IAC1B,eAAe,GAAG,EAAE,CAAC;AACtB,CAAC;AAUD,MAAM,UAAU,sBAAsB,CACrC,SAA8B,EAC9B,OAAe;IAEf,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAGpE,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IAG1C,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,gBAAgB,IAAI,QAAQ,CAAC,MAAM,CAAC;QACpC,IAAI,WAAW,GAAG,gBAAgB,EAAE,CAAC;YACpC,OAAO,QAAQ,CAAC;QACjB,CAAC;IACF,CAAC;IAGD,MAAM,gBAAgB,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC3C,GAAqB,EACrB,OAAe,EACW,EAAE;IAC5B,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAElC,eAAe,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAE3E,OAAO;QACN,eAAe,EAAE,iBAAiB,CAAC,OAAO;QAC1C,QAAQ,EAAE;YACT,GAAG,EAAE,iBAAiB,CAAC,GAAG;YAC1B,SAAS,EAAE,iBAAiB,CAAC,SAAS;SACtC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/tests/providers.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=providers.unit.test.d.ts.map

package/dist/tests/providers.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.unit.test.d.ts","sourceRoot":"","sources":["../../src/tests/providers.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/providers.unit.test.js

@@ -0,0 +1,224 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { loadBalancer } from "../index.js";
+import { getRandomActiveProvider, selectWeightedProvider, } from "../providers.js";
+import { _resetCache } from "../providers.js";
+vi.mock("../index.js", () => ({
+    loadBalancer: vi.fn(),
+}));
+describe("selectWeightedProvider", () => {
+    it("selects provider based on weight distribution", () => {
+        const providers = [
+            {
+                address: "address1",
+                url: "url1",
+                datasetId: "dataset1",
+                weight: 1,
+            },
+            {
+                address: "address2",
+                url: "url2",
+                datasetId: "dataset2",
+                weight: 3,
+            },
+            {
+                address: "address3",
+                url: "url3",
+                datasetId: "dataset3",
+                weight: 1,
+            },
+        ];
+        expect(selectWeightedProvider(providers, 0).address).toBe("address1");
+        expect(selectWeightedProvider(providers, 1).address).toBe("address2");
+        expect(selectWeightedProvider(providers, 2).address).toBe("address2");
+        expect(selectWeightedProvider(providers, 3).address).toBe("address2");
+        expect(selectWeightedProvider(providers, 4).address).toBe("address3");
+        expect(selectWeightedProvider(providers, 5).address).toBe("address1");
+        expect(selectWeightedProvider(providers, 6).address).toBe("address2");
+    });
+    it("handles equal weights correctly", () => {
+        const providers = [
+            {
+                address: "address1",
+                url: "url1",
+                datasetId: "dataset1",
+                weight: 1,
+            },
+            {
+                address: "address2",
+                url: "url2",
+                datasetId: "dataset2",
+                weight: 1,
+            },
+        ];
+        expect(selectWeightedProvider(providers, 0).address).toBe("address1");
+        expect(selectWeightedProvider(providers, 1).address).toBe("address2");
+        expect(selectWeightedProvider(providers, 2).address).toBe("address1");
+        expect(selectWeightedProvider(providers, 3).address).toBe("address2");
+    });
+    it("handles single provider", () => {
+        const providers = [
+            {
+                address: "address1",
+                url: "url1",
+                datasetId: "dataset1",
+                weight: 10,
+            },
+        ];
+        expect(selectWeightedProvider(providers, 0).address).toBe("address1");
+        expect(selectWeightedProvider(providers, 5).address).toBe("address1");
+        expect(selectWeightedProvider(providers, 100).address).toBe("address1");
+    });
+    it("throws error for empty provider list", () => {
+        expect(() => selectWeightedProvider([], 0)).toThrow("No providers available");
+    });
+    it("heavily weighted provider is selected more often", () => {
+        const providers = [
+            {
+                address: "address1",
+                url: "url1",
+                datasetId: "dataset1",
+                weight: 1,
+            },
+            {
+                address: "address2",
+                url: "url2",
+                datasetId: "dataset2",
+                weight: 99,
+            },
+        ];
+        const selections = { address1: 0, address2: 0 };
+        for (let i = 0; i < 100; i++) {
+            const selected = selectWeightedProvider(providers, i);
+            if (selected.address === "address1") {
+                selections.address1++;
+            }
+            else {
+                selections.address2++;
+            }
+        }
+        expect(selections.address1).toBe(1);
+        expect(selections.address2).toBe(99);
+    });
+    it("handles maximum weight value (100)", () => {
+        const providers = [
+            {
+                address: "address1",
+                url: "url1",
+                datasetId: "dataset1",
+                weight: 100,
+            },
+            {
+                address: "address2",
+                url: "url2",
+                datasetId: "dataset2",
+                weight: 100,
+            },
+        ];
+        const selections = { address1: 0, address2: 0 };
+        for (let i = 0; i < 200; i++) {
+            const selected = selectWeightedProvider(providers, i);
+            if (selected.address === "address1") {
+                selections.address1++;
+            }
+            else {
+                selections.address2++;
+            }
+        }
+        expect(selections.address1).toBe(100);
+        expect(selections.address2).toBe(100);
+    });
+    it("correctly handles providers without values for weight", () => {
+        const providers = [
+            {
+                address: "address1",
+                url: "url1",
+                datasetId: "dataset1",
+            },
+            {
+                address: "address2",
+                url: "url2",
+                datasetId: "dataset2",
+                weight: 3,
+            },
+        ];
+        const providersWithDefaults = [
+            { ...providers[0], weight: 1 },
+            providers[1],
+        ];
+        const selections = { address1: 0, address2: 0 };
+        for (let i = 0; i < 100; i++) {
+            const selected = selectWeightedProvider(providersWithDefaults, i);
+            if (selected.address === "address1") {
+                selections.address1++;
+            }
+            else {
+                selections.address2++;
+            }
+        }
+        expect(selections.address1).toBe(25);
+        expect(selections.address2).toBe(75);
+    });
+});
+describe("getRandomActiveProvider", () => {
+    beforeEach(() => {
+        _resetCache();
+        vi.clearAllMocks();
+        vi.resetAllMocks();
+        vi.resetModules();
+    });
+    it("returns a random provider when providers list is populated", async () => {
+        const mockProviders = [
+            { address: "address1", url: "url1", datasetId: "dataset1", weight: 1 },
+            { address: "address2", url: "url2", datasetId: "dataset2", weight: 1 },
+        ];
+        loadBalancer.mockResolvedValue(mockProviders);
+        const result = await getRandomActiveProvider("development", 1);
+        expect(result.providerAccount).toBe("address2");
+        expect(result.provider.url).toBe("url2");
+        expect(result.provider.datasetId).toBe("dataset2");
+    });
+    it("loads providers only once when called multiple times", async () => {
+        const mockProviders = [
+            { address: "address1", url: "url1", datasetId: "dataset1", weight: 1 },
+        ];
+        loadBalancer.mockResolvedValue(mockProviders);
+        await getRandomActiveProvider("development", 123);
+        await getRandomActiveProvider("development", 456);
+        expect(loadBalancer).toHaveBeenCalledTimes(1);
+    });
+    it("handles empty providers list gracefully", async () => {
+        loadBalancer.mockResolvedValue([]);
+        await expect(getRandomActiveProvider("development", 123)).rejects.toThrow();
+    });
+    it("respects provider weights when selecting", async () => {
+        const mockProviders = [
+            { address: "address1", url: "url1", datasetId: "dataset1", weight: 1 },
+            { address: "address2", url: "url2", datasetId: "dataset2", weight: 3 },
+        ];
+        loadBalancer.mockResolvedValue(mockProviders);
+        const result0 = await getRandomActiveProvider("development", 0);
+        expect(result0.providerAccount).toBe("address1");
+        _resetCache();
+        const result1 = await getRandomActiveProvider("development", 1);
+        expect(result1.providerAccount).toBe("address2");
+        _resetCache();
+        const result2 = await getRandomActiveProvider("development", 2);
+        expect(result2.providerAccount).toBe("address2");
+        _resetCache();
+        const result3 = await getRandomActiveProvider("development", 3);
+        expect(result3.providerAccount).toBe("address2");
+    });
+    it("handles providers with missing weight field (defaults to 1)", async () => {
+        const mockProviders = [
+            { address: "address1", url: "url1", datasetId: "dataset1", weight: 1 },
+            { address: "address2", url: "url2", datasetId: "dataset2", weight: 1 },
+        ];
+        loadBalancer.mockResolvedValue(mockProviders);
+        const result0 = await getRandomActiveProvider("development", 0);
+        expect(result0.providerAccount).toBe("address1");
+        _resetCache();
+        const result1 = await getRandomActiveProvider("development", 1);
+        expect(result1.providerAccount).toBe("address2");
+    });
+});
+//# sourceMappingURL=providers.unit.test.js.map

package/dist/tests/providers.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.unit.test.js","sourceRoot":"","sources":["../../src/tests/providers.unit.test.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAA0B,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACN,uBAAuB,EACvB,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;CACrB,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACxD,MAAM,SAAS,GAAG;YACjB;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;YACD;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;YACD;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;SACD,CAAC;QAQF,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAGtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAGtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAGtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC1C,MAAM,SAAS,GAAG;YACjB;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;YACD;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;SACD,CAAC;QAGF,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAClC,MAAM,SAAS,GAAG;YACjB;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,EAAE;aACV;SACD,CAAC;QAGF,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAClD,wBAAwB,CACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC3D,MAAM,SAAS,GAAG;YACjB;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;YACD;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,EAAE;aACV;SACD,CAAC;QAMF,MAAM,UAAU,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACtD,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACrC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACP,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;QACF,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC7C,MAAM,SAAS,GAAG;YACjB;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,GAAG;aACX;YACD;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,GAAG;aACX;SACD,CAAC;QAGF,MAAM,UAAU,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACtD,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACrC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACP,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;QACF,CAAC;QAGD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAEhE,MAAM,SAAS,GAAG;YACjB;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;aAErB;YACD;gBACC,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,MAAM;gBACX,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC;aACT;SACD,CAAC;QAIF,MAAM,qBAAqB,GAAG;YAC7B,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;YAC9B,SAAS,CAAC,CAAC,CAAC;SACZ,CAAC;QAMF,MAAM,UAAU,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,sBAAsB,CACtC,qBAA4C,EAC5C,CAAC,CACD,CAAC;YACF,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACrC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACP,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;QACF,CAAC;QAGD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACxC,UAAU,CAAC,GAAG,EAAE;QACf,WAAW,EAAE,CAAC;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,YAAY,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,aAAa,GAAG;YACrB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;YACtE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;SACtE,CAAC;QACD,YAAoD,CAAC,iBAAiB,CACtE,aAAa,CACb,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,aAAa,GAAG;YACrB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;SACtE,CAAC;QACD,YAAoD,CAAC,iBAAiB,CACtE,aAAa,CACb,CAAC;QAEF,MAAM,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAClD,MAAM,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAElD,MAAM,CAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,YAAoD,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAE5E,MAAM,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,aAAa,GAAG;YACrB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;YACtE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;SACtE,CAAC;QACD,YAAoD,CAAC,iBAAiB,CACtE,aAAa,CACb,CAAC;QAMF,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,WAAW,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,WAAW,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,WAAW,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAE5E,MAAM,aAAa,GAAG;YACrB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;YACtE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;SACtE,CAAC;QACD,YAAoD,CAAC,iBAAiB,CACtE,aAAa,CACb,CAAC;QAGF,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,WAAW,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
 	"name": "@prosopo/load-balancer",
-	"version": "2.6.17",
+	"version": "2.8.8",
 	"description": "Provider load balancer",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"type": "module",
 	"engines": {
-		"node": "20",
-		"npm": "10.8.2"
+		"node": ">=v20.0.0",
+		"npm": ">=10.6.0"
 	},
 	"exports": {
 		".": {
@@ -21,7 +21,8 @@
 		"build": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.esm.config.ts --mode $NODE_ENV",
 		"build:tsc": "tsc --build --verbose",
 		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
-		"typecheck": "tsc --build --declaration --emitDeclarationOnly"
+		"test": "NODE_ENV=${NODE_ENV:-test}; npx vitest run --config ./vite.test.config.ts --mode $NODE_ENV",
+		"typecheck": "tsc --project tsconfig.types.json"
 	},
 	"repository": {
 		"type": "git",
@@ -34,26 +35,23 @@
 	},
 	"homepage": "https://github.com/prosopo/captcha#readme",
 	"dependencies": {
-		"@prosopo/common": "3.1.2",
-		"@prosopo/config": "3.1.3",
-		"@prosopo/types": "3.0.6",
-		"@typegoose/auto-increment": "4.13.0",
-		"axios": "1.10.0",
-		"esbuild": "0.25.6",
-		"express": "4.21.2",
-		"openpgp": "5.11.3",
-		"webpack-dev-server": "5.2.2"
+		"@prosopo/common": "3.1.21",
+		"@prosopo/config": "3.1.21",
+		"@prosopo/types": "3.5.11",
+		"zod": "3.23.8"
 	},
 	"devDependencies": {
-		"@vitest/coverage-v8": "3.0.9",
+		"@types/node": "22.10.2",
+		"@vitest/coverage-v8": "3.2.4",
 		"concurrently": "9.0.1",
 		"del-cli": "6.0.0",
+		"dotenv": "17.2.1",
 		"npm-run-all": "4.1.5",
 		"tslib": "2.7.0",
 		"tsx": "4.20.3",
 		"typescript": "5.6.2",
-		"vite": "6.3.5",
-		"vitest": "3.0.9"
+		"vite": "6.4.1",
+		"vitest": "3.2.4"
 	},
 	"sideEffects": false
 }