sos-portal-components-react 0.1.2 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## Unreleased
 
+## 0.2.1 - 2026-11-07
+
+- Pin `sos-data-utils-ts@0.6.28`, the exact release that owns the portal RTC
+  Communication contract consumed by `LiveKitRealtimeCallClient`. Clean npm
+  installs no longer retain a nested pre-RTC data-utils release.
+
+## 0.2.0 - 2026-11-07
+
+- Establish this package as the shared presentation boundary consumed directly
+  by CH Personal and Professional in every flavour. Product portals provide
+  authorization, policy and BFF adapters; UHC compatibility exports no longer
+  own the active implementation.
+- Export `SubjectConversationChat` as the single subject-channel renderer over
+  canonical Communications. It projects text, governed attachments, clinical
+  Bundles, ICS/files, audio and call events without owning persistence,
+  signaling or recipient authority.
+- Export `LiveKitRealtimeCallClient` as a dynamically loaded web RTC adapter
+  designed for later Expo substitution. It consumes only the short grant
+  issued by the BFF and never receives LiveKit API credentials.
+- Separate CH all-local, telephone-assistant, optional web-assistant and RTC
+  integration profiles. Calls use a host-injected dedicated RTC client while
+  invitations, terminal events and unanswered audio render as Communications.
+
 ## 0.1.2 - 2026-11-07
 
 - Document and enforce one shared UI contract for Demo, Test Network, web and

package/README.md

@@ -7,6 +7,11 @@ Expo. They never select storage. Owning applications inject memory for
 all-local, Expo SQLite for native, or an explicit durable adapter. Firestore
 must not create a Demo-only component or data model.
 
+CH all-local portal execution does not start or require Chat, the telephone
+assistant or the optional web assistant. Realtime audio/video is a dedicated
+RTC boundary supplied by the host BFF. Invitations, terminal states and an
+optional unanswered audio attachment are rendered from Communications.
+
 Shared portal UI for base components. It provides the portal UI core for
 personal and professional applications across human
 health, animal care, public safety, emergency response and other configured

package/dist/LiveKitRealtimeCallClient.d.ts

@@ -0,0 +1,50 @@
+export type RealtimeCallMedia = 'audio' | 'video';
+export type RealtimeCallSession = Readonly<{
+    callId: string;
+    localStream: MediaStream;
+    remoteStream: MediaStream;
+    end(): Promise<void>;
+}>;
+export type LiveKitJoinSession<Conversation> = Readonly<{
+    conversation: Conversation;
+    callId?: string;
+    media: readonly RealtimeCallMedia[];
+}>;
+export type LiveKitSessionGrant = Readonly<{
+    callId: string;
+    serverUrl: string;
+    participantToken: string;
+}>;
+type LiveKitModule = typeof import('livekit-client');
+/** Dedicated RTC adapter. It never receives Chat routes and persists no call history. */
+export declare function createLiveKitRealtimeCallClient<Conversation>(dependencies: Readonly<{
+    issueSession(input: LiveKitJoinSession<Conversation>): Promise<LiveKitSessionGrant>;
+    endCall(input: Readonly<{
+        conversation: Conversation;
+        callId: string;
+    }>): Promise<void>;
+    loadLiveKit?: () => Promise<LiveKitModule>;
+    createMediaStream?: () => MediaStream;
+}>): {
+    start(input: Readonly<{
+        conversation: Conversation;
+        media: readonly RealtimeCallMedia[];
+    }>): Promise<Readonly<{
+        callId: string;
+        localStream: MediaStream;
+        remoteStream: MediaStream;
+        end(): Promise<void>;
+    }>>;
+    accept(input: Readonly<{
+        conversation: Conversation;
+        callId: string;
+        media: readonly RealtimeCallMedia[];
+    }>): Promise<Readonly<{
+        callId: string;
+        localStream: MediaStream;
+        remoteStream: MediaStream;
+        end(): Promise<void>;
+    }>>;
+};
+export {};
+//# sourceMappingURL=LiveKitRealtimeCallClient.d.ts.map

package/dist/LiveKitRealtimeCallClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveKitRealtimeCallClient.d.ts","sourceRoot":"","sources":["../src/LiveKitRealtimeCallClient.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,CAAA;AACjD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAC;IAAC,YAAY,EAAE,WAAW,CAAC;IAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAAA;AACzI,MAAM,MAAM,kBAAkB,CAAC,YAAY,IAAI,QAAQ,CAAC;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAAA;AAC7I,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE3G,KAAK,aAAa,GAAG,cAAc,gBAAgB,CAAC,CAAA;AAEpD,yFAAyF;AACzF,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC;IACnF,YAAY,CAAC,KAAK,EAAE,kBAAkB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACnF,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IAC1C,iBAAiB,CAAC,EAAE,MAAM,WAAW,CAAA;CACtC,CAAC;iBA+Be,QAAQ,CAAC;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;KAAE,CAAC;gBA3CzC,MAAM;qBAAe,WAAW;sBAAgB,WAAW;eAAS,OAAO,CAAC,IAAI,CAAC;;kBA4CpH,QAAQ,CAAC;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;KAAE,CAAC;gBA5C1D,MAAM;qBAAe,WAAW;sBAAgB,WAAW;eAAS,OAAO,CAAC,IAAI,CAAC;;EA8CrI"}

package/dist/LiveKitRealtimeCallClient.js

@@ -0,0 +1,40 @@
+/** Dedicated RTC adapter. It never receives Chat routes and persists no call history. */
+export function createLiveKitRealtimeCallClient(dependencies) {
+    const loadLiveKit = dependencies.loadLiveKit ?? (() => import('livekit-client'));
+    const createMediaStream = dependencies.createMediaStream ?? (() => new MediaStream());
+    async function connect(input) {
+        const [liveKit, grant] = await Promise.all([loadLiveKit(), dependencies.issueSession(input)]);
+        const room = new liveKit.Room({ adaptiveStream: true, dynacast: true });
+        const localStream = createMediaStream();
+        const remoteStream = createMediaStream();
+        room.on(liveKit.RoomEvent.TrackSubscribed, track => {
+            const mediaTrack = track.mediaStreamTrack;
+            if (mediaTrack)
+                remoteStream.addTrack(mediaTrack);
+        });
+        await room.connect(grant.serverUrl, grant.participantToken);
+        if (input.media.includes('audio'))
+            await room.localParticipant.setMicrophoneEnabled(true);
+        if (input.media.includes('video'))
+            await room.localParticipant.setCameraEnabled(true);
+        for (const publication of room.localParticipant.trackPublications.values()) {
+            const mediaTrack = publication.track?.mediaStreamTrack;
+            if (mediaTrack)
+                localStream.addTrack(mediaTrack);
+        }
+        return Object.freeze({
+            callId: grant.callId, localStream, remoteStream,
+            async end() {
+                room.disconnect();
+                for (const track of localStream.getTracks())
+                    track.stop();
+                await dependencies.endCall({ conversation: input.conversation, callId: grant.callId });
+            },
+        });
+    }
+    return {
+        start(input) { return connect(input); },
+        accept(input) { return connect(input); },
+    };
+}
+//# sourceMappingURL=LiveKitRealtimeCallClient.js.map

package/dist/LiveKitRealtimeCallClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveKitRealtimeCallClient.js","sourceRoot":"","sources":["../src/LiveKitRealtimeCallClient.ts"],"names":[],"mappings":"AAOA,yFAAyF;AACzF,MAAM,UAAU,+BAA+B,CAAe,YAK5D;IACA,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAChF,MAAM,iBAAiB,GAAG,YAAY,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,CAAA;IAErF,KAAK,UAAU,OAAO,CAAC,KAAuC;QAC5D,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAC7F,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACvE,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAA;QACvC,MAAM,YAAY,GAAG,iBAAiB,EAAE,CAAA;QACxC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE;YACjD,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAA;YACzC,IAAI,UAAU;gBAAE,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QACnD,CAAC,CAAC,CAAA;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAC3D,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;QACzF,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACrF,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3E,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAA;YACtD,IAAI,UAAU;gBAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY;YAC/C,KAAK,CAAC,GAAG;gBACP,IAAI,CAAC,UAAU,EAAE,CAAA;gBACjB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE;oBAAE,KAAK,CAAC,IAAI,EAAE,CAAA;gBACzD,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;YACxF,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,CAAC,KAAoF,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;QACrH,MAAM,CAAC,KAAoG,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;KACvI,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './SubjectConversationChat.js';
+export * from './LiveKitRealtimeCallClient.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export * from './SubjectConversationChat.js';
+export * from './LiveKitRealtimeCallClient.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sos-portal-components-react",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Shared portal UI for base components",
   "license": "Apache-2.0",
   "type": "module",
@@ -34,6 +34,7 @@
   },
   "peerDependencies": {
     "@kesha-antonov/react-native-chat": "^6.0.1",
+    "livekit-client": ">=2.23.0 <3",
     "react": ">=18.3.0",
     "react-dom": ">=18.3.0",
     "react-native": ">=0.82.0",
@@ -43,16 +44,31 @@
     "react-native-safe-area-context": ">=5.0.0"
   },
   "peerDependenciesMeta": {
-    "@kesha-antonov/react-native-chat": { "optional": true },
-    "react-native": { "optional": true },
-    "react-native-gesture-handler": { "optional": true },
-    "react-native-keyboard-controller": { "optional": true },
-    "react-native-reanimated": { "optional": true },
-    "react-native-safe-area-context": { "optional": true }
+    "@kesha-antonov/react-native-chat": {
+      "optional": true
+    },
+    "livekit-client": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react-native-gesture-handler": {
+      "optional": true
+    },
+    "react-native-keyboard-controller": {
+      "optional": true
+    },
+    "react-native-reanimated": {
+      "optional": true
+    },
+    "react-native-safe-area-context": {
+      "optional": true
+    }
   },
   "dependencies": {
     "antifraud-portal-components-react": "0.2.2",
-    "sos-data-utils-ts": "0.6.27"
+    "sos-data-utils-ts": "0.6.28"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
@@ -60,6 +76,7 @@
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
     "jsdom": "26.1.0",
+    "livekit-client": "2.23.0",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "typescript": "5.9.3",
@@ -73,4 +90,3 @@
     "url": "git+https://github.com/soschain/sos-portal-components-react.git"
   }
 }
-