@twilio/voice-sdk/lib/twilio/uuid.ts

Twilio's JavaScript Voice SDK

/**
 * @packageDocumentation
 * @module Voice
 * @internalapi
 */

import * as md5Lib from 'md5';
import { NotSupportedError } from '../twilio/errors';

// If imported as an ESM module, sometimes md5 is available by accessing
// the "default" property of the imported library.
// @ts-ignore
const md5 = typeof md5Lib === 'function' ? md5Lib : md5Lib.default;

function generateUuid(): string {
  if (typeof window !== 'object') {
    throw new NotSupportedError('This platform is not supported.');
  }

  const crypto: Crypto & { randomUUID?: () => string } = window.crypto;
  if (typeof crypto !== 'object') {
    throw new NotSupportedError(
      'The `crypto` module is not available on this platform.',
    );
  }
  if (typeof (crypto.randomUUID || crypto.getRandomValues) === 'undefined') {
    throw new NotSupportedError(
      'Neither `crypto.randomUUID` or `crypto.getRandomValues` are available ' +
      'on this platform.',
    );
  }

  const uInt32Arr: typeof Uint32Array = window.Uint32Array;
  if (typeof uInt32Arr === 'undefined') {
    throw new NotSupportedError(
      'The `Uint32Array` module is not available on this platform.',
    );
  }

  const generateRandomValues: () => string =
    typeof crypto.randomUUID === 'function'
      ? () => crypto.randomUUID!()
      : () => crypto.getRandomValues(new Uint32Array(32)).toString();

  return md5(generateRandomValues());
}

export function generateVoiceEventSid() {
  return `KX${generateUuid()}`;
}