Add server URL normalization for flexible serverURL input

[chris-freeman-glean]

Summary

Adds server URL normalization so users can pass schemeless URLs (e.g., "mycompany-be.glean.com") as serverURL when constructing the SDK client. This is part of promoting serverURL as the primary configuration option, replacing instance in all documentation and examples.

TypeScript-specific implementation

The TypeScript SDK required a two-layer approach due to how Speakeasy generates the TypeScript target:

1. SDKInit hook (src/hooks/server-url-normalizer.ts): Normalizes URLs that already have a scheme (strips trailing slashes, preserves http/https). This is consistent with the hook-based approach used in Go, Python, and Java SDKs.

2. Custom Code edit to config.ts (src/lib/config.ts): The Speakeasy-generated serverURLFromOptions() calls new URL() before the SDKInit hook runs. Unlike Go/Python/Java where the hook receives a raw string, the TypeScript hook receives a parsed URL object — so schemeless URLs throw TypeError: Invalid URL before the hook can normalize them. This edit adds normalization directly in serverURLFromOptions(), before new URL() is called. Speakeasy's Custom Code 3-way merge preserves this edit across regenerations.

Normalization rules

• No scheme → prepend https://
• http:// preserved (for localhost/dev)
• https:// preserved
• Trailing slashes stripped

User-facing API

// All of these now work identically:
const glean = new Glean({ serverURL: "mycompany-be.glean.com" });
const glean = new Glean({ serverURL: "https://mycompany-be.glean.com" });
const glean = new Glean({ serverURL: "https://mycompany-be.glean.com/" });

Backwards compatibility

The instance parameter continues to work unchanged. No breaking changes.

Test plan

• 15 unit tests pass (8 normalizeServerURL, 2 hook, 5 serverURLFromOptions)
• Full integration test suite passes (120 pass, 61 skipped, 0 failed)