@signalwire/js 3.29.2 → 4.0.0-dev-20260220205014

package/src/fabric/FabricRoomSession.ts

@@ -1,446 +0,0 @@
-import {
-  connect,
-  BaseComponentContract,
-  BaseRPCResult,
-  FabricLayoutChangedEventParams,
-  ExecuteExtendedOptions,
-  Rooms,
-  VideoMemberEntity,
-  VideoPosition,
-  BaseConnectionContract,
-  FabricRoomSessionMethods,
-  MemberCommandParams,
-  MemberCommandWithVolumeParams,
-  MemberCommandWithValueParams,
-  SetAudioFlagsParams,
-  toSnakeCaseKeys,
-} from '@signalwire/core'
-import {
-  BaseRoomSessionConnection,
-  BaseRoomSessionOptions,
-} from '../BaseRoomSession'
-import {
-  BaseRoomSessionContract,
-  ExecuteMemberActionParams,
-  FabricRoomSessionContract,
-  FabricRoomSessionEvents,
-  RequestMemberParams,
-} from '../utils/interfaces'
-import { getStorage } from '../utils/storage'
-import { PREVIOUS_CALLID_STORAGE_KEY } from './utils/constants'
-import { fabricWorker } from './workers'
-import { FabricRoomSessionMember } from './FabricRoomSessionMember'
-import { makeAudioElementSaga } from '../features/mediaElements/mediaElementsSagas'
-import { CallCapabilitiesContract } from './interfaces/capabilities'
-import { createFabricRoomSessionValidateProxy } from './utils/validationProxy'
-
-export interface FabricRoomSession
-  extends FabricRoomSessionContract,
-    FabricRoomSessionMethods,
-    BaseRoomSessionContract,
-    BaseConnectionContract<FabricRoomSessionEvents>,
-    BaseComponentContract {}
-
-export interface FabricRoomSessionOptions
-  extends Omit<BaseRoomSessionOptions, 'customSagas'> {}
-
-export class FabricRoomSessionConnection
-  extends BaseRoomSessionConnection<FabricRoomSessionEvents>
-  implements FabricRoomSessionContract
-{
-  // this is "self" parameter required by the RPC, and is always "the member" on the 1st call segment
-  private _self?: FabricRoomSessionMember
-  // this is "the member" on the last/active call segment
-  private _member?: FabricRoomSessionMember
-  private _currentLayoutEvent: FabricLayoutChangedEventParams
-  //describes what are methods are allow for the user in a call segment
-  private _capabilities?: CallCapabilitiesContract
-
-  constructor(options: FabricRoomSessionOptions) {
-    super(options)
-
-    this.initWorker()
-  }
-
-  override get memberId() {
-    return this._member?.memberId
-  }
-
-  override dialogParams(rtcPeerId: string) {
-    const params = super.dialogParams(rtcPeerId)
-    params.dialogParams.attach = this.options.attach || this.resuming
-    params.dialogParams.reattaching = this.options.attach || this.resuming
-    return params
-  }
-
-  set currentLayoutEvent(event: FabricLayoutChangedEventParams) {
-    this._currentLayoutEvent = event
-  }
-
-  get currentLayoutEvent() {
-    return this._currentLayoutEvent
-  }
-
-  get currentLayout() {
-    return this._currentLayoutEvent?.layout
-  }
-
-  get currentPosition() {
-    return this._currentLayoutEvent?.layout.layers.find(
-      (layer) => layer.member_id === this.memberId
-    )?.position
-  }
-
-  get capabilities(): CallCapabilitiesContract | undefined {
-    return this._capabilities
-  }
-
-  set capabilities(capabilities: CallCapabilitiesContract | undefined) {
-    this._capabilities = capabilities
-  }
-
-  get selfMember(): FabricRoomSessionMember | undefined {
-    return this._self
-  }
-
-  set selfMember(member: FabricRoomSessionMember | undefined) {
-    this._self = member
-  }
-
-  set member(member: FabricRoomSessionMember) {
-    this._member = member
-  }
-
-  get member(): FabricRoomSessionMember {
-    return this._member!
-  }
-
-  private initWorker() {
-    this.runWorker('fabricWorker', {
-      worker: fabricWorker,
-    })
-
-    /**
-     * By default the SDK attaches the audio to
-     * an Audio element (regardless of "rootElement")
-     */
-    this.runWorker('makeAudioElement', {
-      worker: makeAudioElementSaga({
-        speakerId: this.options.speakerId,
-      }),
-    })
-  }
-
-  private async join() {
-    if (this.options.attach) {
-      this.options.prevCallId =
-        getStorage()?.getItem(PREVIOUS_CALLID_STORAGE_KEY) ?? undefined
-      this.logger.debug(
-        `Tying to reattach to previuos call? ${!!this.options
-          .prevCallId} - prevCallId: ${this.options.prevCallId}`
-      )
-    }
-
-    return super.invite<FabricRoomSession>()
-  }
-
-  private executeAction<
-    InputType,
-    OutputType = InputType,
-    ParamsType extends MemberCommandParams = MemberCommandParams
-  >(
-    params: ExecuteMemberActionParams,
-    options: ExecuteExtendedOptions<InputType, OutputType, ParamsType> = {}
-  ) {
-    const { method, channel, memberId, extraParams = {} } = params
-
-    const targetMember =
-      !memberId || memberId === 'all'
-        ? this.member
-        : this.instanceMap.get<FabricRoomSessionMember>(memberId)
-
-    if (!targetMember) {
-      throw new Error(
-        memberId && memberId !== 'all'
-          ? `Member ${memberId} not found`
-          : 'No target member available'
-      )
-    }
-
-    return this.execute<InputType, OutputType, ParamsType>(
-      {
-        method,
-        params: {
-          ...(channel && { channels: [channel] }),
-          self: {
-            member_id: this.selfMember?.id,
-            call_id: this.selfMember?.callId,
-            node_id: this.selfMember?.nodeId,
-          },
-          target: {
-            member_id: memberId === 'all' ? memberId : targetMember.id,
-            call_id: targetMember.callId,
-            node_id: targetMember.nodeId,
-          },
-          ...extraParams,
-        },
-      },
-      options
-    )
-  }
-
-  /** @internal */
-  public override async resume() {
-    this.logger.warn(`[resume] Call ${this.id}`)
-    if (this.peer?.instance) {
-      const { connectionState } = this.peer.instance
-      this.logger.debug(
-        `[resume] connectionState for ${this.id} is '${connectionState}'`
-      )
-      if (['closed', 'failed', 'disconnected'].includes(connectionState)) {
-        // should not resume when selfMember is defined (the SDK didn't lost its state since the `call.joined` was received)
-        this.resuming = !this.selfMember
-        this.peer.restartIce()
-      }
-    }
-  }
-
-  public async start() {
-    return new Promise<void>(async (resolve, reject) => {
-      try {
-        this.once('room.subscribed', (params) => {
-          getStorage()?.setItem(PREVIOUS_CALLID_STORAGE_KEY, params.call_id)
-          resolve()
-        })
-
-        this.once('destroy', () => {
-          getStorage()?.removeItem(PREVIOUS_CALLID_STORAGE_KEY)
-        })
-
-        await this.join()
-      } catch (error) {
-        this.logger.error('WSClient call start', error)
-        reject(error)
-      }
-    })
-  }
-
-  public async audioMute(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.mute',
-      channel: 'audio',
-      memberId: params?.memberId,
-    })
-  }
-
-  public async audioUnmute(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.unmute',
-      channel: 'audio',
-      memberId: params?.memberId,
-    })
-  }
-
-  public async videoMute(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.mute',
-      channel: 'video',
-      memberId: params?.memberId,
-    })
-  }
-
-  public async videoUnmute(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.unmute',
-      channel: 'video',
-      memberId: params?.memberId,
-    })
-  }
-
-  public async deaf(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.deaf',
-      memberId: params?.memberId,
-    })
-  }
-
-  public async undeaf(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.undeaf',
-      memberId: params?.memberId,
-    })
-  }
-
-  public async getLayouts() {
-    return this.executeAction<{ layouts: string[] }>(
-      {
-        method: 'call.layout.list',
-      },
-      {
-        transformResolve: (payload) => ({
-          layouts: payload.layouts,
-        }),
-      }
-    )
-  }
-
-  public async getMembers() {
-    return this.executeAction<{ members: VideoMemberEntity[] }>(
-      {
-        method: 'call.member.list',
-      },
-      {
-        transformResolve: (payload) => ({
-          members: payload.members,
-        }),
-      }
-    )
-  }
-
-  public async removeMember(params: Required<MemberCommandParams>) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.member.remove',
-      memberId: params.memberId,
-    })
-  }
-
-  public async setRaisedHand(params?: Rooms.SetRaisedHandRoomParams) {
-    const { raised = true, memberId } = params || {}
-    return this.executeAction<BaseRPCResult>({
-      method: raised ? 'call.raisehand' : 'call.lowerhand',
-      memberId,
-    })
-  }
-
-  public async setLayout(params: Rooms.SetLayoutParams) {
-    const extraParams = {
-      layout: params.name,
-      positions: params.positions,
-    }
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.layout.set',
-      extraParams,
-    })
-  }
-
-  public async setInputVolume(params: MemberCommandWithVolumeParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.microphone.volume.set',
-      memberId: params.memberId,
-      extraParams: {
-        volume: params.volume,
-      },
-    })
-  }
-
-  public async setOutputVolume(params: MemberCommandWithVolumeParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.speaker.volume.set',
-      memberId: params.memberId,
-      extraParams: {
-        volume: params.volume,
-      },
-    })
-  }
-
-  public async setInputSensitivity(params: MemberCommandWithValueParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.microphone.sensitivity.set',
-      memberId: params.memberId,
-      extraParams: {
-        sensitivity: params.value,
-      },
-    })
-  }
-
-  public async setPositions(params: Rooms.SetPositionsParams) {
-    const targets: {
-      target: RequestMemberParams
-      position: VideoPosition
-    }[] = []
-
-    Object.entries(params.positions).forEach(([key, value]) => {
-      const targetMember =
-        key === 'self'
-          ? this.member
-          : this.instanceMap.get<FabricRoomSessionMember>(key)
-
-      if (targetMember) {
-        targets.push({
-          target: {
-            member_id: targetMember.id,
-            call_id: targetMember.callId!,
-            node_id: targetMember.nodeId!,
-          },
-          position: value,
-        })
-      }
-    })
-
-    if (!targets.length) {
-      throw new Error('Invalid targets')
-    }
-
-    return this.execute({
-      method: 'call.member.position.set',
-      params: {
-        self: {
-          member_id: this.selfMember?.id,
-          call_id: this.selfMember?.callId,
-          node_id: this.selfMember?.nodeId,
-        },
-        targets,
-      },
-    })
-  }
-
-  public async lock() {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.lock',
-    })
-  }
-
-  public async unlock() {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.unlock',
-    })
-  }
-
-  public async setAudioFlags(params: SetAudioFlagsParams) {
-    const { memberId, ...rest } = params
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.audioflags.set',
-      memberId,
-      extraParams: toSnakeCaseKeys(rest),
-    })
-  }
-
-  public async end(params?: MemberCommandParams) {
-    return this.executeAction<BaseRPCResult>({
-      method: 'call.end',
-      memberId: params?.memberId,
-    })
-  }
-}
-
-export const isFabricRoomSession = (
-  room: unknown
-): room is FabricRoomSession => {
-  return room instanceof FabricRoomSessionConnection
-}
-
-/** @internal */
-export const createFabricRoomSessionObject = (
-  params: FabricRoomSessionOptions
-): FabricRoomSession => {
-  const room = connect<
-    FabricRoomSessionEvents,
-    FabricRoomSessionConnection,
-    FabricRoomSession
-  >({
-    store: params.store,
-    Component: FabricRoomSessionConnection,
-  })(params)
-
-  return createFabricRoomSessionValidateProxy(room)
-}

package/src/fabric/FabricRoomSessionMember.ts

@@ -1,188 +0,0 @@
-import {
-  FabricMemberEventNames,
-  FabricMemberEventParams,
-  FabricMemberEventParamsExcludeTalking,
-  FabricMemberJoinedEventParams,
-  FabricMemberLeftEventParams,
-  FabricMemberTalkingEventParams,
-  FabricMemberUpdatedEventParams,
-  FabricMemberContract,
-  connect,
-  MemberJoined,
-  MemberLeft,
-  MemberTalking,
-  MemberUpdated,
-  BaseComponentOptionsWithPayload,
-  BaseComponent,
-} from '@signalwire/core'
-
-export interface FabricRoomSessionMember extends FabricMemberContract {
-  /** Unique id of this member. */
-  id: string
-  setPayload(payload: FabricMemberEventParams): void
-}
-
-// TODO: Fabric Room Session Member instance does not emit any events yet
-export type FabricRoomSessionMemberEventsHandlerMap = Record<
-  MemberJoined,
-  (params: FabricMemberJoinedEventParams) => void
-> &
-  Record<MemberUpdated, (params: FabricMemberUpdatedEventParams) => void> &
-  Record<MemberLeft, (params: FabricMemberLeftEventParams) => void> &
-  Record<MemberTalking, (params: FabricMemberTalkingEventParams) => void> &
-  Record<
-    Exclude<FabricMemberEventNames, MemberJoined | MemberLeft | MemberTalking>,
-    (params: FabricMemberUpdatedEventParams) => void
-  >
-
-export type FabricRoomSessionMemberEvents = {
-  [k in keyof FabricRoomSessionMemberEventsHandlerMap]: FabricRoomSessionMemberEventsHandlerMap[k]
-}
-
-export interface FabricRoomSessionMemberOptions
-  extends BaseComponentOptionsWithPayload<FabricMemberEventParamsExcludeTalking> {}
-
-export class FabricRoomSessionMemberAPI
-  extends BaseComponent<FabricRoomSessionMemberEvents>
-  implements FabricMemberContract
-{
-  private _payload: FabricMemberEventParamsExcludeTalking
-
-  constructor(options: FabricRoomSessionMemberOptions) {
-    super(options)
-    this._payload = options.payload
-  }
-
-  get id() {
-    return this._payload.member.member_id
-  }
-
-  get callId() {
-    return this._payload.member.call_id
-  }
-
-  get nodeId() {
-    return this._payload.member.node_id
-  }
-
-  get memberId() {
-    return this.id
-  }
-
-  get roomSessionId() {
-    return this._payload.room_session_id
-  }
-
-  get roomId() {
-    return this._payload.room_id
-  }
-
-  get parentId() {
-    return this._payload.member.parent_id
-  }
-
-  get subscriberId() {
-    return this._payload.member.subscriber_id
-  }
-
-  get addressId() {
-    return this._payload.member.address_id
-  }
-
-  get name() {
-    return this._payload.member.name
-  }
-
-  get type() {
-    return this._payload.member.type
-  }
-
-  get requestedPosition() {
-    return this._payload.member.requested_position
-  }
-
-  get currentPosition() {
-    return this._payload.member.current_position
-  }
-
-  get meta() {
-    return this._payload.member.meta
-  }
-
-  get handraised() {
-    return this._payload.member.handraised
-  }
-
-  get talking() {
-    return this._payload.member.talking
-  }
-
-  get audioMuted() {
-    return this._payload.member.audio_muted
-  }
-
-  get videoMuted() {
-    return this._payload.member.video_muted
-  }
-
-  get deaf() {
-    return this._payload.member.deaf
-  }
-
-  get visible() {
-    return this._payload.member.visible
-  }
-
-  get inputVolume() {
-    return this._payload.member.input_volume
-  }
-
-  get outputVolume() {
-    return this._payload.member.output_volume
-  }
-
-  get inputSensitivity() {
-    return this._payload.member.input_sensitivity
-  }
-
-  get echoCancellation() {
-    return this._payload.member.echo_cancellation
-  }
-
-  get autoGain() {
-    return this._payload.member.auto_gain
-  }
-
-  get noiseSuppression() {
-    return this._payload.member.noise_suppression
-  }
-
-  /** @internal */
-  setPayload(payload: FabricMemberEventParams) {
-    // Reshape the payload since the `member.talking` event does not return all the parameters of a member
-    const newPayload = {
-      ...this._payload,
-      ...payload,
-      member: {
-        ...this._payload.member,
-        ...payload.member,
-      },
-    }
-    this._payload = newPayload
-  }
-}
-
-export const createFabricRoomSessionMemberObject = (
-  params: FabricRoomSessionMemberOptions
-): FabricRoomSessionMember => {
-  const member = connect<
-    FabricRoomSessionMemberEventsHandlerMap,
-    FabricRoomSessionMemberAPI,
-    FabricRoomSessionMember
-  >({
-    store: params.store,
-    Component: FabricRoomSessionMemberAPI,
-  })(params)
-
-  return member
-}

package/src/fabric/HTTPClient.test.ts

@@ -1,28 +0,0 @@
-import { HTTPClient } from './HTTPClient'
-
-describe('HTTPClient', () => {
-  it('should return the host value from the token ch header', () => {
-    const client = new HTTPClient({
-      token:
-        'eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwiY2giOiJwdWMuc3dpcmUuaW8iLCJ0eXAiOiJTQVQifQ..WI4IT6Bny7lfcU8-.lV5QlKfnONM-5FGwmkllyv747du_UB2nLGqGz3WcB4jemGjofhCzLDhJIiMzp7_xtVjHkV-K2DxiiftxWEgwo3cMn3Eo8ICqA0tZ227tGVEuOztOopsmM3CAMUDej5aovPyznw6grkQ3e7VbzwByDFxs0rS9__c1_bZrAHET1PE8AmigjN35ggY2axEHhSpo7P-vtS321Nv4qURQIococCkWhcUIr0NIbOzTDMJqGLfP2AWSFOtVd9tuyamGMZ0tSUC-JICaS-A4-JdHpKLHbaRn6XTyYj0CKeW1DdrI7uvcglVVN2ooLyWAtv__1MnGdnBoDuXKgzqd2JuiCcN3oIYLt9I3bEu2PWPu1nxumP1aJpk6VXrci0x_nRamRtr9zjVsjzK3RdhYY5Gi1q6Pf1UZvNAPv1-hF1vgthG_QLs-T76HCRm6AN0r_wS97xvBAFbSZ5rCbUR2_1fMG4YOz8dfrlF19WIzY7zaAhMhXiuX.AMbl6Ha3VmKkD40vuz3q6Q',
-    })
-    expect(client.httpHost).toEqual('fabric.swire.io')
-  })
-
-  it('should return the host value from the host option', () => {
-    const client = new HTTPClient({
-      host: 'server.custom.io',
-      token:
-        'eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwiY2giOiJwdWMuc3dpcmUuaW8iLCJ0eXAiOiJTQVQifQ..WI4IT6Bny7lfcU8-.lV5QlKfnONM-5FGwmkllyv747du_UB2nLGqGz3WcB4jemGjofhCzLDhJIiMzp7_xtVjHkV-K2DxiiftxWEgwo3cMn3Eo8ICqA0tZ227tGVEuOztOopsmM3CAMUDej5aovPyznw6grkQ3e7VbzwByDFxs0rS9__c1_bZrAHET1PE8AmigjN35ggY2axEHhSpo7P-vtS321Nv4qURQIococCkWhcUIr0NIbOzTDMJqGLfP2AWSFOtVd9tuyamGMZ0tSUC-JICaS-A4-JdHpKLHbaRn6XTyYj0CKeW1DdrI7uvcglVVN2ooLyWAtv__1MnGdnBoDuXKgzqd2JuiCcN3oIYLt9I3bEu2PWPu1nxumP1aJpk6VXrci0x_nRamRtr9zjVsjzK3RdhYY5Gi1q6Pf1UZvNAPv1-hF1vgthG_QLs-T76HCRm6AN0r_wS97xvBAFbSZ5rCbUR2_1fMG4YOz8dfrlF19WIzY7zaAhMhXiuX.AMbl6Ha3VmKkD40vuz3q6Q',
-    })
-    expect(client.httpHost).toEqual('fabric.custom.io')
-  })
-
-  it('should base the host value from default value', () => {
-    const client = new HTTPClient({
-      token:
-        'eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwidHlwIjoiU0FUIn0..HV7ITWNVgpVAXymg.7SchDC_tOtLy860sMcSpLhBjN1oBHU8ImVc6sZJBGSyDSflZoGi4sVogyK47R9sNaWS0zNBKZFBNfoFE3AeHZTIgcMgYZqS3kUsdLxZv6dNuHvO_pXOJns5OWf2B5MSHyQrNrVv-WDAaFTo2q4AIHitn5o05SEEoEB8zz52BCfFb9NmuN5MpQHH9GZBcBpRAc-fbKLgG17GqYIpRfoGCgzpvcWOCa_Auwfz9WUdSvjEcO6ZDkOsUJVx6N5oA003gwbdWtX4gMU-lBWKSmkN8o6XTPjfn5wV9X5stdA_A_n4K2qW6gtySdxBZMoP3SrY-t0VKDE00l8Yoy7-e8sV7YH4dXSPfMxvEmhYcHiQIF9je5Urwgy6dwMCVi9KaSCBniHeD9-LK--E2gXeCPCFTN5dpvOtyYidXSRAJbeeGM_iaDnphV9-10dpAMtWcFxtxOxZzzpCgG_w30r6_6wMvGNXrIY0NFgQy1w1371s3mmZs.8uiq7Gl0W4YQHYniuBetoA',
-    })
-    expect(client.httpHost).toEqual('fabric.signalwire.com')
-  })
-})