@waitaya.buc/client-js 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -17,15 +17,22 @@ npm install @waitaya.buc/client-js
 
 ### React Native
 
-`Vroom.init({ platformInfo })` automatically prepares required RN WebRTC globals on iOS/Android
-via `@waitaya.buc/client-js/react-native` (internally calls LiveKit RN global setup).
+On iOS/Android, the active provider adapter prepares its required WebRTC globals
+automatically inside `Vroom.connect()` (during adapter creation). You do not need
+to register polyfills manually.
 
-If needed, you can import mobile-specific helpers from:
+If you need RN-specific helpers (e.g., `RTCView` for rendering remote video),
+import them from the provider-agnostic subpath:
 
 ```typescript
-import { RTCView, MediaStream, registerWebRTCGlobals } from '@waitaya.buc/client-js/react-native'
+import { RTCView, MediaStream } from '@waitaya.buc/client-js/react-native'
 ```
 
+This subpath is served by the SDK composition root (`src/react-native.ts`),
+which re-exports from the active adapter's bindings. Consumer code stays
+provider-agnostic — the import path does not change if the active adapter
+changes.
+
 #### React Native Dependency Note (v0.x)
 
 The current RTC adapter is LiveKit (internal adapter), and React Native native-module autolinking

package/dist/adapters/livekit/react-native.d.ts

@@ -8,13 +8,7 @@
  */
 import { MediaStream, RTCView } from '@livekit/react-native-webrtc';
 export { RTCView, MediaStream };
-export interface RTCViewProps {
-    streamURL: string | null;
-    objectFit?: 'cover' | 'contain';
-    mirror?: boolean;
-    zOrder?: number;
-    style?: unknown;
-}
+export type { RTCViewProps } from '../../core/ports/outbound/react-native-bindings.port';
 /**
  * Registers all globals required by LiveKit on React Native.
  *

package/dist/adapters/livekit/react-native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../../src/adapters/livekit/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AAE/B,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAID;;;;;GAKG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBvE"}
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../../src/adapters/livekit/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAInE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAA;AAUxF;;;;;GAKG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBvE"}

package/dist/adapters/livekit/react-native.js

@@ -9,6 +9,11 @@
 import { registerGlobals as registerLiveKitGlobals } from '@livekit/react-native';
 import { MediaStream, RTCView } from '@livekit/react-native-webrtc';
 export { RTCView, MediaStream };
+// Compile-time check: exports must satisfy the ReactNativeBindings port.
+// If LiveKit ever changes the shape of RTCView/MediaStream, this will fail
+// to typecheck — surface the breakage at build time, not at runtime.
+const _contract = { RTCView, MediaStream };
+void _contract;
 let globalsRegistered = false;
 /**
  * Registers all globals required by LiveKit on React Native.

package/dist/adapters/livekit/react-native.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../../../src/adapters/livekit/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AAU/B,IAAI,iBAAiB,GAAG,KAAK,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC;IACrD,IAAI,iBAAiB;QAAE,OAAM;IAE7B,sBAAsB,EAAE,CAAA;IAExB,IACE,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW;QAC7C,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW,EAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;IACzF,CAAC;IAED,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,WAAW,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IAED,IACE,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW;QAChD,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW,EAChD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IAED,iBAAiB,GAAG,IAAI,CAAA;AAC1B,CAAC"}
+{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../../../src/adapters/livekit/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAInE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AAG/B,yEAAyE;AACzE,2EAA2E;AAC3E,qEAAqE;AACrE,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,WAAW,EAAgC,CAAA;AACxE,KAAK,SAAS,CAAA;AAEd,IAAI,iBAAiB,GAAG,KAAK,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC;IACrD,IAAI,iBAAiB;QAAE,OAAM;IAE7B,sBAAsB,EAAE,CAAA;IAExB,IACE,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW;QAC7C,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW,EAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;IACzF,CAAC;IAED,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,WAAW,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IAED,IACE,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW;QAChD,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW,EAChD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IAED,iBAAiB,GAAG,IAAI,CAAA;AAC1B,CAAC"}

package/dist/core/ports/outbound/react-native-bindings.port.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Contract that React Native bindings of any provider adapter must satisfy.
+ *
+ * Scope: This port currently reflects the **WebRTC family** of providers
+ * (LiveKit, Daily, Twilio Video, etc.) which all expose `RTCView` from
+ * `react-native-webrtc` and a `MediaStream` with `.toURL()`.
+ *
+ * If a non-WebRTC provider (e.g., Agora with `RtcSurfaceView`) is added
+ * later, do NOT force-fit it into this shape — split into a parallel port
+ * or generalize this one with a clear migration plan. The current shape
+ * is intentional, not a placeholder.
+ *
+ * This is an **optional contract** — only providers that support React
+ * Native need to satisfy it. Web-only adapters can ignore this port.
+ */
+export interface ReactNativeBindings {
+    RTCView: ReactComponentType<RTCViewProps>;
+    MediaStream: new (...args: never[]) => MediaStreamLike;
+}
+/**
+ * Minimal structural type matching React's `ComponentType`.
+ *
+ * Defined locally so this port (and the core) does not take a dependency on
+ * `react` types. Adapters that import `ComponentType` from `react` will
+ * remain assignable to this shape via structural typing.
+ */
+export type ReactComponentType<P> = (props: P) => unknown;
+export interface RTCViewProps {
+    streamURL: string | null;
+    objectFit?: 'cover' | 'contain';
+    mirror?: boolean;
+    zOrder?: number;
+    style?: unknown;
+}
+export interface MediaStreamLike {
+    toURL(): string;
+    readonly id: string;
+}
+//# sourceMappingURL=react-native-bindings.port.d.ts.map

package/dist/core/ports/outbound/react-native-bindings.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-bindings.port.d.ts","sourceRoot":"","sources":["../../../../src/core/ports/outbound/react-native-bindings.port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAA;IACzC,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,eAAe,CAAA;CACvD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAA;AAEzD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB"}

package/dist/core/ports/outbound/react-native-bindings.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=react-native-bindings.port.js.map

package/dist/core/ports/outbound/react-native-bindings.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-bindings.port.js","sourceRoot":"","sources":["../../../../src/core/ports/outbound/react-native-bindings.port.ts"],"names":[],"mappings":""}

package/dist/react-native.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SDK composition root for React Native.
+ *
+ * This file (and only this file) knows which provider adapter is active —
+ * it re-exports the active adapter's React Native bindings so consumers
+ * can import them via the provider-agnostic public subpath
+ * `@waitaya.buc/client-js/react-native`.
+ *
+ * Hexagonal rule: core code under `src/core/` MUST NOT import this file.
+ * The composition root is allowed to know the concrete adapter; the core
+ * is not.
+ *
+ * Swapping providers (e.g., LiveKit → Daily) is a build-time change to
+ * this single line — consumers do not need to update import paths.
+ */
+export * from './adapters/livekit/react-native';
+//# sourceMappingURL=react-native.d.ts.map

package/dist/react-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../src/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,iCAAiC,CAAA"}

package/dist/react-native.js

@@ -0,0 +1,17 @@
+/**
+ * SDK composition root for React Native.
+ *
+ * This file (and only this file) knows which provider adapter is active —
+ * it re-exports the active adapter's React Native bindings so consumers
+ * can import them via the provider-agnostic public subpath
+ * `@waitaya.buc/client-js/react-native`.
+ *
+ * Hexagonal rule: core code under `src/core/` MUST NOT import this file.
+ * The composition root is allowed to know the concrete adapter; the core
+ * is not.
+ *
+ * Swapping providers (e.g., LiveKit → Daily) is a build-time change to
+ * this single line — consumers do not need to update import paths.
+ */
+export * from './adapters/livekit/react-native';
+//# sourceMappingURL=react-native.js.map

package/dist/react-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../src/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,iCAAiC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waitaya.buc/client-js",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Vroom Core SDK - Platform-agnostic RTC abstraction layer",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,9 +13,9 @@
       "default": "./dist/index.js"
     },
     "./react-native": {
-      "types": "./dist/adapters/livekit/react-native.d.ts",
-      "import": "./dist/adapters/livekit/react-native.js",
-      "default": "./dist/adapters/livekit/react-native.js"
+      "types": "./dist/react-native.d.ts",
+      "import": "./dist/react-native.js",
+      "default": "./dist/react-native.js"
     }
   },
   "files": [