@mux/playback-core 0.7.1-canary.0-556dabf

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"program":{"fileNames":["../../../node_modules/typescript/lib/lib.es5.d.ts","../../../node_modules/typescript/lib/lib.es2015.d.ts","../../../node_modules/typescript/lib/lib.es2016.d.ts","../../../node_modules/typescript/lib/lib.es2017.d.ts","../../../node_modules/typescript/lib/lib.es2018.d.ts","../../../node_modules/typescript/lib/lib.es2019.d.ts","../../../node_modules/typescript/lib/lib.dom.d.ts","../../../node_modules/typescript/lib/lib.dom.iterable.d.ts","../../../node_modules/typescript/lib/lib.webworker.importscripts.d.ts","../../../node_modules/typescript/lib/lib.scripthost.d.ts","../../../node_modules/typescript/lib/lib.es2015.core.d.ts","../../../node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../node_modules/typescript/lib/lib.es2016.array.include.d.ts","../../../node_modules/typescript/lib/lib.es2017.object.d.ts","../../../node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../../../node_modules/typescript/lib/lib.es2017.string.d.ts","../../../node_modules/typescript/lib/lib.es2017.intl.d.ts","../../../node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../../../node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../../../node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../../../node_modules/typescript/lib/lib.es2018.intl.d.ts","../../../node_modules/typescript/lib/lib.es2018.promise.d.ts","../../../node_modules/typescript/lib/lib.es2018.regexp.d.ts","../../../node_modules/typescript/lib/lib.es2019.array.d.ts","../../../node_modules/typescript/lib/lib.es2019.object.d.ts","../../../node_modules/typescript/lib/lib.es2019.string.d.ts","../../../node_modules/typescript/lib/lib.es2019.symbol.d.ts","../../../node_modules/typescript/lib/lib.es2019.full.d.ts","../../../node_modules/hls.js/dist/hls.js.d.ts","../src/autoplay.ts","../src/errors.ts","../src/tracks.ts","../src/util.ts","../src/index.ts","../../../types/mux-embed.d.ts","../../../types/mux.d.ts"],"fileInfos":[{"version":"3ac1b83264055b28c0165688fda6dfcc39001e9e7828f649299101c23ad0a0c3","affectsGlobalScope":true},"dc47c4fa66b9b9890cf076304de2a9c5201e94b740cffdf09f87296d877d71f6","7a387c58583dfca701b6c85e0adaf43fb17d590fb16d5b2dc0a2fbd89f35c467","8a12173c586e95f4433e0c6dc446bc88346be73ffe9ca6eec7aa63c8f3dca7f9","5f4e733ced4e129482ae2186aae29fde948ab7182844c3a5a51dd346182c7b06","e6b724280c694a9f588847f754198fb96c43d805f065c3a5b28bbc9594541c84",{"version":"72704b10d97777e15f1a581b73f88273037ef752d2e50b72287bd0a90af64fe6","affectsGlobalScope":true},{"version":"dbb73d4d99be496175cb432c74c2615f78c76f4272f1d83cba11ee0ed6dbddf0","affectsGlobalScope":true},{"version":"7fac8cb5fc820bc2a59ae11ef1c5b38d3832c6d0dfaec5acdb5569137d09a481","affectsGlobalScope":true},{"version":"097a57355ded99c68e6df1b738990448e0bf170e606707df5a7c0481ff2427cd","affectsGlobalScope":true},{"version":"d8996609230d17e90484a2dd58f22668f9a05a3bfe00bfb1d6271171e54a31fb","affectsGlobalScope":true},{"version":"43fb1d932e4966a39a41b464a12a81899d9ae5f2c829063f5571b6b87e6d2f9c","affectsGlobalScope":true},{"version":"cdccba9a388c2ee3fd6ad4018c640a471a6c060e96f1232062223063b0a5ac6a","affectsGlobalScope":true},{"version":"c5c05907c02476e4bde6b7e76a79ffcd948aedd14b6a8f56e4674221b0417398","affectsGlobalScope":true},{"version":"0d5f52b3174bee6edb81260ebcd792692c32c81fd55499d69531496f3f2b25e7","affectsGlobalScope":true},{"version":"810627a82ac06fb5166da5ada4159c4ec11978dfbb0805fe804c86406dab8357","affectsGlobalScope":true},{"version":"62d80405c46c3f4c527ee657ae9d43fda65a0bf582292429aea1e69144a522a6","affectsGlobalScope":true},{"version":"3013574108c36fd3aaca79764002b3717da09725a36a6fc02eac386593110f93","affectsGlobalScope":true},{"version":"75ec0bdd727d887f1b79ed6619412ea72ba3c81d92d0787ccb64bab18d261f14","affectsGlobalScope":true},{"version":"3be5a1453daa63e031d266bf342f3943603873d890ab8b9ada95e22389389006","affectsGlobalScope":true},{"version":"17bb1fc99591b00515502d264fa55dc8370c45c5298f4a5c2083557dccba5a2a","affectsGlobalScope":true},{"version":"7ce9f0bde3307ca1f944119f6365f2d776d281a393b576a18a2f2893a2d75c98","affectsGlobalScope":true},{"version":"6a6b173e739a6a99629a8594bfb294cc7329bfb7b227f12e1f7c11bc163b8577","affectsGlobalScope":true},{"version":"12a310447c5d23c7d0d5ca2af606e3bd08afda69100166730ab92c62999ebb9d","affectsGlobalScope":true},{"version":"b0124885ef82641903d232172577f2ceb5d3e60aed4da1153bab4221e1f6dd4e","affectsGlobalScope":true},{"version":"0eb85d6c590b0d577919a79e0084fa1744c1beba6fd0d4e951432fa1ede5510a","affectsGlobalScope":true},{"version":"da233fc1c8a377ba9e0bed690a73c290d843c2c3d23a7bd7ec5cd3d7d73ba1e0","affectsGlobalScope":true},{"version":"d154ea5bb7f7f9001ed9153e876b2d5b8f5c2bb9ec02b3ae0d239ec769f1f2ae","affectsGlobalScope":true},{"version":"bb2d3fb05a1d2ffbca947cc7cbc95d23e1d053d6595391bd325deb265a18d36c","affectsGlobalScope":true},{"version":"c80df75850fea5caa2afe43b9949338ce4e2de086f91713e9af1a06f973872b8","affectsGlobalScope":true},{"version":"9d57b2b5d15838ed094aa9ff1299eecef40b190722eb619bac4616657a05f951","affectsGlobalScope":true},{"version":"6c51b5dd26a2c31dbf37f00cfc32b2aa6a92e19c995aefb5b97a3a64f1ac99de","affectsGlobalScope":true},{"version":"6e7997ef61de3132e4d4b2250e75343f487903ddf5370e7ce33cf1b9db9a63ed","affectsGlobalScope":true},{"version":"2ad234885a4240522efccd77de6c7d99eecf9b4de0914adb9a35c0c22433f993","affectsGlobalScope":true},"1f03b495671c3a1bd24510f38b8947f0991dfd6bf0278c68eca14af15b306e1f","ece0cccc693a3364f05f68d7feb4d472e05b9f2eaea80f19fc10b17a0a6aa14d","220ef4a7a23988997249b25f0561c317c059294c3b145426216a5af31de22721","2c90891ab2ef9273ebe2db728e271417f71625600221a13d11e19ec6f58fa673","daba6bbdb3eebc7c5c23813ea10bfd6a154de40e29fa9b4e470ab17031a87dcd","0a3f1571252fb6fa5d7b0b111836aae2dec501a1ba3ff1c381c1c61f5f7cd9f8","37b197bf33d00bb51ef3b7bf531733ede3c3ea00fae1041335ea4525bf156118","c5a4764697efe3b6b4eaf19b3dc1880cf3df665d30ec93e212233c29a2fa7207",{"version":"ee8e401f800f3d48020eda76c4fd27afd5bab992195252939329ae56dc9d1889","affectsGlobalScope":true}],"options":{"composite":true,"declaration":true,"emitDeclarationOnly":true,"esModuleInterop":true,"jsx":2,"module":5,"noImplicitAny":true,"outDir":"./types","rootDir":"../src","skipLibCheck":true,"sourceMap":true,"strict":true,"target":6},"fileIdsList":[[36],[36,37,38,39,40,42]],"referencedMap":[[37,1],[41,2],[39,1],[43,1]],"exportedModulesMap":[[37,1],[41,2],[39,1],[43,1]],"semanticDiagnosticsPerFile":[36,7,8,12,11,2,13,14,15,16,17,18,19,20,3,4,24,21,22,23,25,26,27,5,28,29,30,31,6,35,32,33,34,1,10,9,37,38,41,39,40,42,43]},"version":"4.6.4"}

package/dist/types/autoplay.d.ts

@@ -0,0 +1,15 @@
+import Hls from 'hls.js';
+declare type PlaybackEngine = Hls;
+export declare type AutoplayTypes = {
+    ANY: 'any';
+    MUTED: 'muted';
+};
+export declare const AutoplayTypes: AutoplayTypes;
+declare type ValueOf<T> = T[keyof T];
+declare type Maybe<T> = T | null | undefined;
+export declare type Autoplay = boolean | ValueOf<AutoplayTypes>;
+export declare type UpdateAutoplay = (newAutoplay: Maybe<string | boolean>) => void;
+export declare const isAutoplayValue: (value: unknown) => value is Autoplay;
+export declare const setupAutoplay: (mediaEl: HTMLMediaElement, maybeAutoplay: Maybe<string | boolean>, hls: PlaybackEngine | undefined) => UpdateAutoplay;
+export declare const handleAutoplay: (mediaEl: HTMLMediaElement, autoplay: Autoplay) => void;
+export {};

package/dist/types/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class MediaError extends Error {
+    static MEDIA_ERR_ABORTED: number;
+    static MEDIA_ERR_NETWORK: number;
+    static MEDIA_ERR_DECODE: number;
+    static MEDIA_ERR_SRC_NOT_SUPPORTED: number;
+    static MEDIA_ERR_ENCRYPTED: number;
+    static MEDIA_ERR_CUSTOM: number;
+    static defaultMessages: Record<number, string>;
+    name: string;
+    code: number;
+    fatal: boolean;
+    data?: any;
+    constructor(message?: string, code?: number, fatal?: boolean);
+}

package/dist/types/index.d.ts

@@ -0,0 +1,70 @@
+import '@mux/polyfills';
+import mux, { Options } from 'mux-embed';
+import Hls, { HlsConfig } from 'hls.js';
+import { AutoplayTypes, setupAutoplay } from './autoplay';
+import { MediaError } from './errors';
+import type { Autoplay, UpdateAutoplay } from './autoplay';
+export declare type ValueOf<T> = T[keyof T];
+export declare type Metadata = Partial<Options['data']>;
+export declare type PlaybackEngine = Hls;
+export { mux, Hls, MediaError, Autoplay, UpdateAutoplay, setupAutoplay };
+export declare const generatePlayerInitTime: () => any;
+export declare type StreamTypes = {
+    VOD: 'on-demand';
+    ON_DEMAND: 'on-demand';
+    LIVE: 'live';
+    LL_LIVE: 'll-live';
+    DVR: 'live:dvr';
+    LL_DVR: 'll-live:dvr';
+};
+export declare const StreamTypes: StreamTypes;
+export declare type ExtensionMimeTypeMap = {
+    M3U8: 'application/vnd.apple.mpegurl';
+    MP4: 'video/mp4';
+};
+export declare const ExtensionMimeTypeMap: ExtensionMimeTypeMap;
+export declare type MimeTypeShorthandMap = {
+    HLS: ExtensionMimeTypeMap['M3U8'];
+};
+export declare const MimeTypeShorthandMap: MimeTypeShorthandMap;
+export declare const shorthandKeys: string[];
+export declare type MediaTypes = ValueOf<ExtensionMimeTypeMap> | keyof MimeTypeShorthandMap
+/** @TODO Figure out a way to "downgrade" derived types below to early TS syntax (e.g. 3.4) instead of explicit versions here (CJP) */
+ | 'hls';
+export declare const allMediaTypes: MediaTypes[];
+export declare type MuxMediaPropTypes = {
+    envKey: Options['data']['env_key'];
+    debug: Options['debug'] & Hls['config']['debug'];
+    metadata: Partial<Options['data']>;
+    customDomain: string;
+    beaconCollectionDomain: Options['beaconCollectionDomain'];
+    errorTranslator: Options['errorTranslator'];
+    playbackId: string;
+    playerInitTime: Options['data']['player_init_time'];
+    preferMse: boolean;
+    type: MediaTypes;
+    streamType: ValueOf<StreamTypes>;
+    startTime: HlsConfig['startPosition'];
+    autoPlay: boolean | ValueOf<AutoplayTypes>;
+    autoplay: boolean | ValueOf<AutoplayTypes>;
+};
+export declare type HTMLMediaElementProps = Partial<Pick<HTMLMediaElement, 'src'>>;
+export declare type MuxMediaProps = HTMLMediaElementProps & MuxMediaPropTypes;
+export declare type MuxMediaPropsInternal = MuxMediaProps & {
+    playerSoftwareName: Options['data']['player_software_name'];
+    playerSoftwareVersion: Options['data']['player_software_version'];
+};
+export declare const toPlaybackIdParts: (playbackIdWithOptionalParams: string) => [string, string?];
+export declare const toMuxVideoURL: (playbackId?: string | undefined, { domain }?: {
+    domain?: string | undefined;
+}) => string | undefined;
+export declare const inferMimeTypeFromURL: (url: string) => "" | "application/vnd.apple.mpegurl" | "video/mp4";
+export declare const getType: (props: Partial<Pick<MuxMediaProps, 'type' | 'src'>>) => "" | MediaTypes;
+export declare const getStreamTypeConfig: (streamType?: ValueOf<StreamTypes> | undefined) => {};
+export declare const getError: (mediaEl: HTMLMediaElement) => MediaError | undefined;
+export declare const teardown: (mediaEl?: HTMLMediaElement | null | undefined, hls?: Pick<Hls, "destroy" | "detachMedia"> | undefined) => void;
+export declare const setupHls: (props: Partial<Pick<MuxMediaProps, 'debug' | 'preferMse' | 'streamType' | 'type' | 'src' | 'startTime'>>, mediaEl?: Pick<HTMLMediaElement, "canPlayType"> | null | undefined) => Hls | undefined;
+export declare const isMuxVideoSrc: ({ playbackId, src, customDomain, }: Partial<Pick<MuxMediaPropsInternal, 'playbackId' | 'src' | 'customDomain'>>) => boolean;
+export declare const setupMux: (props: Partial<Pick<MuxMediaPropsInternal, 'envKey' | 'playerInitTime' | 'beaconCollectionDomain' | 'errorTranslator' | 'metadata' | 'debug' | 'playerSoftwareName' | 'playerSoftwareVersion' | 'playbackId' | 'src' | 'customDomain'>>, mediaEl?: HTMLMediaElement | null | undefined, hlsjs?: Hls | undefined) => void;
+export declare const loadMedia: (props: Partial<Pick<MuxMediaProps, 'preferMse' | 'src' | 'type' | 'startTime' | 'streamType' | 'autoplay'>>, mediaEl?: HTMLMediaElement | null | undefined, hls?: Pick<Hls, "once" | "liveSyncPosition" | "on" | "subtitleTracks" | "subtitleTrack" | "config" | "destroy" | "attachMedia" | "loadSource" | "startLoad" | "stopLoad" | "recoverMediaError"> | undefined) => void;
+export declare const initialize: (props: Partial<MuxMediaPropsInternal>, mediaEl?: HTMLMediaElement | null | undefined, hls?: Hls | undefined) => Hls | undefined;

package/dist/types/tracks.d.ts

@@ -0,0 +1,2 @@
+import Hls from 'hls.js';
+export declare function setupTracks(mediaEl: HTMLMediaElement, hls: Pick<Hls, 'on' | 'once' | 'subtitleTracks' | 'subtitleTrack'>): void;

package/dist/types/util.d.ts

@@ -0,0 +1,3 @@
+declare type KeyTypes = string | number | symbol;
+export declare const isKeyOf: <T = any>(k: KeyTypes, o: T) => k is keyof T;
+export {};

package/dist/types-ts3.4/autoplay.d.ts

@@ -0,0 +1,15 @@
+import Hls from 'hls.js';
+declare type PlaybackEngine = Hls;
+export declare type AutoplayTypes = {
+    ANY: 'any';
+    MUTED: 'muted';
+};
+export declare const AutoplayTypes: AutoplayTypes;
+declare type ValueOf<T> = T[keyof T];
+declare type Maybe<T> = T | null | undefined;
+export declare type Autoplay = boolean | ValueOf<AutoplayTypes>;
+export declare type UpdateAutoplay = (newAutoplay: Maybe<string | boolean>) => void;
+export declare const isAutoplayValue: (value: unknown) => value is Autoplay;
+export declare const setupAutoplay: (mediaEl: HTMLMediaElement, maybeAutoplay: Maybe<string | boolean>, hls: PlaybackEngine | undefined) => UpdateAutoplay;
+export declare const handleAutoplay: (mediaEl: HTMLMediaElement, autoplay: Autoplay) => void;
+export {};

package/dist/types-ts3.4/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class MediaError extends Error {
+    static MEDIA_ERR_ABORTED: number;
+    static MEDIA_ERR_NETWORK: number;
+    static MEDIA_ERR_DECODE: number;
+    static MEDIA_ERR_SRC_NOT_SUPPORTED: number;
+    static MEDIA_ERR_ENCRYPTED: number;
+    static MEDIA_ERR_CUSTOM: number;
+    static defaultMessages: Record<number, string>;
+    name: string;
+    code: number;
+    fatal: boolean;
+    data?: any;
+    constructor(message?: string, code?: number, fatal?: boolean);
+}

package/dist/types-ts3.4/index.d.ts

@@ -0,0 +1,73 @@
+import '@mux/polyfills';
+import mux, { Options } from 'mux-embed';
+import Hls, { HlsConfig } from 'hls.js';
+import { AutoplayTypes, setupAutoplay } from './autoplay';
+import { MediaError } from './errors';
+import { Autoplay, UpdateAutoplay } from './autoplay';
+export declare type ValueOf<T> = T[keyof T];
+export declare type Metadata = Partial<Options['data']>;
+export declare type PlaybackEngine = Hls;
+export { mux, Hls, MediaError, Autoplay, UpdateAutoplay, setupAutoplay };
+export declare const generatePlayerInitTime: () => any;
+export declare type StreamTypes = {
+    VOD: 'on-demand';
+    ON_DEMAND: 'on-demand';
+    LIVE: 'live';
+    LL_LIVE: 'll-live';
+    DVR: 'live:dvr';
+    LL_DVR: 'll-live:dvr';
+};
+export declare const StreamTypes: StreamTypes;
+export declare type ExtensionMimeTypeMap = {
+    M3U8: 'application/vnd.apple.mpegurl';
+    MP4: 'video/mp4';
+};
+export declare const ExtensionMimeTypeMap: ExtensionMimeTypeMap;
+export declare type MimeTypeShorthandMap = {
+    HLS: ExtensionMimeTypeMap['M3U8'];
+};
+export declare const MimeTypeShorthandMap: MimeTypeShorthandMap;
+export declare const shorthandKeys: string[];
+export declare type MediaTypes = ValueOf<ExtensionMimeTypeMap> | keyof MimeTypeShorthandMap
+/** @TODO Figure out a way to "downgrade" derived types below to early TS syntax (e.g. 3.4) instead of explicit versions here (CJP) */
+ | 'hls';
+export declare const allMediaTypes: MediaTypes[];
+export declare type MuxMediaPropTypes = {
+    envKey: Options['data']['env_key'];
+    debug: Options['debug'] & Hls['config']['debug'];
+    metadata: Partial<Options['data']>;
+    customDomain: string;
+    beaconCollectionDomain: Options['beaconCollectionDomain'];
+    errorTranslator: Options['errorTranslator'];
+    playbackId: string;
+    playerInitTime: Options['data']['player_init_time'];
+    preferMse: boolean;
+    type: MediaTypes;
+    streamType: ValueOf<StreamTypes>;
+    startTime: HlsConfig['startPosition'];
+    autoPlay: boolean | ValueOf<AutoplayTypes>;
+    autoplay: boolean | ValueOf<AutoplayTypes>;
+};
+export declare type HTMLMediaElementProps = Partial<Pick<HTMLMediaElement, 'src'>>;
+export declare type MuxMediaProps = HTMLMediaElementProps & MuxMediaPropTypes;
+export declare type MuxMediaPropsInternal = MuxMediaProps & {
+    playerSoftwareName: Options['data']['player_software_name'];
+    playerSoftwareVersion: Options['data']['player_software_version'];
+};
+export declare const toPlaybackIdParts: (playbackIdWithOptionalParams: string) => [
+    string,
+    string?
+];
+export declare const toMuxVideoURL: (playbackId?: string | undefined, { domain }?: {
+    domain?: string | undefined;
+}) => string | undefined;
+export declare const inferMimeTypeFromURL: (url: string) => "" | "application/vnd.apple.mpegurl" | "video/mp4";
+export declare const getType: (props: Partial<Pick<MuxMediaProps, 'type' | 'src'>>) => "" | MediaTypes;
+export declare const getStreamTypeConfig: (streamType?: ValueOf<StreamTypes> | undefined) => {};
+export declare const getError: (mediaEl: HTMLMediaElement) => MediaError | undefined;
+export declare const teardown: (mediaEl?: HTMLMediaElement | null | undefined, hls?: Pick<Hls, "destroy" | "detachMedia"> | undefined) => void;
+export declare const setupHls: (props: Partial<Pick<MuxMediaProps, 'debug' | 'preferMse' | 'streamType' | 'type' | 'src' | 'startTime'>>, mediaEl?: Pick<HTMLMediaElement, "canPlayType"> | null | undefined) => Hls | undefined;
+export declare const isMuxVideoSrc: ({ playbackId, src, customDomain, }: Partial<Pick<MuxMediaPropsInternal, 'playbackId' | 'src' | 'customDomain'>>) => boolean;
+export declare const setupMux: (props: Partial<Pick<MuxMediaPropsInternal, 'envKey' | 'playerInitTime' | 'beaconCollectionDomain' | 'errorTranslator' | 'metadata' | 'debug' | 'playerSoftwareName' | 'playerSoftwareVersion' | 'playbackId' | 'src' | 'customDomain'>>, mediaEl?: HTMLMediaElement | null | undefined, hlsjs?: Hls | undefined) => void;
+export declare const loadMedia: (props: Partial<Pick<MuxMediaProps, 'preferMse' | 'src' | 'type' | 'startTime' | 'streamType' | 'autoplay'>>, mediaEl?: HTMLMediaElement | null | undefined, hls?: Pick<Hls, "once" | "liveSyncPosition" | "on" | "subtitleTracks" | "subtitleTrack" | "config" | "destroy" | "attachMedia" | "loadSource" | "startLoad" | "stopLoad" | "recoverMediaError"> | undefined) => void;
+export declare const initialize: (props: Partial<MuxMediaPropsInternal>, mediaEl?: HTMLMediaElement | null | undefined, hls?: Hls | undefined) => Hls | undefined;

package/dist/types-ts3.4/tracks.d.ts

@@ -0,0 +1,2 @@
+import Hls from 'hls.js';
+export declare function setupTracks(mediaEl: HTMLMediaElement, hls: Pick<Hls, 'on' | 'once' | 'subtitleTracks' | 'subtitleTrack'>): void;

package/dist/types-ts3.4/util.d.ts

@@ -0,0 +1,3 @@
+declare type KeyTypes = string | number | symbol;
+export declare const isKeyOf: <T = any>(k: KeyTypes, o: T) => k is keyof T;
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@mux/playback-core",
+  "version": "0.7.1-canary.0-556dabf",
+  "description": "Core library for media playback in the browser shared by mux elements",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.mjs",
+  "browser": "./dist/index.mjs",
+  "unpkg": "./dist/playback-core.js",
+  "exports": {
+    "import": "./dist/index.mjs",
+    "require": "./dist/index.cjs.js",
+    "default": "./dist/index.cjs.js"
+  },
+  "types": "dist/types-ts3.4/index.d.ts",
+  "typesVersions": {
+    ">=4.3.5": {
+      "*": [
+        "dist/types/index.d.ts"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/muxinc/elements",
+    "directory": "packages/playback-core"
+  },
+  "author": "Mux, Inc.",
+  "license": "MIT",
+  "scripts": {
+    "clean": "shx rm -rf dist/",
+    "dev:cjs": "open-process | yarn build:cjs --watch",
+    "dev:esm": "open-process | yarn build:esm --watch",
+    "dev:esm-module": "open-process | yarn build:esm-module --watch",
+    "dev:iife": "open-process | yarn build:iife --watch",
+    "dev:types": "yarn build:types -w",
+    "dev": "npm-run-all --parallel dev:types dev:cjs dev:esm dev:iife dev:esm-module",
+    "build:esm": "esbuild --metafile=./dist/esm.json src/index.ts --target=es2019 --bundle --sourcemap --format=esm --outdir=dist --out-extension:.js=.mjs --external:mux-embed --external:hls.js",
+    "build:esm-module": "esbuild --metafile=./dist/module.json src/index.ts --target=es2019 --bundle --sourcemap --format=esm --outfile=./dist/playback-core.mjs",
+    "build:cjs": "esbuild --metafile=./dist/cjs.json src/index.ts --target=es2019 --bundle --sourcemap --format=cjs --outdir=dist --out-extension:.js=.cjs.js --external:mux-embed --external:hls.js",
+    "build:iife": "esbuild --metafile=./dist/iife.json src/index.ts --target=es2019 --bundle --sourcemap --format=iife --outfile=./dist/playback-core.js",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir './dist/types' && downlevel-dts ./dist/types ./dist/types-ts3.4 --to=3.4",
+    "build": "npm-run-all --parallel build:types 'build:esm -- --minify' 'build:iife -- --minify' 'build:cjs -- --minify' 'build:esm-module -- --minify'",
+    "prebuild": "yarn clean",
+    "prepublishOnly": "yarn build",
+    "create-release-notes": "create-release-notes ./CHANGELOG.md",
+    "publish-release": "../../scripts/publish.sh"
+  },
+  "dependencies": {
+    "hls.js": "1.1.5",
+    "mux-embed": "^4.7.0"
+  },
+  "devDependencies": {
+    "@mux/open-process": "0.1.0",
+    "@mux/polyfills": "0.1.0",
+    "downlevel-dts": "^0.9.0",
+    "esbuild": "^0.13.13",
+    "npm-run-all": "^4.1.5",
+    "shx": "^0.3.4",
+    "typescript": "^4.5.2"
+  }
+}

package/src/autoplay.ts

@@ -0,0 +1,167 @@
+import Hls from 'hls.js';
+
+type PlaybackEngine = Hls;
+
+// TODO add INVIEW_MUTED, INVIEW_ANY
+export type AutoplayTypes = {
+  ANY: 'any';
+  MUTED: 'muted';
+};
+
+export const AutoplayTypes: AutoplayTypes = {
+  ANY: 'any',
+  MUTED: 'muted',
+};
+
+type ValueOf<T> = T[keyof T];
+type Maybe<T> = T | null | undefined;
+export type Autoplay = boolean | ValueOf<AutoplayTypes>;
+export type UpdateAutoplay = (newAutoplay: Maybe<string | boolean>) => void;
+
+const AutoplayTypeValues = Object.values(AutoplayTypes);
+export const isAutoplayValue = (value: unknown): value is Autoplay => {
+  return (
+    typeof value === 'boolean' ||
+    (typeof value === 'string' && AutoplayTypeValues.includes(value as ValueOf<AutoplayTypes>))
+  );
+};
+
+// Given a video element, will listen to lifecycle events to determine important
+// things like whether the video is live or whether the video has played
+// and then handles autoplaying the video as appropraite.
+// It works with both the native video element or hls.js.
+// This returns a method UpdateAutoplay, that allows the user to change
+// the value of the autoplay attribute and it will react appropriately.
+export const setupAutoplay = (
+  mediaEl: HTMLMediaElement,
+  maybeAutoplay: Maybe<string | boolean>,
+  hls: PlaybackEngine | undefined
+) => {
+  let hasPlayed = false;
+  let isLive = false;
+  let autoplay: Autoplay = isAutoplayValue(maybeAutoplay) ? maybeAutoplay : !!maybeAutoplay;
+
+  const updateHasPlayed = () => {
+    // hasPlayed
+    mediaEl.addEventListener(
+      'playing',
+      () => {
+        hasPlayed = true;
+      },
+      { once: true }
+    );
+  };
+
+  updateHasPlayed();
+
+  // on `loadstart`
+  // hasPlayed should default to false
+  // we should try and autoplay
+  mediaEl.addEventListener(
+    'loadstart',
+    () => {
+      hasPlayed = false;
+      updateHasPlayed();
+      handleAutoplay(mediaEl, autoplay);
+    },
+    { once: true }
+  );
+
+  // on `loadedmetadata` we can check whether we're live in the case of native playback
+  mediaEl.addEventListener(
+    'loadedmetadata',
+    () => {
+      // only update isLive here if we're using native playback
+      if (!hls) {
+        isLive = !Number.isFinite(mediaEl.duration);
+      }
+      handleAutoplay(mediaEl, autoplay);
+    },
+    { once: true }
+  );
+
+  // determine if we're live for hls.js
+  if (hls) {
+    hls.once(Hls.Events.LEVEL_LOADED, (e: any, data: any) => {
+      isLive = data.details.live ?? false;
+    });
+  }
+
+  // When we are not auto-playing, we should seek to the live sync position
+  // This will seek first play event of *any* live video including event-type,
+  // which probably shouldn't seek
+  if (!autoplay) {
+    const handleSeek = () => {
+      // don't seek if we're not live
+      if (!isLive) {
+        return;
+      }
+      // seek to either hls.js's liveSyncPosition or the native seekable end
+      if (hls?.liveSyncPosition) {
+        mediaEl.currentTime = hls.liveSyncPosition;
+      } else {
+        if (Number.isFinite(mediaEl.seekable.end(0))) {
+          mediaEl.currentTime = mediaEl.seekable.end(0);
+        }
+      }
+    };
+    mediaEl.addEventListener(
+      'play',
+      () => {
+        if (hls && mediaEl.preload === 'metadata') {
+          hls.once(Hls.Events.LEVEL_UPDATED, handleSeek);
+        } else if (hls) {
+          handleSeek();
+        }
+      },
+      { once: true }
+    );
+  }
+
+  // this method allows us to update the value of autoplay
+  // and try autoplaying appropriately.
+  const updateAutoplay: UpdateAutoplay = (newAutoplay) => {
+    if (!hasPlayed) {
+      autoplay = isAutoplayValue(newAutoplay) ? newAutoplay : !!newAutoplay;
+      handleAutoplay(mediaEl, autoplay);
+    }
+  };
+
+  return updateAutoplay;
+};
+
+export const handleAutoplay = (mediaEl: HTMLMediaElement, autoplay: Autoplay) => {
+  if (!autoplay) {
+    return;
+  }
+
+  const oldMuted = mediaEl.muted;
+  const restoreMuted = () => (mediaEl.muted = oldMuted);
+
+  switch (autoplay) {
+    // ANY:
+    // try to play with current options
+    // if it fails, mute and try playing again
+    // if that fails, restore muted state and don't try playing again
+    case AutoplayTypes.ANY:
+      mediaEl.play().catch((error: Error) => {
+        mediaEl.muted = true;
+        mediaEl.play().catch(restoreMuted);
+      });
+      break;
+
+    // MUTED:
+    // mute the player and then try playing
+    // if that fails, restore muted state
+    case AutoplayTypes.MUTED:
+      mediaEl.muted = true;
+      mediaEl.play().catch(restoreMuted);
+      break;
+
+    // Default or if autoplay is a boolean attribute:
+    // Try playing the video and catch the failed autoplay warning
+    default:
+      mediaEl.play().catch(() => {});
+      break;
+  }
+};

package/src/errors.ts

@@ -0,0 +1,33 @@
+export class MediaError extends Error {
+  static MEDIA_ERR_ABORTED: number = 1;
+  static MEDIA_ERR_NETWORK: number = 2;
+  static MEDIA_ERR_DECODE: number = 3;
+  static MEDIA_ERR_SRC_NOT_SUPPORTED: number = 4;
+  static MEDIA_ERR_ENCRYPTED: number = 5;
+  // @see https://docs.mux.com/guides/data/monitor-html5-video-element#customize-error-tracking-behavior
+  static MEDIA_ERR_CUSTOM: number = 100;
+
+  static defaultMessages: Record<number, string> = {
+    1: 'You aborted the media playback',
+    2: 'A network error caused the media download to fail.',
+    3: 'A media error caused playback to be aborted. The media could be corrupt or your browser does not support this format.',
+    4: 'An unsupported error occurred. The server or network failed, or your browser does not support this format.',
+    5: 'The media is encrypted and there are no keys to decrypt it.',
+  };
+
+  name: string;
+  code: number;
+  fatal: boolean;
+  data?: any;
+
+  constructor(message?: string, code: number = MediaError.MEDIA_ERR_CUSTOM, fatal?: boolean) {
+    super(message);
+    this.name = 'MediaError';
+    this.code = code;
+    this.fatal = fatal ?? (code >= MediaError.MEDIA_ERR_NETWORK && code <= MediaError.MEDIA_ERR_ENCRYPTED);
+
+    if (!this.message) {
+      this.message = MediaError.defaultMessages[this.code] ?? '';
+    }
+  }
+}