@chitchat/sdk-react-native 0.1.0-dev.2 → 0.2.0-dev.1

package/README.md

@@ -4,6 +4,10 @@
 
 This package is currently a **development prerelease**. Pin the version you have tested before shipping an application.
 
+## SDK foundation in v0.2
+
+The native SDK validates both the TLS endpoint and the linked bridge result before sending frames. The bridge must expose every method in the documented connection contract; partial bridges fail fast instead of silently degrading to an unsafe transport.
+
 ## Read this before integrating
 
 This JavaScript package needs a linked native bridge. You pass that bridge as `nativeModule`; the SDK does not secretly create TCP sockets in JavaScript.

package/index.d.ts

@@ -0,0 +1,6 @@
+import type { ReliableRealtimeClient, ReliableRealtimeClientOptions, RealtimeFrame } from '@chitchat/sdk-core';
+export interface ChitChatNativeConnection { onFrame(listener: (frame: RealtimeFrame) => void): void; onClose(listener: (reason?: unknown) => void): void; send(frame: RealtimeFrame): Promise<void> | void; close(): Promise<void> | void; }
+export interface ChitChatNativeModule { connect(input: { endpoint: string; token: string; protocol: 'chitchat.protobuf.v1'; tls: true }): Promise<ChitChatNativeConnection>; }
+export function validateNativeTlsEndpoint(endpoint: string): string;
+export function createNativeTcpTransportFactory(options: { nativeModule: ChitChatNativeModule }): ReliableRealtimeClientOptions['nativeTransportFactory'];
+export function createChitChatNativeClient(options: Omit<ReliableRealtimeClientOptions, 'runtime' | 'nativeTransportFactory'> & { nativeModule: ChitChatNativeModule }): ReliableRealtimeClient;

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@chitchat/sdk-react-native",
-  "version": "0.1.0-dev.2",
+  "version": "0.2.0-dev.1",
   "main": "src/index.js",
-  "exports": "./src/index.js",
-  "files": ["src", "README.md", "LICENSE"],
+  "exports": { ".": { "types": "./index.d.ts", "require": "./src/index.js", "import": "./src/index.js" } },
+  "types": "index.d.ts",
+  "files": ["src", "index.d.ts", "README.md", "LICENSE"],
   "engines": { "node": ">=18" },
   "scripts": { "test": "node test/transport.test.js" },
-  "dependencies": { "@chitchat/sdk-core": "0.1.0-dev.2" },
+  "dependencies": { "@chitchat/sdk-core": "0.2.0-dev.1" },
   "license": "UNLICENSED",
   "publishConfig": { "access": "public", "tag": "development" }
 }

package/src/index.js

@@ -12,6 +12,11 @@ const validateNativeTlsEndpoint = (endpoint) => {
   return endpoint;
 };
 
+const assertConnection = (connection) => {
+  if (!connection || ['onFrame', 'onClose', 'send', 'close'].some((name) => typeof connection[name] !== 'function')) throw new Error('Native TCP module returned an invalid connection');
+  return connection;
+};
+
 const createNativeTcpTransportFactory = ({ nativeModule }) => {
   if (!nativeModule || typeof nativeModule.connect !== 'function') throw new Error('The official ChitChat native TCP module is required');
   return async ({ endpoint, token, protocol }) => {
@@ -21,12 +26,12 @@ const createNativeTcpTransportFactory = ({ nativeModule }) => {
       onMessage: (listener) => { onMessage = listener; },
       onClose: (listener) => { onClose = listener; },
       open: async () => {
-        connection = await nativeModule.connect({ endpoint, token, protocol, tls: true });
+        connection = assertConnection(await nativeModule.connect({ endpoint, token, protocol, tls: true }));
         connection.onFrame((frame) => onMessage(frame));
         connection.onClose((reason) => onClose(reason));
       },
-      send: (frame) => connection.send(frame),
-      close: () => connection ? connection.close() : Promise.resolve()
+      send: (frame) => connection ? Promise.resolve(connection.send(frame)) : Promise.reject(new Error('Native TCP transport is not open')),
+      close: () => connection ? Promise.resolve(connection.close()) : Promise.resolve()
     };
   };
 };