@prosopo/load-balancer 2.8.13 → 2.9.10

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/load-balancer",
-	"version": "2.8.13",
+	"version": "2.9.10",
 	"description": "Provider load balancer",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -18,7 +18,8 @@
 	},
 	"scripts": {
 		"clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
-		"build": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.esm.config.ts --mode $NODE_ENV",
+		"build": "npm run build:cross-env -- --mode ${NODE_ENV:-development}",
+		"build:cross-env": "vite build --config vite.esm.config.ts",
 		"build:tsc": "tsc --build --verbose",
 		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
 		"test": "NODE_ENV=${NODE_ENV:-test}; npx vitest run --config ./vite.test.config.ts --mode $NODE_ENV",
@@ -26,7 +27,8 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git+ssh://git@github.com/prosopo/captcha.git"
+		"url": "git+https://github.com/prosopo/captcha.git",
+		"directory": "packages/load-balancer"
 	},
 	"author": "Prosopo Limited",
 	"license": "Apache-2.0",
@@ -35,12 +37,12 @@
 	},
 	"homepage": "https://github.com/prosopo/captcha#readme",
 	"dependencies": {
-		"@prosopo/common": "3.1.26",
-		"@prosopo/types": "3.6.4",
+		"@prosopo/common": "3.1.38",
+		"@prosopo/types": "4.3.0",
 		"zod": "3.23.8"
 	},
 	"devDependencies": {
-		"@prosopo/config": "3.1.26",
+		"@prosopo/config": "3.3.1",
 		"@types/node": "22.10.2",
 		"@vitest/coverage-v8": "3.2.4",
 		"concurrently": "9.0.1",

package/src/balancer.ts

@@ -0,0 +1,81 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { ProsopoEnvError } from "@prosopo/common";
+import type { EnvironmentTypes } from "@prosopo/types";
+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) => {
+			// weight coerced to int 1-100
+			const weight = Math.round(val);
+			return Math.max(1, Math.min(100, weight));
+		}),
+});
+
+export type HardcodedProvider = z.infer<typeof HardcodedProviderSchema>;
+
+type hostedProviders = Record<string, unknown>;
+
+export const convertHostedProvider = (
+	provider: hostedProviders,
+): HardcodedProvider[] => {
+	const providers = Object.values(provider).map((p) =>
+		HardcodedProviderSchema.parse(p),
+	);
+	return providers.sort((a, b) => a.url.localeCompare(b.url));
+};
+
+export const getLoadBalancerUrl = (environment: EnvironmentTypes): string => {
+	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 },
+	});
+};
+
+export const loadBalancer = async (
+	environment: EnvironmentTypes,
+): Promise<HardcodedProvider[]> => {
+	if (environment === "development") {
+		return [
+			{
+				address: "5EjTA28bKSbFPPyMbUjNtArxyqjwq38r1BapVmLZShaqEedV",
+				url: "https://localhost:9229",
+				datasetId:
+					"0x7984714b92d61fd92fd6a7bc9b56b729481470bcc771c19c382ec679acf02e67",
+				weight: 1,
+			},
+		];
+	}
+
+	const providers: hostedProviders = await fetch(
+		getLoadBalancerUrl(environment),
+		{
+			method: "GET",
+			mode: "cors",
+		},
+	).then((res) => res.json());
+	return convertHostedProvider(providers);
+};

package/src/index.ts

@@ -0,0 +1,15 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export * from "./providers.js";
+export * from "./balancer.js";

package/src/providers.ts

@@ -0,0 +1,131 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import type { EnvironmentTypes, RandomProvider } from "@prosopo/types";
+import { type HardcodedProvider, loadBalancer } from "./index.js";
+
+// Keyed by env so a prefetch and a later call with a different env don't share.
+const providerPromiseCache: Map<
+	EnvironmentTypes,
+	Promise<HardcodedProvider[]>
+> = new Map();
+
+/** Optional custom loader for server-side caching (e.g. cacheFile with ETag). */
+let customProviderLoader:
+	| ((env: EnvironmentTypes) => Promise<HardcodedProvider[]>)
+	| null = null;
+
+/**
+ * Set a custom provider loader that replaces the default HTTP fetch.
+ * Use this on the server side to inject cacheFile-based loading with
+ * ETag/Last-Modified support for disk persistence across restarts.
+ */
+export function setProviderLoader(
+	loader: (env: EnvironmentTypes) => Promise<HardcodedProvider[]>,
+): void {
+	customProviderLoader = loader;
+}
+
+export function _resetCache() {
+	providerPromiseCache.clear();
+}
+
+/**
+ * Selects a weighted random provider using the entropy value.
+ * Providers with higher weights are more likely to be selected.
+ *
+ * @param providers - Array of providers with weights
+ * @param entropy - Random seed value for deterministic selection
+ * @returns Selected provider
+ */
+export function selectWeightedProvider(
+	providers: HardcodedProvider[],
+	entropy: number,
+): HardcodedProvider {
+	if (providers.length === 0) {
+		throw new Error("No providers available");
+	}
+
+	const totalWeight = providers.reduce((sum, p) => sum + p.weight, 0);
+
+	// Use entropy to generate a value between 0 and totalWeight-1
+	const randomValue = entropy % totalWeight;
+
+	// Select provider based on cumulative weight
+	let cumulativeWeight = 0;
+	for (const provider of providers) {
+		cumulativeWeight += provider.weight;
+		if (randomValue < cumulativeWeight) {
+			return provider;
+		}
+	}
+
+	// Fallback (should never reach here)
+	const selectedProvider = providers[providers.length - 1];
+	if (!selectedProvider) {
+		throw new Error("No providers available");
+	}
+	return selectedProvider;
+}
+
+/** Load providers using the custom loader if set, otherwise the default fetch. */
+const loadProviders = async (
+	env: EnvironmentTypes,
+): Promise<HardcodedProvider[]> => {
+	if (customProviderLoader) {
+		return customProviderLoader(env);
+	}
+	return loadBalancer(env);
+};
+
+// Caches the in-flight Promise (not the resolved array) so concurrent callers
+// share a single network request rather than racing.
+const getProvidersPromise = (
+	env: EnvironmentTypes,
+): Promise<HardcodedProvider[]> => {
+	const existing = providerPromiseCache.get(env);
+	if (existing) return existing;
+	const promise = loadProviders(env).catch((err) => {
+		providerPromiseCache.delete(env);
+		throw err;
+	});
+	providerPromiseCache.set(env, promise);
+	return promise;
+};
+
+/**
+ * Pre-warms the provider cache for a given environment without requiring entropy.
+ * Call this as early as possible to avoid a cold-cache delay when getRandomActiveProvider is first used.
+ */
+export const prefetchProviders = async (
+	env: EnvironmentTypes,
+): Promise<void> => {
+	await getProvidersPromise(env);
+};
+
+export const getRandomActiveProvider = async (
+	env: EnvironmentTypes,
+	entropy: number,
+): Promise<RandomProvider> => {
+	const providers = await getProvidersPromise(env);
+	const randomProviderObj = selectWeightedProvider(providers, entropy);
+
+	return {
+		providerAccount: randomProviderObj.address,
+		provider: {
+			url: randomProviderObj.url,
+			datasetId: randomProviderObj.datasetId,
+		},
+	};
+};