rx-player 4.0.0-beta.2 → 4.0.0-beta.3

package/dist/_esm5.processed/core/decrypt/__tests__/__global__/utils.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Copyright 2015 CANAL+ Group
  *
@@ -13,38 +14,14 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-import { base64ToBytes, bytesToBase64, } from "../../../../utils/base64";
-import EventEmitter from "../../../../utils/event_emitter";
-import flatMap from "../../../../utils/flat_map";
-import { strToUtf8, utf8ToStr, } from "../../../../utils/string_parsing";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFakeChallengeFromInitData = exports.extrackInfoFromFakeChallenge = exports.testContentDecryptorError = exports.mockCompat = exports.requestMediaKeySystemAccessImpl = exports.MediaKeySystemAccessImpl = exports.MediaKeysImpl = exports.MediaKeySessionImpl = exports.MediaKeyStatusMapImpl = exports.defaultWidevineConfig = exports.defaultPRRecommendationKSConfig = exports.defaultKSConfig = void 0;
+const base64_1 = require("../../../../utils/base64");
+const event_emitter_1 = require("../../../../utils/event_emitter");
+const flat_map_1 = require("../../../../utils/flat_map");
+const string_parsing_1 = require("../../../../utils/string_parsing");
 /** Default MediaKeySystemAccess configuration used by the RxPlayer. */
-export var defaultKSConfig = [
+exports.defaultKSConfig = [
     {
         audioCapabilities: [{ contentType: "audio/mp4;codecs=\"mp4a.40.2\"" },
             { contentType: "audio/webm;codecs=opus" }],
@@ -69,7 +46,7 @@ export var defaultKSConfig = [
  * Default "com.microsoft.playready.recommendation" MediaKeySystemAccess
  * configuration used by the RxPlayer.
  */
-export var defaultPRRecommendationKSConfig = [
+exports.defaultPRRecommendationKSConfig = [
     {
         audioCapabilities: [{ robustness: "3000",
                 contentType: "audio/mp4;codecs=\"mp4a.40.2\"" },
@@ -106,59 +83,59 @@ export var defaultPRRecommendationKSConfig = [
     },
 ];
 /** Default Widevine MediaKeySystemAccess configuration used by the RxPlayer. */
-export var defaultWidevineConfig = (function () {
-    var ROBUSTNESSES = ["HW_SECURE_ALL",
+exports.defaultWidevineConfig = (() => {
+    const ROBUSTNESSES = ["HW_SECURE_ALL",
         "HW_SECURE_DECODE",
         "HW_SECURE_CRYPTO",
         "SW_SECURE_DECODE",
         "SW_SECURE_CRYPTO"];
-    var videoCapabilities = flatMap(ROBUSTNESSES, function (robustness) {
-        return [{ contentType: "video/mp4;codecs=\"avc1.4d401e\"", robustness: robustness },
-            { contentType: "video/mp4;codecs=\"avc1.42e01e\"", robustness: robustness },
-            { contentType: "video/webm;codecs=\"vp8\"", robustness: robustness }];
+    const videoCapabilities = (0, flat_map_1.default)(ROBUSTNESSES, robustness => {
+        return [{ contentType: "video/mp4;codecs=\"avc1.4d401e\"",
+                robustness },
+            { contentType: "video/mp4;codecs=\"avc1.42e01e\"",
+                robustness },
+            { contentType: "video/webm;codecs=\"vp8\"",
+                robustness }];
     });
-    var audioCapabilities = flatMap(ROBUSTNESSES, function (robustness) {
-        return [{ contentType: "audio/mp4;codecs=\"mp4a.40.2\"", robustness: robustness },
-            { contentType: "audio/webm;codecs=opus", robustness: robustness }];
+    const audioCapabilities = (0, flat_map_1.default)(ROBUSTNESSES, robustness => {
+        return [{ contentType: "audio/mp4;codecs=\"mp4a.40.2\"",
+                robustness },
+            { contentType: "audio/webm;codecs=opus",
+                robustness }];
     });
     return [
-        __assign(__assign({}, defaultKSConfig[0]), { audioCapabilities: audioCapabilities, videoCapabilities: videoCapabilities }),
-        defaultKSConfig[1],
+        Object.assign(Object.assign({}, exports.defaultKSConfig[0]), { audioCapabilities, videoCapabilities }),
+        exports.defaultKSConfig[1],
     ];
 })();
 /**
  * Custom implementation of an EME-compliant MediaKeyStatusMap.
  * @class MediaKeyStatusMapImpl
  */
-var MediaKeyStatusMapImpl = /** @class */ (function () {
-    function MediaKeyStatusMapImpl() {
+class MediaKeyStatusMapImpl {
+    get size() {
+        return this._map.size;
+    }
+    constructor() {
         this._map = new Map();
     }
-    Object.defineProperty(MediaKeyStatusMapImpl.prototype, "size", {
-        get: function () {
-            return this._map.size;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    MediaKeyStatusMapImpl.prototype.get = function (keyId) {
-        var keyIdAB = keyId instanceof ArrayBuffer ? keyId :
+    get(keyId) {
+        const keyIdAB = keyId instanceof ArrayBuffer ? keyId :
             keyId.buffer;
         return this._map.get(keyIdAB);
-    };
-    MediaKeyStatusMapImpl.prototype.has = function (keyId) {
-        var keyIdAB = keyId instanceof ArrayBuffer ? keyId :
+    }
+    has(keyId) {
+        const keyIdAB = keyId instanceof ArrayBuffer ? keyId :
             keyId.buffer;
         return this._map.has(keyIdAB);
-    };
-    MediaKeyStatusMapImpl.prototype.forEach = function (callbackfn, 
+    }
+    forEach(callbackfn, 
     // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
     thisArg) {
-        var _this = this;
-        this._map.forEach(function (value, key) { return callbackfn.bind(thisArg, value, key, _this); });
-    };
-    MediaKeyStatusMapImpl.prototype._setKeyStatus = function (keyId, value) {
-        var keyIdAB = keyId instanceof ArrayBuffer ? keyId :
+        this._map.forEach((value, key) => callbackfn.bind(thisArg, value, key, this));
+    }
+    _setKeyStatus(keyId, value) {
+        const keyIdAB = keyId instanceof ArrayBuffer ? keyId :
             keyId.buffer;
         if (value === undefined) {
             this._map.delete(keyIdAB);
@@ -166,194 +143,191 @@ var MediaKeyStatusMapImpl = /** @class */ (function () {
         else {
             this._map.set(keyIdAB, value);
         }
-    };
-    return MediaKeyStatusMapImpl;
-}());
-export { MediaKeyStatusMapImpl };
+    }
+}
+exports.MediaKeyStatusMapImpl = MediaKeyStatusMapImpl;
 /**
  * Custom implementation of an EME-compliant MediaKeySession.
  * @class MediaKeySessionImpl
  */
-var MediaKeySessionImpl = /** @class */ (function (_super) {
-    __extends(MediaKeySessionImpl, _super);
-    function MediaKeySessionImpl() {
-        var _this = _super.call(this) || this;
-        _this._currentKeyId = 0;
-        _this.expiration = Number.MAX_VALUE;
-        _this.keyStatuses = new MediaKeyStatusMapImpl();
-        _this.closed = new Promise(function (res) {
-            _this._close = res;
+class MediaKeySessionImpl extends event_emitter_1.default {
+    constructor() {
+        super();
+        this._currentKeyId = 0;
+        this.expiration = Number.MAX_VALUE;
+        this.keyStatuses = new MediaKeyStatusMapImpl();
+        this.closed = new Promise((res) => {
+            this._close = res;
         });
-        _this.onkeystatuseschange = null;
-        _this.onmessage = null;
-        _this.sessionId = "";
-        return _this;
+        this.onkeystatuseschange = null;
+        this.onmessage = null;
+        this.sessionId = "";
     }
-    MediaKeySessionImpl.prototype.close = function () {
+    close() {
         if (this._close !== undefined) {
             this._close();
         }
         return Promise.resolve();
-    };
-    MediaKeySessionImpl.prototype.generateRequest = function (initDataType, initData) {
-        var _this = this;
-        var msg = formatFakeChallengeFromInitData(initData, initDataType);
-        setTimeout(function () {
-            var event = Object.assign(new CustomEvent("message"), { message: msg.buffer,
+    }
+    generateRequest(initDataType, initData) {
+        const msg = formatFakeChallengeFromInitData(initData, initDataType);
+        setTimeout(() => {
+            const event = Object.assign(new CustomEvent("message"), { message: msg.buffer,
                 messageType: "license-request" });
-            _this.trigger("message", event);
-            if (_this.onmessage !== null && _this.onmessage !== undefined) {
-                _this.onmessage(event);
+            this.trigger("message", event);
+            if (this.onmessage !== null && this.onmessage !== undefined) {
+                this.onmessage(event);
             }
         }, 5);
         return Promise.resolve();
-    };
-    MediaKeySessionImpl.prototype.load = function (_sessionId) {
+    }
+    load(_sessionId) {
         throw new Error("Not implemented yet");
-    };
-    MediaKeySessionImpl.prototype.remove = function () {
+    }
+    remove() {
         return Promise.resolve();
-    };
-    MediaKeySessionImpl.prototype.update = function (_response) {
-        var _this = this;
+    }
+    update(_response) {
         this.keyStatuses._setKeyStatus(new Uint8Array([0, 1, 2, this._currentKeyId++]), "usable");
-        var event = new CustomEvent("keystatuseschange");
-        setTimeout(function () {
-            _this.trigger("keyStatusesChange", event);
-            if (_this.onkeystatuseschange !== null && _this.onkeystatuseschange !== undefined) {
-                _this.onkeystatuseschange(event);
+        const event = new CustomEvent("keystatuseschange");
+        setTimeout(() => {
+            this.trigger("keyStatusesChange", event);
+            if (this.onkeystatuseschange !== null && this.onkeystatuseschange !== undefined) {
+                this.onkeystatuseschange(event);
             }
         }, 50);
         return Promise.resolve();
-    };
-    return MediaKeySessionImpl;
-}(EventEmitter));
-export { MediaKeySessionImpl };
+    }
+}
+exports.MediaKeySessionImpl = MediaKeySessionImpl;
 /**
  * Custom implementation of an EME-compliant MediaKeys.
  * @class MediaKeysImpl
  */
-var MediaKeysImpl = /** @class */ (function () {
-    function MediaKeysImpl() {
-    }
-    MediaKeysImpl.prototype.createSession = function (_sessionType) {
+class MediaKeysImpl {
+    createSession(_sessionType) {
         return new MediaKeySessionImpl();
-    };
-    MediaKeysImpl.prototype.setServerCertificate = function (_serverCertificate) {
+    }
+    setServerCertificate(_serverCertificate) {
         return Promise.resolve(true);
-    };
-    return MediaKeysImpl;
-}());
-export { MediaKeysImpl };
+    }
+}
+exports.MediaKeysImpl = MediaKeysImpl;
 /**
  * Custom implementation of an EME-compliant MediaKeySystemAccess.
  * @class MediaKeySystemAccessImpl
  */
-var MediaKeySystemAccessImpl = /** @class */ (function () {
-    function MediaKeySystemAccessImpl(keySystem, config) {
+class MediaKeySystemAccessImpl {
+    constructor(keySystem, config) {
         this.keySystem = keySystem;
         this._config = config;
     }
-    MediaKeySystemAccessImpl.prototype.createMediaKeys = function () {
+    createMediaKeys() {
         return Promise.resolve(new MediaKeysImpl());
-    };
-    MediaKeySystemAccessImpl.prototype.getConfiguration = function () {
+    }
+    getConfiguration() {
         return this._config;
-    };
-    return MediaKeySystemAccessImpl;
-}());
-export { MediaKeySystemAccessImpl };
-export function requestMediaKeySystemAccessImpl(keySystem, config) {
+    }
+}
+exports.MediaKeySystemAccessImpl = MediaKeySystemAccessImpl;
+function requestMediaKeySystemAccessImpl(keySystem, config) {
     return Promise.resolve(new MediaKeySystemAccessImpl(keySystem, config));
 }
-var MockedDecryptorEventEmitter = /** @class */ (function (_super) {
-    __extends(MockedDecryptorEventEmitter, _super);
-    function MockedDecryptorEventEmitter() {
-        return _super !== null && _super.apply(this, arguments) || this;
+exports.requestMediaKeySystemAccessImpl = requestMediaKeySystemAccessImpl;
+class MockedDecryptorEventEmitter extends event_emitter_1.default {
+    triggerEncrypted(elt, value) {
+        this.trigger("encrypted", { elt, value });
     }
-    MockedDecryptorEventEmitter.prototype.triggerEncrypted = function (elt, value) {
-        this.trigger("encrypted", { elt: elt, value: value });
-    };
-    MockedDecryptorEventEmitter.prototype.triggerKeyError = function (session, value) {
-        this.trigger("keyerror", { session: session, value: value });
-    };
-    MockedDecryptorEventEmitter.prototype.triggerKeyStatusesChange = function (session, value) {
-        this.trigger("keystatuseschange", { session: session, value: value });
-    };
-    MockedDecryptorEventEmitter.prototype.triggerKeyMessage = function (session, value) {
-        this.trigger("keymessage", { session: session, value: value });
-    };
-    return MockedDecryptorEventEmitter;
-}(EventEmitter));
+    triggerKeyError(session, value) {
+        this.trigger("keyerror", { session, value });
+    }
+    triggerKeyStatusesChange(session, value) {
+        this.trigger("keystatuseschange", { session, value });
+    }
+    triggerKeyMessage(session, value) {
+        this.trigger("keymessage", { session, value });
+    }
+}
 /**
  * Mock functions coming from the compat directory.
  */
 // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
-export function mockCompat(exportedFunctions) {
-    if (exportedFunctions === void 0) { exportedFunctions = {}; }
-    var ee = new MockedDecryptorEventEmitter();
-    var mockEvents = {
-        onEncrypted: jest.fn(function (elt, fn, signal) {
-            elt.addEventListener("encrypted", fn);
-            signal.register(function () {
-                elt.removeEventListener("encrypted", fn);
-            });
-            ee.addEventListener("encrypted", function (evt) {
-                if (evt.elt === elt) {
-                    fn(evt.value);
-                }
-            }, signal);
-        }),
-        onKeyMessage: jest.fn(function (elt, fn, signal) {
+function mockCompat(exportedFunctions = {}) {
+    var _a, _b, _c;
+    const ee = new MockedDecryptorEventEmitter();
+    const onEncrypted = (_a = exportedFunctions.onEncrypted) !== null && _a !== void 0 ? _a : jest.fn((elt, fn, signal) => {
+        elt.addEventListener("encrypted", fn);
+        signal.register(() => {
+            elt.removeEventListener("encrypted", fn);
+        });
+        ee.addEventListener("encrypted", (evt) => {
+            if (evt.elt === elt) {
+                fn(evt.value);
+            }
+        }, signal);
+    });
+    const mockEvents = {
+        onKeyMessage: jest.fn((elt, fn, signal) => {
             elt.addEventListener("message", fn, signal);
-            ee.addEventListener("keymessage", function (evt) {
+            ee.addEventListener("keymessage", (evt) => {
                 if (evt.session === elt) {
                     fn(evt.value);
                 }
             }, signal);
         }),
-        onKeyError: jest.fn(function (elt, fn, signal) {
+        onKeyError: jest.fn((elt, fn, signal) => {
             elt.addEventListener("error", fn, signal);
-            ee.addEventListener("keyerror", function (evt) {
+            ee.addEventListener("keyerror", (evt) => {
                 if (evt.session === elt) {
                     fn(evt.value);
                 }
             }, signal);
         }),
-        onKeyStatusesChange: jest.fn(function (elt, fn, signal) {
+        onKeyStatusesChange: jest.fn((elt, fn, signal) => {
             elt.addEventListener("keystatuseschange", fn, signal);
-            ee.addEventListener("keystatuseschange", function (evt) {
+            ee.addEventListener("keystatuseschange", (evt) => {
                 if (evt.session === elt) {
                     fn(evt.value);
                 }
             }, signal);
         }),
     };
-    var mockRmksa = jest.fn(requestMediaKeySystemAccessImpl);
-    var mockSetMediaKeys = jest.fn();
-    var mockGenerateKeyRequest = jest.fn(function (mks, initializationDataType, initializationData) {
+    const mockRmksa = (_b = exportedFunctions.requestMediaKeySystemAccess) !== null && _b !== void 0 ? _b : jest.fn(requestMediaKeySystemAccessImpl);
+    const mockSetMediaKeys = (_c = exportedFunctions.setMediaKeys) !== null && _c !== void 0 ? _c : jest.fn(() => Promise.resolve());
+    const mockGenerateKeyRequest = jest.fn((mks, initializationDataType, initializationData) => {
         return mks.generateRequest(initializationDataType, initializationData);
     });
-    var mockGetInitData = jest.fn(function (encryptedEvent) {
+    const mockGetInitData = jest.fn((encryptedEvent) => {
         return encryptedEvent;
     });
-    jest.mock("../../../../compat", function () { return (__assign({ events: mockEvents, requestMediaKeySystemAccess: mockRmksa, setMediaKeys: mockSetMediaKeys, getInitData: mockGetInitData, generateKeyRequest: mockGenerateKeyRequest, shouldRenewMediaKeySystemAccess: jest.fn(function () { return false; }), canReuseMediaKeys: jest.fn(function () { return true; }) }, exportedFunctions)); });
-    return { mockEvents: mockEvents, eventTriggers: {
-            triggerEncrypted: function (elt, value) {
+    jest.mock("../../../../compat", () => (Object.assign({ events: mockEvents, shouldRenewMediaKeySystemAccess: jest.fn(() => false), shouldWaitForEncryptedBeforeAttachment: jest.fn(() => false), canReuseMediaKeys: jest.fn(() => true) }, exportedFunctions)));
+    const emeImplementation = {
+        onEncrypted,
+        requestMediaKeySystemAccess: mockRmksa,
+        setMediaKeys: mockSetMediaKeys,
+    };
+    jest.mock("../../../../compat/eme", () => (Object.assign({ __esModule: true, default: emeImplementation, getInitData: mockGetInitData, generateKeyRequest: mockGenerateKeyRequest }, exportedFunctions)));
+    return { mockEvents,
+        eventTriggers: {
+            triggerEncrypted(elt, value) {
                 ee.triggerEncrypted(elt, value);
             },
-            triggerKeyMessage: function (session, value) {
+            triggerKeyMessage(session, value) {
                 ee.triggerKeyMessage(session, value);
             },
-            triggerKeyError: function (session, value) {
+            triggerKeyError(session, value) {
                 ee.triggerKeyError(session, value);
             },
-            triggerKeyStatusesChange: function (session, value) {
+            triggerKeyStatusesChange(session, value) {
                 ee.triggerKeyStatusesChange(session, value);
             },
         },
-        mockRequestMediaKeySystemAccess: mockRmksa, mockGetInitData: mockGetInitData, mockSetMediaKeys: mockSetMediaKeys, mockGenerateKeyRequest: mockGenerateKeyRequest };
+        mockRequestMediaKeySystemAccess: mockRmksa,
+        mockGetInitData,
+        mockSetMediaKeys,
+        mockGenerateKeyRequest };
 }
+exports.mockCompat = mockCompat;
 /**
  * Check that the ContentDecryptor, when called with those arguments, throws.
  * If that's the case, resolve with the corresponding error.
@@ -363,36 +337,39 @@ export function mockCompat(exportedFunctions) {
  * @param {Array} keySystemsConfigs
  * @returns {Promise}
  */
-export function testContentDecryptorError(ContentDecryptor, mediaElement, keySystemsConfigs) {
-    return new Promise(function (res, rej) {
-        var contentDecryptor = new ContentDecryptor(mediaElement, keySystemsConfigs);
-        contentDecryptor.addEventListener("error", function (error) {
+function testContentDecryptorError(ContentDecryptor, mediaElement, keySystemsConfigs) {
+    return new Promise((res, rej) => {
+        const contentDecryptor = new ContentDecryptor(mediaElement, keySystemsConfigs);
+        contentDecryptor.addEventListener("error", (error) => {
             res(error);
         });
-        setTimeout(function () {
+        setTimeout(() => {
             rej(new Error("Timeout exceeded"));
         }, 10);
     });
 }
+exports.testContentDecryptorError = testContentDecryptorError;
 /**
  * Does the reverse operation than what `formatFakeChallengeFromInitData` does:
  * Retrieve initialization data from a fake challenge done in our tests
  * @param {Uint8Array} challenge
  * @returns {Object}
  */
-export function extrackInfoFromFakeChallenge(challenge) {
-    var licenseData = JSON.stringify(utf8ToStr(challenge));
-    var initData = base64ToBytes(licenseData[1]);
-    return { initData: initData, initDataType: licenseData[0] };
+function extrackInfoFromFakeChallenge(challenge) {
+    const licenseData = JSON.stringify((0, string_parsing_1.utf8ToStr)(challenge));
+    const initData = (0, base64_1.base64ToBytes)(licenseData[1]);
+    return { initData, initDataType: licenseData[0] };
 }
+exports.extrackInfoFromFakeChallenge = extrackInfoFromFakeChallenge;
 /**
  * @param {BufferSource} initData
  * @param {string} initDataType
  * @returns {Uint8Array}
  */
-export function formatFakeChallengeFromInitData(initData, initDataType) {
-    var initDataAB = initData instanceof ArrayBuffer ? initData :
+function formatFakeChallengeFromInitData(initData, initDataType) {
+    const initDataAB = initData instanceof ArrayBuffer ? initData :
         initData.buffer;
-    var objChallenge = [initDataType, bytesToBase64(new Uint8Array(initDataAB))];
-    return strToUtf8(JSON.stringify(objChallenge));
+    const objChallenge = [initDataType, (0, base64_1.bytesToBase64)(new Uint8Array(initDataAB))];
+    return (0, string_parsing_1.strToUtf8)(JSON.stringify(objChallenge));
 }
+exports.formatFakeChallengeFromInitData = formatFakeChallengeFromInitData;

package/dist/_esm5.processed/core/decrypt/attach_media_keys.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { ICustomMediaKeys, ICustomMediaKeySystemAccess } from "../../compat";
+import { ICustomMediaKeys, ICustomMediaKeySystemAccess, IEmeApiImplementation } from "../../compat/eme";
 import { IKeySystemOption } from "../../public_types";
 import { CancellationSignal } from "../../utils/task_canceller";
 import LoadedSessionsStore from "./utils/loaded_sessions_store";
@@ -32,7 +32,7 @@ export declare function disableMediaKeys(mediaElement: HTMLMediaElement): void;
  * @param {Object} cancelSignal
  * @returns {Promise}
  */
-export default function attachMediaKeys(mediaElement: HTMLMediaElement, { keySystemOptions, loadedSessionsStore, mediaKeySystemAccess, mediaKeys }: IMediaKeysState, cancelSignal: CancellationSignal): Promise<void>;
+export default function attachMediaKeys(mediaElement: HTMLMediaElement, { emeImplementation, keySystemOptions, loadedSessionsStore, mediaKeySystemAccess, mediaKeys }: IMediaKeysState, cancelSignal: CancellationSignal): Promise<void>;
 /** MediaKeys and associated state attached to a media element. */
 export interface IMediaKeysState {
     /** Options set when the MediaKeys has been attached. */
@@ -43,4 +43,10 @@ export interface IMediaKeysState {
     mediaKeySystemAccess: MediaKeySystemAccess | ICustomMediaKeySystemAccess;
     /** The MediaKeys instance to attach to the media element. */
     mediaKeys: MediaKeys | ICustomMediaKeys;
+    /**
+     * The chosen EME implementation abstraction linked to `mediaKeys`.
+     * Different EME implementation might for example be used while debugging or
+     * work-arounding EME-linked device issues.
+     */
+    emeImplementation: IEmeApiImplementation;
 }