@chitchat/sdk-web 0.1.0-dev.0

package/README.md

@@ -0,0 +1,5 @@
+# ChitChat Web SDK
+
+`createChitChatWebClient` always uses WSS. It authenticates through the first binary Protobuf frame, never by placing a session token in a URL. Supply the generated Protobuf codec and a function that fetches a short-lived project-user session token.
+
+Raw TCP is not available in browsers and is never attempted by this module.

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@chitchat/sdk-web",
+  "version": "0.1.0-dev.0",
+  "main": "src/index.js",
+  "files": ["src", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "dependencies": { "@chitchat/sdk-core": "0.1.0-dev.0" },
+  "license": "UNLICENSED",
+  "publishConfig": { "access": "public", "tag": "development" }
+}

package/src/index.js

@@ -0,0 +1,37 @@
+'use strict';
+
+let ReliableRealtimeClient;
+try { ({ ReliableRealtimeClient } = require('@chitchat/sdk-core')); } catch (_) { ({ ReliableRealtimeClient } = require('../../chitchat-core/src')); }
+
+const toWssEndpoint = (endpoint) => {
+  const url = new URL(endpoint);
+  if (url.protocol === 'https:') url.protocol = 'wss:';
+  if (url.protocol === 'http:') url.protocol = 'ws:';
+  if (!['wss:', 'ws:'].includes(url.protocol)) throw new Error('A HTTP(S) or WS(S) endpoint is required');
+  return url.toString();
+};
+
+const createWssTransportFactory = ({ WebSocketImpl = globalThis.WebSocket, encode, decode }) => {
+  if (!WebSocketImpl || typeof encode !== 'function' || typeof decode !== 'function') throw new Error('WebSocket implementation and protobuf encode/decode functions are required');
+  return async ({ endpoint, token, protocol }) => {
+    let socket; let onMessage = () => {}; let onClose = () => {};
+    return {
+      onMessage: (listener) => { onMessage = listener; },
+      onClose: (listener) => { onClose = listener; },
+      open: () => new Promise((resolve, reject) => {
+        socket = new WebSocketImpl(toWssEndpoint(endpoint), protocol);
+        socket.binaryType = 'arraybuffer';
+        socket.onopen = () => { socket.send(encode({ type: 'auth', token })); resolve(); };
+        socket.onerror = () => reject(new Error('WSS connection failed'));
+        socket.onclose = (event) => onClose({ code: event.code, reason: event.reason });
+        socket.onmessage = (event) => onMessage(decode(event.data));
+      }),
+      send: (frame) => socket.send(encode(frame)),
+      close: () => new Promise((resolve) => { if (!socket || socket.readyState === 3) return resolve(); socket.onclose = () => resolve(); socket.close(); })
+    };
+  };
+};
+
+const createChitChatWebClient = ({ endpoint, tokenProvider, protobuf, ...options }) => new ReliableRealtimeClient({ endpoint, tokenProvider, runtime: 'web', webTransportFactory: createWssTransportFactory(protobuf), ...options });
+
+module.exports = { createChitChatWebClient, createWssTransportFactory, toWssEndpoint };