@palbase/web 3.0.0 → 4.0.0

package/dist/index.cjs

@@ -765,19 +765,29 @@ var PalbeAuth = class {
 
 // src/calls/facade.ts
 var import_livekit_client = require("livekit-client");
-var Call = class {
+var Call = class _Call {
   id;
   _state = "connecting";
   _participants = /* @__PURE__ */ new Map();
   _listeners = /* @__PURE__ */ new Set();
   _room;
   _keyProvider;
-  /** @internal — obtain via PalbeCalls.start() / .accept() */
+  // PRIVATE constructor + `@internal` factory: the media-engine types (`Room`,
+  // `ExternalE2EEKeyProvider`) appear ONLY on a private constructor and an
+  // `@internal` static factory, both of which `stripInternal` (set in this
+  // package's tsconfig) removes from the emitted public `.d.ts`. So no engine type
+  // ever reaches the public API surface — the same "no engine type in the public
+  // interface" contract the iOS SDK enforces. Consumers obtain a `Call` only
+  // through `pb.calls.start()` / `.accept()`.
   constructor(callId, room, keyProvider) {
     this.id = callId;
     this._room = room;
     this._keyProvider = keyProvider;
-    this._wireRoomEvents();
+    this._wireMediaEvents();
+  }
+  /** @internal — facade-only factory; stripped from the public `.d.ts`. */
+  static _create(callId, room, keyProvider) {
+    return new _Call(callId, room, keyProvider);
   }
   // ─── State ──────────────────────────────────────────────────────────────
   get state() {
@@ -787,9 +797,9 @@ var Call = class {
   get participants() {
     return Array.from(this._participants.values());
   }
-  get localParticipant() {
-    return this._room.localParticipant;
-  }
+  // (No `localParticipant` accessor: it would return a raw media-engine participant
+  // object and leak the engine type onto the public API. Local mic/camera control is
+  // exposed engine-agnostically via `mute()` / `setCamera()` below.)
   // ─── Subscribe ──────────────────────────────────────────────────────────
   /**
    * Subscribe to call changes (state + participant updates).
@@ -813,7 +823,7 @@ var Call = class {
   /**
    * Set a raw frame encryption key (ArrayBuffer) for this call.
    * Design seam for SP-1.x web-MLS: call this with the MLS exporter secret
-   * to enable frame-level E2EE via ExternalE2EEKeyProvider.
+   * to enable frame-level E2EE via the media engine's external key provider.
    *
    * NOTE: The room must have been opened with `e2ee` options for this to take
    * effect. Currently calls connect WITHOUT e2ee — see module docstring.
@@ -823,7 +833,7 @@ var Call = class {
   async setMediaKey(key) {
     await this._keyProvider.setKey(key);
   }
-  /** Leave the call and disconnect from the LiveKit room. */
+  /** Leave the call and disconnect from the media room. */
   async leave() {
     await this._room.disconnect();
     this._setState("ended");
@@ -865,7 +875,7 @@ var Call = class {
     }
     this._emit();
   }
-  _wireRoomEvents() {
+  _wireMediaEvents() {
     this._room.on(import_livekit_client.RoomEvent.Connected, () => {
       this._setState("active");
     }).on(
@@ -906,9 +916,9 @@ var PalbeCalls = class {
    *
    * @param groupId  - Messaging group display-id (`grp_<uuidv7>`)
    * @param media    - Which media tracks to publish (default: audio + video)
-   * @returns        A `Call` in `connecting` state; transitions to `active` once LiveKit connects.
+   * @returns        A `Call` in `connecting` state; transitions to `active` once the media room connects.
    *
-   * @throws BackendError('network', { code: 'call_service_unavailable' })  if LiveKit SFU is down (503)
+   * @throws BackendError('network', { code: 'call_service_unavailable' })  if the SFU is down (503)
    * @throws BackendError('forbidden', { code: 'not_group_member' })       if the caller is not a member (403)
    * @throws BackendError('conflict', { code: 'call_room_full' })          if the room is full (409)
    */
@@ -965,7 +975,7 @@ var PalbeCalls = class {
       adaptiveStream: true,
       dynacast: true
     });
-    const call = new Call(callId, room, keyProvider);
+    const call = Call._create(callId, room, keyProvider);
     await room.connect(edgeUrl, token);
     if (media.includes("audio")) {
       await room.localParticipant.setMicrophoneEnabled(true);
@@ -7611,7 +7621,7 @@ function localStorageSessionStorage(key = DEFAULT_KEY) {
 }
 
 // src/version.ts
-var VERSION = "3.0.0";
+var VERSION = "4.0.0";
 
 // src/internal.ts
 function getRuntime() {