@spatialwalk/avatarkit-rtc 1.0.0-beta.8 → 1.0.0-beta.9

package/dist/index15.js

@@ -1,4 +1,4 @@
-const jsContent = 'const VP8_FRAME_HEADER_SIZE = 10;\nconst METADATA_FIXED_HEADER_SIZE = 5;\nconst PACKET_FLAG_IDLE = 1;\nconst PACKET_FLAG_START = 2;\nconst PACKET_FLAG_END = 4;\nconst PACKET_FLAG_GZIPPED = 8;\nconst PACKET_FLAG_TRANSITION = 16;\nconst PACKET_FLAG_TRANSITION_END = 32;\nconst PACKET_FLAG_REDUNDANT = 64;\nlet receiverMetaCount = 0;\nlet lastLogTime = 0;\nlet totalFrames = 0;\nlet framesWithMeta = 0;\nlet wasIdle = false;\nlet isInStartTransition = false;\nlet isInEndTransition = false;\nlet lastReceivedTimestamp = null;\nlet framesRecovered = 0;\nlet framesLost = 0;\nconst EXPECTED_TIMESTAMP_INCREMENT = 3600;\nlet lastRenderedSeq = -1;\nlet framesOutOfOrder = 0;\nlet framesDuplicate = 0;\nlet framesDropped = 0;\nlet framesSent = 0;\nfunction parseMetadataHeader(data) {\n  if (data.byteLength < METADATA_FIXED_HEADER_SIZE) return null;\n  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n  const flags = data[0];\n  const msgLen = view.getUint32(1, true);\n  const headerSize = METADATA_FIXED_HEADER_SIZE + msgLen;\n  if (data.byteLength < headerSize) return null;\n  const compressedData = data.slice(METADATA_FIXED_HEADER_SIZE, METADATA_FIXED_HEADER_SIZE + msgLen);\n  const hasRedundant = (flags & PACKET_FLAG_REDUNDANT) !== 0;\n  return {\n    meta: {\n      flags,\n      protobufLength: msgLen,\n      protobufData: compressedData,\n      // This is still compressed at this point\n      hasRedundant,\n      redundantLength: 0,\n      // Will be determined after decompression\n      redundantData: null\n      // Will be extracted after decompression\n    },\n    headerSize\n  };\n}\nfunction isIdlePacket(flags) {\n  return (flags & PACKET_FLAG_IDLE) !== 0;\n}\nfunction isStartPacket(flags) {\n  return (flags & PACKET_FLAG_START) !== 0;\n}\nfunction isEndPacket(flags) {\n  return (flags & PACKET_FLAG_END) !== 0;\n}\nfunction isGzipped(flags) {\n  return (flags & PACKET_FLAG_GZIPPED) !== 0;\n}\nfunction isTransitionPacket(flags) {\n  return (flags & PACKET_FLAG_TRANSITION) !== 0;\n}\nfunction isTransitionEndPacket(flags) {\n  return (flags & PACKET_FLAG_TRANSITION_END) !== 0;\n}\nasync function decompressGzip(data) {\n  const ds = new DecompressionStream("gzip");\n  const writer = ds.writable.getWriter();\n  const copy = new Uint8Array(data);\n  writer.write(copy);\n  writer.close();\n  const reader = ds.readable.getReader();\n  const chunks = [];\n  let totalLength = 0;\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n    totalLength += value.length;\n  }\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.length;\n  }\n  return result;\n}\nlet totalCompressedBytes = 0;\nlet totalUncompressedBytes = 0;\nfunction parseALRPayload(decompressed, hasRedundant) {\n  if (decompressed.byteLength < 4) return null;\n  const view = new DataView(decompressed.buffer, decompressed.byteOffset, decompressed.byteLength);\n  let offset = 0;\n  const frameSeq = view.getUint32(offset, true);\n  offset += 4;\n  if (!hasRedundant) {\n    const currentData2 = decompressed.slice(offset);\n    return { frameSeq, currentData: currentData2, prev1Data: null, prev2Data: null };\n  }\n  if (decompressed.byteLength < offset + 4) return null;\n  const currentLen = view.getUint32(offset, true);\n  offset += 4;\n  if (decompressed.byteLength < offset + currentLen) return null;\n  const currentData = decompressed.slice(offset, offset + currentLen);\n  offset += currentLen;\n  let prev1Data = null;\n  if (decompressed.byteLength >= offset + 4) {\n    const prev1Len = view.getUint32(offset, true);\n    offset += 4;\n    if (prev1Len > 0 && decompressed.byteLength >= offset + prev1Len) {\n      prev1Data = decompressed.slice(offset, offset + prev1Len);\n      offset += prev1Len;\n    }\n  }\n  let prev2Data = null;\n  if (decompressed.byteLength >= offset + 4) {\n    const prev2Len = view.getUint32(offset, true);\n    offset += 4;\n    if (prev2Len > 0 && decompressed.byteLength >= offset + prev2Len) {\n      prev2Data = decompressed.slice(offset, offset + prev2Len);\n    }\n  }\n  return { frameSeq, currentData, prev1Data, prev2Data };\n}\nfunction sendAnimationToMainThread(protobufData, flags, frameSeq, isRecovered = false) {\n  const isIdle = isIdlePacket(flags);\n  const isStart = isStartPacket(flags);\n  const isEnd = isEndPacket(flags);\n  if (frameSeq <= lastRenderedSeq && lastRenderedSeq !== -1 && !isStart) {\n    if (frameSeq === lastRenderedSeq) {\n      framesDuplicate++;\n    } else {\n      framesOutOfOrder++;\n    }\n    return false;\n  }\n  if (lastRenderedSeq !== -1 && frameSeq > lastRenderedSeq + 1 && !isStart) {\n    const gap = frameSeq - lastRenderedSeq - 1;\n    framesDropped += gap;\n  }\n  framesSent++;\n  lastRenderedSeq = frameSeq;\n  const protobufBuffer = new ArrayBuffer(protobufData.byteLength);\n  new Uint8Array(protobufBuffer).set(protobufData);\n  self.postMessage({\n    type: "animation",\n    flags,\n    isIdle,\n    isStart,\n    isEnd,\n    isRecovered,\n    frameSeq,\n    protobufData: protobufBuffer\n  }, { transfer: [protobufBuffer] });\n  return true;\n}\nfunction receiverTransform(frame, _controller) {\n  totalFrames++;\n  const data = new Uint8Array(frame.data);\n  const currentTimestamp = frame.timestamp;\n  if (data.length <= VP8_FRAME_HEADER_SIZE) {\n    return;\n  }\n  const animData = data.subarray(VP8_FRAME_HEADER_SIZE);\n  const parsed = parseMetadataHeader(animData);\n  if (parsed) {\n    const { meta } = parsed;\n    framesWithMeta++;\n    receiverMetaCount++;\n    const isIdle = isIdlePacket(meta.flags);\n    const isStart = isStartPacket(meta.flags);\n    const isEnd = isEndPacket(meta.flags);\n    if (lastReceivedTimestamp !== null && !isIdle && !isStart) {\n      const timestampDelta = currentTimestamp - lastReceivedTimestamp;\n      if (timestampDelta > EXPECTED_TIMESTAMP_INCREMENT * 1.5) {\n        const missedFrames = Math.round(timestampDelta / EXPECTED_TIMESTAMP_INCREMENT) - 1;\n        framesLost += missedFrames;\n        if (meta.hasRedundant && isGzipped(meta.flags)) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n          decompressGzip(meta.protobufData).then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n            const parsed2 = parseALRPayload(decompressed, true);\n            if (parsed2) {\n              const currentSeq = parsed2.frameSeq;\n              const framesToRecover = [];\n              if (missedFrames >= 2 && parsed2.prev2Data) {\n                framesToRecover.push({ data: parsed2.prev2Data, seq: currentSeq - 2 });\n              }\n              if (missedFrames >= 1 && parsed2.prev1Data) {\n                framesToRecover.push({ data: parsed2.prev1Data, seq: currentSeq - 1 });\n              }\n              const recovered = framesToRecover.length;\n              if (recovered > 0) {\n                framesRecovered += recovered;\n                for (const frame2 of framesToRecover) {\n                  sendAnimationToMainThread(frame2.data, meta.flags & ~PACKET_FLAG_REDUNDANT, frame2.seq, true);\n                }\n              }\n              sendAnimationToMainThread(parsed2.currentData, meta.flags & ~PACKET_FLAG_REDUNDANT, currentSeq, false);\n            }\n          }).catch((err) => {\n            console.error(`[Animation Worker] ALR decompression error:`, err);\n          });\n          lastReceivedTimestamp = currentTimestamp;\n          return;\n        }\n      }\n    }\n    if (!isIdle) {\n      lastReceivedTimestamp = currentTimestamp;\n    }\n    if (isStart) {\n      lastReceivedTimestamp = currentTimestamp;\n      framesRecovered = 0;\n      framesLost = 0;\n      lastRenderedSeq = -1;\n      framesOutOfOrder = 0;\n      framesDuplicate = 0;\n      framesDropped = 0;\n      framesSent = 0;\n    }\n    const isTransition = isTransitionPacket(meta.flags);\n    const isTransitionEnd = isTransitionEndPacket(meta.flags);\n    if (isIdle) {\n      if (!wasIdle) {\n        self.postMessage({ type: "idleStart" });\n        wasIdle = true;\n      }\n      isInStartTransition = false;\n      isInEndTransition = false;\n    } else if (isTransition && meta.protobufLength > 0) {\n      wasIdle = false;\n      if (!isInStartTransition) {\n        isInStartTransition = true;\n        isInEndTransition = false;\n        const gzipped = isGzipped(meta.flags);\n        if (gzipped) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n          decompressGzip(meta.protobufData).then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n            const protobufBuffer = new ArrayBuffer(decompressed.byteLength);\n            new Uint8Array(protobufBuffer).set(decompressed);\n            self.postMessage({\n              type: "transition",\n              flags: meta.flags,\n              protobufData: protobufBuffer\n            }, { transfer: [protobufBuffer] });\n          }).catch((err) => {\n            console.error(`[Animation Worker] Gzip decompress error (transition):`, err);\n          });\n        } else {\n          const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n          new Uint8Array(protobufBuffer).set(meta.protobufData);\n          self.postMessage({\n            type: "transition",\n            flags: meta.flags,\n            protobufData: protobufBuffer\n          }, { transfer: [protobufBuffer] });\n        }\n      }\n    } else if (isTransitionEnd && meta.protobufLength > 0) {\n      if (!isInEndTransition) {\n        isInEndTransition = true;\n        isInStartTransition = false;\n        const gzipped = isGzipped(meta.flags);\n        if (gzipped) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n          decompressGzip(meta.protobufData).then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n            const protobufBuffer = new ArrayBuffer(decompressed.byteLength);\n            new Uint8Array(protobufBuffer).set(decompressed);\n            self.postMessage({\n              type: "transitionEnd",\n              flags: meta.flags,\n              protobufData: protobufBuffer\n            }, { transfer: [protobufBuffer] });\n          }).catch((err) => {\n            console.error(`[Animation Worker] Gzip decompress error (transitionEnd):`, err);\n          });\n        } else {\n          const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n          new Uint8Array(protobufBuffer).set(meta.protobufData);\n          self.postMessage({\n            type: "transitionEnd",\n            flags: meta.flags,\n            protobufData: protobufBuffer\n          }, { transfer: [protobufBuffer] });\n        }\n      }\n    } else if (meta.protobufLength > 0) {\n      if (wasIdle) {\n        wasIdle = false;\n      }\n      isInStartTransition = false;\n      isInEndTransition = false;\n      const gzipped = isGzipped(meta.flags);\n      if (gzipped) {\n        totalCompressedBytes += meta.protobufData.byteLength;\n        decompressGzip(meta.protobufData).then((decompressed) => {\n          totalUncompressedBytes += decompressed.byteLength;\n          const parsed2 = parseALRPayload(decompressed, meta.hasRedundant);\n          if (parsed2) {\n            sendAnimationToMainThread(parsed2.currentData, meta.flags & ~PACKET_FLAG_REDUNDANT, parsed2.frameSeq, false);\n          }\n        }).catch(() => {\n        });\n      } else {\n        const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n        new Uint8Array(protobufBuffer).set(meta.protobufData);\n        self.postMessage({\n          type: "animation",\n          flags: meta.flags,\n          isIdle: false,\n          isStart,\n          isEnd,\n          frameSeq: -1,\n          // Unknown sequence\n          protobufData: protobufBuffer\n        }, { transfer: [protobufBuffer] });\n      }\n    }\n    const now = performance.now();\n    if (now - lastLogTime > 1e3) {\n      lastLogTime = now;\n      self.postMessage({\n        type: "metadata",\n        protobufLength: meta.protobufLength,\n        framesPerSec: receiverMetaCount,\n        totalFrames,\n        framesWithMeta,\n        framesLost,\n        framesRecovered,\n        framesOutOfOrder,\n        framesDuplicate,\n        framesDropped,\n        framesSent,\n        lastRenderedSeq\n      });\n      receiverMetaCount = 0;\n    }\n  }\n}\nself.onrtctransform = (event) => {\n  const transformer = event.transformer;\n  const options = transformer.options;\n  try {\n    if (options.operation === "receiver") {\n      receiverMetaCount = 0;\n      lastLogTime = 0;\n      totalFrames = 0;\n      framesWithMeta = 0;\n      wasIdle = false;\n      isInStartTransition = false;\n      isInEndTransition = false;\n      lastReceivedTimestamp = null;\n      framesRecovered = 0;\n      framesLost = 0;\n      lastRenderedSeq = -1;\n      framesOutOfOrder = 0;\n      framesDuplicate = 0;\n      framesDropped = 0;\n      framesSent = 0;\n      transformer.readable.pipeThrough(new TransformStream({ transform: receiverTransform })).pipeTo(transformer.writable).catch((err) => {\n        console.error("[Animation Worker] Pipeline error:", err);\n        self.postMessage({ type: "error", error: `Animation receiver pipe error: ${err}` });\n      });\n      self.postMessage({ type: "ready", operation: "receiver" });\n    }\n  } catch (err) {\n    console.error("[Animation Worker] Setup error:", err);\n    self.postMessage({ type: "error", error: `Animation transform setup error: ${err}` });\n  }\n};\nself.onmessage = (event) => {\n  const { type } = event.data;\n  if (type === "init") {\n    self.postMessage({ type: "initialized" });\n  }\n};\n//# sourceMappingURL=animation-worker-CdhDm7lL.js.map\n';
+const jsContent = 'const VP8_FRAME_HEADER_SIZE = 10;\nconst METADATA_FIXED_HEADER_SIZE = 5;\nconst PACKET_FLAG_IDLE = 1;\nconst PACKET_FLAG_START = 2;\nconst PACKET_FLAG_END = 4;\nconst PACKET_FLAG_GZIPPED = 8;\nconst PACKET_FLAG_TRANSITION = 16;\nconst PACKET_FLAG_TRANSITION_END = 32;\nconst PACKET_FLAG_REDUNDANT = 64;\nlet receiverMetaCount = 0;\nlet lastLogTime = 0;\nlet totalFrames = 0;\nlet framesWithMeta = 0;\nlet wasIdle = false;\nlet isInStartTransition = false;\nlet isInEndTransition = false;\nlet lastReceivedTimestamp = null;\nlet framesRecovered = 0;\nlet framesLost = 0;\nconst EXPECTED_TIMESTAMP_INCREMENT = 3600;\nlet lastRenderedSeq = -1;\nlet framesOutOfOrder = 0;\nlet framesDuplicate = 0;\nlet framesDropped = 0;\nlet framesSent = 0;\nfunction parseMetadataHeader(data) {\n  if (data.byteLength < METADATA_FIXED_HEADER_SIZE) return null;\n  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n  const flags = data[0];\n  const msgLen = view.getUint32(1, true);\n  const headerSize = METADATA_FIXED_HEADER_SIZE + msgLen;\n  if (data.byteLength < headerSize) return null;\n  const compressedData = data.slice(\n    METADATA_FIXED_HEADER_SIZE,\n    METADATA_FIXED_HEADER_SIZE + msgLen\n  );\n  const hasRedundant = (flags & PACKET_FLAG_REDUNDANT) !== 0;\n  return {\n    meta: {\n      flags,\n      protobufLength: msgLen,\n      protobufData: compressedData,\n      // This is still compressed at this point\n      hasRedundant,\n      redundantLength: 0,\n      // Will be determined after decompression\n      redundantData: null\n      // Will be extracted after decompression\n    },\n    headerSize\n  };\n}\nfunction isIdlePacket(flags) {\n  return (flags & PACKET_FLAG_IDLE) !== 0;\n}\nfunction isStartPacket(flags) {\n  return (flags & PACKET_FLAG_START) !== 0;\n}\nfunction isEndPacket(flags) {\n  return (flags & PACKET_FLAG_END) !== 0;\n}\nfunction isGzipped(flags) {\n  return (flags & PACKET_FLAG_GZIPPED) !== 0;\n}\nfunction isTransitionPacket(flags) {\n  return (flags & PACKET_FLAG_TRANSITION) !== 0;\n}\nfunction isTransitionEndPacket(flags) {\n  return (flags & PACKET_FLAG_TRANSITION_END) !== 0;\n}\nasync function decompressGzip(data) {\n  const ds = new DecompressionStream("gzip");\n  const writer = ds.writable.getWriter();\n  const copy = new Uint8Array(data);\n  writer.write(copy);\n  writer.close();\n  const reader = ds.readable.getReader();\n  const chunks = [];\n  let totalLength = 0;\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n    totalLength += value.length;\n  }\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.length;\n  }\n  return result;\n}\nlet totalCompressedBytes = 0;\nlet totalUncompressedBytes = 0;\nfunction parseALRPayload(decompressed, hasRedundant) {\n  if (decompressed.byteLength < 4) return null;\n  const view = new DataView(\n    decompressed.buffer,\n    decompressed.byteOffset,\n    decompressed.byteLength\n  );\n  let offset = 0;\n  const frameSeq = view.getUint32(offset, true);\n  offset += 4;\n  if (!hasRedundant) {\n    const currentData2 = decompressed.slice(offset);\n    return { frameSeq, currentData: currentData2, prev1Data: null, prev2Data: null };\n  }\n  if (decompressed.byteLength < offset + 4) return null;\n  const currentLen = view.getUint32(offset, true);\n  offset += 4;\n  if (decompressed.byteLength < offset + currentLen) return null;\n  const currentData = decompressed.slice(offset, offset + currentLen);\n  offset += currentLen;\n  let prev1Data = null;\n  if (decompressed.byteLength >= offset + 4) {\n    const prev1Len = view.getUint32(offset, true);\n    offset += 4;\n    if (prev1Len > 0 && decompressed.byteLength >= offset + prev1Len) {\n      prev1Data = decompressed.slice(offset, offset + prev1Len);\n      offset += prev1Len;\n    }\n  }\n  let prev2Data = null;\n  if (decompressed.byteLength >= offset + 4) {\n    const prev2Len = view.getUint32(offset, true);\n    offset += 4;\n    if (prev2Len > 0 && decompressed.byteLength >= offset + prev2Len) {\n      prev2Data = decompressed.slice(offset, offset + prev2Len);\n    }\n  }\n  return { frameSeq, currentData, prev1Data, prev2Data };\n}\nfunction sendAnimationToMainThread(protobufData, flags, frameSeq, isRecovered = false) {\n  const isIdle = isIdlePacket(flags);\n  const isStart = isStartPacket(flags);\n  const isEnd = isEndPacket(flags);\n  if (frameSeq <= lastRenderedSeq && lastRenderedSeq !== -1 && !isStart) {\n    if (frameSeq === lastRenderedSeq) {\n      framesDuplicate++;\n    } else {\n      framesOutOfOrder++;\n    }\n    return false;\n  }\n  if (lastRenderedSeq !== -1 && frameSeq > lastRenderedSeq + 1 && !isStart) {\n    const gap = frameSeq - lastRenderedSeq - 1;\n    framesDropped += gap;\n  }\n  framesSent++;\n  lastRenderedSeq = frameSeq;\n  const protobufBuffer = new ArrayBuffer(protobufData.byteLength);\n  new Uint8Array(protobufBuffer).set(protobufData);\n  self.postMessage(\n    {\n      type: "animation",\n      flags,\n      isIdle,\n      isStart,\n      isEnd,\n      isRecovered,\n      frameSeq,\n      protobufData: protobufBuffer\n    },\n    { transfer: [protobufBuffer] }\n  );\n  return true;\n}\nfunction receiverTransform(frame, _controller) {\n  totalFrames++;\n  const data = new Uint8Array(frame.data);\n  const currentTimestamp = frame.timestamp;\n  if (data.length <= VP8_FRAME_HEADER_SIZE) {\n    return;\n  }\n  const animData = data.subarray(VP8_FRAME_HEADER_SIZE);\n  const parsed = parseMetadataHeader(animData);\n  if (parsed) {\n    const { meta } = parsed;\n    framesWithMeta++;\n    receiverMetaCount++;\n    const isIdle = isIdlePacket(meta.flags);\n    const isStart = isStartPacket(meta.flags);\n    const isEnd = isEndPacket(meta.flags);\n    if (lastReceivedTimestamp !== null && !isIdle && !isStart) {\n      const timestampDelta = currentTimestamp - lastReceivedTimestamp;\n      if (timestampDelta > EXPECTED_TIMESTAMP_INCREMENT * 1.5) {\n        const missedFrames = Math.round(timestampDelta / EXPECTED_TIMESTAMP_INCREMENT) - 1;\n        framesLost += missedFrames;\n        if (meta.hasRedundant && isGzipped(meta.flags)) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n          decompressGzip(meta.protobufData).then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n            const parsed2 = parseALRPayload(decompressed, true);\n            if (parsed2) {\n              const currentSeq = parsed2.frameSeq;\n              const framesToRecover = [];\n              if (missedFrames >= 2 && parsed2.prev2Data) {\n                framesToRecover.push({\n                  data: parsed2.prev2Data,\n                  seq: currentSeq - 2\n                });\n              }\n              if (missedFrames >= 1 && parsed2.prev1Data) {\n                framesToRecover.push({\n                  data: parsed2.prev1Data,\n                  seq: currentSeq - 1\n                });\n              }\n              const recovered = framesToRecover.length;\n              if (recovered > 0) {\n                framesRecovered += recovered;\n                for (const frame2 of framesToRecover) {\n                  sendAnimationToMainThread(\n                    frame2.data,\n                    meta.flags & ~PACKET_FLAG_REDUNDANT,\n                    frame2.seq,\n                    true\n                  );\n                }\n              }\n              sendAnimationToMainThread(\n                parsed2.currentData,\n                meta.flags & ~PACKET_FLAG_REDUNDANT,\n                currentSeq,\n                false\n              );\n            }\n          }).catch((err) => {\n            console.error(`[Animation Worker] ALR decompression error:`, err);\n          });\n          lastReceivedTimestamp = currentTimestamp;\n          return;\n        }\n      }\n    }\n    if (!isIdle) {\n      lastReceivedTimestamp = currentTimestamp;\n    }\n    if (isStart) {\n      lastReceivedTimestamp = currentTimestamp;\n      framesRecovered = 0;\n      framesLost = 0;\n      lastRenderedSeq = -1;\n      framesOutOfOrder = 0;\n      framesDuplicate = 0;\n      framesDropped = 0;\n      framesSent = 0;\n    }\n    const isTransition = isTransitionPacket(meta.flags);\n    const isTransitionEnd = isTransitionEndPacket(meta.flags);\n    if (isIdle) {\n      if (!wasIdle) {\n        self.postMessage({ type: "idleStart" });\n        wasIdle = true;\n      }\n      isInStartTransition = false;\n      isInEndTransition = false;\n    } else if (isTransition && meta.protobufLength > 0) {\n      wasIdle = false;\n      if (!isInStartTransition) {\n        isInStartTransition = true;\n        isInEndTransition = false;\n        const gzipped = isGzipped(meta.flags);\n        if (gzipped) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n          decompressGzip(meta.protobufData).then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n            const protobufBuffer = new ArrayBuffer(decompressed.byteLength);\n            new Uint8Array(protobufBuffer).set(decompressed);\n            self.postMessage(\n              {\n                type: "transition",\n                flags: meta.flags,\n                protobufData: protobufBuffer\n              },\n              { transfer: [protobufBuffer] }\n            );\n          }).catch((err) => {\n            console.error(\n              `[Animation Worker] Gzip decompress error (transition):`,\n              err\n            );\n          });\n        } else {\n          const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n          new Uint8Array(protobufBuffer).set(meta.protobufData);\n          self.postMessage(\n            {\n              type: "transition",\n              flags: meta.flags,\n              protobufData: protobufBuffer\n            },\n            { transfer: [protobufBuffer] }\n          );\n        }\n      }\n    } else if (isTransitionEnd && meta.protobufLength > 0) {\n      if (!isInEndTransition) {\n        isInEndTransition = true;\n        isInStartTransition = false;\n        const gzipped = isGzipped(meta.flags);\n        if (gzipped) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n          decompressGzip(meta.protobufData).then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n            const protobufBuffer = new ArrayBuffer(decompressed.byteLength);\n            new Uint8Array(protobufBuffer).set(decompressed);\n            self.postMessage(\n              {\n                type: "transitionEnd",\n                flags: meta.flags,\n                protobufData: protobufBuffer\n              },\n              { transfer: [protobufBuffer] }\n            );\n          }).catch((err) => {\n            console.error(\n              `[Animation Worker] Gzip decompress error (transitionEnd):`,\n              err\n            );\n          });\n        } else {\n          const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n          new Uint8Array(protobufBuffer).set(meta.protobufData);\n          self.postMessage(\n            {\n              type: "transitionEnd",\n              flags: meta.flags,\n              protobufData: protobufBuffer\n            },\n            { transfer: [protobufBuffer] }\n          );\n        }\n      }\n    } else if (meta.protobufLength > 0) {\n      if (wasIdle) {\n        wasIdle = false;\n      }\n      isInStartTransition = false;\n      isInEndTransition = false;\n      const gzipped = isGzipped(meta.flags);\n      if (gzipped) {\n        totalCompressedBytes += meta.protobufData.byteLength;\n        decompressGzip(meta.protobufData).then((decompressed) => {\n          totalUncompressedBytes += decompressed.byteLength;\n          const parsed2 = parseALRPayload(decompressed, meta.hasRedundant);\n          if (parsed2) {\n            sendAnimationToMainThread(\n              parsed2.currentData,\n              meta.flags & ~PACKET_FLAG_REDUNDANT,\n              parsed2.frameSeq,\n              false\n            );\n          }\n        }).catch(() => {\n        });\n      } else {\n        const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n        new Uint8Array(protobufBuffer).set(meta.protobufData);\n        self.postMessage(\n          {\n            type: "animation",\n            flags: meta.flags,\n            isIdle: false,\n            isStart,\n            isEnd,\n            frameSeq: -1,\n            // Unknown sequence\n            protobufData: protobufBuffer\n          },\n          { transfer: [protobufBuffer] }\n        );\n      }\n    }\n    const now = performance.now();\n    if (now - lastLogTime > 1e3) {\n      lastLogTime = now;\n      self.postMessage({\n        type: "metadata",\n        protobufLength: meta.protobufLength,\n        framesPerSec: receiverMetaCount,\n        totalFrames,\n        framesWithMeta,\n        framesLost,\n        framesRecovered,\n        totalCompressedBytes,\n        totalUncompressedBytes,\n        framesOutOfOrder,\n        framesDuplicate,\n        framesDropped,\n        framesSent,\n        lastRenderedSeq\n      });\n      receiverMetaCount = 0;\n    }\n  }\n}\nself.onrtctransform = (event) => {\n  const transformer = event.transformer;\n  const options = transformer.options;\n  try {\n    if (options.operation === "receiver") {\n      receiverMetaCount = 0;\n      lastLogTime = 0;\n      totalFrames = 0;\n      framesWithMeta = 0;\n      wasIdle = false;\n      isInStartTransition = false;\n      isInEndTransition = false;\n      lastReceivedTimestamp = null;\n      framesRecovered = 0;\n      framesLost = 0;\n      lastRenderedSeq = -1;\n      framesOutOfOrder = 0;\n      framesDuplicate = 0;\n      framesDropped = 0;\n      framesSent = 0;\n      transformer.readable.pipeThrough(new TransformStream({ transform: receiverTransform })).pipeTo(transformer.writable).catch((err) => {\n        console.error("[Animation Worker] Pipeline error:", err);\n        self.postMessage({\n          type: "error",\n          error: `Animation receiver pipe error: ${err}`\n        });\n      });\n      self.postMessage({ type: "ready", operation: "receiver" });\n    }\n  } catch (err) {\n    console.error("[Animation Worker] Setup error:", err);\n    self.postMessage({\n      type: "error",\n      error: `Animation transform setup error: ${err}`\n    });\n  }\n};\nself.onmessage = (event) => {\n  const { type } = event.data;\n  if (type === "init") {\n    self.postMessage({ type: "initialized" });\n  }\n};\n//# sourceMappingURL=animation-worker-DOGeTjF0.js.map\n';
 const blob = typeof self !== "undefined" && self.Blob && new Blob(["URL.revokeObjectURL(import.meta.url);", jsContent], { type: "text/javascript;charset=utf-8" });
 function WorkerWrapper(options) {
   let objURL;

package/dist/index2.js

@@ -70,6 +70,14 @@ class AvatarPlayer {
     await this.provider.connect(config);
     this._isConnected = true;
   }
+  /**
+   * Pre-warm a future RTC connection when the provider supports it.
+   * This is best-effort and does not change the connected state.
+   */
+  async prepareConnection(config) {
+    var _a, _b;
+    await ((_b = (_a = this.provider).prepareConnection) == null ? void 0 : _b.call(_a, config));
+  }
   /**
    * Disconnect from RTC server.
    * Stops all tracks and cleans up resources.
@@ -89,22 +97,22 @@ class AvatarPlayer {
   }
   /**
    * Publish an audio track to the RTC server.
-   * 
+   *
    * The audio source is controlled externally - you can pass any audio track:
    * - Microphone: `getUserMedia({ audio: true })`
    * - Browser audio: `audioElement.captureStream()`
    * - Web Audio API: `audioContext.createMediaStreamDestination().stream`
    * - Screen share audio: `getDisplayMedia({ audio: true })`
-   * 
+   *
    * @param track - MediaStreamTrack to publish (must be an audio track)
    * @throws Error if not connected or track is invalid
-   * 
+   *
    * @example
    * ```typescript
    * // Microphone
    * const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
    * await player.publishAudio(stream.getAudioTracks()[0]);
-   * 
+   *
    * // Browser audio element
    * const audioEl = document.querySelector('audio');
    * const stream = audioEl.captureStream();
@@ -137,12 +145,12 @@ class AvatarPlayer {
   }
   /**
    * Start publishing microphone audio.
-   * 
+   *
    * This requests microphone permission and publishes it to the RTC session.
    * For custom audio sources (e.g., audio files), use `publishAudio(track)` instead.
-   * 
+   *
    * @throws Error if not connected, permission denied, or no microphone found
-   * 
+   *
    * @example
    * ```typescript
    * await player.startPublishing();
@@ -157,13 +165,15 @@ class AvatarPlayer {
     if (this.microphoneStream) {
       return;
     }
-    this.microphoneStream = await navigator.mediaDevices.getUserMedia({ audio: true });
+    this.microphoneStream = await navigator.mediaDevices.getUserMedia({
+      audio: true
+    });
     const track = this.microphoneStream.getAudioTracks()[0];
     await this.publishAudio(track);
   }
   /**
    * Stop publishing microphone audio and release the microphone.
-   * 
+   *
    * This stops the microphone track and releases the device.
    * If you used `publishAudio()` with a custom track, use `unpublishAudio()` instead.
    */
@@ -184,19 +194,19 @@ class AvatarPlayer {
   }
   /**
    * Get the native RTC client object.
-   * 
+   *
    * Returns the underlying RTC client for advanced use cases:
    * - LiveKit: Returns the Room instance
    * - Agora: Returns the IAgoraRTCClient instance
-   * 
+   *
    * @returns The native RTC client object, or null if not connected
-   * 
+   *
    * @example
    * ```typescript
    * // Access LiveKit Room
    * const room = player.getNativeClient() as Room;
    * console.log('Participants:', room?.remoteParticipants.size);
-   * 
+   *
    * // Access Agora Client
    * const client = player.getNativeClient() as IAgoraRTCClient;
    * console.log('State:', client?.connectionState);
@@ -269,7 +279,9 @@ class AvatarPlayer {
       return;
     }
     if (!this.lastConnectionConfig) {
-      throw new Error("Cannot reconnect: no previous connection. Call connect() first.");
+      throw new Error(
+        "Cannot reconnect: no previous connection. Call connect() first."
+      );
     }
     this.isReconnecting = true;
     logger.info("AvatarPlayer", "Attempting reconnection...");
@@ -346,10 +358,16 @@ class AvatarPlayer {
         );
       },
       onTransition: (protobufData, transitionFrameCount) => {
-        this.animationHandler.handleTransitionData(protobufData, transitionFrameCount);
+        this.animationHandler.handleTransitionData(
+          protobufData,
+          transitionFrameCount
+        );
       },
       onTransitionEnd: (protobufData, transitionFrameCount) => {
-        this.animationHandler.handleTransitionToIdle(protobufData, transitionFrameCount);
+        this.animationHandler.handleTransitionToIdle(
+          protobufData,
+          transitionFrameCount
+        );
       },
       onSessionStart: () => {
       },
@@ -359,7 +377,10 @@ class AvatarPlayer {
         if (this.animationHandler.isInTransition()) {
           this.hasActiveAnimationSession = false;
           this.isTrackingPrimed = false;
-          logger.info("AvatarPlayer", "Deferring idleStart while transition is active");
+          logger.info(
+            "AvatarPlayer",
+            "Deferring idleStart while transition is active"
+          );
           return;
         }
         this.hasActiveAnimationSession = false;

package/dist/index2.js.map

@@ -1 +1 @@
-{"version":3,"file":"index2.js","sources":["../src/core/AvatarPlayer.ts"],"sourcesContent":["/**\n * AvatarPlayer - Unified entry point for RTC avatar streaming.\n *\n * This class provides a unified API that shields applications from\n * differences between different RTC providers (LiveKit, Agora, etc.)\n * and integrates seamlessly with @spatialwalk/avatarkit for rendering.\n *\n * @packageDocumentation\n */\n\nimport type { RTCProvider } from './RTCProvider';\nimport type { RTCConnectionConfig } from '../types';\nimport { AnimationHandler } from './AnimationHandler';\nimport type { AnimationTrackCallbacks, RTCProviderEvents } from './types';\nimport { configureLogger, logger, type LogLevel } from '../utils';\n\n// Import AvatarView type from avatarkit\nimport type { AvatarView, KeyframeData } from '@spatialwalk/avatarkit';\n\n/**\n * Options for configuring AvatarPlayer.\n */\nexport interface AvatarPlayerOptions {\n  /**\n   * Log level for SDK output.\n   * - 'info': Show all logs (debug mode)\n   * - 'warning': Show warnings and errors (default)\n   * - 'error': Show only errors\n   * - 'none': Disable all logs\n   */\n  logLevel?: LogLevel;\n\n  /**\n   * Enable jitter buffer for smoother animation playback.\n   * When enabled, frames are buffered and rendered in sequence order at a steady 25fps,\n   * absorbing network jitter and out-of-order delivery.\n   * Default: true\n   */\n  enableJitterBuffer?: boolean;\n\n  /**\n   * Maximum delay (in ms) a frame can sit in the jitter buffer before being rendered.\n   * Only used when enableJitterBuffer is true.\n   * Default: 80 (2 frames at 25fps)\n   */\n  maxBufferDelayMs?: number;\n}\n\n/**\n * Unified Avatar Player.\n *\n * Main entry point for applications to interact with RTC avatar streaming.\n * Handles connection management, audio publishing, animation rendering,\n * and coordinates with avatarkit for display.\n *\n * @example\n * ```typescript\n * import { AvatarPlayer, LiveKitProvider } from '@spatialwalk/avatarkit-rtc';\n * import { AvatarView, Avatar } from '@spatialwalk/avatarkit';\n *\n * // Create avatar and view (from avatarkit)\n * const avatar = await Avatar.create(characterId);\n * const avatarView = new AvatarView(avatar, container);\n *\n * // Create player\n * const provider = new LiveKitProvider();\n * const player = new AvatarPlayer(provider, avatarView);\n *\n * // Connect\n * await player.connect({ url: 'wss://...', token: '...' });\n *\n * // Option 1: Use microphone (most common)\n * await player.startPublishing();\n * await player.stopPublishing();\n *\n * // Option 2: Use custom audio source\n * const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n * await player.publishAudio(stream.getAudioTracks()[0]);\n * await player.unpublishAudio();\n * stream.getTracks().forEach(t => t.stop());\n *\n * // Disconnect\n * await player.disconnect();\n * ```\n */\nexport class AvatarPlayer {\n  /** @internal */\n  private provider: RTCProvider;\n\n  /** @internal */\n  private avatarView: AvatarView;\n\n  /** @internal */\n  private animationHandler: AnimationHandler;\n\n  /** @internal */\n  private _isConnected = false;\n\n  /** @internal */\n  private localAudioTrack: MediaStreamTrack | null = null;\n\n  /** @internal */\n  private microphoneStream: MediaStream | null = null;\n\n  /** @internal */\n  private eventHandlers: Map<string, Set<Function>> = new Map();\n\n  /** @internal */\n  private lastConnectionConfig: RTCConnectionConfig | null = null;\n\n  /** @internal */\n  private isReconnecting = false;\n\n  /** @internal */\n  private hasActiveAnimationSession = false;\n\n  /** @internal */\n  private isTrackingPrimed = false;\n\n  /**\n   * Create a new AvatarPlayer instance.\n   * @param provider - RTC provider implementation (e.g., LiveKitProvider)\n   * @param avatarView - AvatarView instance from @spatialwalk/avatarkit\n   * @param options - Optional configuration for transitions\n   */\n  constructor(\n    provider: RTCProvider,\n    avatarView: AvatarView,\n    options?: AvatarPlayerOptions\n  ) {\n    this.provider = provider;\n    this.avatarView = avatarView;\n\n    // Configure logging if specified\n    if (options?.logLevel !== undefined) {\n      configureLogger({ level: options.logLevel });\n    }\n\n    // Create internal renderer adapter\n    const renderer = this.createRendererAdapter();\n\n    this.animationHandler = new AnimationHandler(renderer, {\n      enableJitterBuffer: options?.enableJitterBuffer,\n      maxBufferDelayMs: options?.maxBufferDelayMs,\n      onStreamStalled: () => {\n        // AnimationHandler already switches to idle state\n        // Just notify external listeners, let them decide what to do (e.g., call reconnect())\n        this.hasActiveAnimationSession = false;\n        this.isTrackingPrimed = false;\n        this.emit('stalled');\n      },\n    });\n\n    // Setup provider event handlers\n    this.setupProviderEvents();\n  }\n\n  /**\n   * Check if currently connected to RTC server.\n   */\n  get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Connect to RTC server.\n   * @param config - Connection configuration (URL, token, room name, etc.)\n   * @throws Error if already connected or connection fails\n   */\n  async connect(config: RTCConnectionConfig): Promise<void> {\n    if (this._isConnected) {\n      throw new Error('Already connected. Please disconnect first.');\n    }\n\n    // Save config for potential reconnection\n    this.lastConnectionConfig = config;\n\n    // Setup animation callbacks before connecting\n    await this.setupAnimationCallbacks();\n    await this.provider.connect(config);\n    this._isConnected = true;\n  }\n\n  /**\n   * Disconnect from RTC server.\n   * Stops all tracks and cleans up resources.\n   */\n  async disconnect(): Promise<void> {\n    if (!this._isConnected) {\n      return;\n    }\n\n    // Stop microphone if active\n    if (this.microphoneStream) {\n      await this.stopPublishing();\n    } else if (this.localAudioTrack) {\n      // Stop custom audio track\n      await this.unpublishAudio();\n    }\n\n    await this.provider.disconnect();\n    this.animationHandler.dispose();\n    this._isConnected = false;\n  }\n\n  /**\n   * Publish an audio track to the RTC server.\n   * \n   * The audio source is controlled externally - you can pass any audio track:\n   * - Microphone: `getUserMedia({ audio: true })`\n   * - Browser audio: `audioElement.captureStream()`\n   * - Web Audio API: `audioContext.createMediaStreamDestination().stream`\n   * - Screen share audio: `getDisplayMedia({ audio: true })`\n   * \n   * @param track - MediaStreamTrack to publish (must be an audio track)\n   * @throws Error if not connected or track is invalid\n   * \n   * @example\n   * ```typescript\n   * // Microphone\n   * const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n   * await player.publishAudio(stream.getAudioTracks()[0]);\n   * \n   * // Browser audio element\n   * const audioEl = document.querySelector('audio');\n   * const stream = audioEl.captureStream();\n   * await player.publishAudio(stream.getAudioTracks()[0]);\n   * ```\n   */\n  async publishAudio(track: MediaStreamTrack): Promise<void> {\n    if (!this._isConnected) {\n      throw new Error('Not connected. Please call connect() first.');\n    }\n\n    if (track.kind !== 'audio') {\n      throw new Error('Invalid track: expected audio track');\n    }\n\n    // Unpublish existing track if any\n    if (this.localAudioTrack) {\n      await this.unpublishAudio();\n    }\n\n    this.localAudioTrack = track;\n    await this.provider.publishAudioTrack(track);\n  }\n\n  /**\n   * Stop publishing audio.\n   * Note: This does NOT stop the track - the caller is responsible for managing the track lifecycle.\n   */\n  async unpublishAudio(): Promise<void> {\n    if (!this.localAudioTrack) {\n      return;\n    }\n\n    await this.provider.unpublishAudioTrack();\n    this.localAudioTrack = null;\n  }\n\n  /**\n   * Start publishing microphone audio.\n   * \n   * This requests microphone permission and publishes it to the RTC session.\n   * For custom audio sources (e.g., audio files), use `publishAudio(track)` instead.\n   * \n   * @throws Error if not connected, permission denied, or no microphone found\n   * \n   * @example\n   * ```typescript\n   * await player.startPublishing();\n   * // ... later\n   * await player.stopPublishing();\n   * ```\n   */\n  async startPublishing(): Promise<void> {\n    if (!this._isConnected) {\n      throw new Error('Not connected. Please call connect() first.');\n    }\n\n    if (this.microphoneStream) {\n      return; // Already using microphone\n    }\n\n    // Request microphone permission\n    this.microphoneStream = await navigator.mediaDevices.getUserMedia({ audio: true });\n    const track = this.microphoneStream.getAudioTracks()[0];\n    \n    await this.publishAudio(track);\n  }\n\n  /**\n   * Stop publishing microphone audio and release the microphone.\n   * \n   * This stops the microphone track and releases the device.\n   * If you used `publishAudio()` with a custom track, use `unpublishAudio()` instead.\n   */\n  async stopPublishing(): Promise<void> {\n    if (!this.microphoneStream) {\n      return;\n    }\n\n    await this.unpublishAudio();\n\n    // Stop and release microphone\n    this.microphoneStream.getTracks().forEach((track) => track.stop());\n    this.microphoneStream = null;\n  }\n\n  /**\n   * Get current connection state.\n   * @returns Connection state string (e.g., 'connected', 'disconnected')\n   */\n  getConnectionState(): string {\n    return this.provider.getConnectionState();\n  }\n\n  /**\n   * Get the native RTC client object.\n   * \n   * Returns the underlying RTC client for advanced use cases:\n   * - LiveKit: Returns the Room instance\n   * - Agora: Returns the IAgoraRTCClient instance\n   * \n   * @returns The native RTC client object, or null if not connected\n   * \n   * @example\n   * ```typescript\n   * // Access LiveKit Room\n   * const room = player.getNativeClient() as Room;\n   * console.log('Participants:', room?.remoteParticipants.size);\n   * \n   * // Access Agora Client\n   * const client = player.getNativeClient() as IAgoraRTCClient;\n   * console.log('State:', client?.connectionState);\n   * ```\n   */\n  getNativeClient(): unknown {\n    return this.provider.getNativeClient();\n  }\n\n  /**\n   * Add event listener.\n   * @param event - Event name ('connected', 'disconnected', 'error', 'stalled', etc.)\n   * @param handler - Event handler function\n   */\n  on(event: string, handler: Function): void {\n    if (event === 'stalled') {\n      // Handle stalled event locally\n      if (!this.eventHandlers.has(event)) {\n        this.eventHandlers.set(event, new Set());\n      }\n      this.eventHandlers.get(event)!.add(handler);\n    } else {\n      // Forward other events to provider\n      this.provider.on(event as any, handler as any);\n    }\n  }\n\n  /**\n   * Remove event listener.\n   * @param event - Event name\n   * @param handler - Event handler function (must be same reference as added)\n   */\n  off(event: string, handler: Function): void {\n    if (event === 'stalled') {\n      this.eventHandlers.get(event)?.delete(handler);\n    } else {\n      this.provider.off(event as any, handler as any);\n    }\n  }\n\n  /**\n   * Emit an event to local listeners.\n   * @internal\n   */\n  private emit(event: string, ...args: unknown[]): void {\n    const handlers = this.eventHandlers.get(event);\n    if (handlers) {\n      handlers.forEach((handler) => {\n        try {\n          handler(...args);\n        } catch (e) {\n          logger.error('AvatarPlayer', `Error in ${event} handler:`, e);\n        }\n      });\n    }\n  }\n\n  /**\n   * Reconnect to RTC server using the last connection configuration.\n   * Useful for recovering from connection issues or stream stalls.\n   *\n   * @example\n   * ```typescript\n   * player.on('stalled', async () => {\n   *   console.log('Stream stalled, attempting reconnection...');\n   *   await player.reconnect();\n   * });\n   * ```\n   *\n   * @throws Error if no previous connection config exists or reconnection fails\n   */\n  async reconnect(): Promise<void> {\n    if (this.isReconnecting) {\n      logger.warn('AvatarPlayer', 'Already attempting reconnection, skipping');\n      return;\n    }\n\n    if (!this.lastConnectionConfig) {\n      throw new Error('Cannot reconnect: no previous connection. Call connect() first.');\n    }\n\n    this.isReconnecting = true;\n    logger.info('AvatarPlayer', 'Attempting reconnection...');\n\n    try {\n      // Disconnect first if connected\n      if (this._isConnected) {\n        await this.disconnect();\n      }\n\n      // Wait a short moment before reconnecting\n      await new Promise((resolve) => setTimeout(resolve, 500));\n\n      // Reconnect\n      await this.connect(this.lastConnectionConfig);\n      logger.info('AvatarPlayer', 'Reconnection successful');\n    } catch (error) {\n      logger.error('AvatarPlayer', 'Reconnection failed:', error);\n      throw error;\n    } finally {\n      this.isReconnecting = false;\n    }\n  }\n\n  /**\n   * Create internal renderer adapter that bridges AnimationHandler to AvatarView.\n   * @internal\n   */\n  private createRendererAdapter() {\n    const avatarView = this.avatarView;\n\n    return {\n      renderFrame(flame: KeyframeData | undefined, startIdle?: boolean): void {\n        if (startIdle) {\n          // Enable idle rendering mode\n          avatarView.renderFlame(undefined as unknown as KeyframeData, true);\n        } else if (flame) {\n          // Render the animation frame\n          avatarView.renderFlame(flame);\n        }\n      },\n\n      async generateTransitionFromIdle(\n        targetFrame: KeyframeData,\n        frameCount: number\n      ): Promise<KeyframeData[]> {\n        // Use avatarkit's generateTransition with from=undefined (current idle frame)\n        return avatarView.generateTransition({\n          to: targetFrame,\n          frameCount,\n          useLinear: true, // Linear interpolation for idle->speaking\n        });\n      },\n\n      isReady(): boolean {\n        return true; // AvatarView is always ready once created\n      },\n    };\n  }\n\n  /**\n   * Setup animation track callbacks.\n   * @internal\n   */\n  private async setupAnimationCallbacks(): Promise<void> {\n    const callbacks: AnimationTrackCallbacks = {\n      onAnimationData: (protobufData, metadata) => {\n        // Reset tracking only once per session to avoid duplicate start-packet resets.\n        if (!this.hasActiveAnimationSession) {\n          if (!this.isTrackingPrimed) {\n            this.animationHandler.resetTracking();\n          }\n\n          this.hasActiveAnimationSession = true;\n          this.isTrackingPrimed = false;\n\n          if (!metadata.isStart) {\n            logger.info(\n              'AvatarPlayer',\n              `Session start inferred from frame seq=${metadata.frameSeq ?? 'n/a'}`\n            );\n          }\n        } else if (metadata.isStart) {\n          logger.info(\n            'AvatarPlayer',\n            `Ignoring duplicate session start frame seq=${metadata.frameSeq ?? 'n/a'}`\n          );\n        }\n\n        this.animationHandler.handleAnimationData(\n          protobufData,\n          metadata.frameSeq,\n          metadata.isRecovered\n        );\n      },\n      onTransition: (protobufData, transitionFrameCount) => {\n        this.animationHandler.handleTransitionData(protobufData, transitionFrameCount);\n      },\n      onTransitionEnd: (protobufData, transitionFrameCount) => {\n        this.animationHandler.handleTransitionToIdle(protobufData, transitionFrameCount);\n      },\n      onSessionStart: () => {\n        // Session started - can be used for UI feedback\n      },\n      onSessionEnd: () => {\n        // Session ended - can be used for UI feedback\n      },\n      onIdleStart: () => {\n        // Idle packets can race with start-transition packets; avoid rendering idle mid-transition.\n        if (this.animationHandler.isInTransition()) {\n          // Keep session bookkeeping in sync even if visual idle is deferred.\n          this.hasActiveAnimationSession = false;\n          this.isTrackingPrimed = false;\n          logger.info('AvatarPlayer', 'Deferring idleStart while transition is active');\n          return;\n        }\n\n        this.hasActiveAnimationSession = false;\n        this.animationHandler.resetTracking();\n        this.isTrackingPrimed = true;\n        this.animationHandler.startIdle();\n      },\n      onStreamStats: (stats) => {\n        // Log packet loss/recovery stats\n        if (stats.framesLost > 0 || stats.framesRecovered > 0 || stats.framesDropped > 0) {\n          logger.warn(\n            'AvatarPlayer',\n            `Stream stats: lost=${stats.framesLost}, recovered=${stats.framesRecovered}, dropped=${stats.framesDropped}, fps=${stats.framesPerSec}`\n          );\n        }\n      },\n    };\n\n    await this.provider.subscribeAnimationTrack(callbacks);\n  }\n\n  /**\n   * Setup provider event handlers.\n   * @internal\n   */\n  private setupProviderEvents(): void {\n    this.provider.on('connected', () => {\n      this._isConnected = true;\n    });\n\n    this.provider.on('disconnected', () => {\n      this._isConnected = false;\n      this.hasActiveAnimationSession = false;\n      this.isTrackingPrimed = false;\n      // Return to idle animation when disconnected\n      this.animationHandler.startIdle();\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index2.js","sources":["../src/core/AvatarPlayer.ts"],"sourcesContent":["/**\n * AvatarPlayer - Unified entry point for RTC avatar streaming.\n *\n * This class provides a unified API that shields applications from\n * differences between different RTC providers (LiveKit, Agora, etc.)\n * and integrates seamlessly with @spatialwalk/avatarkit for rendering.\n *\n * @packageDocumentation\n */\n\nimport type { RTCProvider } from './RTCProvider';\nimport type { RTCConnectionConfig, RTCPrepareConnectionConfig } from '../types';\nimport { AnimationHandler } from './AnimationHandler';\nimport type { AnimationTrackCallbacks } from './types';\nimport { configureLogger, logger, type LogLevel } from '../utils';\n\n// Import AvatarView type from avatarkit\nimport type { AvatarView, KeyframeData } from '@spatialwalk/avatarkit';\n\n/**\n * Options for configuring AvatarPlayer.\n */\nexport interface AvatarPlayerOptions {\n  /**\n   * Log level for SDK output.\n   * - 'info': Show all logs (debug mode)\n   * - 'warning': Show warnings and errors (default)\n   * - 'error': Show only errors\n   * - 'none': Disable all logs\n   */\n  logLevel?: LogLevel;\n\n  /**\n   * Enable jitter buffer for smoother animation playback.\n   * When enabled, frames are buffered and rendered in sequence order at a steady 25fps,\n   * absorbing network jitter and out-of-order delivery.\n   * Default: true\n   */\n  enableJitterBuffer?: boolean;\n\n  /**\n   * Maximum delay (in ms) a frame can sit in the jitter buffer before being rendered.\n   * Only used when enableJitterBuffer is true.\n   * Default: 80 (2 frames at 25fps)\n   */\n  maxBufferDelayMs?: number;\n}\n\n/**\n * Unified Avatar Player.\n *\n * Main entry point for applications to interact with RTC avatar streaming.\n * Handles connection management, audio publishing, animation rendering,\n * and coordinates with avatarkit for display.\n *\n * @example\n * ```typescript\n * import { AvatarPlayer, LiveKitProvider } from '@spatialwalk/avatarkit-rtc';\n * import { AvatarView, Avatar } from '@spatialwalk/avatarkit';\n *\n * // Create avatar and view (from avatarkit)\n * const avatar = await Avatar.create(characterId);\n * const avatarView = new AvatarView(avatar, container);\n *\n * // Create player\n * const provider = new LiveKitProvider();\n * const player = new AvatarPlayer(provider, avatarView);\n *\n * // Connect\n * await player.connect({ url: 'wss://...', token: '...' });\n *\n * // Option 1: Use microphone (most common)\n * await player.startPublishing();\n * await player.stopPublishing();\n *\n * // Option 2: Use custom audio source\n * const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n * await player.publishAudio(stream.getAudioTracks()[0]);\n * await player.unpublishAudio();\n * stream.getTracks().forEach(t => t.stop());\n *\n * // Disconnect\n * await player.disconnect();\n * ```\n */\nexport class AvatarPlayer {\n  /** @internal */\n  private provider: RTCProvider;\n\n  /** @internal */\n  private avatarView: AvatarView;\n\n  /** @internal */\n  private animationHandler: AnimationHandler;\n\n  /** @internal */\n  private _isConnected = false;\n\n  /** @internal */\n  private localAudioTrack: MediaStreamTrack | null = null;\n\n  /** @internal */\n  private microphoneStream: MediaStream | null = null;\n\n  /** @internal */\n  private eventHandlers: Map<string, Set<(...args: unknown[]) => void>> =\n    new Map();\n\n  /** @internal */\n  private lastConnectionConfig: RTCConnectionConfig | null = null;\n\n  /** @internal */\n  private isReconnecting = false;\n\n  /** @internal */\n  private hasActiveAnimationSession = false;\n\n  /** @internal */\n  private isTrackingPrimed = false;\n\n  /**\n   * Create a new AvatarPlayer instance.\n   * @param provider - RTC provider implementation (e.g., LiveKitProvider)\n   * @param avatarView - AvatarView instance from @spatialwalk/avatarkit\n   * @param options - Optional configuration for transitions\n   */\n  constructor(\n    provider: RTCProvider,\n    avatarView: AvatarView,\n    options?: AvatarPlayerOptions,\n  ) {\n    this.provider = provider;\n    this.avatarView = avatarView;\n\n    // Configure logging if specified\n    if (options?.logLevel !== undefined) {\n      configureLogger({ level: options.logLevel });\n    }\n\n    // Create internal renderer adapter\n    const renderer = this.createRendererAdapter();\n\n    this.animationHandler = new AnimationHandler(renderer, {\n      enableJitterBuffer: options?.enableJitterBuffer,\n      maxBufferDelayMs: options?.maxBufferDelayMs,\n      onStreamStalled: () => {\n        // AnimationHandler already switches to idle state\n        // Just notify external listeners, let them decide what to do (e.g., call reconnect())\n        this.hasActiveAnimationSession = false;\n        this.isTrackingPrimed = false;\n        this.emit('stalled');\n      },\n    });\n\n    // Setup provider event handlers\n    this.setupProviderEvents();\n  }\n\n  /**\n   * Check if currently connected to RTC server.\n   */\n  get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Connect to RTC server.\n   * @param config - Connection configuration (URL, token, room name, etc.)\n   * @throws Error if already connected or connection fails\n   */\n  async connect(config: RTCConnectionConfig): Promise<void> {\n    if (this._isConnected) {\n      throw new Error('Already connected. Please disconnect first.');\n    }\n\n    // Save config for potential reconnection\n    this.lastConnectionConfig = config;\n\n    // Setup animation callbacks before connecting\n    await this.setupAnimationCallbacks();\n    await this.provider.connect(config);\n    this._isConnected = true;\n  }\n\n  /**\n   * Pre-warm a future RTC connection when the provider supports it.\n   * This is best-effort and does not change the connected state.\n   */\n  async prepareConnection(config: RTCPrepareConnectionConfig): Promise<void> {\n    await this.provider.prepareConnection?.(config);\n  }\n\n  /**\n   * Disconnect from RTC server.\n   * Stops all tracks and cleans up resources.\n   */\n  async disconnect(): Promise<void> {\n    if (!this._isConnected) {\n      return;\n    }\n\n    // Stop microphone if active\n    if (this.microphoneStream) {\n      await this.stopPublishing();\n    } else if (this.localAudioTrack) {\n      // Stop custom audio track\n      await this.unpublishAudio();\n    }\n\n    await this.provider.disconnect();\n    this.animationHandler.dispose();\n    this._isConnected = false;\n  }\n\n  /**\n   * Publish an audio track to the RTC server.\n   *\n   * The audio source is controlled externally - you can pass any audio track:\n   * - Microphone: `getUserMedia({ audio: true })`\n   * - Browser audio: `audioElement.captureStream()`\n   * - Web Audio API: `audioContext.createMediaStreamDestination().stream`\n   * - Screen share audio: `getDisplayMedia({ audio: true })`\n   *\n   * @param track - MediaStreamTrack to publish (must be an audio track)\n   * @throws Error if not connected or track is invalid\n   *\n   * @example\n   * ```typescript\n   * // Microphone\n   * const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n   * await player.publishAudio(stream.getAudioTracks()[0]);\n   *\n   * // Browser audio element\n   * const audioEl = document.querySelector('audio');\n   * const stream = audioEl.captureStream();\n   * await player.publishAudio(stream.getAudioTracks()[0]);\n   * ```\n   */\n  async publishAudio(track: MediaStreamTrack): Promise<void> {\n    if (!this._isConnected) {\n      throw new Error('Not connected. Please call connect() first.');\n    }\n\n    if (track.kind !== 'audio') {\n      throw new Error('Invalid track: expected audio track');\n    }\n\n    // Unpublish existing track if any\n    if (this.localAudioTrack) {\n      await this.unpublishAudio();\n    }\n\n    this.localAudioTrack = track;\n    await this.provider.publishAudioTrack(track);\n  }\n\n  /**\n   * Stop publishing audio.\n   * Note: This does NOT stop the track - the caller is responsible for managing the track lifecycle.\n   */\n  async unpublishAudio(): Promise<void> {\n    if (!this.localAudioTrack) {\n      return;\n    }\n\n    await this.provider.unpublishAudioTrack();\n    this.localAudioTrack = null;\n  }\n\n  /**\n   * Start publishing microphone audio.\n   *\n   * This requests microphone permission and publishes it to the RTC session.\n   * For custom audio sources (e.g., audio files), use `publishAudio(track)` instead.\n   *\n   * @throws Error if not connected, permission denied, or no microphone found\n   *\n   * @example\n   * ```typescript\n   * await player.startPublishing();\n   * // ... later\n   * await player.stopPublishing();\n   * ```\n   */\n  async startPublishing(): Promise<void> {\n    if (!this._isConnected) {\n      throw new Error('Not connected. Please call connect() first.');\n    }\n\n    if (this.microphoneStream) {\n      return; // Already using microphone\n    }\n\n    // Request microphone permission\n    this.microphoneStream = await navigator.mediaDevices.getUserMedia({\n      audio: true,\n    });\n    const track = this.microphoneStream.getAudioTracks()[0];\n\n    await this.publishAudio(track);\n  }\n\n  /**\n   * Stop publishing microphone audio and release the microphone.\n   *\n   * This stops the microphone track and releases the device.\n   * If you used `publishAudio()` with a custom track, use `unpublishAudio()` instead.\n   */\n  async stopPublishing(): Promise<void> {\n    if (!this.microphoneStream) {\n      return;\n    }\n\n    await this.unpublishAudio();\n\n    // Stop and release microphone\n    this.microphoneStream.getTracks().forEach((track) => track.stop());\n    this.microphoneStream = null;\n  }\n\n  /**\n   * Get current connection state.\n   * @returns Connection state string (e.g., 'connected', 'disconnected')\n   */\n  getConnectionState(): string {\n    return this.provider.getConnectionState();\n  }\n\n  /**\n   * Get the native RTC client object.\n   *\n   * Returns the underlying RTC client for advanced use cases:\n   * - LiveKit: Returns the Room instance\n   * - Agora: Returns the IAgoraRTCClient instance\n   *\n   * @returns The native RTC client object, or null if not connected\n   *\n   * @example\n   * ```typescript\n   * // Access LiveKit Room\n   * const room = player.getNativeClient() as Room;\n   * console.log('Participants:', room?.remoteParticipants.size);\n   *\n   * // Access Agora Client\n   * const client = player.getNativeClient() as IAgoraRTCClient;\n   * console.log('State:', client?.connectionState);\n   * ```\n   */\n  getNativeClient(): unknown {\n    return this.provider.getNativeClient();\n  }\n\n  /**\n   * Add event listener.\n   * @param event - Event name ('connected', 'disconnected', 'error', 'stalled', etc.)\n   * @param handler - Event handler function\n   */\n  on(event: string, handler: (...args: unknown[]) => void): void {\n    if (event === 'stalled') {\n      // Handle stalled event locally\n      if (!this.eventHandlers.has(event)) {\n        this.eventHandlers.set(event, new Set());\n      }\n      this.eventHandlers.get(event)!.add(handler);\n    } else {\n      // Forward other events to provider\n      this.provider.on(event, handler);\n    }\n  }\n\n  /**\n   * Remove event listener.\n   * @param event - Event name\n   * @param handler - Event handler function (must be same reference as added)\n   */\n  off(event: string, handler: (...args: unknown[]) => void): void {\n    if (event === 'stalled') {\n      this.eventHandlers.get(event)?.delete(handler);\n    } else {\n      this.provider.off(event, handler);\n    }\n  }\n\n  /**\n   * Emit an event to local listeners.\n   * @internal\n   */\n  private emit(event: string, ...args: unknown[]): void {\n    const handlers = this.eventHandlers.get(event);\n    if (handlers) {\n      handlers.forEach((handler) => {\n        try {\n          handler(...args);\n        } catch (e) {\n          logger.error('AvatarPlayer', `Error in ${event} handler:`, e);\n        }\n      });\n    }\n  }\n\n  /**\n   * Reconnect to RTC server using the last connection configuration.\n   * Useful for recovering from connection issues or stream stalls.\n   *\n   * @example\n   * ```typescript\n   * player.on('stalled', async () => {\n   *   console.log('Stream stalled, attempting reconnection...');\n   *   await player.reconnect();\n   * });\n   * ```\n   *\n   * @throws Error if no previous connection config exists or reconnection fails\n   */\n  async reconnect(): Promise<void> {\n    if (this.isReconnecting) {\n      logger.warn('AvatarPlayer', 'Already attempting reconnection, skipping');\n      return;\n    }\n\n    if (!this.lastConnectionConfig) {\n      throw new Error(\n        'Cannot reconnect: no previous connection. Call connect() first.',\n      );\n    }\n\n    this.isReconnecting = true;\n    logger.info('AvatarPlayer', 'Attempting reconnection...');\n\n    try {\n      // Disconnect first if connected\n      if (this._isConnected) {\n        await this.disconnect();\n      }\n\n      // Wait a short moment before reconnecting\n      await new Promise((resolve) => setTimeout(resolve, 500));\n\n      // Reconnect\n      await this.connect(this.lastConnectionConfig);\n      logger.info('AvatarPlayer', 'Reconnection successful');\n    } catch (error) {\n      logger.error('AvatarPlayer', 'Reconnection failed:', error);\n      throw error;\n    } finally {\n      this.isReconnecting = false;\n    }\n  }\n\n  /**\n   * Create internal renderer adapter that bridges AnimationHandler to AvatarView.\n   * @internal\n   */\n  private createRendererAdapter() {\n    const avatarView = this.avatarView;\n\n    return {\n      renderFrame(flame: KeyframeData | undefined, startIdle?: boolean): void {\n        if (startIdle) {\n          // Enable idle rendering mode\n          avatarView.renderFlame(undefined as unknown as KeyframeData, true);\n        } else if (flame) {\n          // Render the animation frame\n          avatarView.renderFlame(flame);\n        }\n      },\n\n      async generateTransitionFromIdle(\n        targetFrame: KeyframeData,\n        frameCount: number,\n      ): Promise<KeyframeData[]> {\n        // Use avatarkit's generateTransition with from=undefined (current idle frame)\n        return avatarView.generateTransition({\n          to: targetFrame,\n          frameCount,\n          useLinear: true, // Linear interpolation for idle->speaking\n        });\n      },\n\n      isReady(): boolean {\n        return true; // AvatarView is always ready once created\n      },\n    };\n  }\n\n  /**\n   * Setup animation track callbacks.\n   * @internal\n   */\n  private async setupAnimationCallbacks(): Promise<void> {\n    const callbacks: AnimationTrackCallbacks = {\n      onAnimationData: (protobufData, metadata) => {\n        // Reset tracking only once per session to avoid duplicate start-packet resets.\n        if (!this.hasActiveAnimationSession) {\n          if (!this.isTrackingPrimed) {\n            this.animationHandler.resetTracking();\n          }\n\n          this.hasActiveAnimationSession = true;\n          this.isTrackingPrimed = false;\n\n          if (!metadata.isStart) {\n            logger.info(\n              'AvatarPlayer',\n              `Session start inferred from frame seq=${metadata.frameSeq ?? 'n/a'}`,\n            );\n          }\n        } else if (metadata.isStart) {\n          logger.info(\n            'AvatarPlayer',\n            `Ignoring duplicate session start frame seq=${metadata.frameSeq ?? 'n/a'}`,\n          );\n        }\n\n        this.animationHandler.handleAnimationData(\n          protobufData,\n          metadata.frameSeq,\n          metadata.isRecovered,\n        );\n      },\n      onTransition: (protobufData, transitionFrameCount) => {\n        this.animationHandler.handleTransitionData(\n          protobufData,\n          transitionFrameCount,\n        );\n      },\n      onTransitionEnd: (protobufData, transitionFrameCount) => {\n        this.animationHandler.handleTransitionToIdle(\n          protobufData,\n          transitionFrameCount,\n        );\n      },\n      onSessionStart: () => {\n        // Session started - can be used for UI feedback\n      },\n      onSessionEnd: () => {\n        // Session ended - can be used for UI feedback\n      },\n      onIdleStart: () => {\n        // Idle packets can race with start-transition packets; avoid rendering idle mid-transition.\n        if (this.animationHandler.isInTransition()) {\n          // Keep session bookkeeping in sync even if visual idle is deferred.\n          this.hasActiveAnimationSession = false;\n          this.isTrackingPrimed = false;\n          logger.info(\n            'AvatarPlayer',\n            'Deferring idleStart while transition is active',\n          );\n          return;\n        }\n\n        this.hasActiveAnimationSession = false;\n        this.animationHandler.resetTracking();\n        this.isTrackingPrimed = true;\n        this.animationHandler.startIdle();\n      },\n      onStreamStats: (stats) => {\n        // Log packet loss/recovery stats\n        if (\n          stats.framesLost > 0 ||\n          stats.framesRecovered > 0 ||\n          stats.framesDropped > 0\n        ) {\n          logger.warn(\n            'AvatarPlayer',\n            `Stream stats: lost=${stats.framesLost}, recovered=${stats.framesRecovered}, dropped=${stats.framesDropped}, fps=${stats.framesPerSec}`,\n          );\n        }\n      },\n    };\n\n    await this.provider.subscribeAnimationTrack(callbacks);\n  }\n\n  /**\n   * Setup provider event handlers.\n   * @internal\n   */\n  private setupProviderEvents(): void {\n    this.provider.on('connected', () => {\n      this._isConnected = true;\n    });\n\n    this.provider.on('disconnected', () => {\n      this._isConnected = false;\n      this.hasActiveAnimationSession = false;\n      this.isTrackingPrimed = false;\n      // Return to idle animation when disconnected\n      this.animationHandler.startIdle();\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index3.js

@@ -1,10 +1,10 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { BaseProvider } from "./index10.js";
-import { isLiveKitConfig } from "./index5.js";
-import { VP8Extractor } from "./index11.js";
-import { getInsertableStreamsMethod } from "./index12.js";
+import { BaseProvider } from "./index9.js";
+import { isLiveKitPrepareConfig, isLiveKitConfig } from "./index5.js";
+import { VP8Extractor } from "./index10.js";
+import { getInsertableStreamsMethod } from "./index11.js";
 import { logger } from "./index7.js";
 const globalLiveKitProviderRegistry = /* @__PURE__ */ new Set();
 let rtcPeerConnectionPatched = false;
@@ -29,11 +29,19 @@ function patchRTCPeerConnection() {
           listener.handleEvent(event);
         }
       };
-      return originalAddEventListener.call(this, type, wrappedListener, options);
+      return originalAddEventListener.call(
+        this,
+        type,
+        wrappedListener,
+        options
+      );
     }
     return originalAddEventListener.call(this, type, listener, options);
   };
-  const originalOnTrackDescriptor = Object.getOwnPropertyDescriptor(RTCPeerConnection.prototype, "ontrack");
+  const originalOnTrackDescriptor = Object.getOwnPropertyDescriptor(
+    RTCPeerConnection.prototype,
+    "ontrack"
+  );
   if (originalOnTrackDescriptor) {
     Object.defineProperty(RTCPeerConnection.prototype, "ontrack", {
       get: originalOnTrackDescriptor.get,
@@ -104,6 +112,13 @@ class LiveKitProvider extends BaseProvider {
     __publicField(this, "isMicrophoneEnabled", false);
     globalLiveKitProviderRegistry.add(this);
   }
+  createRoom(livekit) {
+    const { Room } = livekit;
+    return new Room({
+      videoCaptureDefaults: void 0,
+      audioCaptureDefaults: void 0
+    });
+  }
   /**
    * Load LiveKit SDK dynamically.
    * @internal
@@ -115,12 +130,31 @@ class LiveKitProvider extends BaseProvider {
     try {
       this.livekitSDK = await import("livekit-client");
       return this.livekitSDK;
-    } catch (error) {
+    } catch {
       throw new Error(
         "❌ Failed to load livekit-client.\nPlease ensure it is installed: pnpm add livekit-client"
       );
     }
   }
+  async prepareConnection(config) {
+    logger.info("LiveKit", "prepareConnection() called with config:", {
+      hasUrl: "url" in config,
+      hasToken: "token" in config
+    });
+    if (!isLiveKitPrepareConfig(config)) {
+      throw new Error("LiveKitProvider requires url in prepareConnection config");
+    }
+    const livekit = await this.loadSDK();
+    if (!this.room) {
+      this.room = this.createRoom(livekit);
+    }
+    try {
+      await this.room.prepareConnection(config.url, config.token);
+      logger.info("LiveKit", "prepareConnection() completed");
+    } catch (error) {
+      logger.warn("LiveKit", "prepareConnection() failed (non-fatal):", error);
+    }
+  }
   /**
    * Map LiveKit connection state to string.
    * @internal
@@ -296,7 +330,10 @@ class LiveKitProvider extends BaseProvider {
         passive: true
       });
     }
-    logger.warn("LiveKit", "Audio playback blocked by autoplay policy, waiting for user interaction");
+    logger.warn(
+      "LiveKit",
+      "Audio playback blocked by autoplay policy, waiting for user interaction"
+    );
   }
   /**
    * Remove user gesture listeners after playback is unlocked.
@@ -308,7 +345,11 @@ class LiveKitProvider extends BaseProvider {
     }
     this.awaitingAudioUnlock = false;
     for (const eventName of this.audioUnlockEventNames) {
-      window.removeEventListener(eventName, this.handleAudioUnlockGesture, true);
+      window.removeEventListener(
+        eventName,
+        this.handleAudioUnlockGesture,
+        true
+      );
     }
   }
   /**
@@ -320,7 +361,9 @@ class LiveKitProvider extends BaseProvider {
       return error.name === "NotAllowedError";
     }
     if (error instanceof Error) {
-      return error.name === "NotAllowedError" || /didn't interact|user didn't interact|NotAllowedError/i.test(error.message);
+      return error.name === "NotAllowedError" || /didn't interact|user didn't interact|NotAllowedError/i.test(
+        error.message
+      );
     }
     return false;
   }
@@ -367,7 +410,11 @@ class LiveKitProvider extends BaseProvider {
         if (this.isAutoplayBlockedError(error)) {
           this.addAudioUnlockListeners();
         } else {
-          logger.warn("LiveKit", `Failed to call room.startAudio() (${reason}):`, error);
+          logger.warn(
+            "LiveKit",
+            `Failed to call room.startAudio() (${reason}):`,
+            error
+          );
         }
         return;
       }
@@ -388,19 +435,26 @@ class LiveKitProvider extends BaseProvider {
       config
     });
     if (!isLiveKitConfig(config)) {
-      logger.error("LiveKit", "Config validation failed - missing url or roomName");
-      throw new Error("LiveKitProvider requires url and roomName in connection config");
+      logger.error(
+        "LiveKit",
+        "Config validation failed - missing url or roomName"
+      );
+      throw new Error(
+        "LiveKitProvider requires url and roomName in connection config"
+      );
     }
     const livekitConfig = config;
-    logger.info("LiveKit", "Config validated, connecting to:", livekitConfig.url);
+    logger.info(
+      "LiveKit",
+      "Config validated, connecting to:",
+      livekitConfig.url
+    );
     this.removeAudioUnlockListeners();
     const livekit = await this.loadSDK();
     logger.info("LiveKit", "SDK loaded successfully");
-    const { Room } = livekit;
-    this.room = new Room({
-      videoCaptureDefaults: void 0,
-      audioCaptureDefaults: void 0
-    });
+    if (!this.room) {
+      this.room = this.createRoom(livekit);
+    }
     this.setConnectionState("connecting");
     this.setupEventListeners(livekit);
     try {
@@ -408,15 +462,31 @@ class LiveKitProvider extends BaseProvider {
       await this.room.connect(livekitConfig.url, livekitConfig.token);
       logger.info("LiveKit", "Room connected, state:", this.room.state);
       logger.info("LiveKit", "Room name:", this.room.name);
-      logger.info("LiveKit", "Local participant:", (_a = this.room.localParticipant) == null ? void 0 : _a.identity);
-      logger.info("LiveKit", "Remote participants:", this.room.remoteParticipants.size);
+      logger.info(
+        "LiveKit",
+        "Local participant:",
+        (_a = this.room.localParticipant) == null ? void 0 : _a.identity
+      );
+      logger.info(
+        "LiveKit",
+        "Remote participants:",
+        this.room.remoteParticipants.size
+      );
       this.room.remoteParticipants.forEach((participant, sid) => {
-        logger.info("LiveKit", `Remote participant: ${participant.identity}, sid: ${sid}`);
+        logger.info(
+          "LiveKit",
+          `Remote participant: ${participant.identity}, sid: ${sid}`
+        );
         participant.trackPublications.forEach((pub, trackSid) => {
-          logger.info("LiveKit", `  Track: ${pub.trackName}, kind: ${pub.kind}, subscribed: ${pub.isSubscribed}, sid: ${trackSid}`);
+          logger.info(
+            "LiveKit",
+            `  Track: ${pub.trackName}, kind: ${pub.kind}, subscribed: ${pub.isSubscribed}, sid: ${trackSid}`
+          );
         });
       });
-      this.setConnectionState(this.mapLiveKitConnectionState(livekit, this.room.state));
+      this.setConnectionState(
+        this.mapLiveKitConnectionState(livekit, this.room.state)
+      );
     } catch (error) {
       logger.error("LiveKit", "Connection failed:", error);
       this.setConnectionState("failed");
@@ -444,7 +514,10 @@ class LiveKitProvider extends BaseProvider {
       logger.info("LiveKit", `Participant connected: ${participant.identity}`);
     });
     room.on(RoomEvent.ParticipantDisconnected, (participant) => {
-      logger.warn("LiveKit", `Participant disconnected: ${participant.identity}`);
+      logger.warn(
+        "LiveKit",
+        `Participant disconnected: ${participant.identity}`
+      );
     });
     room.on(RoomEvent.TrackPublished, (publication, participant) => {
       logger.info("LiveKit", "TrackPublished:", {
@@ -458,14 +531,22 @@ class LiveKitProvider extends BaseProvider {
       this.setConnectionState("disconnected");
       this.emit("disconnected");
     });
-    room.on(RoomEvent.AudioPlaybackStatusChanged, (canPlaybackAudio) => {
-      logger.info("LiveKit", `Audio playback status changed: ${canPlaybackAudio ? "enabled" : "blocked"}`);
-      if (canPlaybackAudio) {
-        void this.ensureAudioPlaybackUnlocked("audio-playback-status-changed");
-      } else {
-        this.addAudioUnlockListeners();
+    room.on(
+      RoomEvent.AudioPlaybackStatusChanged,
+      (canPlaybackAudio) => {
+        logger.info(
+          "LiveKit",
+          `Audio playback status changed: ${canPlaybackAudio ? "enabled" : "blocked"}`
+        );
+        if (canPlaybackAudio) {
+          void this.ensureAudioPlaybackUnlocked(
+            "audio-playback-status-changed"
+          );
+        } else {
+          this.addAudioUnlockListeners();
+        }
       }
-    });
+    );
     this.room.on(
       RoomEvent.TrackSubscribed,
       (track, publication, participant) => {
@@ -484,7 +565,9 @@ class LiveKitProvider extends BaseProvider {
           audioElement.autoplay = true;
           audioElement.controls = false;
           audioElement.style.display = "none";
-          const previousAudioElement = this.audioElements.get(participant.identity);
+          const previousAudioElement = this.audioElements.get(
+            participant.identity
+          );
           if (previousAudioElement && previousAudioElement !== audioElement) {
             previousAudioElement.remove();
           }
@@ -498,13 +581,24 @@ class LiveKitProvider extends BaseProvider {
             (_b = (_a = this.audioCallbacks).onAudioReceived) == null ? void 0 : _b.call(_a, participant);
           }
         } else if (track.kind === Track.Kind.Video) {
-          logger.info("LiveKit", "Video track received, setting up animation transform...");
+          logger.info(
+            "LiveKit",
+            "Video track received, setting up animation transform..."
+          );
           if (mediaStreamTrack) {
-            const receiver = this.findVideoReceiverByTrackId(mediaStreamTrack.id);
+            const receiver = this.findVideoReceiverByTrackId(
+              mediaStreamTrack.id
+            );
             if (receiver) {
-              this.receiverParticipantMap.set(receiver, { participant, trackName });
+              this.receiverParticipantMap.set(receiver, {
+                participant,
+                trackName
+              });
               if (!receiver.transform || !this.transformedReceivers.has(receiver)) {
-                this.applyAnimationReceiverTransform(receiver, mediaStreamTrack);
+                this.applyAnimationReceiverTransform(
+                  receiver,
+                  mediaStreamTrack
+                );
               }
             }
           }
@@ -570,9 +664,14 @@ class LiveKitProvider extends BaseProvider {
               if (((_a = publication.trackName) == null ? void 0 : _a.includes("animation")) && publication.track) {
                 const mediaStreamTrack = publication.track.mediaStreamTrack;
                 if (mediaStreamTrack) {
-                  const receiver = this.findVideoReceiverByTrackId(mediaStreamTrack.id);
+                  const receiver = this.findVideoReceiverByTrackId(
+                    mediaStreamTrack.id
+                  );
                   if (receiver) {
-                    this.applyAnimationReceiverTransform(receiver, mediaStreamTrack);
+                    this.applyAnimationReceiverTransform(
+                      receiver,
+                      mediaStreamTrack
+                    );
                   }
                 }
               }
@@ -652,12 +751,12 @@ class LiveKitProvider extends BaseProvider {
   }
   /**
    * Get the native LiveKit Room instance.
-   * 
+   *
    * Allows advanced users to access LiveKit-specific features
    * not exposed through the unified API.
-   * 
+   *
    * @returns The LiveKit Room instance, or null if not connected
-   * 
+   *
    * @example
    * ```typescript
    * const room = provider.getNativeClient();