@glomex/integration-web-component 1.1544.1 → 1.1547.0

package/dist/index.d.ts

@@ -1,2805 +1,52 @@
-
-import type { SerializedError } from '@reduxjs/toolkit';
-
-export declare interface Ad {
-    sessionId: string;
-    id: string;
-    adFormat: AdFormat | `${AdFormat}`;
-    duration?: number;
-    positionIndex: number;
-    breakIndex: number;
-    breakName: AdBreakName | `${AdBreakName}`;
-    mimetype: string;
-    totalAds: number;
-    adUrl?: string;
-    nonLinearWidth?: number;
-    nonLinearHeight?: number;
-    title?: string;
-    advertiserName?: string;
-    width?: number;
-    height?: number;
-    adSystem?: string;
-    universalAdIds?: {
-        id: string;
-        registry: string;
-    }[];
-    creativeId?: string;
-    skippable: boolean;
-    clickThroughUrl?: string;
-}
-
-/** Name of ad break - when the ad appears, `OVERLAY` is deprecated */
-export declare enum AdBreakName {
-    PREROLL = "preroll",
-    MIDROLL = "midroll",
-    POSTROLL = "postroll"
-}
-
-/**
- * A broad error shape accepted by AD_ERROR events.
- * Any `Error` with a `name` and `code` satisfies this contract,
- * so domain-specific errors can flow through without normalisation
- * while preserving their origin.
- */
-export declare interface AdError extends Error {
-    name: string;
-    message: string;
-    code: string;
-}
-
-/** Format of the ad - how it is presented */
-export declare enum AdFormat {
-    LINEAR = "linear",
-    OVERLAY = "overlay",
-    CUTIN = "cutin",
-    PAUSE = "pause"
-}
-
-declare const ALLOWED_UI_ACTIONS: readonly ["play", "pause", "openEpg", "startAgeSetup", "forgotPin", "upgradeToHigherTier"];
-
-/**
- * An additional API script definition that should be executed for this media-item.
- *
- * @example
- * ```
- * {
- *   name: 'some-name',
- *   scriptUrl: 'https://content-owner.com/tracking/script.js',
- *   conditions: [
- *     { startMethods: ['click-to-play'], muted: false, requiredVendors: ['967'], probability: 1 },
- *     { startMethods: ['autoplay-scroll'], muted: undefined, requiredVendors: undefined, probability: 1 } // undefined = no filtering
- *   ]
- * }
- * ```
- */
-declare interface ApiScript {
-    /** Name of the API script that should be exposed to tracking */
-    name: string;
-    /** URL of the API script that should be executed. Must implement {@link ConnectIntegration}. */
-    url: string;
-    /**
-     * Conditions under which the API script should be executed. Undefined means always.
-     */
-    conditions?: {
-        startMethods?: StartMethod[];
-        muted?: boolean | undefined;
-        requiredVendors?: string[];
-        probability: number;
-    }[];
-}
-
-/**
- * Represents an audio track.
- */
-export declare interface AudioTrack extends MediaTrack {
-    /** The type of audio track. */
-    kind: 'main' | string;
-}
-
-/**
- * A collection of audio tracks with selection support.
- * A selected track is available when track info is exposed; otherwise null.
- *
- * **Note:** Audio tracks are available after the {@link IntegrationElement.ready | integration.ready} promise resolves.
- *
- * The list is iterable and can be converted to an array:
- * @example
- * ```ts
- * for (const track of integration.audioTracks) { console.log(track); }
- * const tracks = Array.from(integration.audioTracks);
- * ```
- */
-export declare interface AudioTrackList extends MediaTrackList<AudioTrack> {
-    /** The currently selected audio track, or `null` if unavailable. */
-    readonly selected: AudioTrack | null;
-    /**
-     * Selects an audio track.
-     * @param trackOrId - The track or track ID to select.
-     */
-    select(trackOrId: AudioTrack | string): void;
-}
-
-declare class BaseMediaError<T extends string = string> extends Error {
-    code: T;
-    name: string;
-    constructor(message: string, code: T);
-}
-
-export declare interface Channel {
-    /** Human-readable channel title shown in the player UI */
-    name?: string;
-    /** Stable machine-facing code used for lookups or analytics */
-    code?: string;
-    /** Provider-specific identifier when it differs from `code` */
-    id?: string;
-    /** Canonical playback or landing URL clients should open */
-    url?: string;
-    /** Square channel-logo URL (ideally 96x96) used wherever icons appear */
-    logo?: string;
-}
-
-export declare enum ComponentName {
-    INTEGRATION = "glomex-integration",
-    TURBO_INTEGRATION = "turbo-integration",
-    EXTERNAL_MEDIA_ITEM = "external-media-item",
-    GLOMEX_MEDIA_ITEM = "glomex-media-item",
-    JOYN_MEDIA_ITEM = "joyn-media-item"
-}
-
-/**
- * Describes the contract that an external API tracking script must implement so that it can be
- * imported and executed by the integration. The API script must be hosted on the remote server
- * with CORS enabled.
- *
- * @example
- * ```ts
- * import { IntegrationEvent } from '@glomex/integration';
- * export const connectIntegration: ConnectIntegration = (
- *   integration,
- *   // userId will be undefined when no consent is given
- *   { userCountryCode, userId, integrationEnvironment }
- * ) => {
- *   integration.addEventListener(IntegrationEvent.CONTENT_PLAY, () => {
- *     console.log('play', integration.content);
- *   });
- * };
- * ```
- *
- * @example
- * ```js
- * export const connectIntegration = (
- *   integration,
- *   // userId will be undefined when no consent is given
- *   { userCountryCode, userId, integrationEnvironment }
- * ) => {
- *   const { IntegrationEvent } = integration.constructor;
- *   integration.addEventListener(IntegrationEvent.CONTENT_PLAY, () => {
- *     console.log('play', integration.content);
- *   });
- * };
- * ```
- */
-export declare type ConnectIntegration = (integration: IntegrationElement, context: {
-    userCountryCode?: string;
-    userId?: string;
-    integrationEnvironment?: string;
-}, options?: {
-    warnCallback?: (error: Error) => void;
-}) => (() => void) | undefined;
-
-export declare interface Consent {
-    gdprApplies: boolean;
-    consentString?: string;
-    cmpId?: number;
-    policyVersion?: number;
-    vendorListVersion?: number;
-    vendorConsents?: Record<string, boolean>;
-    vendorLegitimateInterests?: Record<string, boolean>;
-    purposeConsents?: Record<string, boolean>;
-    purposeLegitimateInterests?: Record<string, boolean>;
-    ready: boolean;
-    addtlConsent?: string;
-}
-
-export declare enum ContentStopReason {
-    CLEAR_PLAYLIST = "clearPlaylist",
-    SELECT_PLAYLIST_ITEM = "selectPlaylistItem",
-    ENDED = "ended",
-    CONTENT_ERROR = "contentError",
-    API_STOP = "apiStop",
-    LIVESTREAM_STOP = "livestreamStop",
-    LIVESTREAM_NOT_STARTED = "livestreamNotStarted",
-    PAGE_HIDE = "pageHide",
-    BEFORE_UNLOAD = "beforeUnload"
-}
-
-export declare interface CustomMarker extends Omit<Marker, 'name'> {
-    /** {@inheritDoc Marker.name} */
-    name: string;
-}
-
-/**
- * Identifier names for device IDs that can be passed via {@link SharedContextData.deviceId}.
- */
-export declare enum DeviceIdName {
-    /** Android Advertising ID (Google) */
-    AAID = "aaid",
-    /** Amazon Fire OS Advertising ID */
-    AFAI = "afai",
-    /** Android App Set ID — scope: app */
-    ASIA = "asia",
-    /** Android App Set ID — scope: developer */
-    ASID = "asid",
-    /** Tizen Identifier for Advertising (Samsung) */
-    TIFA = "tifa",
-    /** VIDAA Advertising ID (Hisense) */
-    VAID = "vaid",
-    /** Apple Identifier for Advertisers */
-    IDFA = "idfa",
-    /** Apple Identifier for Vendors */
-    IDFV = "idfv",
-    /** LG Unique Device ID */
-    LGUDID = "lgudid",
-    /** Microsoft Advertising ID */
-    MSAI = "msai",
-    /** Huawei Open Advertising ID */
-    OAID = "oaid",
-    /** PlayStation Advertising ID */
-    PSNAI = "psnai",
-    /** Roku Identifier for Advertising */
-    RIDA = "rida",
-    /** Vizio Advertising ID */
-    VIDA = "vida",
-    /** TitanOS Advertising ID (Walmart) */
-    WAID = "waid"
-}
-
-/**
- * Standard EME key system identifiers for the DRM systems supported by the player.
- *
- * Set by the content service after DRM-support detection and source
- * selection so that the video element only needs to know *which* DRM
- * system is in use — without license URIs, tokens or certificates.
- */
-export declare enum DrmSystem {
-    FAIRPLAY = "com.apple.fps",
-    WIDEVINE = "com.widevine.alpha",
-    PLAYREADY = "com.microsoft.playready"
-}
-
-declare interface Experiment {
-    name: string;
-    enabled: boolean;
-    participantPercentage: number;
-    variants: Record<string, ExperimentVariant>;
-    conditions: Record<string, unknown>;
-}
-
-declare interface ExperimentVariant {
-    weight: number;
-    contentOverride: Record<string, unknown>;
-}
-
-export declare interface ExtendedVideoPlaybackQuality extends VideoPlaybackQuality {
-    bitrate: number;
-    liveLatency: number;
-    throughput: number;
-    bytes: number;
-    bandwidth: number;
-    width: number;
-    height: number;
-}
-
-/** @ignore */
-export declare const EXTERNAL_PLAYER_NAME = "turbo-player";
-
-/**
- * A media item web component that allows to define external media items via inline JSON.
- * It can be placed inside the integration element as a child.
- * For more complex use cases, see {@link MediaItemElement}.
- *
- * @tagname external-media-item
- *
- * @slot - Slot for inline JSON of type `application/external-media-item+json`
- *
- * @example single media item with inline JSON
- *
- * This only works when no `playlist-id` is assigned to `glomex-integration`
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <external-media-item>
- *     <script type="application/external-media-item+json">
- *       {
- *         "id": "SOME_ID",
- *         "sources": [
- *           {
- *             "src": "SOME_VIDEO_URL",
- *             "mimetype": "video/mp4"
- *           }
- *         ],
- *         "duration": 120,
- *         "poster": "POSTER_URL",
- *         "title": "VIDEO_TITLE"
- *       }
- *     </script>
- *   </external-media-item>
- * </glomex-integration>
- * ```
- *
- * @example multiple media items with inline JSON array
- *
- * You can also pass an array of {@link MediaItem} objects to define a playlist.
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <external-media-item>
- *     <script type="application/external-media-item+json">
- *       [
- *         {
- *           "id": "VIDEO_1",
- *           "sources": [{ "src": "VIDEO_1_URL", "mimetype": "video/mp4" }],
- *           "duration": 120,
- *           "poster": "POSTER_1_URL",
- *           "title": "First Video"
- *         },
- *         {
- *           "id": "VIDEO_2",
- *           "sources": [{ "src": "VIDEO_2_URL", "mimetype": "video/mp4" }],
- *           "duration": 180,
- *           "poster": "POSTER_2_URL",
- *           "title": "Second Video"
- *         }
- *       ]
- *     </script>
- *   </external-media-item>
- * </glomex-integration>
- * ```
- */
-export declare class ExternalMediaItemElement extends MediaItemElement {
-}
-
-/**
- * An optional context object that can be used to pass additional application, device and user information to the integration. Updates must be performed immutably: always provide a new object to the {@link IntegrationElement#extraContext} property when modifying any property or nested field.
- */
-export declare interface ExtraContext {
-    /**
-     * The presentational context of the integration. Do not define it when it is not part of those contexts.
-     */
-    presentationalContext?: 'curated-list' | 'discovery-page';
-    /**
-     * The version of the app. When it is a website, fill in the deployed version of the website.
-     */
-    appVersion?: string;
-    /**
-     * The name of the app. When it is a website, fill in the name of the project.
-     */
-    appName?: string;
-    /**
-     * User ids of the user. User ids are only used when the user has given consent for the assigned vendor.
-     */
-    userIds?: {
-        id: string;
-        name: UserIdName | `${UserIdName}`;
-        ext?: Record<string, unknown>;
-    }[];
-    /**
-     * The bundle id of the app. Only required for iOS apps.
-     */
-    appBundleId?: string;
-    /**
-     * The store id of the app. Only required for apps. Depending on the app store, the id is formatted differently.
-     * {@link https://iabtechlab.com/wp-content/uploads/2020/08/IAB-Tech-Lab-OTT-store-assigned-App-Identification-Guidelines-2020.pdf IAB Tech Lab App Identification Guidelines}
-     */
-    appStoreId?: string;
-    /**
-     * The store URL of the app. Only required for apps.
-     * {@link https://iabtechlab.com/wp-content/uploads/2020/08/IAB-Tech-Lab-OTT-store-assigned-App-Identification-Guidelines-2020.pdf IAB Tech Lab App Identification Guidelines}
-     */
-    appStoreUrl?: string;
-    b2bContext?: string;
-    deviceId?: {
-        id: string;
-        name: DeviceIdName | `${DeviceIdName}`;
-    };
-}
-
-/** Returns the custom element name for the given tenant. */
-export declare function getIntegrationComponentName(tenant?: string): string;
-
-/** Returns the CSS URL for a given integration, tenant and environment. */
-export declare function getIntegrationCssUrl(integrationId: string, tenant?: string, env?: TenantEnvironment): string;
-
-/**
- * Returns the {@link SharedContext} singleton from the loaded integration.
- *
- * Waits for the integration custom element to be defined, then
- * reads the singleton from its static property — guaranteeing the same
- * instance that the running player uses.
- *
- * @example
- * ```ts
- * import { getSharedContext } from '@glomex/integration-web-component';
- *
- * const sharedContext = await getSharedContext();
- * sharedContext.set({
- *   appVersion: '2.3.0',
- *   providers: {
- *     'my-provider': async () => ({ token: await myAuth.getFreshToken() }),
- *   }
- * });
- * ```
- */
-export declare function getSharedContext(tenant?: string): Promise<SharedContext>;
-
-/**
- * Web component that allows to override title and poster of a given glomex content id. It can be placed
- * inside the integration element. For integrating external media items, see {@link ExternalMediaItemElement}.
- *
- * @tagname glomex-media-item
- *
- * @attribute id - The glomex media ID or playlist ID to load.
- * @attribute {stage|prod} environment - The environment to use for the provider request.
- * @attribute poster - URL to override the poster image of the media item.
- * @attribute title - Override the title of the media item.
- *
- * @example with 2 glomex-media-items
- *
- * This only works when no `playlist-id` is assigned to `glomex-integration`
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <glomex-media-item
- *     id="REPLACE_WITH_MEDIA_OR_PLAYLIST_ID"
- *   ></glomex-media-item>
- *   <glomex-media-item
- *     id="ANOTHER_MEDIA_OR_PLAYLIST_ID"
- *   ></glomex-media-item>
- * </glomex-integration>
- * ```
- *
- * @example glomex-media-item with title and poster override
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <glomex-media-item
- *     id="REPLACE_WITH_MEDIA_OR_PLAYLIST_ID"
- *     title="REPLACE_WITH_TITLE_OVERRIDE"
- *     poster="REPLACE_WITH_POSTER_URL_OVERRIDE"
- *   ></glomex-media-item>
- * </glomex-integration>
- * ```
- *
- * @example glomex-media-item targeting the stage environment
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <glomex-media-item
- *     id="REPLACE_WITH_MEDIA_OR_PLAYLIST_ID"
- *     environment="stage"
- *   ></glomex-media-item>
- * </glomex-integration>
- * ```
- */
-export declare class GlomexMediaItemElement extends MediaItemElement {
-    /**
-     * Overridden poster of the media item.
-     * @attribute poster
-     */
-    poster: string;
-}
-
-/**
- * Web component to integrate the player.
- *
- * @see {@link IntegrationElementEventMap} for a full list of event types and their payloads
- * @tagname glomex-integration
- * @slot - (optional) Slot for custom media items ({@link GlomexMediaItemElement}, {@link JoynMediaItemElement}, {@link ExternalMediaItemElement} or {@link MediaItemElement})
- * @slot overlay - (optional) Slot for a custom overlay rendered on top of the player. Use `width: 100%; height: 100%` on the slotted element to cover the full player area.
- *
- * @example with a playlist-id
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- *   playlist-id="REPLACE_WITH_PLAYLIST_ID"
- * ></glomex-integration>
- * ```
- *
- * @example with a custom overlay
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- *   playlist-id="REPLACE_WITH_PLAYLIST_ID"
- * >
- *   <div slot="overlay" style="width: 100%; height: 100%;">
- *     Custom overlay content
- *   </div>
- * </glomex-integration>
- * ```
- *
- * You can find more advanced examples in the {@link GlomexMediaItemElement}, {@link JoynMediaItemElement}, {@link ExternalMediaItemElement} or {@link MediaItemElement} documentation.
- */
-export declare class IntegrationElement extends HTMLElement implements IntegrationProperties {
-    #private;
-    static MarkerType: typeof MarkerType;
-    static KnownMarkerName: typeof KnownMarkerName;
-    static PlaybackMode: typeof PlaybackMode;
-    static Mimetype: typeof Mimetype;
-    static PresentationMode: typeof PresentationMode;
-    static IntegrationEvent: typeof IntegrationEvent;
-    static sharedContext: SharedContext;
-    /**
-     * {@inheritDoc IntegrationProperties.integrationId}
-     * @attribute integration-id
-     */
-    integrationId?: string;
-    /**
-     * {@inheritDoc IntegrationProperties.tenant}
-     * @attribute tenant
-     * @ignore
-     */
-    tenant?: string;
-    /**
-     * {@inheritDoc IntegrationProperties.playlistId}
-     * @attribute playlist-id
-     */
-    playlistId?: string;
-    /**
-     * {@inheritDoc IntegrationProperties.index}
-     * @attribute index
-     */
-    index?: number;
-    /**
-     * {@inheritDoc IntegrationProperties.hidden}
-     * @attribute {on|off} hidden
-     */
-    hidden: boolean;
-    /**
-     * {@inheritDoc IntegrationProperties.topLevelIframe}
-     * @attribute top-level-iframe
-     */
-    topLevelIframe: boolean;
-    /**
-     * {@inheritDoc IntegrationProperties.placement}
-     * @attribute placement
-     */
-    placement?: string;
-    variant?: string;
-    adPlayer?: string;
-    /**
-     * {@inheritDoc IntegrationProperties.crossorigin}
-     * @attribute crossorigin
-     */
-    crossorigin?: IntegrationProperties['crossorigin'];
-    /**
-     * {@inheritDoc IntegrationProperties.userLanguage}
-     * @attribute user-language
-     */
-    userLanguage?: string;
-    extraContext?: ExtraContext;
-    /**
-     * {@inheritDoc IntegrationProperties.schain}
-     * @attribute schain
-     */
-    schain?: string;
-    /**
-     * Optional callback function invoked when the integration fails to load an advertisement.
-     * The callback receives an object with a `reason` property that explains why no ad was loaded.
-     * It must be defined before the element gets attached to the DOM.
-     */
-    passback?: (payload: {
-        reason: string;
-    }) => void;
-    /**
-     * Resolves when the integration API is available (e.g. setting volume, play, pause, etc.).
-     * Alternatively to `element.addEventListener(IntegrationEvent.READY, () => {...})`
-     */
-    ready: Promise<void>;
-    /**
-     * Initiates playback of the media content.
-     * @param options.startMethod - The method used to start playback (defaults to CLICK)
-     */
-    play(options?: {
-        startMethod: Exclude<StartMethod, StartMethod.PRE_CLICK>;
-    }): Promise<void>;
-    /**
-     * Pauses the current media playback.
-     */
-    pause(): Promise<void>;
-    /**
-     * Snapshots current video frame. Requires {@link crossorigin} to be set to `anonymous`.
-     */
-    getCurrentVideoFrame(): Promise<ImageBitmap>;
-    /**
-     * Returns the current playback time (in seconds) of the media.
-     */
-    get currentTime(): number;
-    /**
-     * Returns the current extended playback quality.
-     */
-    getVideoPlaybackQuality(): {
-        droppedVideoFrames: number;
-        totalVideoFrames: number;
-        creationTime: number;
-        corruptedVideoFrames: number;
-        bitrate: number;
-        liveLatency: number;
-        throughput: number;
-        bytes: number;
-        bandwidth: number;
-        width: number;
-        height: number;
-    } | undefined;
-    /**
-     * Returns the current session ID.
-     */
-    get sessionId(): string;
-    /**
-     * Returns the current wall clock time (UNIX timestamp in seconds). Useful for livestreams.
-     */
-    get wallClockTime(): number;
-    /**
-     * Seeks the media to the specified time, updating the current playback time.
-     *
-     * To set an initial start time, use {@link MediaItem.resumePosition} on the media item.
-     *
-     * @param time - The time (in seconds) to seek to.
-     */
-    set currentTime(time: number);
-    /**
-     * Retrieves the total duration (in seconds) of the current media content.
-     */
-    get duration(): number;
-    /**
-     * Retrieves the seekable range of the current media content.
-     * For VoD content, this typically represents the full duration (0 to duration).
-     * For live streams, this represents the DVR window that can be seeked to.
-     * The `start` and `end` properties are `undefined` if the seek range is not yet available.
-     */
-    get seekRange(): SeekRange;
-    /**
-     * Indicates whether the media playback is currently muted.
-     */
-    get muted(): boolean;
-    /**
-     * Mutes or unmutes the media playback.
-     * @param value - A boolean value indicating whether to mute the media playback.
-     */
-    set muted(value: boolean);
-    /**
-     * Returns the current volume level of the media playback (0-1).
-     */
-    get volume(): number;
-    /**
-     * Sets the media playback volume to the specified level.
-     * @param value - The volume level to be set (0-1).
-     */
-    set volume(value: number);
-    /**
-     * Returns the current playback speed.
-     */
-    get playbackRate(): number;
-    /**
-     * Sets the playback speed.
-     * @param value - The playback speed to be set (e.g. 0.5, 1, 1.5, 2).
-     */
-    set playbackRate(value: number);
-    /**
-     * Returns `true` if the media playback is currently paused; otherwise, returns `false`.
-     */
-    get paused(): boolean;
-    /**
-     * Indicates whether the media playback has ended.
-     */
-    get ended(): boolean;
-    /**
-     * Indicates whether the media is currently in a seeking state.
-     */
-    get seeking(): boolean;
-    /**
-     * Indicates whether the media is currently in a buffering state.
-     */
-    get buffering(): boolean;
-    /**
-     * Retrieves the current presentation mode of the media player.
-     * This mode may affect how the media is displayed.
-     */
-    get presentationMode(): PresentationMode;
-    /**
-     * Returns whether the ad playback is muted. If no ad is currently active, this value is `undefined`.
-     */
-    get adMuted(): boolean | undefined;
-    /**
-     * Retrieves the volume level for the ad playback. If no ad is currently active, this value is `undefined`.
-     */
-    get adVolume(): number | undefined;
-    /**
-     * Returns the current playback time (in seconds) for the ad content. If no ad is currently active, this value is `NaN`.
-     */
-    get adCurrentTime(): number;
-    /**
-     * Retrieves the total duration (in seconds) of the ad content. If no ad is currently active, this value is `NaN`.
-     */
-    get adDuration(): number;
-    /**
-     * Indicates whether the ad playback is currently paused. If no ad is currently active, this value is `undefined`.
-     */
-    get adPaused(): boolean | undefined;
-    /**
-     * Retrieves the currently selected content item.
-     */
-    get content(): MediaItemResolved | undefined;
-    /**
-     * Retrieves the currently selected source.
-     */
-    get source(): SourceSelected | undefined;
-    /**
-     * Retrieves the current playlist.
-     */
-    get playlist(): MediaItemResolved[] | undefined;
-    /**
-     * Provides access to the user's consent information.
-     */
-    get consent(): Consent | undefined;
-    /**
-     * Retrieves information about the detected page.
-     */
-    get page(): Page | undefined;
-    /**
-     * Retrieves the playback time (in seconds) of the current content.
-     */
-    get contentPlaybackTime(): number;
-    /**
-     * Retrieves details about the currently selected ad, if any.
-     */
-    get currentAd(): Ad | undefined;
-    /** Version of the integration */
-    get version(): string;
-    /**
-     * Sets the presentation mode of the media player to the specified mode. This mode affects how the integration gets displayed
-     * (e.g. inline, dock, lightbox, fullscreen).
-     *
-     * @param {PresentationMode} mode - The presentation mode to set.
-     * @param {Object} [options] - Optional configuration.
-     * @param {boolean} [options.byUser=false] - Indicates if the change was initiated by a user action.
-     */
-    setPresentationMode(mode: PresentationMode | `${PresentationMode}`, { byUser }?: {
-        byUser?: boolean | undefined;
-    }): Promise<void>;
-    /**
-     * Exits the current presentation mode.
-     *
-     * @param {Object} [options] - Optional configuration.
-     * @param {boolean} [options.byUser=false] - Indicates if the change was initiated by a user action.
-     */
-    exitCurrentPresentationMode({ byUser }?: {
-        byUser?: boolean;
-    }): Promise<void>;
-    /**
-     * Returns the audio track list.
-     * You can use this to listen to audio track changes via `audioTracks.addEventListener('change', ...)`.
-     *
-     * **Note:** Audio tracks are available after the {@link ready | integration.ready} promise resolves.
-     * @example
-     * ```ts
-     * await integration.ready;
-     * for (const track of integration.audioTracks) { console.log(track); }
-     * const tracks = Array.from(integration.audioTracks);
-     * ```
-     *
-     * Use the `select()` method to change the active audio track:
-     * @example
-     * ```ts
-     * integration.audioTracks?.select(trackId);
-     * ```
-     */
-    get audioTracks(): AudioTrackList | undefined;
-    /**
-     * Returns the text track list.
-     * You can use this to listen to text track changes via `textTracks.addEventListener('change', ...)`.
-     *
-     * **Note:** Text tracks are available after the {@link ready | integration.ready} promise resolves.
-     * @example
-     * ```ts
-     * await integration.ready;
-     * for (const track of integration.textTracks) { console.log(track); }
-     * const tracks = Array.from(integration.textTracks);
-     * ```
-     *
-     * Use the `select()` method to change the active text track, or pass `undefined` to disable:
-     * @example
-     * ```ts
-     * integration.textTracks?.select(trackId);
-     * integration.textTracks?.select(undefined); // disable text tracks
-     * ```
-     */
-    get textTracks(): TextTrackList_2 | undefined;
-    /**
-     * Returns the video track list.
-     * You can use this to listen to video track changes via `videoTracks.addEventListener('change', ...)`.
-     *
-     * **Note:** Video tracks are available after the {@link ready | integration.ready} promise resolves.
-     * @example
-     * ```ts
-     * await integration.ready;
-     * for (const track of integration.videoTracks) { console.log(track); }
-     * const tracks = Array.from(integration.videoTracks);
-     * ```
-     *
-     * Use the `select()` method to change the active video track, or pass `'auto'` for automatic quality selection:
-     * @example
-     * ```ts
-     * integration.videoTracks?.select(trackId);
-     * integration.videoTracks?.select('auto'); // enable ABR
-     * ```
-     */
-    get videoTracks(): VideoTrackList | undefined;
-}
-
-/**
- * Map of events that are dispatched by the {@link IntegrationElement}. The {@link IntegrationElement} provides
- * getters to read {@link IntegrationElement#consent consent}, {@link IntegrationElement#content content}, {@link IntegrationElement#page page}, {@link IntegrationElement#currentTime currentTime}, ... state from.
- *
- * @see {@link IntegrationEvent} for all event types as constants
- *
- * @example
- *
- * ```js
- * // using strings
- * integration.addEventListener('ready', () => {});
- * // using constants
- * await window.customElements.whenDefined('glomex-integration');
- * const { IntegrationEvent } = integration.constructor;
- * integration.addEventListener(IntegrationEvent.READY, () => {});
- * ```
- */
-export declare interface IntegrationElementEventMap {
-    /**
-     * @inheritdoc IntegrationEvent.READY
-     * @eventProperty
-     */
-    [IntegrationEvent.READY]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.INTEGRATION_ABORT
-     * @eventProperty
-     */
-    [IntegrationEvent.INTEGRATION_ABORT]: CustomEvent<{
-        error: SerializedError;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.INTEGRATION_AD_AVAILABLE
-     * @eventProperty
-     */
-    [IntegrationEvent.INTEGRATION_AD_AVAILABLE]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.INTEGRATION_PASSBACK
-     * @eventProperty
-     */
-    [IntegrationEvent.INTEGRATION_PASSBACK]: CustomEvent<{
-        reason: string;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.USER_UPDATE_CONSENT
-     * @eventProperty
-     */
-    [IntegrationEvent.USER_UPDATE_CONSENT]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.PLAYLIST_UPDATE
-     * @eventProperty
-     */
-    [IntegrationEvent.PLAYLIST_UPDATE]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.PLAYER_SET_PRESENTATION_MODE
-     * @eventProperty
-     */
-    [IntegrationEvent.PLAYER_SET_PRESENTATION_MODE]: CustomEvent<{
-        mode: PresentationMode;
-        previousMode: PresentationMode;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_SELECT
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_SELECT]: CustomEvent<{
-        sessionId: string;
-        source: SourceSelected & {
-            /**
-             * Entitlement token for the source, if any.
-             * @deprecated For Joyn sources, read from `source.metadata.entitlementToken` instead.
-             */
-            entitlementToken?: string;
-        };
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_START
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_START]: CustomEvent<{
-        startMethod: StartMethod;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_IMPRESSION
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_IMPRESSION]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_BUFFERING_START
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_BUFFERING_START]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_BUFFERING_END
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_BUFFERING_END]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_STOP
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_STOP]: CustomEvent<{
-        reason: ContentStopReason;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_SUSPEND
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_SUSPEND]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_ERROR
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_ERROR]: CustomEvent<{
-        error: SerializedError;
-        recoverable: boolean;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_MARKER_REACHED
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_MARKER_REACHED]: CustomEvent<{
-        markerName: string;
-        markerData: unknown;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_TIME_UPDATE
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_TIME_UPDATE]: CustomEvent<void> | HTMLElementEventMap['timeupdate'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_SEEKING
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_SEEKING]: CustomEvent<void> | HTMLElementEventMap['seeking'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_SEEKED
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_SEEKED]: CustomEvent<void> | HTMLElementEventMap['seeked'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_PLAY
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_PLAY]: CustomEvent<void> | HTMLElementEventMap['play'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_PAUSE
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_PAUSE]: CustomEvent<void> | HTMLElementEventMap['pause'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_VOLUME_CHANGE
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_VOLUME_CHANGE]: CustomEvent<void> | HTMLElementEventMap['volumechange'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_RATECHANGE
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_RATECHANGE]: CustomEvent<void> | HTMLElementEventMap['ratechange'];
-    /**
-     * @inheritdoc IntegrationEvent.CONTENT_ENDED
-     * @eventProperty
-     */
-    [IntegrationEvent.CONTENT_ENDED]: CustomEvent<void> | HTMLElementEventMap['ended'];
-    /**
-     * @inheritdoc IntegrationEvent.AD_BREAK_REQUEST
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_BREAK_REQUEST]: CustomEvent<{
-        name: string;
-        index: number;
-        plannedSlotCount: number;
-        plannedAdRequestCount: number;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_BREAK_REQUEST_ERROR
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_BREAK_REQUEST_ERROR]: CustomEvent<{
-        name: string;
-        index: number;
-        error: Error & {
-            code?: string;
-        };
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_LOADED
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_LOADED]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_IMPRESSION
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_IMPRESSION]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_BUFFERING_START
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_BUFFERING_START]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_BUFFERING_END
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_BUFFERING_END]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_TIME_UPDATE
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_TIME_UPDATE]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_VOLUME_CHANGE
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_VOLUME_CHANGE]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_PAUSED
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_PAUSED]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_RESUMED
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_RESUMED]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_CLICK
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_CLICK]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_SKIPPED
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_SKIPPED]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_COMPLETE
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_COMPLETE]: CustomEvent<void>;
-    /**
-     * @inheritdoc IntegrationEvent.AD_ERROR
-     * @eventProperty
-     */
-    [IntegrationEvent.AD_ERROR]: CustomEvent<{
-        error: AdError;
-    }>;
-    /**
-     * @inheritdoc IntegrationEvent.UI_INTERACTION
-     * @eventProperty
-     */
-    [IntegrationEvent.UI_INTERACTION]: CustomEvent<{
-        action: UiAction;
-    }>;
-}
-
-/**
- * Constants for all events dispatched by the {@link IntegrationElement}.
- *
- * @see {@link IntegrationElementEventMap} for a full list of event types and their payloads
- */
-export declare enum IntegrationEvent {
-    /**
-     * When the integration got initialized.
-     * @eventProperty
-     */
-    READY = "ready",
-    /**
-     * When the integration got aborted because of a configuration / authorization error.
-     * It is not triggered when the content errors.
-     * @eventProperty
-     */
-    INTEGRATION_ABORT = "integrationabort",
-    /**
-     * When an ad is available.
-     * @eventProperty
-     */
-    INTEGRATION_AD_AVAILABLE = "integrationadavailable",
-    /**
-     * When a passback is triggered because of no content or no ad. Only available when {@link IntegrationElement#passback} is set.
-     * @eventProperty
-     */
-    INTEGRATION_PASSBACK = "integrationpassback",
-    /**
-     * When the user's consent got updated.
-     * See {@link IntegrationElement#consent} to get the current consent.
-     * @eventProperty
-     */
-    USER_UPDATE_CONSENT = "userupdateconsent",
-    /**
-     * When the playlist is updated (e.g. new media item got added). See {@link IntegrationElement#playlist} to get the current playlist items.
-     * @eventProperty
-     */
-    PLAYLIST_UPDATE = "playlistupdate",
-    /**
-     * When the player's presentation mode got changed.
-     * @eventProperty
-     */
-    PLAYER_SET_PRESENTATION_MODE = "playersetpresentationmode",
-    /**
-     * When content got selected. See {@link IntegrationElement#content} to get the current content.
-     * @eventProperty
-     */
-    CONTENT_SELECT = "contentselect",
-    /**
-     * When content started initially (e.g. before ad break).
-     * @eventProperty
-     */
-    CONTENT_START = "contentstart",
-    /**
-     * When the first frame of the content got played back.
-     * @eventProperty
-     */
-    CONTENT_IMPRESSION = "contentimpression",
-    /**
-     * When content buffering started.
-     * @eventProperty
-     */
-    CONTENT_BUFFERING_START = "contentbufferingstart",
-    /**
-     * When content buffering ended.
-     * @eventProperty
-     */
-    CONTENT_BUFFERING_END = "contentbufferingend",
-    /**
-     * When content got stopped (e.g. loading another content or it ended normally). The reason is provided in the payload.
-     * It gets triggered after a potential postroll.
-     * @eventProperty
-     */
-    CONTENT_STOP = "contentstop",
-    /**
-     * When content playback is suspended due to a recoverable error (e.g. network error, PIN required).
-     * The session is not over — playback may resume after a reload.
-     * @eventProperty
-     */
-    CONTENT_SUSPEND = "contentsuspend",
-    /**
-     * When a content error occurs upon loading or playing the content.
-     * @eventProperty
-     */
-    CONTENT_ERROR = "contenterror",
-    /**
-     * When a marker is reached. See {@link MediaItem#markers} how to define own markers.
-     * @eventProperty
-     */
-    CONTENT_MARKER_REACHED = "contentmarkerreached",
-    /**
-     * When the content's time updates. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/timeupdate_event HTMLMediaElement.timeupdate}.
-     * See {@link IntegrationElement#currentTime} to get the current time.
-     * @eventProperty
-     */
-    CONTENT_TIME_UPDATE = "timeupdate",
-    /**
-     * When the content is seeking. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/seeking_event HTMLMediaElement.seeking}.
-     * See {@link IntegrationElement#seeking} to get the current seeking state.
-     * @eventProperty
-     */
-    CONTENT_SEEKING = "seeking",
-    /**
-     * When the content has seeked. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/seeked_event HTMLMediaElement.seeked}.
-     * @eventProperty
-     */
-    CONTENT_SEEKED = "seeked",
-    /**
-     * When the content switches from paused to playing. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/play_event HTMLMediaElement.play}.
-     * @eventProperty
-     */
-    CONTENT_PLAY = "play",
-    /**
-     * When the content switches from playing to paused. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/pause_event HTMLMediaElement.pause}.
-     * @eventProperty
-     */
-    CONTENT_PAUSE = "pause",
-    /**
-     * When the content's volume changes. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/volumechange_event HTMLMediaElement.volumechange}.
-     * See {@link IntegrationElement#volume} to get the current volume.
-     * @eventProperty
-     */
-    CONTENT_VOLUME_CHANGE = "volumechange",
-    /**
-     * When the content playback rate changes. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/ratechange_event HTMLMediaElement.ratechange}.
-     * See {@link IntegrationElement#playbackRate} to get the current playback rate.
-     * @eventProperty
-     */
-    CONTENT_RATECHANGE = "ratechange",
-    /**
-     * When the content reached its end. This is equal to {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/ended_event HTMLMediaElement.ended}.
-     * See {@link IntegrationElement#ended} to check if the content ended.
-     * @eventProperty
-     */
-    CONTENT_ENDED = "ended",
-    /**
-     * When an ad break gets requested
-     * @eventProperty
-     */
-    AD_BREAK_REQUEST = "adbreakrequest",
-    /**
-     * When an ad break request fails
-     * @eventProperty
-     */
-    AD_BREAK_REQUEST_ERROR = "adbreakrequesterror",
-    /**
-     * When an ad is loaded.
-     * See {@link IntegrationElement#currentAd} to get the loaded ad.
-     * @eventProperty
-     */
-    AD_LOADED = "adloaded",
-    /**
-     * When the first frame of the ad got played back.
-     * See {@link IntegrationElement#currentAd} to get the current ad.
-     * @eventProperty
-     */
-    AD_IMPRESSION = "adimpression",
-    /**
-     * When the ad started buffering.
-     * @eventProperty
-     */
-    AD_BUFFERING_START = "adbufferingstart",
-    /**
-     * When the ad stopped buffering.
-     * @eventProperty
-     */
-    AD_BUFFERING_END = "adbufferingend",
-    /**
-     * When the ad's time updates.
-     * @eventProperty
-     */
-    AD_TIME_UPDATE = "adtimeupdate",
-    /**
-     * When the ad's volume changes.
-     * See {@link IntegrationElement#adVolume} to get the current volume.
-     * @eventProperty
-     */
-    AD_VOLUME_CHANGE = "advolumechange",
-    /**
-     * When the ad paused.
-     * @eventProperty
-     */
-    AD_PAUSED = "adpaused",
-    /**
-     * When the ad resumed.
-     * @eventProperty
-     */
-    AD_RESUMED = "adresumed",
-    /**
-     * When the ad was clicked.
-     * @eventProperty
-     */
-    AD_CLICK = "adclick",
-    /**
-     * When the ad was skipped.
-     * @eventProperty
-     */
-    AD_SKIPPED = "adskipped",
-    /**
-     * When the ad completed.
-     * @eventProperty
-     */
-    AD_COMPLETE = "adcomplete",
-    /**
-     * When a non-fatal ad error occurs during playback or setup (not triggered when ad loading fails).
-     * @eventProperty
-     */
-    AD_ERROR = "aderror",
-    /**
-     * When the user interacted with the UI (e.g. play, pause, seek, etc.). The specific action is provided in the payload.
-     * @eventProperty
-     */
-    UI_INTERACTION = "uiinteraction"
-}
-
-/**
- * Properties that can be set on the integration element.
- */
-export declare interface IntegrationProperties {
-    /**
-     * The identifier for this integration. This value is used to determine the configuration and behavior of the integration.
-     */
-    integrationId?: string;
-    /**
-     * The tenant determines which platform endpoints the player connects to.
-     * Defaults to `glomex` when not specified.
-     * @ignore
-     * @example
-     * ```html
-     * <glomex-integration tenant="joyn" integration-id="..."></glomex-integration>
-     * ```
-     */
-    tenant?: string;
-    /**
-     * Defines the playlist / content identifier that should be loaded and managed by the integration. It can be a single content id, a playlist id or `auto`.
-     * It must be empty when the content is provided via the `media-item` web components inside the integration.
-     */
-    playlistId?: string;
-    /**
-     * Determines the index of the media item within the playlist that should be or is currently selected.
-     *
-     * This property can be used to:
-     * - **Switch between media items**: Set this property to navigate to a different item in the playlist (zero-based index).
-     * - **Get the current playlist index**: Read this property to determine which media item is currently active in the playlist.
-     */
-    index?: number;
-    /**
-     * Hides the integration element when set to `true`.
-     */
-    hidden?: boolean;
-    /**
-     * An optional flag that can mark the integration as if it is running in a top-level window context. Useful when the embedded iframe represents an article, which contains this integration.
-     */
-    topLevelIframe?: boolean;
-    /**
-     * Allows the publisher to provide an optional placement attribute, which supplies additional contextual information for enhanced analytics tracking.
-     * This can be a simple string or a stringified JSON object. If it is a stringified JSON object, its contents are forwarded as `placementDetail`. If the object contains a property key `name`, its value will be tracked for the placement attribute.
-     */
-    placement?: string;
-    env?: 'stage' | 'local';
-    variant?: string;
-    adPlayer?: string;
-    /**
-     * The {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/crossorigin crossorigin attribute}
-     * is used to define the CORS (Cross-Origin Resource Sharing) policy for the video element.
-     * Defaults to `anonymous`. If set to `none` (non-standard value) it won't require CORS headers
-     * for the loaded media files, though text-tracks from foreign origins then cannot be loaded.
-     */
-    crossorigin?: '' | 'anonymous' | 'use-credentials' | 'none';
-    /**
-     * Preferred language for the current user.
-     * When provided, this value is used for the UI instead of the browser language detected in the environment.
-     * Accepts a BCP 47 language tag (e.g. "de", "en-US").
-     */
-    userLanguage?: string;
-    /**
-     * {@inheritDoc ExtraContext}
-     */
-    extraContext?: ExtraContext;
-    /**
-     * Supply chain (schain) information provided by the integrating party (e.g. meta-publisher).
-     * Must be set as an IAB serialized string (e.g. `"1.0,1!exchange.com,123,1"`).
-     * Supply chain nodes provided here are extended with the relevant downstream nodes.
-     */
-    schain?: string;
-}
-
-/**
- * Web component that allows to register Joyn media items. It can be placed
- * inside the integration element as a child.
- *
- * @tagname joyn-media-item
- *
- * @attribute id - The Joyn media ID to load.
- * @attribute {stage|prod} environment - The environment to use for the provider request.
- *
- * @example with a joyn-media-item
- *
- * This only works when no `playlist-id` is assigned to `glomex-integration`
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <joyn-media-item
- *     id="REPLACE_WITH_JOYN_MEDIA_ID"
- *   ></joyn-media-item>
- * </glomex-integration>
- * ```
- *
- * @example with 2 joyn-media-items
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <joyn-media-item
- *     id="REPLACE_WITH_JOYN_MEDIA_ID"
- *   ></joyn-media-item>
- *   <joyn-media-item
- *     id="ANOTHER_JOYN_MEDIA_ID"
- *   ></joyn-media-item>
- * </glomex-integration>
- * ```
- *
- * @example joyn-media-item targeting the stage environment
- *
- * ```html
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <joyn-media-item
- *     id="REPLACE_WITH_JOYN_MEDIA_ID"
- *     environment="stage"
- *   ></joyn-media-item>
- * </glomex-integration>
- * ```
- */
-export declare class JoynMediaItemElement extends MediaItemElement {
-}
-
-/** Source metadata produced by the Joyn media provider. */
-export declare interface JoynSourceMetadata extends SourceMetadataBase {
-    /** Identifies this metadata as produced by the Joyn provider. */
-    provider: 'joyn';
-    /** Distribution tenant name (e.g. `"JOYN"`, `"JOYN_AT"`, `"JOYN_CH"`). May be absent when the entitlement token cannot be decoded. */
-    distributionTenant?: string;
-    /** Anonymous user identifier. May be absent when the entitlement token cannot be decoded. */
-    anonymousId?: string;
-    /** Authenticated user identifier. May be absent when the entitlement token cannot be decoded. */
-    userId?: string;
-    /** Entitlement identifier from the entitlement token. May be absent when the entitlement token cannot be decoded. */
-    entitlementId?: string;
-    /** Business model for this entitlement (e.g. `"RVOD"`, `"SVOD"`). May be absent when the entitlement token cannot be decoded. */
-    businessModel?: string;
-    /** CDN delivery network identifier returned by the playlist service (e.g. `"akamai"`, `"amazon"`, `"fastly"`). */
-    deliveryNetwork: string;
-    /** DRM protection system used for the source (e.g. `"fairplay"`, `"widevine"`, `"playready"`). */
-    protectionSystem: string;
-    /** DRM encryption scheme used for the source (`"cenc"` or `"cbcs"`). */
-    encryptionScheme: string;
-    /** Entitlement token received from the Joyn entitlement service. */
-    entitlementToken: string;
-    /** Joyn packages associated with the entitlement token (e.g. `DE_FREE`, `DE_PREMIUM`, `DE_REG`) */
-    joynPackages?: string[];
-}
-
-export declare enum KnownMarkerName {
-    PREROLL = "preroll",
-    MIDROLL = "midroll",
-    POSTROLL = "postroll",
-    FIRST_QUARTILE = "contentFirstQuartile",
-    MIDPOINT = "contentMidpoint",
-    THIRD_QUARTILE = "contentThirdQuartile",
-    COMPLETE = "contentComplete",
-    STILL_INTERESTING = "stillInteresting",
-    REQUEST_RECOMMENDATIONS = "requestRecommendations"
-}
-
-/**
- * Loads the integration custom element by injecting the tenant-specific
- * script into the document. Does nothing if the element is already defined.
- */
-export declare function loadIntegrationComponent(tenant?: string, env?: TenantEnvironment): void;
-
-/**
- * Loads the variant CSS for the given integration ID by injecting a
- * `<link>` element into the document head. Does nothing if the stylesheet
- * is already loaded.
- *
- * @example
- * ```ts
- * import { loadIntegrationStyles } from '@glomex/integration-web-component';
- *
- * loadIntegrationStyles('my-integration-id');
- * ```
- */
-export declare function loadIntegrationStyles(integrationId: string, tenant?: string, env?: TenantEnvironment): void;
-
-/**
- * Known markers that the integration interprets.
- */
-export declare interface Marker {
-    /** Name of the marker */
-    name: KnownMarkerName;
-    /** Type of the marker */
-    type: MarkerType;
-    /**
-     * Threshold for the marker:
-     * - {@link MarkerType.TIME_IN_SECONDS}: seconds (use negative values to calculate position from end of content, e.g., -10 means 10 seconds before the end; only valid for VoD content)
-     * - {@link MarkerType.PERCENT}: percent as fraction (0-1)
-     * - {@link MarkerType.TIME_IN_SECONDS_RECURRING}: seconds
-     */
-    threshold: number;
-    /** Whether the marker should reference watch time instead of current time. Livestreams always use watch time. */
-    useWatchTime?: boolean;
-}
-
-export declare enum MarkerType {
-    /** Triggers by time in seconds */
-    TIME_IN_SECONDS = "time",
-    /** Triggers by percentage (only works when media item has a {@link MediaItem#duration duration}) */
-    PERCENT = "percent",
-    /** Recurringly triggers by time in seconds (e.g. every 60 seconds) */
-    TIME_IN_SECONDS_RECURRING = "timeRecurring"
-}
-
-/**
- * Represents the input description of a media asset for the player.
- *
- * A minimal playable `MediaItem` requires only a source — every other field is optional.
- * Additional fields can be supplied to support analytics, monetization, UI enhancements, and other use cases.
- * In general, the richer the metadata, the more likely the `MediaItem` can satisfy all integration requirements.
- *
- * Alternatively, a {@link MediaItemReference} can be passed to the player instead of a
- * full `MediaItem`. A reference carries only an `id` and a `provider`, letting the player
- * resolve the complete media item from that provider by ID.
- *
- * When the player processes a `MediaItem` (or a resolved {@link MediaItemReference}) it
- * produces a {@link MediaItemResolved} — an expanded version where missing fields are
- * filled with defaults (e.g. `id`, `language`, `aspectRatio`) and additional data is
- * derived automatically.
- */
-export declare interface MediaItem {
-    /**
-     * Unique identifier of the media item.
-     */
-    id?: string;
-    /**
-     * Additional ids that identify the media item in other systems
-     */
-    additionalIds?: {
-        originId?: string;
-        externalId?: string;
-    };
-    /**
-     * Poster image of the media item.
-     */
-    poster?: string;
-    /**
-     * Sources of the media item.
-     */
-    sources?: Partial<SourceMediaItem>[];
-    /**
-     * Array of text tracks for subtitles, captions, etc.
-     * These tracks apply to the whole media item, not to individual sources.
-     *
-     * Note: This is only useful for progressive sources or when the adaptive stream
-     * (HLS/DASH) does not deliver the text tracks / subtitles within the manifest.
-     */
-    textTracks?: MediaItemTextTrack[];
-    /**
-     * Title of the media item.
-     */
-    title?: string;
-    /**
-     * Duration of the media item in seconds. Not defined when livestream.
-     */
-    duration?: number;
-    /**
-     * Position (in seconds) at which playback should resume.
-     * Applied automatically when the media item is loaded.
-     */
-    resumePosition?: number;
-    /**
-     * Description of the media item.
-     */
-    description?: string;
-    /**
-     * Language of the media item. 2-letter ISO language code.
-     *
-     * @defaultValue `de` (German)
-     */
-    language?: string;
-    /**
-     * IAB categories (as {@link iabCategoryTaxonomy}) of the media item. Used for monetization.
-     */
-    iabCategories?: string[];
-    /**
-     * IAB category taxonomy used for {@link iabCategories} ({@link https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list_categorytaxonomies see IAB spec for details})
-     * @defaultValue `9` for IAB Tech Lab Content Taxonomy 3.1
-     */
-    iabCategoryTaxonomy?: number;
-    /**
-     * Aspect ratio of the media item. Useful when vertical variants are used.
-     *
-     * @defaultValue `16:9`
-     */
-    aspectRatio?: string;
-    /**
-     * Minimum age to watch the media item. Shows a minimum age indicator in the UI.
-     *
-     * @defaultValue `0` (no minimum age)
-     */
-    minimumAge?: number;
-    /**
-     * Release date of the media item. Unix timestamp in milliseconds.
-     * Useful for JSON-LD generation.
-     */
-    releaseDate?: number;
-    /**
-     * Original TV air date of the media item. Unix timestamp in milliseconds.
-     * Used for analytics (e.g. Comscore dateOfTVAiring).
-     */
-    tvAirDate?: number;
-    /**
-     * Time when the media item expires. Unix timestamp in milliseconds.
-     * Useful for JSON-LD generation.
-     */
-    endDate?: number;
-    /**
-     * Whether the media item has product placements. Shows a product placement indicator in the UI.
-     */
-    hasProductPlacement?: boolean;
-    /**
-     * Channel (or often referred to as brand) of the media item.
-     */
-    channel?: Channel;
-    /**
-     * Markers control ad breaks and custom time-based events during playback.
-     *
-     * **⚠️ Important:** When providing custom markers, the default PREROLL is **not** added automatically.
-     * You must explicitly include a PREROLL marker if you want ads to play.
-     *
-     * **Reserved marker names:** Only `PREROLL`, `MIDROLL`, and `POSTROLL` from {@link KnownMarkerName}
-     * can be used for ad markers. All other `KnownMarkerName` values are reserved for internal use.
-     * Use custom string names (e.g., `'halfwayPoint'`) for your own markers.
-     *
-     * **Listening for custom markers:** When a custom marker is reached, the player dispatches
-     * an {@link IntegrationEvent.CONTENT_MARKER_REACHED} event. Listen for this event to react
-     * to your custom markers:
-     *
-     * ```js
-     * player.addEventListener('contentmarkerreached', (event) => {
-     *   const { markerName, markerData } = event.detail;
-     *   if (markerName === 'showEndCreditsOverlay') {
-     *     // Show your overlay
-     *   }
-     * });
-     * ```
-     *
-     * @example
-     * // Default: pre-roll ads only (same as omitting markers)
-     * markers: [{ name: KnownMarkerName.PREROLL, type: MarkerType.TIME_IN_SECONDS, threshold: 0 }]
-     *
-     * @example
-     * // Pre-roll + mid-roll at 60 seconds
-     * markers: [
-     *   { name: KnownMarkerName.PREROLL, type: MarkerType.TIME_IN_SECONDS, threshold: 0 },
-     *   { name: KnownMarkerName.MIDROLL, type: MarkerType.TIME_IN_SECONDS, threshold: 60 }
-     * ]
-     *
-     * @example
-     * // Custom marker at 50% of content
-     * markers: [
-     *   { name: KnownMarkerName.PREROLL, type: MarkerType.TIME_IN_SECONDS, threshold: 0 },
-     *   { name: 'halfwayPoint', type: MarkerType.PERCENT, threshold: 0.5 }
-     * ]
-     *
-     * @example
-     * // Custom marker 15 seconds before end (e.g., for end credits overlay)
-     * markers: [
-     *   { name: KnownMarkerName.PREROLL, type: MarkerType.TIME_IN_SECONDS, threshold: 0 },
-     *   { name: 'showEndCreditsOverlay', type: MarkerType.TIME_IN_SECONDS, threshold: -15 }
-     * ]
-     *
-     * @defaultValue `[{ name: KnownMarkerName.PREROLL, type: MarkerType.TIME_IN_SECONDS, threshold: 0 }]`
-     */
-    markers?: (Marker | CustomMarker)[];
-    /**
-     * In which country can this media item be played (e.g. `['de', 'at']`)? Useful for
-     * JSON-LD generation.
-     *
-     * @defaultValue `['all']` (worldwide)
-     */
-    regionsAllowed?: string[];
-    /**
-     * Mark this media item as a recommendation.
-     */
-    isRecommendation?: boolean;
-    /**
-     * JSON-LD `contentUrl` that allows search engines to crawl the media source.
-     * You should only allow known crawlers ({@link https://developers.google.com/search/docs/crawling-indexing/verifying-googlebot?hl=en how to verify Googlebot & Crawler})
-     * to access those media sources.
-     */
-    seoContentUrl?: string;
-    /**
-     * Additional teaser options that improve the loading experience and enable additional
-     * integration variants.
-     */
-    teaser?: {
-        /** Image of the first frame of the media item. Used for initially showing the first frame of the media item. */
-        firstFrame?: string;
-        /** {@link https://blurha.sh/ Blurhash} of the first frame of the media item. Used for coloring the background. */
-        firstFrameBlurHash?: string | null;
-        /** Blurred version of the first frame of the media item. Used to show something early while loading. */
-        firstFrameBlurred?: string;
-        /** {@link https://blurha.sh/ Blurhash} of the poster of the media item. Used for coloring the background. */
-        posterBlurHash?: string | null;
-        /** Blurred version of the poster of the media item. Used to show something early while loading. */
-        posterBlurred?: string;
-        /** Teaser video URL which is used for previewing the media item for some integrations. */
-        video?: string;
-    };
-    /**
-     * Additional labels for this media item.
-     */
-    labels?: {
-        id: string;
-        name: string;
-    }[];
-    /** Genre of the media item (e.g. `Documentary`) */
-    genre?: string;
-    /**
-     * Editorial program type of the media item describing what kind of content it is.
-     *
-     * @example ProgramType.MOVIE
-     * @example ProgramType.SERIES
-     */
-    programType?: ProgramType | `${ProgramType}`;
-    /** Content owner id and name of the media item */
-    contentOwner?: {
-        id?: string;
-        name: string;
-    };
-    /**
-     * Additional details to show for the age rating (e.g. `['Alcohol']`) next to the minimum age.
-     */
-    ageRatingDetails?: string[];
-    /** Keywords of the media item */
-    keywords?: string[];
-    /** Logo of the media item in size 220x90 (e.g. for shows, movies, sports events etc.) */
-    logo?: string;
-    /** Alt text for the logo of the media item */
-    logoAltText?: string;
-    /** Accent color of the media item that is shown behind the logo */
-    logoAccentColor?: string;
-    /** Show (often referred to as series, format or tv-show) the media item belongs to */
-    show?: {
-        id?: string;
-        name: string;
-        episodeNumber?: number;
-        seasonNumber?: number;
-    };
-    /** Competition the media item belongs to */
-    competition?: {
-        id?: string;
-        name?: string;
-    };
-    /** Compilation the media item belongs to */
-    compilation?: {
-        id?: string;
-        name?: string;
-    };
-    /** The live on demand channel (livestream using a VoD playlist, often called ODC) the media item belongs to */
-    liveOnDemandChannel?: {
-        id?: string;
-        name?: string;
-    };
-    /** Category id and name of the media item */
-    category?: {
-        id?: string;
-        name: string;
-    };
-    /** Error information if the media item is not available upfront. */
-    error?: MediaItemError;
-    /**
-     * Internal definition of experiments.
-     * @ignore
-     */
-    experiments?: Experiment[];
-    /**
-     * Additional content branding
-     */
-    branding?: {
-        /** @ignore */
-        backgroundColor?: string;
-        /** @ignore */
-        cutInZoomAssetUrl?: string;
-        /** @ignore */
-        cutInZoomHideTimeout?: number;
-        /** Logo that should appear in the corner */
-        logoUrl?: string;
-        /** Optional link target for the logo */
-        logoLinkUrl?: string;
-    };
-    /** Livestream details */
-    livestream?: {
-        /** UTC start time of the livestream in milliseconds */
-        startTime: number;
-        /** UTC end time of the livestream in milliseconds */
-        endTime?: number;
-        /** EPG entries containing UTC start and end times in milliseconds. Can be used for timeshift functionality (e.g., jump markers within the DVR window).*/
-        epgEntries?: {
-            /** UTC start time of the livestream program in milliseconds */
-            startDate: number;
-            /** UTC end time of the livestream program in milliseconds */
-            endDate: number;
-            /** Show (series, format or program) name */
-            name: string;
-            /** Title of the livestream program */
-            title?: string;
-            /** Poster image URL of the livestream program */
-            poster?: string;
-        }[];
-    };
-    /**
-     * An additional API script definition that should be executed for this media-item.
-     * @ignore
-     */
-    apiScript?: ApiScript;
-    /**
-     * Indicates the source from which additional metadata was derived (e.g., "joyn").
-     */
-    metadataSource?: string;
-    /**
-     * Name of actors appearing in the given media item
-     *
-     * @example ["Cate Blanchett", "Leonardo DiCaprio"]
-     */
-    actors?: string[];
-    /**
-     * Links to related content (e.g., a news article or blog post).
-     */
-    links?: {
-        type: 'article';
-        url: string;
-        caption: string;
-    }[];
-}
-
-/**
- * Abstract definition of a media item web component that can be used as a child of the {@link IntegrationElement}.
- *
- * @example of a custom media item
- *
- * It is possible to create more complex media items that query an own API.
- *
- * ```html
- * <script>
- *   class CustomMediaItemElement extends HTMLElement {
- *     get data() {
- *       return fetch(`https://api.example.com/media/${this.id}`)
- *       .then(response => response.json())
- *       .then((body) => ({
- *         id: this.id,
- *         provider: 'external',
- *         item: {
- *           id: this.id,
- *           sources: body.sources,
- *           duration: body.duration,
- *           poster: body.poster,
- *           title: body.title
- *         }
- *       }));
- *     }
- *   }
- *   window.customElements.define('custom-media-item', CustomMediaItemElement);
- * </script>
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <custom-media-item id="API_CONTENT_ID"></custom-media-item>
- * </glomex-integration>
- * ```
- *
- * @example of a custom media item that returns multiple items
- *
- * The `data` getter can also return an array of {@link MediaItemReference} objects
- * to define a playlist from a single element.
- *
- * ```html
- * <script>
- *   class CustomPlaylistElement extends HTMLElement {
- *     get data() {
- *       return fetch(`https://api.example.com/playlist/${this.id}`)
- *       .then(response => response.json())
- *       .then((body) => body.items.map((item) => ({
- *         id: item.id,
- *         provider: 'external',
- *         item: {
- *           id: item.id,
- *           sources: item.sources,
- *           duration: item.duration,
- *           poster: item.poster,
- *           title: item.title
- *         }
- *       })));
- *     }
- *   }
- *   window.customElements.define('custom-playlist', CustomPlaylistElement);
- * </script>
- * <glomex-integration
- *   integration-id="REPLACE_WITH_INTEGRATION_ID"
- * >
- *   <custom-playlist id="API_PLAYLIST_ID"></custom-playlist>
- * </glomex-integration>
- * ```
- */
-export declare abstract class MediaItemElement extends HTMLElement {
-    /**
-     * The content ID used by the provider to look up the media item.
-     * For glomex, this can be a media ID or a playlist ID.
-     * For Joyn, this is a Joyn media ID.
-     * @attribute id
-     */
-    id: string;
-    /**
-     * The environment to use for the provider.
-     * @attribute {stage|prod} environment
-     * @defaultValue 'prod'
-     */
-    environment?: 'stage' | 'prod';
-    abstract get data(): MediaItemReference | MediaItemReference[] | Promise<MediaItemReference | MediaItemReference[]>;
-}
-
-/**
- * Error known before the media item gets loaded.
- */
-export declare class MediaItemError extends BaseMediaError<MediaItemErrorCode> {
-    name: string;
-}
-
-export declare enum MediaItemErrorCode {
-    NOT_FOUND = "NotFound",
-    NOT_AVAILABLE = "NotAvailable",
-    GEOBLOCKED = "Geoblocked",
-    YOUTH_PROTECTED = "YouthProtected",
-    TERMINATED = "Terminated",
-    EXPIRED = "Expired",
-    LOGIN_REQUIRED = "LoginRequired",
-    HIGHER_TIER_ACCOUNT_REQUIRED = "HigherTierAccountRequired",
-    VPN_DETECTED = "VpnDetected",
-    AGE_VERIFICATION_REQUIRED = "AgeVerificationRequired",
-    PIN_REQUIRED = "PinRequired",
-    INVALID_PIN = "InvalidPin",
-    GENERIC = "Generic"
-}
-
-export declare enum MediaItemProvider {
-    /** Content from glomex */
-    GLOMEX = "glomex",
-    /** Content from joyn */
-    JOYN = "joyn",
-    /** External content provided directly */
-    EXTERNAL = "external"
-}
-
-/**
- * Describes how to fetch a media item from a given provider.
- *
- * The provider resolves the media item by its {@link id}. When an {@link item}
- * is supplied, its properties are merged on top of the fetched result, allowing
- * callers to override individual fields such as `title` or `poster`.
- */
-export declare interface MediaItemReference {
-    /** Media item ID used by the provider to look up the content. */
-    id: string;
-    /** Provider that is responsible for resolving this media item. */
-    provider: MediaItemProvider | `${MediaItemProvider}`;
-    /**
-     * Target environment for the provider request.
-     * @defaultValue 'prod'
-     */
-    environment?: 'stage' | 'prod';
-    /**
-     * Optional partial media item whose properties are merged on top of the
-     * data returned by the provider, allowing individual fields to be overridden.
-     *
-     * **Required** when the provider is `external`, since there is no remote
-     * source to fetch the media item from.
-     */
-    item?: MediaItem;
-    /** Whether to observe stream termination independent of business model. */
-    forceObserveTermination?: boolean;
-}
-
-/**
- * Represents a {@link MediaItem} after it has been resolved by the player.
- *
- * When a {@link MediaItem} is passed to the player, it is expanded into a
- * `MediaItemResolved`: fields that were omitted receive sensible defaults
- * (e.g. `id`, `language`, `aspectRatio`), and additional fields such as
- * `originalId`, `provider`, and `ppsj` are derived automatically.
- *
- * As a result, several properties that are optional on {@link MediaItem}
- * become required here.
- */
-export declare interface MediaItemResolved extends Omit<MediaItem, 'id' | 'sources' | 'title' | 'regionsAllowed' | 'aspectRatio' | 'minimumAge' | 'iabCategoryTaxonomy' | 'language'> {
-    id: NonNullable<MediaItem['id']>;
-    sources: (SourceMediaItem & {
-        id: string;
-        mimetype: Mimetype;
-    })[];
-    title: NonNullable<MediaItem['title']>;
-    regionsAllowed: NonNullable<MediaItem['regionsAllowed']>;
-    /**
-     * An internal marker for the used playlist. It is automatically filled.
-     * @ignore
-     */
-    playlistId: string;
-    aspectRatio: NonNullable<MediaItem['aspectRatio']>;
-    minimumAge: NonNullable<MediaItem['minimumAge']>;
-    iabCategoryTaxonomy: NonNullable<MediaItem['iabCategoryTaxonomy']>;
-    language: NonNullable<MediaItem['language']>;
-    /**
-     * Mark this media item to allow teaser experiments.
-     * @ignore
-     */
-    allowTeaserExperiments: boolean;
-    /**
-     * Will be automatically filled based on {@link MediaItem#minimumAge} and {@link MediaItem#iabCategories}.
-     * @ignore
-     */
-    ppsj?: string;
-    /**
-     * Indicates the provider of the media item.
-     */
-    provider: MediaItemProvider | `${MediaItemProvider}`;
-    /**
-     * The original {@link MediaItemReference} that produced this resolved item.
-     * Preserved so that re-resolution (e.g. playlist-item updates) can pass it
-     * back to the provider.
-     *
-     * @ignore
-     */
-    _referenceItem?: MediaItemReference;
-}
-
-/**
- * Text track definition for a media item.
- * Based on {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLTrackElement | HTMLTrackElement}.
- */
-export declare interface MediaItemTextTrack {
-    /**
-     * Unique identifier for the track.
-     */
-    id?: string;
-    /**
-     * The kind of text track.
-     */
-    kind: 'subtitles' | 'captions' | 'descriptions' | 'chapters' | 'metadata';
-    /**
-     * URL of the track file (e.g., WebVTT file).
-     */
-    src: string;
-    /**
-     * Language of the track text data (BCP 47 language tag).
-     */
-    srclang: string;
-    /**
-     * Human-readable title of the track.
-     */
-    label: string;
-    /**
-     * Whether the track should be enabled by default.
-     */
-    default?: boolean;
-}
-
-/**
- * Network error when a request fails due to connectivity issues.
- * Shaka Player network errors have codes in the 1000-1999 range
- * while HTMLMediaElement errors with 2 and 4 are considered network errors.
- */
-export declare class MediaNetworkError extends BaseMediaError {
-    name: string;
-}
-
-/**
- * Error after loading the media item.
- */
-export declare class MediaPlaybackError extends BaseMediaError {
-    name: string;
-}
-
-/**
- * Context object returned by a media-provider resolver registered via
- * {@link SharedContextData.providers}.
- *
- * Only {@link token} is required. Additional provider-specific fields
- * (e.g. subscription state, user ID) can be added freely.
- */
-export declare interface MediaProviderContext {
-    /** Authentication token (should be fresh / handle refresh internally). */
-    token: string;
-    /** Any additional provider-specific fields. */
-    [key: string]: unknown;
-}
-
-/**
- * Error while fetching metadata of the media item.
- */
-export declare class MediaProviderError extends BaseMediaError<MediaProviderErrorCode> {
-    name: string;
-}
-
-export declare enum MediaProviderErrorCode {
-    NOT_FOUND = "NotFound",
-    FORBIDDEN = "Forbidden",
-    HIDDEN = "Hidden",
-    NO_CONTENT = "NoContent",
-    GENERIC = "Generic"
-}
-
-/**
- * @deprecated Use {@link SourceMediaItem} instead.
- */
-declare type MediaSource_2 = SourceMediaItem;
-export { MediaSource_2 as MediaSource }
-
-/**
- * Base interface for all media track types.
- * Provides common properties shared by audio, video, and text tracks.
- */
-declare interface MediaTrack {
-    /** Unique identifier for the track. */
-    id: string;
-    /** The type or category of the track. */
-    kind: string;
-    /** Human-readable label for the track. */
-    label: string;
-    /** BCP 47 language tag (e.g., "en", "de", "es"). */
-    language: string;
-}
-
-/**
- * Base interface for track list collections.
- * Extends EventTarget to support track change events and is iterable.
- *
- * @typeParam T - The specific track type this list contains.
- */
-declare interface MediaTrackList<T extends MediaTrack> extends EventTarget, Iterable<T> {
-    /** The number of tracks in the list. */
-    readonly length: number;
-    /**
-     * Returns the track with the specified ID.
-     * @param id - The track ID to search for.
-     * @returns The matching track, or `null` if not found.
-     */
-    getTrackById(id: string): T | null;
-    /**
-     * Adds an event listener for track list changes.
-     * @param type - The event type: `'trackschange'` (track list changed) or `'change'` (selection changed).
-     * @param listener - The callback function.
-     * @param options - Optional event listener options.
-     */
-    addEventListener(type: 'trackschange' | 'change', listener: EventListener, options?: boolean | AddEventListenerOptions): void;
-}
-
-export declare enum Mimetype {
-    HLS = "application/vnd.apple.mpegurl",
-    HLS_LEGACY = "application/x-mpegURL",
-    DASH = "application/dash+xml",
-    MP4 = "video/mp4",
-    OGG = "video/ogg",
-    WEBM = "video/webm",
-    MP3 = "audio/mp3",
-    AAC = "audio/aac",
-    WAV = "audio/wav",
-    OGG_AUDIO = "audio/ogg",
-    MPEG_AUDIO = "audio/mpeg",
-    DYNAMIC_CONTENT = "application/x-turbo-dynamic-content",
-    JOYN = "application/x-joyn-source"
-}
-
-/**
- * Normalizes a {@link MediaItem} or {@link MediaItemReference} into a
- * {@link MediaItemReference}.
- *
- * @ignore
- *
- * If the input already has a `provider` it is returned as-is.
- * Otherwise the provider is detected from the media item's sources
- * (Joyn when a source with {@link Mimetype.JOYN} is present, external otherwise).
- */
-export declare function normalizeMediaItem(input: MediaItemReference | MediaItem): MediaItemReference;
-
-export declare interface Page {
-    url: string;
-    searchParams: Record<string, string>;
-    utm?: {
-        source?: string;
-        medium?: string;
-        campaign?: string;
-        content?: string;
-        term?: string;
-    };
-    apexDomain: string;
-    hostname: string;
-    pathSegment1?: string;
-    pathSegment2?: string;
-    pathSegment3?: string;
-    referrer: string;
-}
-
-export declare enum PlaybackMode {
-    LIVE = "live",
-    VOD = "vod",
-    INTERACTIVE = "interactive",
-    EMBED = "embed"
-}
-
-export declare enum PresentationMode {
-    HIDDEN = "hidden",
-    INLINE = "inline",
-    DOCK = "dock",
-    LIGHTBOX = "lightbox",
-    LIGHTBOX_EXTERNAL = "lightbox-external",
-    FULLSCREEN = "fullscreen",
-    AMP_DOCK = "amp-dock"
-}
-
-/**
- * Editorial classification of the media item describing what type of program it is.
- */
-export declare enum ProgramType {
-    COMPILATION = "compilation",
-    CLIP = "clip",
-    INTERACTIVE = "interactive",
-    LIVE_ON_DEMAND = "live-on-demand",
-    LIVE = "live",
-    MOVIE = "movie",
-    SERIES = "series",
-    SPORTS_MATCH = "sports-match",
-    TRAILER = "trailer"
-}
-
-export declare enum ScriptType {
-    INTEGRATION_CONFIGS = "application/integration-configs+json",
-    /** @deprecated Use {@link ScriptType.INTEGRATION_CONFIGS} instead. */
-    INTEGRATION_CONFIGS_LEGACY = "application/glomex-integration-configs+json",
-    EXTERNAL_MEDIA_ITEM = "application/external-media-item+json",
-    /** @deprecated Use {@link ScriptType.EXTERNAL_MEDIA_ITEM} instead. */
-    EXTERNAL_MEDIA_ITEM_LEGACY = "application/glomex-external-media-item+json"
-}
-
-/**
- * Represents the seekable range of the media.
- * For VoD content, this typically represents the full duration (0 to duration).
- * For live streams, this represents the DVR window that can be seeked to.
- */
-export declare interface SeekRange {
-    /** The start time of the seekable range in seconds, or undefined if not yet available */
-    start?: number;
-    /** The end time of the seekable range in seconds, or undefined if not yet available */
-    end?: number;
-}
-
-/**
- * A global context singleton shared by every `<glomex-integration>` instance
- * on the page.
- *
- * @example JavaScript (dynamic import)
- * ```ts
- * const { sharedContext } = await import('https://player.glomex.com/integration/1/integration.js');
- *
- * sharedContext.set({
- *   appVersion: '2.3.0',
- *   appName: 'my-app',
- *   deviceId: { id: '...', name: 'idfa' },
- *   userIds: async () => await cmp.getConsentedUserIds(),
- *   providers: {
- *     'my-provider': async () => ({
- *       token: await myAuth.getFreshToken(),
- *     }),
- *   },
- * });
- * ```
- *
- * @example React
- * ```tsx
- * import { getSharedContext } from '@glomex/integration-react';
- * import { useEffect } from 'react';
- *
- * function App() {
- *   useEffect(() => {
- *     async function setup() {
- *       const sharedContext = await getSharedContext();
- *       sharedContext.set({
- *         appVersion: '2.3.0',
- *         appName: 'my-app',
- *         deviceId: { id: '...', name: 'idfa' },
- *         userIds: async () => await cmp.getConsentedUserIds(),
- *         providers: {
- *           'my-provider': async () => ({
- *             token: await myAuth.getFreshToken(),
- *           }),
- *         },
- *       });
- *     }
- *     setup();
- *   }, []);
- * }
- * ```
- */
-export declare interface SharedContext {
-    /**
-     * Merge context data into the shared context.
-     *
-     * - Provider resolvers under `providers` are merged individually —
-     *   only the specified providers are replaced, others are kept.
-     * - Calling `set()` multiple times merges incrementally.
-     */
-    set(data: SharedContextData): void;
-}
-
-/**
- * Module-level singleton shared by every `<glomex-integration>` instance on
- * the page.
- *
- * Publishers obtain it via dynamic import of `integration.js` to ensure they
- * get the same singleton instance as the running player:
- *
- * ```ts
- * const { sharedContext } = await import('https://player.glomex.com/integration/1/integration.js');
- * ```
- *
- * When using the React wrapper, use {@link https://www.npmjs.com/package/@glomex/integration-react @glomex/integration-react} instead:
- *
- * ```ts
- * import { getSharedContext } from '@glomex/integration-react';
- *
- * const sharedContext = await getSharedContext();
- * ```
- */
-export declare const sharedContext: SharedContext;
-
-/**
- * The data object accepted by {@link SharedContext.set}.
- *
- * Every field is optional and merged on top of previously set values.
- * Calling `set()` multiple times merges incrementally — previously set
- * values are preserved unless explicitly overwritten.
- */
-export declare interface SharedContextData {
-    /**
-     * The presentational context of the integration.
-     * Do not define it when it is not part of those contexts.
-     */
-    presentationalContext?: 'curated-list' | 'discovery-page';
-    /**
-     * The version of the app.
-     * When it is a website, fill in the deployed version of the website.
-     */
-    appVersion?: string;
-    /**
-     * The name of the app.
-     * When it is a website, fill in the name of the project.
-     */
-    appName?: string;
-    /**
-     * The bundle id of the app. Only required for iOS apps.
-     */
-    appBundleId?: string;
-    /**
-     * The store id of the app. Only required for apps.
-     * Depending on the app store, the id is formatted differently.
-     *
-     * {@link https://iabtechlab.com/wp-content/uploads/2020/08/IAB-Tech-Lab-OTT-store-assigned-App-Identification-Guidelines-2020.pdf IAB Tech Lab App Identification Guidelines}
-     */
-    appStoreId?: string;
-    /**
-     * The store URL of the app. Only required for apps.
-     *
-     * {@link https://iabtechlab.com/wp-content/uploads/2020/08/IAB-Tech-Lab-OTT-store-assigned-App-Identification-Guidelines-2020.pdf IAB Tech Lab App Identification Guidelines}
-     */
-    appStoreUrl?: string;
-    /** Business-to-business context identifier. */
-    b2bContext?: string;
-    /**
-     * Device id of the user. Only required for app environments.
-     * When no listed deviceId is available, you can pass a ppid as a user id instead.
-     */
-    deviceId?: {
-        id: string;
-        name: DeviceIdName | `${DeviceIdName}`;
-    };
-    /**
-     * Identifiers for the current user (e.g. netID, LiveRamp, PAIR).
-     *
-     * You can pass either a **static array** or a **resolver function**.
-     * A resolver is re-invoked every time the player needs user IDs
-     * (for example before each ad request), so it can return a different
-     * set of IDs when the user's consent state has changed.
-     * The resolver may be asynchronous.
-     *
-     * @example Static array
-     * ```ts
-     * sharedContext.set({
-     *   userIds: [{ id: '...', name: 'netId' }],
-     * });
-     * ```
-     *
-     * @example Async resolver (re-evaluated on every ad request)
-     * ```ts
-     * sharedContext.set({
-     *   userIds: async () => await cmp.getConsentedUserIds(),
-     * });
-     * ```
-     */
-    userIds?: {
-        id: string;
-        name: UserIdName | `${UserIdName}`;
-        ext?: Record<string, unknown>;
-    }[] | (() => {
-        id: string;
-        name: UserIdName | `${UserIdName}`;
-        ext?: Record<string, unknown>;
-    }[] | Promise<{
-        id: string;
-        name: UserIdName | `${UserIdName}`;
-        ext?: Record<string, unknown>;
-    }[]>);
-    /**
-     * Media-provider-specific context resolvers keyed by provider name.
-     *
-     * Each resolver is called every time the player needs fresh context for
-     * the given provider (e.g. to obtain a fresh auth token).
-     *
-     * @example
-     * ```ts
-     * sharedContext.set({
-     *   providers: {
-     *     'my-provider': async () => ({
-     *       token: await myAuth.getFreshToken(),
-     *     }),
-     *   },
-     * });
-     * ```
-     */
-    providers?: {
-        [providerName: string]: (context?: {
-            environment?: string;
-        }) => MediaProviderContext | Promise<MediaProviderContext>;
-    };
-}
-
-export declare type SourceMediaItem = SourceMediaItemBase | SourceMediaItemDrm | SourceMediaItemJoyn;
-
-export declare interface SourceMediaItemBase {
-    /**
-     * Unique identifier of the media source.
-     *
-     * @defaultValue `V1StGXR8_Z5jdHi6B-myT` a generated identifier
-     */
-    id?: string;
-    /**
-     * Mimetype of the media source.
-     *
-     * @defaultValue detected from file extension of given {@link src} or `undefined`
-     */
-    mimetype?: Mimetype;
-    /**
-     * The source URL of this media source.
-     */
-    src: string;
-    /**
-     * Until the media source is valid. Unix timestamp in milliseconds.
-     */
-    validUntil?: number;
-    /**
-     * Content mode of the media source.
-     *
-     * @defaultValue `PlaybackMode.VOD`
-     */
-    playbackMode?: PlaybackMode;
-    /**
-     * When `true`, playback must always remain at the live edge.
-     * Seeking behind the live edge is not permitted.
-     *
-     * @defaultValue `undefined` (treated as `false` — timeshift / seek-back is allowed)
-     */
-    liveEdgeOnly?: boolean;
-    /**
-     * Classification of the user's access level for this source.
-     *
-     * @defaultValue `undefined` (user tier is unknown or not applicable)
-     */
-    userTier?: UserTier;
-    /**
-     * Duration in seconds. Only relevant for dynamic content.
-     */
-    duration?: number;
-}
-
-export declare interface SourceMediaItemDrm extends SourceMediaItemBase {
-    /**
-     * The DRM system this source requires.
-     */
-    drmSystem: DrmSystem;
-    /**
-     * DRM token to include in license requests for the selected DRM system.
-     */
-    token?: string;
-    /**
-     * License server URL for the selected DRM system.
-     */
-    licenseUrl: string;
-    /**
-     * Certificate URL (relevant for FairPlay).
-     */
-    certificateUrl?: string;
-}
-
-export declare interface SourceMediaItemJoyn {
-    /**
-     * Media / asset identifier of joyn.
-     */
-    id: string;
-    mimetype: Mimetype.JOYN;
-    /**
-     * User token used for authentication.
-     */
-    token: string;
-    /**
-     * Allowing to enforce stage environment.
-     * @deprecated Use {@link MediaItemReference.environment} instead.
-     */
-    environment?: 'stg';
-    /** {@inheritDoc SourceMediaItemBase.playbackMode} */
-    playbackMode?: PlaybackMode;
-}
-
-/**
- * Source metadata that may differ per provider.
- *
- * Available on {@link SourceSelected.metadata}. Narrow with
- * `metadata.provider === 'joyn'` to access {@link JoynSourceMetadata} fields.
- */
-export declare type SourceMetadata = JoynSourceMetadata;
-
-/**
- * Base metadata for providers that don't have a dedicated interface.
- */
-declare interface SourceMetadataBase {
-    /** Identifies which provider produced this metadata. */
-    provider: string;
-}
-
-/**
- * Metadata of the source that was selected for playback.
- */
-export declare interface SourceSelected {
-    /** Unique identifier of the source. */
-    id: string;
-    /** MIME type of the media source (e.g. HLS, DASH, MP4). */
-    mimetype: Mimetype;
-    /** URL of the media source. */
-    src: string;
-    /** Playback mode indicating how the content should be played. */
-    playbackMode?: PlaybackMode;
-    /** DRM system used to protect the source, if any. */
-    drmSystem?: DrmSystem;
-    /**
-     * When `true`, playback always remains at the live edge.
-     * Seeking behind the live edge is not permitted.
-     */
-    liveEdgeOnly?: boolean;
-    /**
-     * Classification of the user's tier for this source.
-     *
-     * `undefined` means the user tier is unknown or not applicable.
-     */
-    userTier?: UserTier;
-    /** Provider-generated metadata for this source. */
-    metadata?: SourceMetadata;
-}
-
-export declare enum StartMethod {
-    /** Autoplay occured for above the fold content */
-    PRE_CLICK = "pre-click-to-play",
-    /** Playback started with click */
-    CLICK = "click-to-play",
-    /** Autoplay started when scrolling into view */
-    AUTOPLAY_SCROLL = "autoplay-scroll",
-    /** Autoplay started when scrolling out of view, player was docked */
-    AUTOPLAY_SCROLL_OUT = "autoplay-scroll-out",
-    /** Playback of next video started with click */
-    CLICK_NEXT = "click-to-play-next",
-    /** Replay of current video started with click */
-    CLICK_REPLAY = "click-to-play-replay",
-    /** Autoplay of next video */
-    AUTOPLAY_NEXT = "autoplay-next"
-}
-
-/** Runtime environment for resolving tenant endpoints. */
-declare type TenantEnvironment = 'prod' | 'stage' | 'local';
-
-/**
- * Represents a text track (subtitles, captions, etc.).
- */
-declare interface TextTrack_2 extends MediaTrack {
-    /** The type of text track. */
-    kind: 'subtitles' | 'captions' | 'descriptions' | 'chapters';
-    /**
-     * The current display mode of the track.
-     * - `'disabled'`: Track is not active.
-     * - `'hidden'`: Track is active but not displayed (for programmatic access).
-     * - `'showing'`: Track is active and displayed to the user.
-     */
-    mode: 'disabled' | 'hidden' | 'showing';
-}
-export { TextTrack_2 as TextTrack }
-
-/**
- * A collection of text tracks with selection support.
- * Text tracks can be deselected by passing `undefined` to `select()`.
- *
- * **Note:** Text tracks are available after the {@link IntegrationElement.ready | integration.ready} promise resolves.
- *
- * The list is iterable and can be converted to an array:
- * @example
- * ```ts
- * for (const track of integration.textTracks) { console.log(track); }
- * const tracks = Array.from(integration.textTracks);
- * ```
- */
-declare interface TextTrackList_2 extends MediaTrackList<TextTrack_2> {
-    /** The currently selected text track, or `null` if none is selected. */
-    readonly selected: TextTrack_2 | null;
-    /**
-     * Selects a text track or disables text tracks.
-     * @param trackOrId - The track, track ID, or `undefined` to disable all text tracks.
-     */
-    select(trackOrId: TextTrack_2 | string | undefined): void;
-}
-export { TextTrackList_2 as TextTrackList }
-
-/**
- * A multi-tenant integration custom element that automatically determines
- * the correct tenant from the domain the script was loaded from.
- *
- * When the integration bundle is served from `player.joyn.de` the tenant
- * resolves to `"joyn"`; when served from `player.glomex.com` it resolves
- * to `"glomex"`, and so on.  The mapping is driven by the `domains` list
- * in each tenant configuration (see `@glomex/turbo-shared-types`).
- *
- * For **local development** the tenant can still be overridden via the
- * `tenant` HTML attribute / DOM property so that developers can test any
- * tenant without deploying to the corresponding CDN.
- *
- * > The legacy `<glomex-integration>` element is kept for backwards
- * > compatibility.  New tenants should use `<turbo-integration>`.
- *
- * @tagname turbo-integration
- *
- * @example Basic usage (tenant is auto-detected from the script URL)
- *
- * ```html
- * <turbo-integration
- *   integration-id="joyn-vod"
- * >
- *   <joyn-media-item id="MEDIA_ID"></joyn-media-item>
- * </turbo-integration>
- * ```
- *
- * @example Override tenant for local development
- *
- * ```html
- * <turbo-integration
- *   integration-id="joyn-vod"
- *   tenant="joyn"
- * ></turbo-integration>
- * ```
- */
-export declare class TurboIntegrationElement extends IntegrationElement {
-    constructor();
-}
-
-/**
- * Properties for the `<turbo-integration>` custom element.
- *
- * Identical to {@link IntegrationProperties}. The `tenant` is normally
- * auto-detected from the domain the integration script was loaded from,
- * but can be overridden for local development.
- */
-export declare type TurboIntegrationProperties = IntegrationProperties;
-
-declare type UiAction = (typeof ALLOWED_UI_ACTIONS)[number];
-
-/**
- * Identifier names for user IDs that can be passed via {@link SharedContextData.userIds}.
- */
-export declare enum UserIdName {
-    /** {@link https://netid.de netID} — European login alliance ID */
-    NET_ID = "netId",
-    /** Publisher Provided ID */
-    PPID = "ppid",
-    /** {@link https://utiq.com Utiq} — telco-based advertising ID */
-    UTIQ_ID = "utiqId",
-    /** {@link https://liveramp.com LiveRamp} — identity resolution ID */
-    LIVERAMP_ID = "liverampId",
-    /** {@link https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/pair Google PAIR} — Publisher Advertiser Identity Reconciliation ID */
-    PAIR_ID = "pairId",
-    /** {@link https://liveramp.com LiveRamp} — Authenticated Traffic Solution (ATS) direct encrypted identity envelope */
-    ATS_DIRECT = "atsDirect"
-}
-
-/**
- * Classification of the user's tier.
- */
-export declare enum UserTier {
-    ANONYMOUS = "anonymous",
-    REGISTERED = "registered",
-    PAID = "paid"
-}
-
-/**
- * Represents a video track (quality variant).
- */
-export declare interface VideoTrack {
-    /** Unique identifier for the track. */
-    id: string;
-    /**
-     * The type of video track.
-     * - `'variant'`: A specific quality level.
-     * - `'auto'`: Synthetic track representing automatic quality selection (ABR).
-     */
-    kind: 'variant' | 'auto';
-    /** Human-readable label (e.g., "1080p (6.2 Mbps)"). */
-    label: string;
-    /** Bitrate in bits per second. */
-    bandwidth: number;
-    /** Video width in pixels. */
-    width?: number;
-    /** Video height in pixels. */
-    height?: number;
-}
-
-/**
- * A collection of video tracks with selection support.
- * May be empty or only synthetic when native track info is unavailable.
- *
- * **Note:** Video tracks are available after the {@link IntegrationElement.ready | integration.ready} promise resolves.
- *
- * The list is iterable and can be converted to an array:
- * @example
- * ```ts
- * for (const track of integration.videoTracks) { console.log(track); }
- * const tracks = Array.from(integration.videoTracks);
- * ```
- */
-export declare interface VideoTrackList extends EventTarget, Iterable<VideoTrack> {
-    /** The number of tracks in the list. */
-    readonly length: number;
-    /**
-     * Returns the track with the specified ID.
-     * @param id - The track ID to search for.
-     * @returns The matching track, or `null` if not found.
-     */
-    getTrackById(id: string): VideoTrack | null;
-    /** The currently selected video track, or `null` if unavailable. */
-    readonly selected: VideoTrack | null;
-    /**
-     * Selects a video track or enables automatic quality selection.
-     * @param trackOrId - The track, track ID, or `'auto'` for ABR.
-     */
-    select(trackOrId: VideoTrack | string): void;
-    /**
-     * Adds an event listener for track list changes.
-     * @param type - The event type: `'trackschange'` (track list changed) or `'change'` (selection changed).
-     * @param listener - The callback function.
-     * @param options - Optional event listener options.
-     */
-    addEventListener(type: 'trackschange' | 'change', listener: EventListener, options?: boolean | AddEventListenerOptions): void;
-}
-
-export { }
-
-declare global {
-  interface HTMLElementTagNameMap {
-    [ComponentName.INTEGRATION]: IntegrationElement;
-    [ComponentName.GLOMEX_MEDIA_ITEM]: GlomexMediaItemElement;
-    [ComponentName.JOYN_MEDIA_ITEM]: JoynMediaItemElement;
-    [ComponentName.EXTERNAL_MEDIA_ITEM]: ExternalMediaItemElement;
-  }
-  interface HTMLElementEventMap extends IntegrationElementEventMap {}
-}
+export * from '@turbo-player/integration-web-component';
+import type { SharedContext } from '@turbo-player/integration-web-component';
+import { ComponentName as BaseComponentName } from '@turbo-player/integration-web-component';
+export declare const ComponentName: {
+    readonly INTEGRATION: "glomex-integration";
+    readonly EXTERNAL_MEDIA_ITEM: BaseComponentName.EXTERNAL_MEDIA_ITEM;
+    readonly GLOMEX_MEDIA_ITEM: BaseComponentName.GLOMEX_MEDIA_ITEM;
+    readonly JOYN_MEDIA_ITEM: BaseComponentName.JOYN_MEDIA_ITEM;
+};
+/** Returns the CSS URL for a given integration */
+export declare function getIntegrationCssUrl(integrationId: string): string;
+/** Returns the custom element name. */
+export declare function getIntegrationComponentName(): string;
+/**
+ * Loads the integration custom element by injecting the script into the document.
+ * Does nothing if the element is already defined.
+ */
+export declare function loadIntegrationComponent(): void;
+/**
+ * Loads the variant CSS for the given integration ID by injecting a
+ * `<link>` element into the document head. Does nothing if the stylesheet
+ * is already loaded.
+ *
+ * @example
+ * ```ts
+ * import { loadIntegrationStyles } from '@glomex/integration-web-component';
+ *
+ * loadIntegrationStyles('your-integration-id');
+ * ```
+ */
+export declare function loadIntegrationStyles(integrationId: string, doc?: Document | ShadowRoot): void;
+/**
+ * Returns the {@link SharedContext} singleton from the loaded integration.
+ *
+ * Waits for the integration custom element to be defined, then
+ * reads the singleton from its static property — guaranteeing the same
+ * instance that the running player uses.
+ *
+ * @example
+ * ```ts
+ * import { getSharedContext } from '@glomex/integration-web-component';
+ *
+ * const sharedContext = await getSharedContext();
+ * sharedContext.set({
+ *   appVersion: '2.3.0',
+ *   providers: {
+ *     'my-provider': async () => ({ token: await myAuth.getFreshToken() }),
+ *   }
+ * });
+ * ```
+ */
+export declare function getSharedContext(): Promise<SharedContext>;