@prosopo/load-balancer 2.10.42 → 2.10.44

package/src/providers.ts

@@ -18,6 +18,7 @@ import {
 	type IpMode,
 	loadBalancer,
 } from "./balancer.js";
+import { getDevelopmentProviderUrl } from "./developmentProviderUrl.js";
 import { retryWithBackoff } from "./retry.js";
 
 // Base DNS endpoint per env — the `pronode.prosopo.io` family is latency-routed
@@ -25,11 +26,13 @@ import { retryWithBackoff } from "./retry.js";
 // once to discover which specific pronodeN the DNS layer picked, then pin
 // subsequent captcha calls to that pronode so session creation and submission
 // land on the same backend.
-const DNS_ENDPOINT: Record<EnvironmentTypes, string> = {
-	development: "https://localhost:9229",
+// Resolved per call rather than once at module load, so a development override
+// set after this module is imported is still picked up.
+const dnsEndpoints = (): Record<EnvironmentTypes, string> => ({
+	development: getDevelopmentProviderUrl(),
 	staging: "https://staging.pronode.prosopo.io",
 	production: "https://pronode.prosopo.io",
-};
+});
 
 // Apply the `ipv4.` / `ipv6.` DNS label to a hostname. The single-stack
 // sub-zones only resolve to A or AAAA records respectively, so this pins the
@@ -93,8 +96,10 @@ const fetchPinnedHostWithRetry = (baseUrl: string): Promise<string> =>
 		maxDelayMs: healthzRetryMaxDelayMs,
 	});
 
-const resolveBaseUrl = (env: EnvironmentTypes): string =>
-	DNS_ENDPOINT[env] ?? DNS_ENDPOINT.development;
+const resolveBaseUrl = (env: EnvironmentTypes): string => {
+	const endpoints = dnsEndpoints();
+	return endpoints[env] ?? endpoints.development;
+};
 
 const resolvePinnedUrl = async (
 	env: EnvironmentTypes,

package/src/tests/developmentProviderUrl.unit.test.ts

@@ -0,0 +1,76 @@
+// 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 { afterEach, describe, expect, it } from "vitest";
+import {
+	DEFAULT_DEVELOPMENT_PROVIDER_URL,
+	getDevelopmentProviderUrl,
+	readDevelopmentProviderUrlOverride,
+} from "../developmentProviderUrl.js";
+
+const ENV_KEY = "PROSOPO_PROVIDER_URL_DEVELOPMENT";
+const original: string | undefined = process.env[ENV_KEY];
+
+afterEach(() => {
+	if (original === undefined) delete process.env[ENV_KEY];
+	else process.env[ENV_KEY] = original;
+});
+
+describe("the development provider url", () => {
+	it("is localhost when nothing overrides it", () => {
+		expect(getDevelopmentProviderUrl(undefined)).toBe("https://localhost:9229");
+		expect(DEFAULT_DEVELOPMENT_PROVIDER_URL).toBe("https://localhost:9229");
+	});
+
+	it("is the override when one is set", () => {
+		// The case this exists for: a phone loading the demo over the LAN cannot
+		// reach the provider via `localhost`, which resolves to the phone.
+		expect(getDevelopmentProviderUrl("https://192.0.2.10:9229")).toBe(
+			"https://192.0.2.10:9229",
+		);
+	});
+
+	it("drops a trailing slash so the url composes with /healthz", () => {
+		expect(getDevelopmentProviderUrl("https://192.0.2.10:9229/")).toBe(
+			"https://192.0.2.10:9229",
+		);
+	});
+
+	it("falls back rather than yielding an empty url", () => {
+		for (const blank of ["", "   ", undefined]) {
+			expect(getDevelopmentProviderUrl(blank)).toBe(
+				DEFAULT_DEVELOPMENT_PROVIDER_URL,
+			);
+		}
+	});
+});
+
+describe("reading the override", () => {
+	it("reads the environment variable", () => {
+		process.env[ENV_KEY] = "https://198.51.100.7:9229";
+		expect(readDevelopmentProviderUrlOverride()).toBe(
+			"https://198.51.100.7:9229",
+		);
+	});
+
+	it("is undefined when the variable is unset", () => {
+		delete process.env[ENV_KEY];
+		expect(readDevelopmentProviderUrlOverride()).toBeUndefined();
+	});
+
+	it("defaults when the variable is unset", () => {
+		delete process.env[ENV_KEY];
+		expect(getDevelopmentProviderUrl()).toBe(DEFAULT_DEVELOPMENT_PROVIDER_URL);
+	});
+});