{"version":3,"file":"KeyProvider.mjs","sources":["../../../src/e2ee/KeyProvider.ts"],"sourcesContent":["import { EventEmitter } from 'events';\nimport type TypedEventEmitter from 'typed-emitter';\nimport log from '../logger';\nimport { KEY_PROVIDER_DEFAULTS } from './constants';\nimport { type KeyProviderCallbacks, KeyProviderEvent } from './events';\nimport type { KeyInfo, KeyProviderOptions, RatchetResult } from './types';\nimport { createKeyMaterialFromBuffer, createKeyMaterialFromString } from './utils';\n\n/**\n * @experimental\n */\nexport class BaseKeyProvider extends (EventEmitter as new () => TypedEventEmitter<KeyProviderCallbacks>) {\n  private keyInfoMap: Map<string, KeyInfo>;\n\n  private readonly options: KeyProviderOptions;\n\n  private latestManuallySetKeyIndex = 0;\n\n  constructor(options: Partial<KeyProviderOptions> = {}) {\n    super();\n    this.keyInfoMap = new Map();\n    this.options = { ...KEY_PROVIDER_DEFAULTS, ...options };\n    this.on(KeyProviderEvent.KeyRatcheted, this.onKeyRatcheted);\n  }\n\n  /**\n   * callback to invoke once a key has been set for a participant\n   * @param key\n   * @param participantIdentity\n   * @param keyIndex\n   */\n  protected onSetEncryptionKey(key: CryptoKey, participantIdentity?: string, keyIndex?: number) {\n    const keyInfo: KeyInfo = { key, participantIdentity, keyIndex };\n    if (!this.options.sharedKey && !participantIdentity) {\n      throw new Error(\n        'participant identity needs to be passed for encryption key if sharedKey option is false',\n      );\n    }\n    this.keyInfoMap.set(`${participantIdentity ?? 'shared'}-${keyIndex ?? 0}`, keyInfo);\n    if (keyIndex !== undefined) {\n      this.latestManuallySetKeyIndex = keyIndex;\n    }\n    this.emit(KeyProviderEvent.SetKey, keyInfo, keyIndex !== undefined);\n  }\n\n  /**\n   * Callback being invoked after a key has been ratcheted.\n   * Can happen when:\n   * - A decryption failure occurs and the key is auto-ratcheted\n   * - A ratchet request is sent (see {@link ratchetKey()})\n   * @param ratchetResult Contains the ratcheted chain key (exportable to other participants) and the derived new key material.\n   * @param participantId\n   * @param keyIndex\n   */\n  protected onKeyRatcheted = (\n    ratchetResult: RatchetResult,\n    participantId?: string,\n    keyIndex?: number,\n  ) => {\n    // ratchetResult holds key material, so it stays out of the log.\n    log.debug('key ratcheted event received', { participantId, keyIndex });\n  };\n\n  getKeys() {\n    return Array.from(this.keyInfoMap.values());\n  }\n\n  getLatestManuallySetKeyIndex() {\n    return this.latestManuallySetKeyIndex;\n  }\n\n  getOptions() {\n    return this.options;\n  }\n\n  ratchetKey(participantIdentity?: string, keyIndex?: number) {\n    this.emit(KeyProviderEvent.RatchetRequest, participantIdentity, keyIndex);\n  }\n}\n\n/**\n * A basic KeyProvider implementation intended for a single shared\n * passphrase between all participants\n * @experimental\n */\nexport class ExternalE2EEKeyProvider extends BaseKeyProvider {\n  ratchetInterval: number | undefined;\n\n  constructor(options: Partial<Omit<KeyProviderOptions, 'sharedKey'>> = {}) {\n    const opts: Partial<KeyProviderOptions> = {\n      ...options,\n      sharedKey: true,\n      // for a shared key provider failing to decrypt for a specific participant\n      // should not mark the key as invalid, so we accept wrong keys forever\n      // and won't try to auto-ratchet\n      ratchetWindowSize: 0,\n      failureTolerance: -1,\n    };\n    super(opts);\n  }\n\n  /**\n   * Accepts a passphrase that's used to create the crypto keys.\n   * When passing in a string, PBKDF2 is used. (recommended for maximum compatibility across SDKs)\n   * When passing in an ArrayBuffer of cryptographically random numbers, HKDF is used.\n   *\n   * Note: Not all client SDKS support HKDF.\n   * @param key\n   */\n  async setKey(key: string | ArrayBuffer) {\n    const derivedKey =\n      typeof key === 'string'\n        ? await createKeyMaterialFromString(key)\n        : await createKeyMaterialFromBuffer(key);\n    this.onSetEncryptionKey(derivedKey);\n  }\n}\n"],"names":["BaseKeyProvider","EventEmitter","constructor","options","latestManuallySetKeyIndex","onKeyRatcheted","ratchetResult","participantId","keyIndex","log","debug","keyInfoMap","Map","Object","assign","KEY_PROVIDER_DEFAULTS","on","KeyProviderEvent","KeyRatcheted","onSetEncryptionKey","key","participantIdentity","keyInfo","sharedKey","Error","set","concat","undefined","emit","SetKey","getKeys","Array","from","values","getLatestManuallySetKeyIndex","getOptions","ratchetKey","RatchetRequest","ExternalE2EEKeyProvider","opts","ratchetWindowSize","failureTolerance","setKey","derivedKey","createKeyMaterialFromString","createKeyMaterialFromBuffer"],"mappings":"2RAQA;;AAEG;AACG,MAAOA,eAAgB,SAASC,YAAkE,CAAA;AAOtGC,EAAAA,WAAAA,GAAqD;AAAA,IAAA,IAAzCC,8EAAuC,EAAE;AACnD,IAAA,KAAK,EAAE;IAHD,IAAA,CAAAC,yBAAyB,GAAG,CAAC;AA6BrC;;;;;;;;AAQG;IACO,IAAA,CAAAC,cAAc,GAAG,CACzBC,aAA4B,EAC5BC,aAAsB,EACtBC,QAAiB,KACf;AACF;AACAC,MAAAA,aAAG,CAACC,KAAK,CAAC,8BAA8B,EAAE;QAAEH,aAAa;AAAEC,QAAAA;AAAQ,OAAE,CAAC;IACxE,CAAC;AAzCC,IAAA,IAAI,CAACG,UAAU,GAAG,IAAIC,GAAG,EAAE;AAC3B,IAAA,IAAI,CAACT,OAAO,GAAAU,MAAA,CAAAC,MAAA,CAAAD,MAAA,CAAAC,MAAA,CAAA,EAAA,EAAQC,qBAAqB,CAAA,EAAKZ,OAAO,CAAE;IACvD,IAAI,CAACa,EAAE,CAACC,gBAAgB,CAACC,YAAY,EAAE,IAAI,CAACb,cAAc,CAAC;AAC7D,EAAA;AAEA;;;;;AAKG;AACOc,EAAAA,kBAAkBA,CAACC,GAAc,EAAEC,mBAA4B,EAAEb,QAAiB,EAAA;AAC1F,IAAA,MAAMc,OAAO,GAAY;MAAEF,GAAG;MAAEC,mBAAmB;AAAEb,MAAAA;KAAU;IAC/D,IAAI,CAAC,IAAI,CAACL,OAAO,CAACoB,SAAS,IAAI,CAACF,mBAAmB,EAAE;AACnD,MAAA,MAAM,IAAIG,KAAK,CACb,yFAAyF,CAC1F;AACH,IAAA;AACA,IAAA,IAAI,CAACb,UAAU,CAACc,GAAG,CAAA,EAAA,CAAAC,MAAA,CAAIL,mBAAmB,KAAA,IAAA,IAAnBA,mBAAmB,KAAA,MAAA,GAAnBA,mBAAmB,GAAI,QAAQ,EAAA,GAAA,CAAA,CAAAK,MAAA,CAAIlB,QAAQ,KAAA,IAAA,IAARA,QAAQ,KAAA,MAAA,GAARA,QAAQ,GAAI,CAAC,CAAA,EAAIc,OAAO,CAAC;IACnF,IAAId,QAAQ,KAAKmB,SAAS,EAAE;MAC1B,IAAI,CAACvB,yBAAyB,GAAGI,QAAQ;AAC3C,IAAA;AACA,IAAA,IAAI,CAACoB,IAAI,CAACX,gBAAgB,CAACY,MAAM,EAAEP,OAAO,EAAEd,QAAQ,KAAKmB,SAAS,CAAC;AACrE,EAAA;AAoBAG,EAAAA,OAAOA,GAAA;IACL,OAAOC,KAAK,CAACC,IAAI,CAAC,IAAI,CAACrB,UAAU,CAACsB,MAAM,EAAE,CAAC;AAC7C,EAAA;AAEAC,EAAAA,4BAA4BA,GAAA;IAC1B,OAAO,IAAI,CAAC9B,yBAAyB;AACvC,EAAA;AAEA+B,EAAAA,UAAUA,GAAA;IACR,OAAO,IAAI,CAAChC,OAAO;AACrB,EAAA;AAEAiC,EAAAA,UAAUA,CAACf,mBAA4B,EAAEb,QAAiB,EAAA;IACxD,IAAI,CAACoB,IAAI,CAACX,gBAAgB,CAACoB,cAAc,EAAEhB,mBAAmB,EAAEb,QAAQ,CAAC;AAC3E,EAAA;AACD;AAED;;;;AAIG;AACG,MAAO8B,uBAAwB,SAAQtC,eAAe,CAAA;AAG1DE,EAAAA,WAAAA,GAAwE;AAAA,IAAA,IAA5DC,8EAA0D,EAAE;AACtE,IAAA,MAAMoC,IAAI,GAAA1B,MAAA,CAAAC,MAAA,CAAAD,MAAA,CAAAC,MAAA,CAAA,EAAA,EACLX,OAAO,CAAA,EAAA;AACVoB,MAAAA,SAAS,EAAE,IAAI;AACf;AACA;AACA;AACAiB,MAAAA,iBAAiB,EAAE,CAAC;AACpBC,MAAAA,gBAAgB,EAAE;MACnB;IACD,KAAK,CAACF,IAAI,CAAC;AACb,EAAA;AAEA;;;;;;;AAOG;EACGG,MAAMA,CAACtB,GAAyB,EAAA;;AACpC,MAAA,MAAMuB,UAAU,GACd,OAAOvB,GAAG,KAAK,QAAQ,GACnB,MAAMwB,2BAA2B,CAACxB,GAAG,CAAC,GACtC,MAAMyB,2BAA2B,CAACzB,GAAG,CAAC;AAC5C,MAAA,IAAI,CAACD,kBAAkB,CAACwB,UAAU,CAAC;AACrC,IAAA,CAAC,CAAA;AAAA,EAAA;AACF"}