@theoplayer/extended 3.7.0 → 4.1.0

package/THEOplayer.d.ts

@@ -2,7 +2,7 @@
  * THEOplayer
  * https://www.theoplayer.com
  *
- * Version: 2022.3.1 (3.7.0)
+ * Version: 2022.3.3 (4.1.0)
  */
 
 /**
@@ -41,6 +41,15 @@ export declare interface ABRConfiguration {
      * @defaultValue `30`
      */
     bufferLookbackWindow?: number;
+    /**
+     * The maximum length of the player's buffer, in seconds.
+     *
+     * The player will initially buffer up to {@link ABRConfiguration.targetBuffer} seconds of media data.
+     * If the player detects that the decoder is unable to hold so much data,
+     * it will reduce `maxBufferLength` and restrict `targetBuffer` to be less than
+     * this maximum.
+     */
+    readonly maxBufferLength: number;
 }
 
 /**
@@ -743,6 +752,16 @@ export declare interface AgamaPlayerConfiguration extends AgamaConfiguration {
      * <br/> - Will not be reported to Agama if not present
      */
     userAccountID?: string;
+    /**
+     * The identifier of the device.
+     *
+     * @remarks
+     * <br/> - Available since v4.1.0.
+     * <br/> - Make sure to pass a valid string as indicated by the Agama SDK documentation. No specific value format validation is performed on this
+     * as that is deemed the responsibility of the one setting this value externally via this configuration property.
+     * <br/> - Will be generated internally if not present
+     */
+    deviceID?: string;
 }
 
 /**
@@ -3171,13 +3190,6 @@ export declare interface DRMConfiguration {
     preferredKeySystems?: Array<KeySystemId | string>;
 }
 
-/**
- * A function which processes DRM data.
- *
- * @public
- */
-export declare type DRMProcessor = (arrayBuffer: ArrayBuffer) => ArrayBuffer;
-
 /**
  * Describes the configuration of the DRM Today DRM integration.
  *
@@ -3941,6 +3953,11 @@ export declare interface GoogleDAI {
      * Whether snapback is enabled. When enabled and the user seeks over multiple ad breaks, the last ad break that was seeked past will be played.
      */
     snapback: boolean;
+    /**
+     * A source transformer which will receive the source as returned from Google DAI before loading it in the player. This capability can be useful
+     * if you need to add authentication tokens or signatures to the source URL as returned by Google.
+     */
+    sourceTransformer: (url: string) => string | Promise<string>;
 }
 
 /**
@@ -4401,7 +4418,7 @@ export declare interface HistogramTrackLabeledMetric extends Metric {
 export declare type HlsDiscontinuityAlignment = 'auto' | 'playlist' | 'media';
 
 /**
- * Represents a configuration for controlling playback of an MPEG-DASH stream.
+ * Represents a configuration for controlling playback of an HLS stream.
  *
  * @remarks
  * <br/> - Available since v2.82.0.
@@ -4415,6 +4432,19 @@ export declare interface HlsPlaybackConfiguration {
      * @defaultValue `'auto'`
      */
     discontinuityAlignment?: HlsDiscontinuityAlignment;
+    /**
+     * Whether this source should be played using the legacy HLS pipeline.
+     *
+     * <br/> - If set to `true`, always use the legacy HLS pipeline.
+     * <br/> - If set to `false`, never use the legacy HLS pipeline.
+     * <br/> - If set to `undefined` (default), use the modern HLS pipeline if available, otherwise fall back to the legacy HLS pipeline.
+     *
+     * @defaultValue `undefined`
+     *
+     * @remarks
+     * <br/> - Available since v4.0.0.
+     */
+    useLegacy?: boolean;
 }
 
 /**
@@ -5411,30 +5441,6 @@ export declare interface KeySystemConfiguration {
      * The certificate for the key system. This can be either an ArrayBuffer or Uint8Array containing the raw certificate bytes or a base64-encoded variant of this.
      */
     certificate?: BufferSource_2 | string;
-    /**
-     * Process the certificate's request.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onCertificateRequest} instead.
-     */
-    certificateRequestProcessor?: DRMProcessor;
-    /**
-     * Process the certificate's response.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onCertificateResponse} instead.
-     */
-    certificateResponseProcessor?: DRMProcessor;
-    /**
-     * Process the license's request.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onLicenseRequest} instead.
-     */
-    licenseRequestProcessor?: DRMProcessor;
-    /**
-     * Process the license's response.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onLicenseResponse} instead.
-     */
-    licenseResponseProcessor?: DRMProcessor;
 }
 
 /**