{"version":3,"file":"utils.mjs","sources":["../../../src/e2ee/utils.ts"],"sourcesContent":["import { type DataPacket, EncryptedPacketPayload } from '@livekit/protocol';\nimport type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';\nimport { ENCRYPTION_ALGORITHM } from './constants';\nimport type { KeyProviderOptions } from './types';\n\nexport function isE2EESupported() {\n  return isInsertableStreamSupported() || isScriptTransformSupported();\n}\n\nexport function isScriptTransformSupported() {\n  // @ts-ignore\n  return typeof window !== 'undefined' && typeof window.RTCRtpScriptTransform !== 'undefined';\n}\n\nexport function isInsertableStreamSupported() {\n  return (\n    typeof window !== 'undefined' &&\n    typeof window.RTCRtpSender !== 'undefined' &&\n    // @ts-ignore\n    typeof window.RTCRtpSender.prototype.createEncodedStreams !== 'undefined'\n  );\n}\n\nexport function isVideoFrame(\n  frame: RTCEncodedAudioFrame | RTCEncodedVideoFrame,\n): frame is RTCEncodedVideoFrame {\n  return 'type' in frame;\n}\n\nexport async function importKey(\n  keyBytes: NonSharedUint8Array | ArrayBuffer,\n  algorithm: string | { name: string } = { name: ENCRYPTION_ALGORITHM },\n  usage: 'derive' | 'encrypt' = 'encrypt',\n) {\n  // https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/importKey\n  return crypto.subtle.importKey(\n    'raw',\n    keyBytes,\n    algorithm,\n    false,\n    usage === 'derive' ? ['deriveBits', 'deriveKey'] : ['encrypt', 'decrypt'],\n  );\n}\n\nexport async function createKeyMaterialFromString(password: string) {\n  let enc = new TextEncoder();\n\n  const keyMaterial = await crypto.subtle.importKey(\n    'raw',\n    enc.encode(password),\n    {\n      name: 'PBKDF2',\n    },\n    false,\n    ['deriveBits', 'deriveKey'],\n  );\n\n  return keyMaterial;\n}\n\nexport async function createKeyMaterialFromBuffer(cryptoBuffer: ArrayBuffer) {\n  const keyMaterial = await crypto.subtle.importKey('raw', cryptoBuffer, 'HKDF', false, [\n    'deriveBits',\n    'deriveKey',\n  ]);\n\n  return keyMaterial;\n}\n\nfunction getAlgoOptions(algorithmName: string, salt: string) {\n  const textEncoder = new TextEncoder();\n  const encodedSalt = textEncoder.encode(salt);\n  switch (algorithmName) {\n    case 'HKDF':\n      return {\n        name: 'HKDF',\n        salt: encodedSalt,\n        hash: 'SHA-256',\n        info: new ArrayBuffer(128),\n      };\n    case 'PBKDF2': {\n      return {\n        name: 'PBKDF2',\n        salt: encodedSalt,\n        hash: 'SHA-256',\n        iterations: 100000,\n      };\n    }\n    default:\n      throw new Error(`algorithm ${algorithmName} is currently unsupported`);\n  }\n}\n\n/**\n * Derives a set of keys from the master key.\n * See https://tools.ietf.org/html/draft-omara-sframe-00#section-4.3.1\n */\nexport async function deriveKeys(material: CryptoKey, options: KeyProviderOptions) {\n  const algorithmOptions = getAlgoOptions(material.algorithm.name, options.ratchetSalt);\n\n  // https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/deriveKey#HKDF\n  // https://developer.mozilla.org/en-US/docs/Web/API/HkdfParams\n  const encryptionKey = await crypto.subtle.deriveKey(\n    algorithmOptions,\n    material,\n    {\n      name: ENCRYPTION_ALGORITHM,\n      length: options.keySize,\n    },\n    false,\n    ['encrypt', 'decrypt'],\n  );\n\n  return { material, encryptionKey };\n}\n\nexport function createE2EEKey(): NonSharedUint8Array {\n  return window.crypto.getRandomValues(new Uint8Array(32));\n}\n\n/**\n * Ratchets a key. See\n * https://tools.ietf.org/html/draft-omara-sframe-00#section-4.3.5.1\n */\nexport async function ratchet(material: CryptoKey, salt: string): Promise<ArrayBuffer> {\n  const algorithmOptions = getAlgoOptions(material.algorithm.name, salt);\n\n  // https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/deriveBits\n  return crypto.subtle.deriveBits(algorithmOptions, material, 256);\n}\n\nexport function needsRbspUnescaping(frameData: NonSharedUint8Array) {\n  for (var i = 0; i < frameData.length - 3; i++) {\n    if (frameData[i] == 0 && frameData[i + 1] == 0 && frameData[i + 2] == 3) return true;\n  }\n  return false;\n}\n\nexport function parseRbsp(stream: NonSharedUint8Array): NonSharedUint8Array {\n  const dataOut: number[] = [];\n  var length = stream.length;\n  for (var i = 0; i < stream.length;) {\n    // Be careful about over/underflow here. byte_length_ - 3 can underflow, and\n    // i + 3 can overflow, but byte_length_ - i can't, because i < byte_length_\n    // above, and that expression will produce the number of bytes left in\n    // the stream including the byte at i.\n    if (length - i >= 3 && !stream[i] && !stream[i + 1] && stream[i + 2] == 3) {\n      // Two rbsp bytes.\n      dataOut.push(stream[i++]);\n      dataOut.push(stream[i++]);\n      // Skip the emulation byte.\n      i++;\n    } else {\n      // Single rbsp byte.\n      dataOut.push(stream[i++]);\n    }\n  }\n  return new Uint8Array(dataOut);\n}\n\nconst kZerosInStartSequence = 2;\nconst kEmulationByte = 3;\n\n/**\n * Inserts an emulation prevention byte before every byte <= 3 that follows two zeros.\n * Returns `dataIn` itself when nothing needs escaping, which is the case for almost\n * every encrypted frame. Callers must not mutate the result in place.\n */\nexport function writeRbsp(dataIn: NonSharedUint8Array): NonSharedUint8Array {\n  // Indices of the bytes that need an emulation byte in front of them.\n  const escapes: number[] = [];\n  let numConsecutiveZeros = 0;\n  for (let i = 0; i < dataIn.length; ++i) {\n    const byte = dataIn[i];\n    if (byte <= kEmulationByte && numConsecutiveZeros >= kZerosInStartSequence) {\n      escapes.push(i);\n      numConsecutiveZeros = 0;\n    }\n    numConsecutiveZeros = byte === 0 ? numConsecutiveZeros + 1 : 0;\n  }\n  if (escapes.length === 0) {\n    return dataIn;\n  }\n  const dataOut = new Uint8Array(dataIn.length + escapes.length);\n  let from = 0;\n  for (let k = 0; k < escapes.length; ++k) {\n    // Shifted by k for the emulation bytes already written.\n    dataOut.set(dataIn.subarray(from, escapes[k]), from + k);\n    dataOut[escapes[k] + k] = kEmulationByte;\n    from = escapes[k];\n  }\n  dataOut.set(dataIn.subarray(from), from + escapes.length);\n  return dataOut;\n}\n\nexport function asEncryptablePacket(packet: DataPacket): EncryptedPacketPayload | undefined {\n  if (\n    packet.value?.case !== 'sipDtmf' &&\n    packet.value?.case !== 'metrics' &&\n    packet.value?.case !== 'speaker' &&\n    packet.value?.case !== 'transcription' &&\n    packet.value?.case !== 'encryptedPacket'\n  ) {\n    return new EncryptedPacketPayload({\n      value: packet.value,\n    });\n  }\n  return undefined;\n}\n"],"names":["isE2EESupported","isInsertableStreamSupported","isScriptTransformSupported","window","RTCRtpScriptTransform","RTCRtpSender","prototype","createEncodedStreams","isVideoFrame","frame","importKey","keyBytes_1","keyBytes","algorithm","name","ENCRYPTION_ALGORITHM","usage","arguments","length","undefined","crypto","subtle","createKeyMaterialFromString","password","enc","TextEncoder","keyMaterial","encode","createKeyMaterialFromBuffer","cryptoBuffer","getAlgoOptions","algorithmName","salt","textEncoder","encodedSalt","hash","info","ArrayBuffer","iterations","Error","concat","deriveKeys","material","options","algorithmOptions","ratchetSalt","encryptionKey","deriveKey","keySize","createE2EEKey","getRandomValues","Uint8Array","ratchet","deriveBits","needsRbspUnescaping","frameData","i","parseRbsp","stream","dataOut","push","kZerosInStartSequence","kEmulationByte","writeRbsp","dataIn","escapes","numConsecutiveZeros","byte","from","k","set","subarray","asEncryptablePacket","packet","value","_a","case","_b","_c","_d","_e","EncryptedPacketPayload"],"mappings":"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"}