rx-player 4.0.0-dev.202402213 → 4.0.0-dev.2024022300

package/dist/es2017/parsers/manifest/dash/fast-js-parser/node_parsers/utils.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 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 ITNode } from "../../../../../utils/xml-parser";
+import type { IScheme } from "../../node_parser_types";
+/**
+ * Parse MPD boolean attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed boolean - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<Boolean | Error | null>}
+ */
+declare function parseBoolean(val: string, displayName: string): [boolean, MPDError | null];
+/**
+ * Parse MPD integer attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed boolean - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<number | Error | null>}
+ */
+declare function parseMPDInteger(val: string, displayName: string): [number | null, MPDError | null];
+/**
+ * Parse MPD float attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed boolean - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<number | Error | null>}
+ */
+declare function parseMPDFloat(val: string, displayName: string): [number | null, MPDError | null];
+/**
+ * Parse MPD attributes which are either integer or boolean values.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<Boolean | number | Error | null>}
+ */
+declare function parseIntOrBoolean(val: string, displayName: string): [boolean | number | null, MPDError | null];
+/**
+ * Parse MPD date attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<Date | null | Error>}
+ */
+declare function parseDateTime(val: string, displayName: string): [number | null, MPDError | null];
+/**
+ * Parse MPD ISO8601 duration attributes into seconds.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<number | Error | null>}
+ */
+declare function parseDuration(val: string, displayName: string): [number | null, MPDError | null];
+/**
+ * Parse MPD byterange attributes into arrays of two elements: the start and
+ * the end.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val
+ * @param {string} displayName
+ * @returns {Array.<Array.<number> | Error | null>}
+ */
+declare function parseByteRange(val: string, displayName: string): [[number, number] | null, MPDError | null];
+/**
+ * Parse MPD base64 attribute into an Uint8Array.
+ * the end.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val
+ * @param {string} displayName
+ * @returns {Uint8Array | Error | null>}
+ */
+declare function parseBase64(val: string, displayName: string): [Uint8Array | null, MPDError | null];
+/**
+ * Some values in the MPD can be expressed as divisions of integers (e.g. frame
+ * rates).
+ * This function tries to convert it to a floating point value.
+ * @param {string} val
+ * @param {string} displayName
+ * @returns {Array.<number | Error | null>}
+ */
+declare function parseMaybeDividedNumber(val: string, displayName: string): [number | null, MPDError | null];
+/**
+ * @param {Object} root
+ * @returns {Object}
+ */
+declare function parseScheme(root: ITNode): IScheme;
+/**
+ * Create a function to factorize the MPD parsing logic.
+ * @param {Object} dest - The destination object which will contain the parsed
+ * values.
+ * @param {Array.<Error>} warnings - An array which will contain every parsing
+ * error encountered.
+ * @return {Function}
+ */
+declare function ValueParser<T>(dest: T, warnings: Error[]): (val: string, { asKey, parser, dashName, }: {
+    asKey: keyof T;
+    parser: (value: string, displayName: string) => [T[keyof T] | null, MPDError | null];
+    dashName: string;
+}) => void;
+/**
+ * Error arising when parsing the MPD.
+ * @class MPDError
+ * @extends Error
+ */
+declare class MPDError extends Error {
+    readonly name: "MPDError";
+    readonly message: string;
+    /**
+     * @param {string} message
+     */
+    constructor(message: string);
+}
+/**
+ * Obtain the equivalent of the `textContent` HTMLElement call for that node.
+ * @param {Array} children
+ * @returns {string}
+ */
+export declare function textContent(children: Array<ITNode | string>): string;
+export { MPDError, ValueParser, parseBase64, parseBoolean, parseByteRange, parseDateTime, parseDuration, parseIntOrBoolean, parseMaybeDividedNumber, parseMPDFloat, parseMPDInteger, parseScheme, };

package/dist/es2017/parsers/manifest/dash/fast-js-parser/node_parsers/utils.js

@@ -0,0 +1,310 @@
+/**
+ * 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.
+ */
+// XML-Schema
+// <http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd>
+import log from "../../../../../log";
+import { base64ToBytes } from "../../../../../utils/base64";
+import isNonEmptyString from "../../../../../utils/is_non_empty_string";
+import isNullOrUndefined from "../../../../../utils/is_null_or_undefined";
+import { toContentString } from "../../../../../utils/xml-parser";
+const iso8601Duration = /^P(([\d.]*)Y)?(([\d.]*)M)?(([\d.]*)D)?T?(([\d.]*)H)?(([\d.]*)M)?(([\d.]*)S)?/;
+const rangeRe = /([0-9]+)-([0-9]+)/;
+/**
+ * Parse MPD boolean attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed boolean - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<Boolean | Error | null>}
+ */
+function parseBoolean(val, displayName) {
+    if (val === "true") {
+        return [true, null];
+    }
+    if (val === "false") {
+        return [false, null];
+    }
+    const error = new MPDError(`\`${displayName}\` property is not a boolean value but "${val}"`);
+    return [false, error];
+}
+/**
+ * Parse MPD integer attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed boolean - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<number | Error | null>}
+ */
+function parseMPDInteger(val, displayName) {
+    const toInt = parseInt(val, 10);
+    if (isNaN(toInt)) {
+        const error = new MPDError(`\`${displayName}\` property is not an integer value but "${val}"`);
+        return [null, error];
+    }
+    return [toInt, null];
+}
+/**
+ * Parse MPD float attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed boolean - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<number | Error | null>}
+ */
+function parseMPDFloat(val, displayName) {
+    if (val === "INF") {
+        return [Infinity, null];
+    }
+    const toInt = parseFloat(val);
+    if (isNaN(toInt)) {
+        const error = new MPDError(`\`${displayName}\` property is invalid: "${val}"`);
+        return [null, error];
+    }
+    return [toInt, null];
+}
+/**
+ * Parse MPD attributes which are either integer or boolean values.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<Boolean | number | Error | null>}
+ */
+function parseIntOrBoolean(val, displayName) {
+    if (val === "true") {
+        return [true, null];
+    }
+    if (val === "false") {
+        return [false, null];
+    }
+    const toInt = parseInt(val, 10);
+    if (isNaN(toInt)) {
+        const error = new MPDError(`\`${displayName}\` property is not a boolean nor an integer but "${val}"`);
+        return [null, error];
+    }
+    return [toInt, null];
+}
+/**
+ * Parse MPD date attributes.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<Date | null | Error>}
+ */
+function parseDateTime(val, displayName) {
+    const parsed = Date.parse(val);
+    if (isNaN(parsed)) {
+        const error = new MPDError(`\`${displayName}\` is in an invalid date format: "${val}"`);
+        return [null, error];
+    }
+    return [new Date(Date.parse(val)).getTime() / 1000, null];
+}
+/**
+ * Parse MPD ISO8601 duration attributes into seconds.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val - The value to parse
+ * @param {string} displayName - The name of the property. Used for error
+ * formatting.
+ * @returns {Array.<number | Error | null>}
+ */
+function parseDuration(val, displayName) {
+    if (!isNonEmptyString(val)) {
+        const error = new MPDError(`\`${displayName}\` property is empty`);
+        return [0, error];
+    }
+    const match = iso8601Duration.exec(val);
+    if (match === null) {
+        const error = new MPDError(`\`${displayName}\` property has an unrecognized format "${val}"`);
+        return [null, error];
+    }
+    const duration = parseFloat(isNonEmptyString(match[2]) ? match[2] : "0") * 365 * 24 * 60 * 60 +
+        parseFloat(isNonEmptyString(match[4]) ? match[4] : "0") * 30 * 24 * 60 * 60 +
+        parseFloat(isNonEmptyString(match[6]) ? match[6] : "0") * 24 * 60 * 60 +
+        parseFloat(isNonEmptyString(match[8]) ? match[8] : "0") * 60 * 60 +
+        parseFloat(isNonEmptyString(match[10]) ? match[10] : "0") * 60 +
+        parseFloat(isNonEmptyString(match[12]) ? match[12] : "0");
+    return [duration, null];
+}
+/**
+ * Parse MPD byterange attributes into arrays of two elements: the start and
+ * the end.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val
+ * @param {string} displayName
+ * @returns {Array.<Array.<number> | Error | null>}
+ */
+function parseByteRange(val, displayName) {
+    const match = rangeRe.exec(val);
+    if (match === null) {
+        const error = new MPDError(`\`${displayName}\` property has an unrecognized format "${val}"`);
+        return [null, error];
+    }
+    else {
+        return [[+match[1], +match[2]], null];
+    }
+}
+/**
+ * Parse MPD base64 attribute into an Uint8Array.
+ * the end.
+ *
+ * The returned value is a tuple of two elements where:
+ *   1. the first value is the parsed value - or `null` if we could not parse
+ *      it
+ *   2. the second value is a possible error encountered while parsing this
+ *      value - set to `null` if no error was encountered.
+ * @param {string} val
+ * @param {string} displayName
+ * @returns {Uint8Array | Error | null>}
+ */
+function parseBase64(val, displayName) {
+    try {
+        return [base64ToBytes(val), null];
+    }
+    catch (_) {
+        const error = new MPDError(`\`${displayName}\` is not a valid base64 string: "${val}"`);
+        return [null, error];
+    }
+}
+/**
+ * Some values in the MPD can be expressed as divisions of integers (e.g. frame
+ * rates).
+ * This function tries to convert it to a floating point value.
+ * @param {string} val
+ * @param {string} displayName
+ * @returns {Array.<number | Error | null>}
+ */
+function parseMaybeDividedNumber(val, displayName) {
+    const matches = /^(\d+)\/(\d+)$/.exec(val);
+    if (matches !== null) {
+        // No need to check, we know both are numbers
+        return [+matches[1] / +matches[2], null];
+    }
+    return parseMPDFloat(val, displayName);
+}
+/**
+ * @param {Object} root
+ * @returns {Object}
+ */
+function parseScheme(root) {
+    let schemeIdUri;
+    let value;
+    for (const attributeName of Object.keys(root.attributes)) {
+        const attributeVal = root.attributes[attributeName];
+        if (isNullOrUndefined(attributeVal)) {
+            continue;
+        }
+        switch (attributeName) {
+            case "schemeIdUri":
+                schemeIdUri = attributeVal;
+                break;
+            case "value":
+                value = attributeVal;
+                break;
+        }
+    }
+    return { schemeIdUri, value };
+}
+/**
+ * Create a function to factorize the MPD parsing logic.
+ * @param {Object} dest - The destination object which will contain the parsed
+ * values.
+ * @param {Array.<Error>} warnings - An array which will contain every parsing
+ * error encountered.
+ * @return {Function}
+ */
+function ValueParser(dest, warnings) {
+    /**
+     * Parse a single value and add it to the `dest` objects.
+     * If an error arised while parsing, add it at the end of the `warnings` array.
+     * @param {string} objKey - The key which will be added to the `dest` object.
+     * @param {string} val - The value found in the MPD which we should parse.
+     * @param {Function} parsingFn - The parsing function adapted for this value.
+     * @param {string} displayName - The name of the key as it appears in the MPD.
+     * This is used only in error formatting,
+     */
+    return function (val, { asKey, parser, dashName, }) {
+        const [parsingResult, parsingError] = parser(val, dashName);
+        if (parsingError !== null) {
+            log.warn(parsingError.message);
+            warnings.push(parsingError);
+        }
+        if (parsingResult !== null) {
+            dest[asKey] = parsingResult;
+        }
+    };
+}
+/**
+ * Error arising when parsing the MPD.
+ * @class MPDError
+ * @extends Error
+ */
+class MPDError extends Error {
+    /**
+     * @param {string} message
+     */
+    constructor(message) {
+        super();
+        // @see https://stackoverflow.com/questions/41102060/typescript-extending-error-class
+        Object.setPrototypeOf(this, MPDError.prototype);
+        this.name = "MPDError";
+        this.message = message;
+    }
+}
+/**
+ * Obtain the equivalent of the `textContent` HTMLElement call for that node.
+ * @param {Array} children
+ * @returns {string}
+ */
+export function textContent(children) {
+    return toContentString(children);
+}
+export { MPDError, ValueParser, parseBase64, parseBoolean, parseByteRange, parseDateTime, parseDuration, parseIntOrBoolean, parseMaybeDividedNumber, parseMPDFloat, parseMPDInteger, parseScheme, };

package/dist/es2017/parsers/manifest/dash/fast-js-parser/parse_from_xml_string.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 { IMPDParserArguments } from "../common";
+import type { IDashParserResponse } from "../parsers_types";
+/**
+ * Parse MPD through the Fast JS parser.
+ * @param {string} xml - MPD under a string format
+ * @param {Object} args - Various parsing options and information.
+ * @returns {Object} - Response returned by the DASH-JS parser.
+ */
+export default function parseFromString(xml: string, args: IMPDParserArguments): IDashParserResponse<string>;

package/dist/es2017/parsers/manifest/dash/fast-js-parser/parse_from_xml_string.js

@@ -0,0 +1,114 @@
+/**
+ * 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 { assertUnreachable } from "../../../../utils/assert";
+import { parseXml } from "../../../../utils/xml-parser";
+import parseMpdIr from "../common";
+import { createMPDIntermediateRepresentation } from "./node_parsers/MPD";
+import { createPeriodIntermediateRepresentation } from "./node_parsers/Period";
+/**
+ * Parse MPD through the Fast JS parser.
+ * @param {string} xml - MPD under a string format
+ * @param {Object} args - Various parsing options and information.
+ * @returns {Object} - Response returned by the DASH-JS parser.
+ */
+export default function parseFromString(xml, args) {
+    const root = parseXml(xml);
+    const lastChild = root[root.length - 1];
+    if (lastChild === undefined ||
+        typeof lastChild === "string" ||
+        lastChild.tagName !== "MPD") {
+        throw new Error("DASH Parser: document root should be MPD");
+    }
+    const [mpdIR, warnings] = createMPDIntermediateRepresentation(lastChild, xml);
+    const ret = parseMpdIr(mpdIR, args, warnings);
+    return processReturn(ret);
+    /**
+     * Handle `parseMpdIr` return values, asking for resources if they are needed
+     * and pre-processing them before continuing parsing.
+     *
+     * @param {Object} initialRes
+     * @returns {Object}
+     */
+    function processReturn(initialRes) {
+        if (initialRes.type === "done") {
+            return initialRes;
+        }
+        else if (initialRes.type === "needs-clock") {
+            return {
+                type: "needs-resources",
+                value: {
+                    urls: [initialRes.value.url],
+                    format: "string",
+                    continue(loadedClock) {
+                        if (loadedClock.length !== 1) {
+                            throw new Error("DASH parser: wrong number of loaded ressources.");
+                        }
+                        const newRet = initialRes.value.continue(loadedClock[0].responseData);
+                        return processReturn(newRet);
+                    },
+                },
+            };
+        }
+        else if (initialRes.type === "needs-xlinks") {
+            return {
+                type: "needs-resources",
+                value: {
+                    urls: initialRes.value.xlinksUrls,
+                    format: "string",
+                    continue(loadedXlinks) {
+                        const resourceInfos = [];
+                        for (let i = 0; i < loadedXlinks.length; i++) {
+                            const { responseData: xlinkResp, receivedTime, sendingTime, url, } = loadedXlinks[i];
+                            if (!xlinkResp.success) {
+                                throw xlinkResp.error;
+                            }
+                            const wrappedData = "<root>" + xlinkResp.data + "</root>";
+                            const dataAsXML = parseXml(wrappedData);
+                            const innerParsed = dataAsXML[dataAsXML.length - 1];
+                            if (innerParsed === undefined || typeof innerParsed === "string") {
+                                throw new Error("DASH parser: Invalid external ressources");
+                            }
+                            const periods = innerParsed.children;
+                            const periodsIR = [];
+                            const periodsIRWarnings = [];
+                            for (let j = 0; j < periods.length; j++) {
+                                const period = periods[j];
+                                if (typeof period === "string" || period.tagName !== "Period") {
+                                    continue;
+                                }
+                                const [periodIR, periodWarnings] = createPeriodIntermediateRepresentation(period, wrappedData);
+                                periodsIRWarnings.push(...periodWarnings);
+                                periodsIR.push(periodIR);
+                            }
+                            resourceInfos.push({
+                                url,
+                                receivedTime,
+                                sendingTime,
+                                parsed: periodsIR,
+                                warnings: periodsIRWarnings,
+                            });
+                        }
+                        const newRet = initialRes.value.continue(resourceInfos);
+                        return processReturn(newRet);
+                    },
+                },
+            };
+        }
+        else {
+            assertUnreachable(initialRes);
+        }
+    }
+}

package/dist/es2017/parsers/manifest/dash/node_parser_types.d.ts

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { ITNode } from "../../../utils/xml-parser";
 /**
  * Those are types used when generating the MPD "Intermediate Representation"
  * which is an intermediate step between parsing the MPD (in XML) and generating
@@ -386,10 +387,11 @@ export interface IEventStreamEventIntermediateRepresentation {
     duration?: number;
     /**
      * The `<Event>` element itself.
-     * Can be in two forms:
+     * Can be under any of those forms:
      *   - Either as an Element instance directly
      *   - Either as the Element's UTF-8 textual representation.
+     *   - Either as the Element's string representation.
      */
-    eventStreamData?: Element | ArrayBuffer;
+    eventStreamData?: Element | ArrayBuffer | string;
 }
-export type ITimelineParser = () => HTMLCollection;
+export type ITimelineParser = () => ITNode[] | HTMLCollection;

package/dist/es2017/public_types.d.ts

@@ -15,7 +15,7 @@ export type IRxPlayerMode = "auto" | "main" | "multithread";
 /** Argument of the `attachWorker` method. */
 export interface IWorkerSettings {
     workerUrl: string | Blob;
-    dashWasmUrl: string | ArrayBuffer;
+    dashWasmUrl?: string | ArrayBuffer | undefined;
 }
 /** Every options that can be given to the RxPlayer's constructor. */
 export interface IConstructorOptions {