feat(realtime): add realtimeBaseUrl option to createDecartClient

[AdirAmsalem]

Summary

• Adds a realtimeBaseUrl option to createDecartClient() to override the default wss://api3.decart.ai WebSocket base URL for realtime connections
• Useful for self-hosted or custom deployments where the realtime endpoint differs from the default

Changes

• packages/sdk/src/index.ts — Added realtimeBaseUrl to Zod schema, TypeScript types, JSDoc, error handling, and wiring to the realtime client
• packages/sdk/tests/unit.test.ts — Added tests for invalid URL validation and custom URL creation
• packages/sdk/index.html — Added optional "Realtime Base URL" input field to the test page
• examples/sdk-core/realtime/custom-base-url.ts — New usage example
• examples/sdk-core/README.md — Added example entry

Usage

const decart = createDecartClient({
  apiKey: "your-api-key",
  realtimeBaseUrl: "wss://custom-ws.example.com",
});

When realtimeBaseUrl is omitted, the default wss://api3.decart.ai is used (no breaking change).

---

Note

Low Risk
Additive configuration change with URL validation and tests; main risk is misconfiguration causing realtime connection failures.

Overview
Adds an optional realtimeBaseUrl to createDecartClient to override the default wss://api3.decart.ai used for realtime (WebRTC) connections.

Updates input validation/types/JSDoc and error handling to treat invalid realtimeBaseUrl like baseUrl, wires the value into realtime client creation, and adds unit tests. Also updates the SDK test index.html and examples/sdk-core with a new custom-base-url example and README entry showing how to configure it.

^{Written by Cursor Bugbot for commit 69f4aa8. This will update automatically on new commits. Configure here.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/DecartAI/sdk/@decartai/sdk@91

commit: 69f4aa8

[infoshoc]

thanks a lot!