@amazon/vinyl 1.0.0

package/dist/test/styles.css

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2024. Amazon.com, Inc. or its affiliates. All rights reserved.
+ */
+
+html,
+body {
+    height: 100%;
+    font-family: sans-serif;
+    margin: 0;
+    padding: 0;
+}
+
+body {
+    background-color: #dcdee5;
+    display: flex;
+    flex-direction: column;
+}
+
+.callout {
+    background-color: #bfcbdb;
+    box-sizing: border-box;
+    padding: 10px;
+    font-family: Helvetica, Arial, 'sans-serif';
+    cursor: pointer;
+    transition: background-color 0.3s;
+}
+
+.callout:hover {
+    background-color: #7d9fcc;
+}
+
+.instructions {
+    display: inline-block;
+    font-style: italic;
+    padding: 5px;
+    font-family: inherit;
+}
+
+.jasmine_html-reporter {
+    margin: 0 !important;
+    padding: 0 !important;
+}

package/dist/types/current/client/Capabilities.d.ts

@@ -0,0 +1,73 @@
+import type { DrmKeySystem } from '../drm/DrmKeySystem';
+import type { DrmKeySystemSupport } from '../drm/DrmController';
+export declare enum CanPlayTypeResult {
+    /**
+     * The media cannot be played on the current device.
+     */
+    NO = "no",
+    /**
+     * There is not enough information to determine whether the media can play.
+     */
+    MAYBE = "maybe",
+    /**
+     * The media is probably playable on this device.
+     */
+    PROBABLY = "probably"
+}
+/**
+ * Detected capabilities of the device.
+ */
+export interface Capabilities {
+    /**
+     * Returns true if Media Source Extensions are supported.
+     *
+     * Note that this does not test DRM or any DRM key systems.
+     */
+    readonly mse: boolean;
+    /**
+     * Returns true if Encrypted Media Extensions are supported.
+     */
+    readonly eme: boolean;
+    /**
+     * Returns true if native Dynamic Adaptive Streaming is supported.
+     *
+     * (Legacy Edge 12-18 and XBox One)
+     * Note that this is not the same as supporting a dash track.
+     */
+    readonly dash: boolean;
+    /**
+     * Returns true if native HTTP Live Streaming is supported.
+     *
+     * iOS 7.0+, Safari 8.0+
+     * Note that this does not do FairPlay detection.
+     */
+    readonly hls: boolean;
+    /**
+     * Returns the sample rate, in samples per second, that this platform supports.
+     * Returns null if the sample rate cannot be determined.
+     */
+    readonly sampleRate: number | null;
+    /**
+     * Returns a string that specifies whether the client can play a given media resource type for progressive
+     * content.
+     *
+     * @param type A string specifying the MIME type of the media and (optionally) a codecs
+     * parameter containing a comma-separated list of the supported codecs.
+     */
+    canPlayType(type: string): CanPlayTypeResult;
+    /**
+     * Returns a boolean that specifies whether the client can play a given media resource type for streaming
+     * content with media source extensions.
+     *
+     * @param type A string specifying the MIME type of the media and (optionally) a codecs
+     * parameter containing a comma-separated list of the supported codecs.
+     */
+    canPlayTypeMse(type: string): boolean;
+    /**
+     * Returns a promise describing support for the given key system.
+     *
+     * @param keySystem
+     */
+    supportsKeySystem(keySystem: DrmKeySystem): Promise<DrmKeySystemSupport>;
+}
+//# sourceMappingURL=Capabilities.d.ts.map

package/dist/types/current/client/Capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../../../src/client/Capabilities.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,oBAAY,iBAAiB;IACzB;;OAEG;IACH,EAAE,OAAO;IAET;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,QAAQ,aAAa;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IAErB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAElC;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAA;IAE5C;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAErC;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAC3E"}

package/dist/types/current/client/Capabilities.js

@@ -0,0 +1,19 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export var CanPlayTypeResult;
+(function (CanPlayTypeResult) {
+    /**
+     * The media cannot be played on the current device.
+     */
+    CanPlayTypeResult["NO"] = "no";
+    /**
+     * There is not enough information to determine whether the media can play.
+     */
+    CanPlayTypeResult["MAYBE"] = "maybe";
+    /**
+     * The media is probably playable on this device.
+     */
+    CanPlayTypeResult["PROBABLY"] = "probably";
+})(CanPlayTypeResult || (CanPlayTypeResult = {}));

package/dist/types/current/client/CapabilitiesImpl.d.ts

@@ -0,0 +1,27 @@
+import { type DrmKeySystem } from '../drm/DrmKeySystem';
+import type { Capabilities } from './Capabilities';
+import { CanPlayTypeResult } from './Capabilities';
+import type { DrmController, DrmKeySystemSupport } from '../drm/DrmController';
+/**
+ * Dependencies for CapabilitiesImpl.
+ */
+export interface CapabilitiesImplDeps {
+    readonly media: HTMLMediaElement;
+    readonly drmController: DrmController;
+}
+/**
+ * Client support detection.
+ */
+export declare class CapabilitiesImpl implements Capabilities {
+    private readonly deps;
+    constructor(deps: CapabilitiesImplDeps);
+    get mse(): boolean;
+    get dash(): boolean;
+    get hls(): boolean;
+    get eme(): boolean;
+    get sampleRate(): number | null;
+    canPlayType(type: string): CanPlayTypeResult;
+    canPlayTypeMse(type: string): boolean;
+    supportsKeySystem(keySystem: DrmKeySystem): Promise<DrmKeySystemSupport>;
+}
+//# sourceMappingURL=CapabilitiesImpl.d.ts.map

package/dist/types/current/client/CapabilitiesImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilitiesImpl.d.ts","sourceRoot":"","sources":["../../../../src/client/CapabilitiesImpl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE7E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;CACxC;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,oBAAoB;IAEvD,IAAI,GAAG,IAAI,OAAO,CAEjB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,GAAG,IAAI,OAAO,CAKjB;IAED,IAAI,GAAG,IAAI,OAAO,CAEjB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAe5C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,iBAAiB,CACnB,SAAS,EAAE,YAAY,GACxB,OAAO,CAAC,mBAAmB,CAAC;CAWlC"}

package/dist/types/current/client/CapabilitiesImpl.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CanPlayTypeResult } from './Capabilities';
+import { isTypeSupported, supportsMse } from '../util/media/mediaSource';
+import { getAudioContext } from '../util/media/getAudioContext';
+/**
+ * Client support detection.
+ */
+export class CapabilitiesImpl {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get mse() {
+        return supportsMse();
+    }
+    get dash() {
+        return this.canPlayType('application/dash+xml') !== CanPlayTypeResult.NO;
+    }
+    get hls() {
+        return (this.canPlayType('application/vnd.apple.mpegurl') !==
+            CanPlayTypeResult.NO);
+    }
+    get eme() {
+        return this.deps.drmController.isEmeSupported();
+    }
+    get sampleRate() {
+        return getAudioContext()?.sampleRate ?? null;
+    }
+    canPlayType(type) {
+        const media = this.deps.media;
+        if (typeof media.canPlayType === 'undefined')
+            return CanPlayTypeResult.NO;
+        const str = media.canPlayType(type);
+        switch (str) {
+            case '':
+                return CanPlayTypeResult.NO;
+            case 'maybe':
+                return CanPlayTypeResult.MAYBE;
+            case 'probably':
+                return CanPlayTypeResult.PROBABLY;
+        }
+    }
+    canPlayTypeMse(type) {
+        return isTypeSupported(type);
+    }
+    async supportsKeySystem(keySystem) {
+        // Take the most commonly supported codec and media format, check the DrmController if
+        // it is supported with the given key system.
+        return this.deps.drmController.isSupported({
+            initDataType: 'cenc',
+            encryptionScheme: 'cenc',
+            contentType: 'audio',
+            mimeType: 'audio/mp4; codecs="mp4a.40.2"',
+            contentProtections: [{ keySystem }],
+        });
+    }
+}

package/dist/types/current/client/Client.d.ts

@@ -0,0 +1,11 @@
+import type { Capabilities } from './Capabilities';
+/**
+ * Provides information about the client, such as device and browser capabilities.
+ */
+export interface Client {
+    /**
+     * Browser and platform capabilities.
+     */
+    readonly capabilities: Capabilities;
+}
+//# sourceMappingURL=Client.d.ts.map

package/dist/types/current/client/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../../src/client/Client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;CACtC"}

package/dist/types/current/client/Client.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/types/current/drm/CencEncryptionScheme.d.ts

@@ -0,0 +1,37 @@
+import { type Maybe } from '@amazon/vinyl-util';
+/**
+ * https://www.w3.org/TR/encrypted-media-2/#dom-mediakeysystemmediacapability-encryptionscheme
+ */
+export type CencEncryptionScheme = 
+/**
+ * AES-CTR mode full sample and video NAL subsample encryption.
+ */
+'cenc'
+/**
+ * AES-CBC mode partial video NAL pattern encryption. For video, the spec allows various encryption patterns.
+ */
+ | 'cbcs'
+/**
+ * The same as "cbcs" mode, but with a specific encrypt:skip pattern of 1:9 for video.
+ */
+ | 'cbcs-1-9' | string;
+export interface CencEncryptionSchemeAndVersion {
+    readonly scheme: CencEncryptionScheme;
+    readonly version: number | null;
+}
+/**
+ * 5.8.5.2.2 The MP4 Protection Scheme
+ *
+ * For Representations based on ISO/IEC 14496-12, the following URI is defined to indicate protection
+ * schemes identified by the Scheme Type within the Scheme Type Box of the Protection Scheme
+ * Information Box of the file:
+ * urn:mpeg:dash:mp4protection:2011
+ * In this scheme, the `value` attribute shall present and shall be the 4CC contained in the Scheme Type
+ * Box, suitably percent-encoded according to IETF RFC 8141, and may include the version number. The
+ * 4CC and the version number, if present, shall be separated by a ":". The version number shall be encoded
+ * as up to 8 hexadecimal digits, where the leading '0's may be omitted.
+ *
+ * @param value
+ */
+export declare function parseCencEncryptionScheme(value: Maybe<string>): CencEncryptionSchemeAndVersion | null;
+//# sourceMappingURL=CencEncryptionScheme.d.ts.map

package/dist/types/current/drm/CencEncryptionScheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CencEncryptionScheme.d.ts","sourceRoot":"","sources":["../../../../src/drm/CencEncryptionScheme.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,KAAK,EAGb,MAAM,oBAAoB,CAAA;AAE3B;;GAEG;AACH,MAAM,MAAM,oBAAoB;AAC5B;;GAEG;AACD,MAAM;AAER;;GAEG;GACD,MAAM;AAER;;GAEG;GACD,UAAU,GACV,MAAM,CAAA;AAEZ,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACrC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GACrB,8BAA8B,GAAG,IAAI,CAWvC"}

package/dist/types/current/drm/CencEncryptionScheme.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { parseIntSafe, } from '@amazon/vinyl-util';
+const encryptionSchemeRegex = /([a-z]{4})(?::([\da-f]{1,8}))?/;
+const protectionSchemeCodes = {
+    ['cbcs']: 'cbcs',
+    ['cenc']: 'cenc',
+};
+/**
+ * 5.8.5.2.2 The MP4 Protection Scheme
+ *
+ * For Representations based on ISO/IEC 14496-12, the following URI is defined to indicate protection
+ * schemes identified by the Scheme Type within the Scheme Type Box of the Protection Scheme
+ * Information Box of the file:
+ * urn:mpeg:dash:mp4protection:2011
+ * In this scheme, the `value` attribute shall present and shall be the 4CC contained in the Scheme Type
+ * Box, suitably percent-encoded according to IETF RFC 8141, and may include the version number. The
+ * 4CC and the version number, if present, shall be separated by a ":". The version number shall be encoded
+ * as up to 8 hexadecimal digits, where the leading '0's may be omitted.
+ *
+ * @param value
+ */
+export function parseCencEncryptionScheme(value) {
+    if (!value)
+        return null;
+    const match = encryptionSchemeRegex.exec(value);
+    if (!match)
+        return null;
+    const version = parseIntSafe(match[2], 16);
+    const scheme = protectionSchemeCodes[match[1]];
+    if (!scheme)
+        return null;
+    return {
+        scheme,
+        version,
+    };
+}

package/dist/types/current/drm/DrmController.d.ts

@@ -0,0 +1,103 @@
+import { type AnyRecord, type Maybe, type ReadonlyAbort, type ReadonlyEventHost } from '@amazon/vinyl-util';
+import type { DrmInitDataType } from '../streaming/DrmInitDataType';
+import type { DrmKeySystem } from '../drm/DrmKeySystem';
+import type { MediaFormatMetadata } from '../streaming/MediaQualityMetadata';
+import type { BasicErrorEvent } from '../event/BasicErrorEvent';
+import type { DrmOptions } from '../drm/DrmOptions';
+export interface DrmControllerEventMap {
+    /**
+     * A DRM error occurred.
+     */
+    readonly error: BasicErrorEvent;
+    /**
+     * Emitted when the error state has been reset.
+     */
+    readonly reset: AnyRecord;
+    /**
+     * The media keys have been created and set.
+     *
+     * This will happen after the first call to `initialize` or after the first 'encrypted' event is handled.
+     */
+    readonly mediaKeysSet: MediaKeysSetEvent;
+    /**
+     * Dispatched after a key session has been created.
+     */
+    readonly sessionCreate: KeySessionEvent;
+    /**
+     * Dispatched after a key session has been closed.
+     */
+    readonly sessionClose: KeySessionEvent;
+}
+export interface MediaKeysSetEvent {
+    readonly keySystem: DrmKeySystem;
+}
+export interface KeySessionEvent {
+    readonly mimeType: string;
+    readonly initDataType: DrmInitDataType;
+}
+/**
+ * DrmController manages media keys and sessions, provides tracks a way to declare their content protections.
+ */
+export interface DrmController extends ReadonlyEventHost<DrmControllerEventMap> {
+    /**
+     * The last error emitted.
+     * Use `reset` to reset error state.
+     */
+    readonly error: Error | null;
+    /**
+     * Configures this DrmController for the current track.
+     * This will override any player-level configuration.
+     * @param options
+     */
+    configure(options: Maybe<Partial<DrmOptions>>): void;
+    /**
+     * Returns true if Encrypted Media Extensions are supported.
+     */
+    isEmeSupported(): boolean;
+    /**
+     * Resolves to true if the given encryption metadata is supported.
+     * @param drmInfo
+     */
+    isSupported(drmInfo: MediaFormatMetadata): Promise<DrmKeySystemSupport>;
+    /**
+     * Initializes media keys if they have not yet been created and attached, creates a key session if the
+     * selected `DrmProtection` contains PSSH data.
+     *
+     * The first supported key system will be used.
+     * Once a key system has been set, it cannot be changed, all future content protections will be
+     * expected to contain the supported key system.
+     *
+     * @param drmInfo Format metadata for the representation. May contain content protections.
+     * @param abort If aborted, the created session will be closed.
+     */
+    initializeForPlayback(drmInfo: MediaFormatMetadata | null, abort?: ReadonlyAbort): void;
+    /**
+     * Sets content protection data on drm controller for the currently buffering media.
+     *
+     * The key session will be created on the 'encrypted' event when the decoder has been initialized.
+     *
+     * @param drmInfo Format metadata for the representation. May contain content protections.
+     * @param abort If aborted, the created session from an 'encrypted' event will be closed.
+     */
+    setBufferingDrmInfo(drmInfo: MediaFormatMetadata | null, abort?: ReadonlyAbort): void;
+    /**
+     * Clears all active DRM sessions.
+     * This should not be called unless the audio source has been cleared.
+     */
+    closeSessions(): void;
+    /**
+     * Resets the error state.
+     */
+    reset(): void;
+}
+export type DrmKeySystemSupport = {
+    /**
+     * True if the key system is supported.
+     */
+    readonly supported: boolean;
+    /**
+     * True if the key system and persistent state is supported.
+     */
+    readonly persistentState: boolean;
+};
+//# sourceMappingURL=DrmController.d.ts.map

package/dist/types/current/drm/DrmController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrmController.d.ts","sourceRoot":"","sources":["../../../../src/drm/DrmController.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAA;CACzC;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;CACnC;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB,CAAC,qBAAqB,CAAC;IAC3E;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAE5B;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAA;IAEpD;;OAEG;IACH,cAAc,IAAI,OAAO,CAAA;IAEzB;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAEvE;;;;;;;;;;OAUG;IACH,qBAAqB,CACjB,OAAO,EAAE,mBAAmB,GAAG,IAAI,EACnC,KAAK,CAAC,EAAE,aAAa,GACtB,IAAI,CAAA;IAEP;;;;;;;OAOG;IACH,mBAAmB,CACf,OAAO,EAAE,mBAAmB,GAAG,IAAI,EACnC,KAAK,CAAC,EAAE,aAAa,GACtB,IAAI,CAAA;IAEP;;;OAGG;IACH,aAAa,IAAI,IAAI,CAAA;IAErB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CACpC,CAAA"}

package/dist/types/current/drm/DrmController.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/types/current/drm/DrmControllerImpl.d.ts

@@ -0,0 +1,112 @@
+import { EventHostImpl, type Maybe, type ReadonlyAbort } from '@amazon/vinyl-util';
+import { type DrmOptions } from '../drm/DrmOptions';
+import type { DrmController, DrmControllerEventMap, DrmKeySystemSupport } from '../drm/DrmController';
+import type { CommonEme, CommonMediaKeyMessageEvent, CommonMediaKeys, CommonMediaKeySession } from '../drm/commonEme/CommonEme';
+import type { MediaFormatMetadata } from '../streaming/MediaQualityMetadata';
+/**
+ * The number of seconds a license request will be allowed before timing out.
+ * This should be higher than the network timeout.
+ *
+ * In practice, network requests will time out before this, and a license timeout
+ * indicates a stalled promise result from the license provider.
+ */
+export declare const LICENSE_TIMEOUT = 90;
+/**
+ * Dependencies for creating DrmController.
+ */
+export interface DrmControllerImplDeps {
+    readonly media: HTMLMediaElement;
+    readonly commonEme: CommonEme | null;
+}
+export interface DrmControllerMessageProps {
+    readonly mediaKeys: CommonMediaKeys;
+    readonly session: CommonMediaKeySession;
+    readonly event: CommonMediaKeyMessageEvent;
+}
+export declare class DrmControllerImpl extends EventHostImpl<DrmControllerEventMap> implements DrmController {
+    private readonly deps;
+    get [Symbol.toStringTag](): string;
+    private readonly optionsBase;
+    private options;
+    private mediaKeys;
+    private mediaKeysPromise;
+    private readonly sessions;
+    private _error;
+    private drmInfo;
+    private sessionAbort;
+    private pendingMessageProps;
+    private readonly disposer;
+    constructor(deps: DrmControllerImplDeps, options?: Maybe<Partial<DrmOptions>>);
+    configure(options: Maybe<Partial<DrmOptions>>): void;
+    private get licenseProvider();
+    get error(): Error | null;
+    isEmeSupported(): boolean;
+    isSupported(drmInfo: MediaFormatMetadata): Promise<DrmKeySystemSupport>;
+    private checkIsSupportedCached;
+    private readonly handleEncryptedEvent;
+    /**
+     * Resolves to media keys attached to the element.
+     * The media keys will only be created and set once until `clearMediaKeys` is next called.
+     */
+    private attachMediaKeys;
+    /**
+     * Creates a session for the given initialization data if none currently exists.
+     * This will be done either after an 'encrypted' event or when drm metadata contains initialization data.
+     * The new session will be added to the current sessions list.
+     */
+    private maybeCreateSession;
+    initializeForPlayback(drmInfo: MediaFormatMetadata | null, abort?: ReadonlyAbort): void;
+    setBufferingDrmInfo(drmInfo: MediaFormatMetadata | null, abort?: ReadonlyAbort): void;
+    /**
+     * If the drm metadata contains initialization data for the current key system, create a new session.
+     * Otherwise, wait for the 'encrypted' event for the initialization data.
+     */
+    private createSessionFromInitData;
+    /**
+     * Creates a CommonMediaKeySystemAccess object from the given content protection settings.
+     */
+    private createAccess;
+    /**
+     * Creates a list of the MediaKeySystemAccess configurations to try for the given media format options.
+     */
+    private createMediaKeySystemAccessParams;
+    private getMediaKeySystemOptions;
+    /**
+     * Creates a new key session and adds a message handler.
+     */
+    private createNewSession;
+    /**
+     * Invoked when the content decryption module needs to interact with the license server.
+     */
+    private messageHandler;
+    /**
+     * Closes all active DRM sessions.
+     * This should not be called unless the audio source has been cleared.
+     */
+    closeSessions(): void;
+    private closeSession;
+    /**
+     * A handler which dispatches an error event.
+     * Only one error event will be emitted per unique PSSH.
+     * When track protections is set again, another error event may be emitted.
+     */
+    private readonly handleError;
+    /**
+     * Returns the number of currently active sessions.
+     */
+    get activeSessions(): number;
+    /**
+     * Clears the media keys from the element if they were set.
+     */
+    private clearMediaKeys;
+    protected abortIfDisposed(): void;
+    reset(): void;
+    get disposed(): boolean;
+    dispose(): void;
+    private getSessionByInitData;
+    /**
+     * Sort the key systems first by their priority, then by the presence of a license uri.
+     */
+    private readonly keySystemComparator;
+}
+//# sourceMappingURL=DrmControllerImpl.d.ts.map

package/dist/types/current/drm/DrmControllerImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrmControllerImpl.d.ts","sourceRoot":"","sources":["../../../../src/drm/DrmControllerImpl.ts"],"names":[],"mappings":"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"}