refactor(codegen): accept WsClient via config instead of require('graphql-ws')

[pyramation]

Summary

The orm-realtime.ts codegen template previously did require('graphql-ws') inside the RealtimeManager constructor, which:

• Fails in ESM environments
• Forces graphql-ws as a hidden dependency even when subscriptions aren't used

New approach: RealtimeConfig now accepts a client: WsClient property. The consumer creates and passes in their own graphql-ws client instance:

import { createClient } from 'graphql-ws';

const orm = createOrmClient({
  endpoint: 'https://api.example.com/graphql',
  realtime: {
    client: createClient({ url: 'wss://api.example.com/graphql' }),
  },
});

The SDK defines only a minimal WsClient interface — no import, no require, no dependency on graphql-ws at all. If the developer never uses subscriptions, they never need the package.

Changes:

• RealtimeConfig simplified to { client: WsClient } — all WS connection options (url, auth, retry, etc.) are now the consumer's responsibility when creating the client
• WsClient exported as a public type so consumers can reference the interface
• RealtimeManager constructor reduced to this.wsClient = config.client
• Snapshot updated for the new WsClient export

Review & Testing Checklist for Human

• Verify the WsClient interface shape (subscribe + dispose) stays compatible with graphql-ws's Client type
• After merging, run codegen in constructive-db to confirm the regenerated realtime.ts files match the new template
• Check that any existing subscription usage in downstream apps is updated to pass client: createClient(...) instead of the old url/getToken/etc. config

Notes

Companion fix already pushed to constructive-db PR #1089 (deps-update/20260510-105803) with the same changes applied to all 13 generated realtime.ts files.

Link to Devin session: https://app.devin.ai/sessions/37cd48fd674844c8b6fa1be2b7995746
Requested by: @pyramation

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring