feat(sdk): more helpful TypeScript errors

Improve the DX of TypeScript errors the SDK surfaces (builder generics etc.) so misuse produces a readable, actionable message instead of deep generic spew.

**Acceptance**
- Documented patterns for the common misuse cases
- Representative misuse cases produce clear messages (type-level / expect-type tests)

Part of #194

