rx-player 4.5.0-dev.2026012301 → 4.5.0-dev.2026012302

package/dist/commonjs/main_thread/decrypt/create_or_load_session.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright 2015 CANAL+ Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IMediaKeySession } from "../../compat/browser_compatibility_types";
+import type { CancellationSignal } from "../../utils/task_canceller";
+import type { IProcessedProtectionData, IMediaKeySessionStores } from "./types";
+import { MediaKeySessionLoadingType } from "./types";
+import type KeySessionRecord from "./utils/key_session_record";
+/**
+ * Handle MediaEncryptedEvents sent by a HTMLMediaElement:
+ * Either create a MediaKeySession, recuperate a previous MediaKeySession or
+ * load a persistent session.
+ *
+ * Some previously created MediaKeySession can be closed in this process to
+ * respect the maximum limit of concurrent MediaKeySession, as defined by the
+ * `EME_MAX_SIMULTANEOUS_MEDIA_KEY_SESSIONS` config property.
+ *
+ * You can refer to the events emitted to know about the current situation.
+ * @param {Object} initializationData
+ * @param {Object} stores
+ * @param {string} wantedSessionType
+ * @param {number} maxSessionCacheSize
+ * @param {Object} cancelSignal
+ * @returns {Promise}
+ */
+export default function createOrLoadSession(initializationData: IProcessedProtectionData, stores: IMediaKeySessionStores, wantedSessionType: MediaKeySessionType, maxSessionCacheSize: number, cancelSignal: CancellationSignal): Promise<ICreateOrLoadSessionResult>;
+/** Information concerning a MediaKeySession. */
+export interface IMediaKeySessionContext {
+    /** The MediaKeySession itself. */
+    mediaKeySession: IMediaKeySession;
+    /** The type of MediaKeySession (e.g. "temporary"). */
+    sessionType: MediaKeySessionType;
+    /** `KeySessionRecord` assiociated to this MediaKeySession. */
+    keySessionRecord: KeySessionRecord;
+}
+/** Event emitted when a new MediaKeySession has been created. */
+export interface ICreatedSession {
+    type: MediaKeySessionLoadingType.Created;
+    value: IMediaKeySessionContext;
+}
+/** Event emitted when an already-loaded MediaKeySession is used. */
+export interface ILoadedOpenSession {
+    type: MediaKeySessionLoadingType.LoadedOpenSession;
+    value: IMediaKeySessionContext;
+}
+/** Event emitted when a persistent MediaKeySession has been loaded. */
+export interface ILoadedPersistentSessionEvent {
+    type: MediaKeySessionLoadingType.LoadedPersistentSession;
+    value: IMediaKeySessionContext;
+}
+/** Every possible result returned by `createOrLoadSession`. */
+export type ICreateOrLoadSessionResult = ICreatedSession | ILoadedOpenSession | ILoadedPersistentSessionEvent;
+//# sourceMappingURL=create_or_load_session.d.ts.map

package/dist/commonjs/main_thread/decrypt/create_or_load_session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_or_load_session.d.ts","sourceRoot":"","sources":["../../../../src/main_thread/decrypt/create_or_load_session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAA8B,mBAAmB,CAC/C,kBAAkB,EAAE,wBAAwB,EAC5C,MAAM,EAAE,sBAAsB,EAC9B,iBAAiB,EAAE,mBAAmB,EACtC,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CA6DrC;AAED,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,eAAe,EAAE,gBAAgB,CAAC;IAClC,sDAAsD;IACtD,WAAW,EAAE,mBAAmB,CAAC;IACjC,8DAA8D;IAC9D,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,0BAA0B,CAAC,OAAO,CAAC;IACzC,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,0BAA0B,CAAC,iBAAiB,CAAC;IACnD,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,uEAAuE;AACvE,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,0BAA0B,CAAC,uBAAuB,CAAC;IACzD,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,+DAA+D;AAC/D,MAAM,MAAM,0BAA0B,GAClC,eAAe,GACf,kBAAkB,GAClB,6BAA6B,CAAC"}

package/dist/commonjs/main_thread/decrypt/create_or_load_session.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Copyright 2015 CANAL+ Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = createOrLoadSession;
+var log_1 = require("../../log");
+var create_session_1 = require("./create_session");
+var clean_old_loaded_sessions_1 = require("./utils/clean_old_loaded_sessions");
+var is_session_usable_1 = require("./utils/is_session_usable");
+/**
+ * Handle MediaEncryptedEvents sent by a HTMLMediaElement:
+ * Either create a MediaKeySession, recuperate a previous MediaKeySession or
+ * load a persistent session.
+ *
+ * Some previously created MediaKeySession can be closed in this process to
+ * respect the maximum limit of concurrent MediaKeySession, as defined by the
+ * `EME_MAX_SIMULTANEOUS_MEDIA_KEY_SESSIONS` config property.
+ *
+ * You can refer to the events emitted to know about the current situation.
+ * @param {Object} initializationData
+ * @param {Object} stores
+ * @param {string} wantedSessionType
+ * @param {number} maxSessionCacheSize
+ * @param {Object} cancelSignal
+ * @returns {Promise}
+ */
+function createOrLoadSession(initializationData, stores, wantedSessionType, maxSessionCacheSize, cancelSignal) {
+    return __awaiter(this, void 0, void 0, function () {
+        var previousLoadedSession, loadedSessionsStore, persistentSessionsStore, entry, evt;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    previousLoadedSession = null;
+                    loadedSessionsStore = stores.loadedSessionsStore, persistentSessionsStore = stores.persistentSessionsStore;
+                    entry = loadedSessionsStore.reuse(initializationData);
+                    if (entry !== null) {
+                        previousLoadedSession = entry.mediaKeySession;
+                        if ((0, is_session_usable_1.default)(previousLoadedSession)) {
+                            log_1.default.info("DRM", "Reuse loaded session", {
+                                sessionId: previousLoadedSession.sessionId,
+                            });
+                            return [2 /*return*/, {
+                                    type: "loaded-open-session" /* MediaKeySessionLoadingType.LoadedOpenSession */,
+                                    value: {
+                                        mediaKeySession: previousLoadedSession,
+                                        sessionType: entry.sessionType,
+                                        keySessionRecord: entry.keySessionRecord,
+                                    },
+                                }];
+                        }
+                        else if (persistentSessionsStore !== null) {
+                            // If the session is not usable anymore, we can also remove it from the
+                            // PersistentSessionsStore.
+                            // TODO Are we sure this is always what we want?
+                            if (entry.mediaKeySession.sessionId !== "") {
+                                persistentSessionsStore.delete(entry.mediaKeySession.sessionId);
+                            }
+                        }
+                    }
+                    if (!(previousLoadedSession !== null)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, loadedSessionsStore.closeSession(previousLoadedSession)];
+                case 1:
+                    _a.sent();
+                    if (cancelSignal.cancellationError !== null) {
+                        throw cancelSignal.cancellationError; // stop here if cancelled since
+                    }
+                    _a.label = 2;
+                case 2: return [4 /*yield*/, (0, clean_old_loaded_sessions_1.default)(loadedSessionsStore, 
+                    // Account for the next session we will be creating
+                    // Note that `maxSessionCacheSize < 0 has special semantic (no limit)`
+                    maxSessionCacheSize <= 0 ? maxSessionCacheSize : maxSessionCacheSize - 1)];
+                case 3:
+                    _a.sent();
+                    if (cancelSignal.cancellationError !== null) {
+                        throw cancelSignal.cancellationError; // stop here if cancelled since
+                    }
+                    return [4 /*yield*/, (0, create_session_1.default)(stores, initializationData, wantedSessionType, cancelSignal)];
+                case 4:
+                    evt = _a.sent();
+                    return [2 /*return*/, {
+                            type: evt.type,
+                            value: {
+                                mediaKeySession: evt.value.mediaKeySession,
+                                sessionType: evt.value.sessionType,
+                                keySessionRecord: evt.value.keySessionRecord,
+                            },
+                        }];
+            }
+        });
+    });
+}

package/dist/commonjs/main_thread/decrypt/create_session.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright 2015 CANAL+ Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IMediaKeySession } from "../../compat/browser_compatibility_types";
+import type { CancellationSignal } from "../../utils/task_canceller";
+import type { IProcessedProtectionData, IMediaKeySessionStores } from "./types";
+import { MediaKeySessionLoadingType } from "./types";
+import type KeySessionRecord from "./utils/key_session_record";
+/**
+ * Create a new Session or load a persistent one on the given MediaKeys,
+ * according to wanted settings and what is currently stored.
+ *
+ * If session creating fails, remove the oldest MediaKeySession loaded and
+ * retry.
+ *
+ * /!\ This only creates new sessions.
+ * It will fail if loadedSessionsStore already has a MediaKeySession with
+ * the given initialization data.
+ * @param {Object} stores
+ * @param {Object} initData
+ * @param {string} wantedSessionType
+ * @param {Object} cancelSignal
+ * @returns {Promise}
+ */
+export default function createSession(stores: IMediaKeySessionStores, initData: IProcessedProtectionData, wantedSessionType: MediaKeySessionType, cancelSignal: CancellationSignal): Promise<ICreateSessionEvent>;
+export interface INewSessionCreatedEvent {
+    type: MediaKeySessionLoadingType.Created;
+    value: {
+        mediaKeySession: IMediaKeySession;
+        sessionType: MediaKeySessionType;
+        keySessionRecord: KeySessionRecord;
+    };
+}
+export interface IPersistentSessionRecoveryEvent {
+    type: MediaKeySessionLoadingType.LoadedPersistentSession;
+    value: {
+        mediaKeySession: IMediaKeySession;
+        sessionType: MediaKeySessionType;
+        keySessionRecord: KeySessionRecord;
+    };
+}
+export type ICreateSessionEvent = INewSessionCreatedEvent | IPersistentSessionRecoveryEvent;
+//# sourceMappingURL=create_session.d.ts.map

package/dist/commonjs/main_thread/decrypt/create_session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_session.d.ts","sourceRoot":"","sources":["../../../../src/main_thread/decrypt/create_session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAI/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,wBAAwB,EAClC,iBAAiB,EAAE,mBAAmB,EACtC,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAkID,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,0BAA0B,CAAC,OAAO,CAAC;IACzC,KAAK,EAAE;QACL,eAAe,EAAE,gBAAgB,CAAC;QAClC,WAAW,EAAE,mBAAmB,CAAC;QACjC,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,0BAA0B,CAAC,uBAAuB,CAAC;IACzD,KAAK,EAAE;QACL,eAAe,EAAE,gBAAgB,CAAC;QAClC,WAAW,EAAE,mBAAmB,CAAC;QACjC,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,CAAC;CACH;AAED,MAAM,MAAM,mBAAmB,GAC3B,uBAAuB,GACvB,+BAA+B,CAAC"}

package/dist/commonjs/main_thread/decrypt/create_session.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Copyright 2015 CANAL+ Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = createSession;
+var log_1 = require("../../log");
+var is_session_usable_1 = require("./utils/is_session_usable");
+/**
+ * Create a new Session or load a persistent one on the given MediaKeys,
+ * according to wanted settings and what is currently stored.
+ *
+ * If session creating fails, remove the oldest MediaKeySession loaded and
+ * retry.
+ *
+ * /!\ This only creates new sessions.
+ * It will fail if loadedSessionsStore already has a MediaKeySession with
+ * the given initialization data.
+ * @param {Object} stores
+ * @param {Object} initData
+ * @param {string} wantedSessionType
+ * @param {Object} cancelSignal
+ * @returns {Promise}
+ */
+function createSession(stores, initData, wantedSessionType, cancelSignal) {
+    var loadedSessionsStore = stores.loadedSessionsStore, persistentSessionsStore = stores.persistentSessionsStore;
+    if (wantedSessionType === "temporary") {
+        return createTemporarySession(loadedSessionsStore, initData);
+    }
+    else if (persistentSessionsStore === null) {
+        log_1.default.warn("DRM", "Cannot create persistent MediaKeySession, " +
+            "PersistentSessionsStore not created.");
+        return createTemporarySession(loadedSessionsStore, initData);
+    }
+    return createAndTryToRetrievePersistentSession(loadedSessionsStore, persistentSessionsStore, initData, cancelSignal);
+}
+/**
+ * Create a new temporary MediaKeySession linked to the given initData and
+ * initDataType.
+ * @param {Object} loadedSessionsStore
+ * @param {Object} initData
+ * @returns {Promise}
+ */
+function createTemporarySession(loadedSessionsStore, initData) {
+    log_1.default.info("DRM", "Creating a new temporary session");
+    var entry = loadedSessionsStore.createSession(initData, "temporary");
+    return Promise.resolve({
+        type: "created-session" /* MediaKeySessionLoadingType.Created */,
+        value: entry,
+    });
+}
+/**
+ * Create a persistent MediaKeySession and try to load on it a previous
+ * MediaKeySession linked to the same initialization data.
+ * @param {Object} loadedSessionsStore
+ * @param {Object} persistentSessionsStore
+ * @param {Object} initData
+ * @param {Object} cancelSignal
+ * @returns {Promise}
+ */
+function createAndTryToRetrievePersistentSession(loadedSessionsStore, persistentSessionsStore, initData, cancelSignal) {
+    return __awaiter(this, void 0, void 0, function () {
+        /**
+         * Helper function to close and restart the current persistent session
+         * considered, and re-create it from scratch.
+         * @returns {Promise.<Object>}
+         */
+        function recreatePersistentSession() {
+            return __awaiter(this, void 0, void 0, function () {
+                var persistentEntry, err_2, newEntry;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (cancelSignal.cancellationError !== null) {
+                                throw cancelSignal.cancellationError;
+                            }
+                            log_1.default.info("DRM", "Removing previous persistent session.");
+                            persistentEntry = persistentSessionsStore.get(initData);
+                            if (persistentEntry !== null) {
+                                persistentSessionsStore.delete(persistentEntry.sessionId);
+                            }
+                            _a.label = 1;
+                        case 1:
+                            _a.trys.push([1, 3, , 4]);
+                            return [4 /*yield*/, loadedSessionsStore.closeSession(entry.mediaKeySession)];
+                        case 2:
+                            _a.sent();
+                            return [3 /*break*/, 4];
+                        case 3:
+                            err_2 = _a.sent();
+                            // From reading the EME specification in details, it seems that a
+                            // `MediaKeySession`'s ability to be closed is tightly linked to its
+                            // possession of a "sanitized session ID" set as `sessionId`.
+                            // This is never clearly stated however and I'm (Paul B.) always afraid of
+                            // breaking compatibility when it comes to EME code.
+                            // So we still try to close the `MediaKeySession` in any case, only, if it
+                            // fails and it didn't had any `sessionId` set, we just ignore the error.
+                            // Note that trying to close the `MediaKeySession` might incur some delays
+                            // in those rare cases.
+                            if (entry.mediaKeySession.sessionId !== "") {
+                                throw err_2;
+                            }
+                            loadedSessionsStore.removeSessionWithoutClosingIt(entry.mediaKeySession);
+                            return [3 /*break*/, 4];
+                        case 4:
+                            if (cancelSignal.cancellationError !== null) {
+                                throw cancelSignal.cancellationError;
+                            }
+                            newEntry = loadedSessionsStore.createSession(initData, "persistent-license");
+                            return [2 /*return*/, { type: "created-session" /* MediaKeySessionLoadingType.Created */, value: newEntry }];
+                    }
+                });
+            });
+        }
+        var entry, storedEntry, hasLoadedSession, newEntry, err_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (cancelSignal.cancellationError !== null) {
+                        throw cancelSignal.cancellationError;
+                    }
+                    log_1.default.info("DRM", "Creating persistent MediaKeySession");
+                    entry = loadedSessionsStore.createSession(initData, "persistent-license");
+                    storedEntry = persistentSessionsStore.getAndReuse(initData);
+                    if (storedEntry === null) {
+                        return [2 /*return*/, { type: "created-session" /* MediaKeySessionLoadingType.Created */, value: entry }];
+                    }
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, loadedSessionsStore.loadPersistentSession(entry.mediaKeySession, storedEntry.sessionId)];
+                case 2:
+                    hasLoadedSession = _a.sent();
+                    if (!hasLoadedSession) {
+                        log_1.default.warn("DRM", "No data stored for the loaded session", {
+                            sessionId: storedEntry.sessionId,
+                        });
+                        persistentSessionsStore.delete(storedEntry.sessionId);
+                        // The EME specification is kind of implicit about it but it seems from my
+                        // understanding (Paul B.) that a MediaKeySession on wich a `load` attempt
+                        // did not succeed due to the loaded session not being found by the
+                        // browser/CDM, should neither be used anymore nor closed.
+                        // Thus, we're creating another `"persistent-license"` `MediaKeySession`
+                        // in that specific case.
+                        loadedSessionsStore.removeSessionWithoutClosingIt(entry.mediaKeySession);
+                        newEntry = loadedSessionsStore.createSession(initData, "persistent-license");
+                        return [2 /*return*/, { type: "created-session" /* MediaKeySessionLoadingType.Created */, value: newEntry }];
+                    }
+                    if (hasLoadedSession && (0, is_session_usable_1.default)(entry.mediaKeySession)) {
+                        persistentSessionsStore.add(initData, initData.keyIds, entry.mediaKeySession);
+                        log_1.default.info("DRM", "Succeeded to load persistent session.");
+                        return [2 /*return*/, {
+                                type: "loaded-persistent-session" /* MediaKeySessionLoadingType.LoadedPersistentSession */,
+                                value: entry,
+                            }];
+                    }
+                    // Unusable persistent session: recreate a new session from scratch.
+                    log_1.default.warn("DRM", "Previous persistent session not usable anymore.");
+                    return [2 /*return*/, recreatePersistentSession()];
+                case 3:
+                    err_1 = _a.sent();
+                    log_1.default.warn("DRM", "Unable to load persistent session: " +
+                        (err_1 instanceof Error ? err_1.toString() : "Unknown Error"));
+                    return [2 /*return*/, recreatePersistentSession()];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}

package/dist/commonjs/main_thread/decrypt/dispose_decryption_resources.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright 2015 CANAL+ Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IMediaElement } from "../../compat/browser_compatibility_types";
+/**
+ * Free up all ressources taken by the content decryption logic.
+ * @param {HTMLMediaElement} mediaElement
+ * @returns {Promise}
+ */
+export default function disposeDecryptionResources(mediaElement: IMediaElement): Promise<unknown>;
+//# sourceMappingURL=dispose_decryption_resources.d.ts.map

package/dist/commonjs/main_thread/decrypt/dispose_decryption_resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose_decryption_resources.d.ts","sourceRoot":"","sources":["../../../../src/main_thread/decrypt/dispose_decryption_resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAG9E;;;;GAIG;AACH,wBAA8B,0BAA0B,CACtD,YAAY,EAAE,aAAa,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/commonjs/main_thread/decrypt/dispose_decryption_resources.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Copyright 2015 CANAL+ Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = disposeDecryptionResources;
+var media_keys_attacher_1 = require("./utils/media_keys_attacher");
+/**
+ * Free up all ressources taken by the content decryption logic.
+ * @param {HTMLMediaElement} mediaElement
+ * @returns {Promise}
+ */
+function disposeDecryptionResources(mediaElement) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            return [2 /*return*/, media_keys_attacher_1.default.clearMediaKeys(mediaElement)];
+        });
+    });
+}