Add alias 'topics' for 'contexts'

.changeset/fresh-steaks-join.md

@@ -0,0 +1,6 @@
+---
+'@signalwire/realtime-api': minor
+'@signalwire/core': minor
+---
+
+Add alias 'topics' for 'contexts'

internal/e2e-realtime-api/src/voice.test.ts

@@ -8,7 +8,7 @@ const handler = () => {
       host: process.env.RELAY_HOST || 'relay.swire.io',
       project: process.env.RELAY_PROJECT as string,
       token: process.env.RELAY_TOKEN as string,
-      contexts: [process.env.VOICE_CONTEXT as string],
+      topics: [process.env.VOICE_CONTEXT as string],
       // logLevel: "trace",
       debug: {
         logWsTraffic: true,

packages/core/src/BaseSession.ts

@@ -348,7 +348,9 @@ export class BaseSession {
     if (this._relayProtocolIsValid()) {
       params.protocol = this.relayProtocol
     }
-    if (this.options.contexts?.length) {
+    if (this.options.topics?.length) {
+      params.contexts = this.options.topics
+    } else if (this.options.contexts?.length) {
       params.contexts = this.options.contexts
     }
     this._rpcConnectResult = await this.execute(RPCConnect(params))

packages/core/src/RPCMessages/RPCConnect.ts

@@ -10,6 +10,7 @@ export type RPCConnectParams = {
   protocol?: string
   authorization_state?: string
   contexts?: string[]
+  topics?: string[]
 }
 
 export const DEFAULT_CONNECT_VERSION = {

packages/core/src/utils/interfaces.ts

@@ -97,6 +97,8 @@ export interface SessionOptions {
   token: string
   /** SignalWire contexts, e.g. 'home', 'office'.. */
   contexts?: string[]
+  /** An alias for contexts - Topics has more priority over contexts */
+  topics?: string[]
   // From `LogLevelDesc` of loglevel to simplify our docs
   /** logging level */
   logLevel?: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent'

packages/realtime-api/src/voice/VoiceClient.ts

@@ -7,10 +7,15 @@ interface VoiceClient extends Voice {
   new (opts: VoiceClientOptions): this
 }
 
-export interface VoiceClientOptions
-  extends Omit<UserOptions, '_onRefreshToken'> {
-  contexts: string[]
-}
+export type VoiceClientOptions = Omit<UserOptions, '_onRefreshToken'> &
+  (
+    | {
+        contexts: string[]
+      }
+    | {
+        topics: string[]
+      }
+  )
 
 /**
  * You can use instances of this class to initiate or receive calls. Please see

packages/realtime-api/src/voice/workers/voiceCallReceiveWorker.ts

@@ -14,8 +14,8 @@ export const voiceCallReceiveWorker = function* (
   } = options
 
   // Contexts is required
-  const { contexts = [] } = client?.options ?? {}
-  if (!contexts.length) {
+  const { contexts = [], topics = [] } = client?.options ?? {}
+  if (!contexts.length && !topics.length) {
     throw new Error('Invalid contexts to receive inbound calls')
   }