[forgetso]

What was annoying

In development the widget looks for its provider at a hardcoded https://localhost:9229.

That is right when the page and the provider are on the same machine, and wrong the moment they are not. A phone or an iOS simulator loading the demo over the LAN resolves localhost to itself, so the widget never reaches the provider. The failure surfaces as "Site key not registered", which reads like a configuration problem with the site key rather than what it is — the request went nowhere.

It cost a while to work out when testing a mobile-only bug on a real device, because nothing in the error points at the provider URL.

What changed

PROSOPO_PROVIDER_URL_DEVELOPMENT now overrides it:

PROSOPO_PROVIDER_URL_DEVELOPMENT="https://192.0.2.10:9229" npm run start:bundle

Unset, it still falls back to https://localhost:9229, so existing setups are unaffected. Staging and production resolve through their DNS-routed endpoints and ignore it entirely.

The URL was hardcoded in two places — the DNS endpoint map in providers.ts and the single-provider dev list in balancer.ts — and both now read the same resolver.

Two details worth a look in review

• The override is read as a static process.env.X access, because the frontend build substitutes that exact expression for a literal. A computed lookup (process.env[key]) would not be matched and would silently never work in the browser. For the same reason there is no typeof process guard: in a browser bundle the expression is already a string by the time it runs, and guarding on a process that does not exist there would throw the value away.
• The endpoint map is now built per call rather than once at module load, so an override set after the module is first imported is still picked up.

Effect

Development only. No change to staging or production behaviour, and no change when the variable is unset.

Test coverage

7 tests: the default, an override, trailing-slash normalisation, empty and whitespace-only values falling back rather than yielding an empty URL, reading the variable, and the unset case.

Also checked end to end against the built package — with the variable set, getRandomActiveProvider("development") and loadBalancer("development") both return the override; without it, both return https://localhost:9229.

Suite: 49 passed, 0 type errors.

🤖 Generated with Claude Code