// Types for resolve-origin.js — the shared core behind resolveConnectUrl and resolveKaitoBase.
// Same criterion as retry.d.ts: ours, and load-bearing. `varName` is typed as required because a
// refusal that does not name the variable sends the reader to the wrong config file.

/**
 * An env-supplied base URL with a compiled-in production fallback, failing closed on anything
 * malformed.
 *
 * @param raw      the env value, if any. Unset/blank/whitespace ⇒ `fallback` verbatim.
 * @param fallback the compiled-in production default.
 * @param varName  the env variable's name, so the refusal says which line to go and look at.
 * @param example  a correct value, for the refusal message.
 * @throws if `raw` is set but is not a plain absolute http(s) URL, or carries a query/fragment.
 */
export function resolveOrigin(
  raw: unknown,
  fallback: string,
  varName: string,
  example: string,
): string;