Add clone deep

.changeset/cuddly-colts-perform.md

@@ -0,0 +1,5 @@
+---
+"livekit-client": patch
+---
+
+Use a deepClone util function for CreateLocalTrackOptions

src/room/track/utils.ts

@@ -1,3 +1,4 @@
+import { cloneDeep } from '../../utils/cloneDeep';
 import { isSafari, sleep } from '../utils';
 import { Track } from './Track';
 import type {
@@ -13,9 +14,7 @@ export function mergeDefaultOptions(
   audioDefaults?: AudioCaptureOptions,
   videoDefaults?: VideoCaptureOptions,
 ): CreateLocalTracksOptions {
-  const opts: CreateLocalTracksOptions = {
-    ...options,
-  };
+  const opts: CreateLocalTracksOptions = cloneDeep(options) ?? {};
   if (opts.audio === true) opts.audio = {};
   if (opts.video === true) opts.video = {};
 

src/utils/cloneDeep.test.ts

@@ -0,0 +1,54 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { cloneDeep } from './cloneDeep';
+
+describe('cloneDeep', () => {
+  beforeEach(() => {
+    global.structuredClone = vi.fn((val) => {
+      return JSON.parse(JSON.stringify(val));
+    });
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('should clone a simple object', () => {
+    const structuredCloneSpy = vi.spyOn(global, 'structuredClone');
+
+    const original = { name: 'John', age: 30 };
+    const cloned = cloneDeep(original);
+
+    expect(cloned).toEqual(original);
+    expect(cloned).not.toBe(original);
+    expect(structuredCloneSpy).toHaveBeenCalledTimes(1);
+  });
+
+  it('should clone an object with nested properties', () => {
+    const structuredCloneSpy = vi.spyOn(global, 'structuredClone');
+
+    const original = { name: 'John', age: 30, children: [{ name: 'Mark', age: 7 }] };
+    const cloned = cloneDeep(original);
+
+    expect(cloned).toEqual(original);
+    expect(cloned).not.toBe(original);
+    expect(cloned?.children).not.toBe(original.children);
+    expect(structuredCloneSpy).toHaveBeenCalledTimes(1);
+  });
+
+  it('should use JSON namespace as a fallback', () => {
+    const structuredCloneSpy = vi.spyOn(global, 'structuredClone');
+    const serializeSpy = vi.spyOn(JSON, 'stringify');
+    const deserializeSpy = vi.spyOn(JSON, 'parse');
+
+    global.structuredClone = undefined as any;
+
+    const original = { name: 'John', age: 30 };
+    const cloned = cloneDeep(original);
+
+    expect(cloned).toEqual(original);
+    expect(cloned).not.toBe(original);
+    expect(structuredCloneSpy).not.toHaveBeenCalled();
+    expect(serializeSpy).toHaveBeenCalledTimes(1);
+    expect(deserializeSpy).toHaveBeenCalledTimes(1);
+  });
+});

src/utils/cloneDeep.ts

@@ -0,0 +1,11 @@
+export function cloneDeep<T>(value: T) {
+  if (typeof value === 'undefined') {
+    return;
+  }
+
+  if (typeof structuredClone === 'function') {
+    return structuredClone(value);
+  } else {
+    return JSON.parse(JSON.stringify(value)) as T;
+  }
+}