@stream-io/video-client 0.0.46 → 0.0.47

package/dist/src/coordinator/connection/client.d.ts

@@ -18,6 +18,7 @@ export declare class StreamClient {
     key: string;
     listeners: Record<string, Array<(event: StreamVideoEvent) => void>>;
     logger: Logger;
+    private locationHint;
     node: boolean;
     options: StreamClientOptions;
     secret?: string;
@@ -56,6 +57,7 @@ export declare class StreamClient {
     devToken: (userID: string) => string;
     getAuthType: () => "anonymous" | "jwt";
     setBaseURL: (baseURL: string) => void;
+    getLocationHint: (hintUrl?: string, timeout?: number) => Promise<string>;
     _getConnectionID: () => string | undefined;
     _hasConnectionID: () => boolean;
     /**

package/dist/src/coordinator/connection/location.d.ts

@@ -0,0 +1 @@
+export declare const getLocationHint: (hintUrl?: string, timeout?: number) => Promise<string>;

package/dist/src/coordinator/connection/types.d.ts

@@ -77,6 +77,14 @@ export type StreamClientOptions = Partial<AxiosRequestConfig> & {
     enableWSFallback?: boolean;
     logger?: Logger;
     logLevel?: LogLevel;
+    /**
+     * The URL to use for the location hint.
+     */
+    locationHintUrl?: string;
+    /**
+     * The default timeout for requesting a location hint.
+     */
+    locationHintTimeout?: number;
     /**
      * When true, user will be persisted on client. Otherwise if `connectUser` call fails, then you need to
      * call `connectUser` again to retry.

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "0.0.46";
+export declare const version = "0.0.47";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stream-io/video-client",
-  "version": "0.0.46",
+  "version": "0.0.47",
   "packageManager": "yarn@3.2.4",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",

package/src/coordinator/connection/client.ts

@@ -34,6 +34,7 @@ import {
 } from './types';
 import { InsightMetrics, postInsights } from './insights';
 import { version } from '../../../version';
+import { getLocationHint } from './location';
 
 export class StreamClient {
   _user?: UserWithId;
@@ -48,6 +49,8 @@ export class StreamClient {
   listeners: Record<string, Array<(event: StreamVideoEvent) => void>>;
   logger: Logger;
 
+  private locationHint: Promise<string> | undefined;
+
   node: boolean;
   options: StreamClientOptions;
   secret?: string;
@@ -101,6 +104,13 @@ export class StreamClient {
     this.browser = inputOptions.browser || typeof window !== 'undefined';
     this.node = !this.browser;
 
+    if (this.browser) {
+      this.locationHint = getLocationHint(
+        options?.locationHintUrl,
+        options?.locationHintTimeout,
+      );
+    }
+
     this.options = {
       timeout: 5000,
       withCredentials: false, // making sure cookies are not sent
@@ -178,6 +188,21 @@ export class StreamClient {
       .replace(':3030', ':8800');
   };
 
+  getLocationHint = async (
+    hintUrl?: string,
+    timeout?: number,
+  ): Promise<string> => {
+    const hint = await this.locationHint;
+    if (!hint || hint === 'ERR') {
+      this.locationHint = getLocationHint(
+        hintUrl ?? this.options.locationHintUrl,
+        timeout ?? this.options.locationHintTimeout,
+      );
+      return this.locationHint;
+    }
+    return hint;
+  };
+
   _getConnectionID = () =>
     this.wsConnection?.connectionID || this.wsFallback?.connectionID;
 

package/src/coordinator/connection/location.ts

@@ -0,0 +1,26 @@
+import { getLogger } from '../../logger';
+
+const logger = getLogger(['location']);
+const HINT_URL = `https://hint.stream-io-video.com/`;
+
+export const getLocationHint = async (
+  hintUrl: string = HINT_URL,
+  timeout: number = 1500,
+) => {
+  const abortController = new AbortController();
+  const timeoutId = setTimeout(() => abortController.abort(), timeout);
+  try {
+    const response = await fetch(HINT_URL, {
+      method: 'HEAD',
+      signal: abortController.signal,
+    });
+    const awsPop = response.headers.get('x-amz-cf-pop') || 'ERR';
+    logger('debug', `Location header: ${awsPop}`);
+    return awsPop.substring(0, 3); // AMS1-P2 -> AMS
+  } catch (e) {
+    logger('error', `Failed to get location hint from ${HINT_URL}`, e);
+    return 'ERR';
+  } finally {
+    clearTimeout(timeoutId);
+  }
+};

package/src/coordinator/connection/types.ts

@@ -102,6 +102,14 @@ export type StreamClientOptions = Partial<AxiosRequestConfig> & {
   enableWSFallback?: boolean;
   logger?: Logger;
   logLevel?: LogLevel;
+  /**
+   * The URL to use for the location hint.
+   */
+  locationHintUrl?: string;
+  /**
+   * The default timeout for requesting a location hint.
+   */
+  locationHintTimeout?: number;
   /**
    * When true, user will be persisted on client. Otherwise if `connectUser` call fails, then you need to
    * call `connectUser` again to retry.

package/src/rtc/flows/join.ts

@@ -10,7 +10,6 @@ import {
   StreamVideoParticipant,
 } from '../../types';
 import { StreamClient } from '../../coordinator/connection/client';
-import { getLogger } from '../../logger';
 
 /**
  * Collects all necessary information to join a call, talks to the coordinator
@@ -45,7 +44,7 @@ const doJoin = async (
   id: string,
   data?: JoinCallData,
 ) => {
-  const location = await getLocationHint();
+  const location = await httpClient.getLocationHint();
   const request: JoinCallRequest = {
     ...data,
     location,
@@ -75,27 +74,6 @@ const doJoin = async (
   );
 };
 
-const getLocationHint = async () => {
-  const hintURL = `https://hint.stream-io-video.com/`;
-  const abortController = new AbortController();
-  const timeoutId = setTimeout(() => abortController.abort(), 1000);
-  const logger = getLogger(['call']);
-  try {
-    const response = await fetch(hintURL, {
-      method: 'HEAD',
-      signal: abortController.signal,
-    });
-    const awsPop = response.headers.get('x-amz-cf-pop') || 'ERR';
-    logger?.('info', `Location header: ${awsPop}`);
-    return awsPop.substring(0, 3); // AMS1-P2 -> AMS
-  } catch (e) {
-    logger?.('error', `Failed to get location hint from ${hintURL}`, e);
-    return 'ERR';
-  } finally {
-    clearTimeout(timeoutId);
-  }
-};
-
 const toRtcConfiguration = (config?: ICEServer[]) => {
   if (!config || config.length === 0) return undefined;
   const rtcConfig: RTCConfiguration = {