@skax/hls-parse 0.0.1-beta.1

package/dist/types/index.d.ts

@@ -0,0 +1,1102 @@
+/**
+ * HLS Playlist Type Definitions
+ *
+ * All types conforming to {@link https://datatracker.ietf.org/doc/html/rfc8216 | RFC 8216}
+ * (HTTP Live Streaming) and LL-HLS (Low-Latency HLS) extensions.
+ *
+ * @remarks
+ * All URIs in these types will be resolved to absolute when
+ * {@link ParseOptions.uri} is provided to {@link parse}.
+ *
+ * @module types
+ * @category Types
+ */
+/**
+ * Media Initialization Section.
+ *
+ * Corresponds to the `#EXT-X-MAP` tag.
+ * Contains the URI and optional byte range of the initialization resource
+ * required to parse applicable Media Segments.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.5 | RFC 8216 §4.3.2.5}
+ */
+interface MediaInitializationSection {
+    /** Whether this is a preload hint (LL-HLS). */
+    hint?: boolean;
+    /** URI to the initialization section resource. */
+    uri: string;
+    /** Byte range within the resource. */
+    byterange?: Byterange;
+}
+/**
+ * Byte range specification.
+ *
+ * Corresponds to the `#EXT-X-BYTERANGE` tag value.
+ *
+ * @remarks
+ * When `offset` is `-1` it indicates the sub-range begins at the next byte
+ * following the sub-range of the previous Media Segment.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.2 | RFC 8216 §4.3.2.2}
+ */
+interface Byterange {
+    /** Length of the byte range in bytes. */
+    length: number;
+    /**
+     * Start offset in bytes.
+     *
+     * @defaultValue `-1` (implicit offset)
+     */
+    offset: number;
+}
+/**
+ * Display resolution.
+ *
+ * Corresponds to the `RESOLUTION` attribute value.
+ *
+ * @example `{ width: 1920, height: 1080 }` for `RESOLUTION=1920x1080`
+ */
+interface Resolution {
+    /** Horizontal pixel dimension. */
+    width: number;
+    /** Vertical pixel dimension. */
+    height: number;
+}
+/**
+ * Encryption / decryption key.
+ *
+ * Corresponds to `#EXT-X-KEY` and `#EXT-X-SESSION-KEY` tags.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.4 | RFC 8216 §4.3.2.4}
+ */
+interface Key {
+    /**
+     * Encryption method.
+     *
+     * @remarks Valid values: `"NONE"`, `"AES-128"`, `"SAMPLE-AES"`.
+     */
+    method: string;
+    /** URI to obtain the key file. */
+    uri?: string;
+    /**
+     * Initialization Vector.
+     *
+     * @remarks Must be exactly 128 bits (16 bytes) when present.
+     */
+    iv?: Uint8Array;
+    /**
+     * Key format identifier.
+     *
+     * @defaultValue `"identity"`
+     */
+    format?: string;
+    /** Key format version(s), separated by `/`. */
+    formatVersion?: string;
+}
+/**
+ * Parsed `#EXTINF` tag data.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.1 | RFC 8216 §4.3.2.1}
+ */
+interface ExtInfo {
+    /** Segment duration in seconds. */
+    duration: number;
+    /** Optional human-readable title. */
+    title?: string;
+}
+/**
+ * Partial segment for Low-Latency HLS.
+ *
+ * Corresponds to `#EXT-X-PART` and `#EXT-X-PRELOAD-HINT` (TYPE=PART) tags.
+ *
+ * @beta LL-HLS feature
+ */
+interface PartialSegment {
+    /** Whether this is a preload hint (`#EXT-X-PRELOAD-HINT`). */
+    hint?: boolean;
+    /** URI to the partial segment. */
+    uri: string;
+    /** Byte range within the resource. */
+    byterange?: Byterange;
+    /** Duration in seconds. */
+    duration?: number;
+    /** Whether this segment can be decoded independently. */
+    independent?: boolean;
+    /** Whether this segment is a gap. */
+    gap?: boolean;
+}
+/**
+ * Prefetch segment for Low-Latency HLS.
+ *
+ * Corresponds to the `#EXT-X-PREFETCH` tag.
+ *
+ * @beta LL-HLS feature
+ */
+interface PrefetchSegment {
+    /** URI of the prefetch segment. */
+    uri: string;
+    /** Media Sequence Number. */
+    mediaSequenceNumber: number;
+    /** Discontinuity Sequence Number. */
+    discontinuitySequence: number;
+    /** Whether this segment indicates a discontinuity. */
+    discontinuity?: boolean;
+    /** Encryption key (inherited from previous segment if not specified). */
+    key?: Key | null;
+}
+/**
+ * Media Segment.
+ *
+ * Represents a single segment in a Media Playlist, including all associated tags
+ * (`#EXTINF`, `#EXT-X-KEY`, `#EXT-X-MAP`, `#EXT-X-BYTERANGE`, etc.).
+ */
+interface Segment {
+    /** URI of the media segment. */
+    uri: string;
+    /** Duration in seconds (from `#EXTINF`). */
+    duration?: number;
+    /** Optional title (from `#EXTINF`). */
+    title?: string;
+    /** Byte range within the resource (from `#EXT-X-BYTERANGE`). */
+    byterange?: Byterange;
+    /** Media Sequence Number. */
+    mediaSequenceNumber: number;
+    /** Discontinuity Sequence Number. */
+    discontinuitySequence: number;
+    /** Whether this segment is a discontinuity (`#EXT-X-DISCONTINUITY`). */
+    discontinuity?: boolean;
+    /** Whether this segment is a gap (`#EXT-X-GAP`). */
+    gap?: boolean;
+    /** Encryption key (`#EXT-X-KEY`). Inherited if not present. */
+    key?: Key | null;
+    /** Media Initialization Section (`#EXT-X-MAP`). Inherited if not present. */
+    map?: MediaInitializationSection | null;
+    /** Program date/time (`#EXT-X-PROGRAM-DATE-TIME`). */
+    programDateTime?: Date;
+    /** Date range metadata (`#EXT-X-DATERANGE`). */
+    dateRange?: DateRange;
+    /** Splice / marker information. */
+    markers?: SpliceInfo[];
+    /** Partial segments (LL-HLS `#EXT-X-PART` / `#EXT-X-PRELOAD-HINT`). */
+    parts?: PartialSegment[];
+}
+/**
+ * Date Range metadata.
+ *
+ * Corresponds to the `#EXT-X-DATERANGE` tag.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.7 | RFC 8216 §4.3.2.7}
+ */
+interface DateRange {
+    /** Unique identifier. */
+    id: string;
+    /** CLASS name grouping ranges with shared semantics. */
+    classId?: string;
+    /** Start date/time. */
+    start: Date;
+    /** Cue information. */
+    cue?: string;
+    /** End date/time. */
+    end?: Date;
+    /** Duration in seconds. */
+    duration?: number;
+    /** Expected duration (when actual is not yet known). */
+    plannedDuration?: number;
+    /**
+     * Whether this range ends at the start of the next range of the same CLASS.
+     *
+     * @remarks Cannot coexist with `duration` or `end`.
+     */
+    endOnNext?: boolean;
+    /** Custom attributes (SCTE35- and X- prefixed). */
+    attributes?: Record<string, any>;
+}
+/**
+ * Splice / marker information.
+ *
+ * Carried by `#EXT-X-CUE-OUT`, `#EXT-X-CUE-IN`, and raw SCTE-35 tags.
+ */
+interface SpliceInfo {
+    /** Marker type. */
+    type: "OUT" | "IN" | "RAW";
+    /** Duration in seconds (for `OUT` type). */
+    duration?: number;
+    /** Original tag name (for `RAW` type). */
+    tagName?: string;
+    /** Raw tag value. */
+    value?: any;
+}
+/**
+ * Alternative Rendition.
+ *
+ * Corresponds to the `#EXT-X-MEDIA` tag.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.1 | RFC 8216 §4.3.4.1}
+ */
+interface Rendition {
+    /** Media type: `"AUDIO"`, `"VIDEO"`, `"SUBTITLES"`, or `"CLOSED-CAPTIONS"`. */
+    type: string;
+    /** URI of the media playlist (optional for AUDIO/VIDEO). */
+    uri?: string;
+    /** Rendition group ID. */
+    groupId: string;
+    /** Primary language (RFC 5646 tag). */
+    language?: string;
+    /** Associated language (RFC 5646 tag). */
+    assocLanguage?: string;
+    /** Human-readable name. */
+    name: string;
+    /** Whether this is the default rendition. */
+    isDefault?: boolean;
+    /** Whether this can be auto-selected. */
+    autoselect?: boolean;
+    /** Whether this is forced (SUBTITLES only). */
+    forced?: boolean;
+    /**
+     * In-stream ID.
+     *
+     * @remarks Required when `type` is `"CLOSED-CAPTIONS"`.
+     * Valid: `"CC1"`-`"CC4"`, `"SERVICE1"`-`"SERVICE63"`.
+     */
+    instreamId?: string;
+    /** Uniform Type Identifiers (UTIs), comma-separated. */
+    characteristics?: string;
+    /** Audio channel count and parameters. */
+    channels?: string;
+    /** Pathway ID for content steering. */
+    pathwayId?: string;
+}
+/**
+ * Variant Stream.
+ *
+ * Corresponds to `#EXT-X-STREAM-INF` or `#EXT-X-I-FRAME-STREAM-INF`.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.2 | RFC 8216 §4.3.4.2}
+ */
+interface Variant {
+    /** URI of the media playlist. */
+    uri: string;
+    /** Peak bit rate in bits per second. */
+    bandwidth: number;
+    /** Average bit rate in bits per second. */
+    averageBandwidth?: number;
+    /**
+     * Variant SCORE (LL-HLS), used for prioritised playlist reload.
+     *
+     * @remarks If any variant has a SCORE, all variants SHOULD have one.
+     */
+    score?: number;
+    /** Codec identifiers (RFC 6381). */
+    codecs?: string;
+    /** Optimal display resolution. */
+    resolution?: Resolution;
+    /** Maximum frame rate (rounded to 3 decimal places). */
+    frameRate?: number;
+    /** HDCP level: `"TYPE-0"` or `"NONE"`. */
+    hdcpLevel?: string;
+    /** Allowed Content Protection Configurations. */
+    allowedCpc?: AllowedCpc[];
+    /** Video range: `"SDR"`, `"HLG"`, or `"PQ"`. */
+    videoRange?: string;
+    /** Stable variant identifier. */
+    stableVariantId?: string;
+    /** Pathway ID for content steering. */
+    pathwayId?: string;
+    /** Program ID.
+     *
+     * @deprecated Removed in protocol version 6.
+     */
+    programId?: number;
+    /** Whether this is an I-frame variant (`#EXT-X-I-FRAME-STREAM-INF`). */
+    isIFrameOnly?: boolean;
+    /** Audio renditions matching this variant's GROUP-ID. */
+    audio?: Rendition[];
+    /** Video renditions matching this variant's GROUP-ID. */
+    video?: Rendition[];
+    /** Subtitle renditions matching this variant's GROUP-ID. */
+    subtitles?: Rendition[];
+    /** Closed-caption renditions matching this variant's GROUP-ID. */
+    closedCaptions?: Rendition[];
+}
+/**
+ * Allowed Content Protection Configuration entry.
+ *
+ * Part of the `ALLOWED-CPC` attribute value.
+ */
+interface AllowedCpc {
+    /** Content protection format identifier. */
+    format: string;
+    /** List of Content Protection Configurations. */
+    cpcList: string[];
+}
+/**
+ * Session Data.
+ *
+ * Corresponds to the `#EXT-X-SESSION-DATA` tag.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.4 | RFC 8216 §4.3.4.4}
+ */
+interface SessionData {
+    /** Data identifier (reverse-DNS recommended). */
+    id: string;
+    /** Inline value (mutually exclusive with `uri`). */
+    value?: string;
+    /** URI to a JSON resource (mutually exclusive with `value`). */
+    uri?: string;
+    /** Language of the value (RFC 5646 tag). */
+    language?: string;
+}
+/**
+ * Content Steering configuration.
+ *
+ * Corresponds to the `#EXT-X-CONTENT-STEERING` tag.
+ */
+interface ContentSteering {
+    /** Server URI for the steering manifest. */
+    serverUri: string;
+    /** Pathway ID to use. */
+    pathwayId?: string;
+}
+/**
+ * Rendition Report for Low-Latency HLS.
+ *
+ * Corresponds to the `#EXT-X-RENDITION-REPORT` tag.
+ *
+ * @beta LL-HLS feature
+ */
+interface RenditionReport {
+    /** URI of the rendition playlist (must be relative). */
+    uri: string;
+    /** Last Media Sequence Number. */
+    lastMSN?: number;
+    /** Last Part index. */
+    lastPart?: number;
+}
+/**
+ * Preferred start position.
+ *
+ * Corresponds to the `#EXT-X-START` tag.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.5.2 | RFC 8216 §4.3.5.2}
+ */
+interface StartData {
+    /**
+     * Time offset in seconds.
+     *
+     * @remarks Positive = from beginning, negative = from end.
+     */
+    offset: number;
+    /**
+     * Whether to precisely seek to the TIME-OFFSET.
+     *
+     * @defaultValue `false`
+     */
+    precise?: boolean;
+}
+/**
+ * Low-Latency HLS server control parameters.
+ *
+ * Corresponds to the `#EXT-X-SERVER-CONTROL` tag.
+ *
+ * @beta LL-HLS feature
+ */
+interface LowLatencyCompatibility {
+    /** Whether block reload is supported. */
+    canBlockReload: boolean;
+    /** Maximum skip duration in seconds. */
+    canSkipUntil?: number;
+    /** Minimum hold-back time in seconds. */
+    holdBack?: number;
+    /** Minimum part hold-back time in seconds. */
+    partHoldBack?: number;
+}
+/**
+ * User-defined attribute value.
+ *
+ * @internal
+ */
+type UserAttribute = string | number | Uint8Array;
+/**
+ * Master Playlist.
+ *
+ * Contains variant streams and renditions for adaptive bitrate streaming.
+ *
+ * @remarks
+ * Type discriminator: `isMasterPlaylist === true`.
+ *
+ * @example
+ * ```ts
+ * import { parse } from '@skax/hls-parse';
+ * const pl = parse(m3u8Content) as MasterPlaylist;
+ * for (const v of pl.variants) {
+ *   console.log(v.bandwidth, v.uri);
+ * }
+ * ```
+ */
+interface MasterPlaylist {
+    /** Type discriminator — always `true` for Master Playlist. */
+    isMasterPlaylist: true;
+    /** The raw playlist source text. */
+    source?: string;
+    /** Protocol compatibility version. */
+    version?: number;
+    /** Whether independent segments are signaled. */
+    independentSegments?: boolean;
+    /** Preferred start position. */
+    start?: StartData;
+    /** Content steering configuration. */
+    contentSteering?: ContentSteering;
+    /** Variable definitions (`#EXT-X-DEFINE`). */
+    defines?: Record<string, any>[];
+    /** Session data entries. */
+    sessionDataList: SessionData[];
+    /** Session keys. */
+    sessionKeyList: Key[];
+    /** Variant streams (`#EXT-X-STREAM-INF` / `#EXT-X-I-FRAME-STREAM-INF`). */
+    variants: Variant[];
+}
+/**
+ * Media Playlist.
+ *
+ * Contains segments and metadata for sequential playback.
+ *
+ * @remarks
+ * Type discriminator: `isMasterPlaylist === false`.
+ *
+ * @example
+ * ```ts
+ * import { parse } from '@skax/hls-parse';
+ * const pl = parse(m3u8Content) as MediaPlaylist;
+ * for (const seg of pl.segments) {
+ *   console.log(seg.uri, seg.duration);
+ * }
+ * ```
+ */
+interface MediaPlaylist {
+    /** Type discriminator — always `false` for Media Playlist. */
+    isMasterPlaylist: false;
+    /** The raw playlist source text. */
+    source?: string;
+    /** Protocol compatibility version. */
+    version?: number;
+    /** Whether independent segments are signaled. */
+    independentSegments?: boolean;
+    /** Preferred start position. */
+    start?: StartData;
+    /** Variable definitions (`#EXT-X-DEFINE`). */
+    defines?: Record<string, any>[];
+    /** Maximum segment duration in seconds (`#EXT-X-TARGETDURATION`). */
+    targetDuration?: number;
+    /** Base media sequence number. */
+    mediaSequenceBase?: number;
+    /** Base discontinuity sequence number. */
+    discontinuitySequenceBase?: number;
+    /** Whether the playlist is complete (`#EXT-X-ENDLIST`). */
+    endlist?: boolean;
+    /** Playlist type: `"EVENT"` or `"VOD"`. */
+    playlistType?: string;
+    /** Whether this is an I-frame only playlist. */
+    isIFrame?: boolean;
+    /** LL-HLS server control parameters. */
+    lowLatencyCompatibility?: LowLatencyCompatibility;
+    /** Partial segment target duration (LL-HLS). */
+    partTargetDuration?: number;
+    /** Bitrate of the media playlist in bps (RFC 8216bis EXT-X-BITRATE). */
+    bitrate?: number;
+    /** Number of skipped segments (LL-HLS `#EXT-X-SKIP`). */
+    skip?: number;
+    /** Media segments. */
+    segments: Segment[];
+    /** Prefetch segments (LL-HLS). */
+    prefetchSegments: PrefetchSegment[];
+    /** Rendition reports (LL-HLS). */
+    renditionReports: RenditionReport[];
+    /** Date ranges in the playlist. */
+    dateRanges: DateRange[];
+}
+/**
+ * Union type for any parsed playlist.
+ *
+ * @remarks
+ * Use the `isMasterPlaylist` discriminator to narrow the type:
+ * ```ts
+ * if (pl.isMasterPlaylist) {
+ *   // pl is MasterPlaylist
+ * } else {
+ *   // pl is MediaPlaylist
+ * }
+ * ```
+ */
+type Playlist = MasterPlaylist | MediaPlaylist;
+/**
+ * Options for the {@link parse} function.
+ */
+interface ParseOptions {
+    /**
+     * Base URI for resolving relative URLs in the playlist.
+     *
+     * @remarks
+     * If provided, all relative URIs (segment URIs, key URIs, map URIs,
+     * variant URIs, etc.) will be resolved to absolute URLs.
+     *
+     * @example
+     * ```ts
+     * const pl = parse(m3u8, { uri: 'https://example.com/hls/main.m3u8' });
+     * // pl.segments[0].uri → 'https://example.com/hls/segment.ts'
+     * ```
+     */
+    uri?: string;
+}
+/**
+ * Type guard: returns `true` if the parsed playlist is a Master Playlist.
+ *
+ * @example
+ * ```ts
+ * const pl = parse(m3u8);
+ * if (isMasterPlaylist(pl)) {
+ *   pl.variants; // ← narrowed to MasterPlaylist
+ * }
+ * ```
+ */
+declare function isMasterPlaylist(pl: Playlist): pl is MasterPlaylist;
+/**
+ * Type guard: returns `true` if the parsed playlist is a Media Playlist.
+ *
+ * @example
+ * ```ts
+ * const pl = parse(m3u8);
+ * if (isMediaPlaylist(pl)) {
+ *   pl.segments; // ← narrowed to MediaPlaylist
+ * }
+ * ```
+ */
+declare function isMediaPlaylist(pl: Playlist): pl is MediaPlaylist;
+
+/**
+ * HLS / M3U8 Playlist Parser
+ *
+ * Parses M3U8 playlists according to RFC 8216 (HTTP Live Streaming),
+ * including support for:
+ * - Master Playlists (EXT-X-STREAM-INF, EXT-X-I-FRAME-STREAM-INF, etc.)
+ * - Media Playlists (Media Segments, Encryption Keys, etc.)
+ * - LL-HLS / Low-Latency HLS (EXT-X-PART, EXT-X-PRELOAD-HINT,
+ *   EXT-X-SERVER-CONTROL, EXT-X-SKIP, EXT-X-RENDITION-REPORT, etc.)
+ * - Relative URL resolution
+ * - Automatic protocol version detection
+ * - Variable substitution (EXT-X-DEFINE)
+ *
+ * Usage:
+ *   import { parse } from '@skax/hls-parse';
+ *   const playlist = parse(m3u8Content);
+ *   // With URL resolution:
+ *   const playlist = parse(m3u8Content, { uri: 'https://example.com/playlist.m3u8' });
+ *
+ * @see https://datatracker.ietf.org/doc/html/rfc8216
+ */
+
+/**
+ * Parses an M3U8 playlist string into a structured object.
+ *
+ * Automatically detects whether the playlist is a Master Playlist or
+ * Media Playlist and parses accordingly.
+ *
+ * @param text - The raw M3U8 playlist content as a string
+ * @param options - Optional parsing options
+ * @param options.uri - Base URI for resolving relative URLs in the playlist
+ * @returns A structured MasterPlaylist or MediaPlaylist object
+ *
+ * @throws {InvalidPlaylistError} If the playlist violates RFC 8216 syntax rules
+ *
+ * @example
+ * ```typescript
+ * import { parse } from '@skax/hls-parse';
+ *
+ * // Parse a simple media playlist
+ * const media = parse(`#EXTM3U
+ * #EXT-X-TARGETDURATION:10
+ * #EXTINF:9.009,
+ * segment1.ts
+ * #EXTINF:9.009,
+ * segment2.ts
+ * #EXT-X-ENDLIST`);
+ *
+ * // Parse with relative URL resolution
+ * const master = parse(m3u8Content, {
+ *   uri: 'https://example.com/path/to/playlist.m3u8'
+ * });
+ * ```
+ */
+declare function parse(text: string, options?: ParseOptions): MasterPlaylist | MediaPlaylist;
+
+/**
+ * Utility functions for HLS parsing.
+ *
+ * @module utils
+ * @category Internal
+ * @internal
+ */
+/**
+ * Custom error class for invalid playlist parsing.
+ *
+ * Thrown by {@link parse} when a playlist violates RFC 8216 syntax rules.
+ * Extends the standard `Error` class.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   parse(m3u8);
+ * } catch (e) {
+ *   if (e instanceof InvalidPlaylistError) {
+ *     console.log(e.message);
+ *   }
+ * }
+ * ```
+ */
+declare class InvalidPlaylistError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolves a relative URI against a base URI.
+ *
+ * If the URI is absolute (has a scheme), it is returned as-is.
+ * If no base URI is provided, the URI is returned as-is.
+ * Supports `http://`, `https://`, and other standard schemes.
+ *
+ * @param base - The base URI for resolution, or `undefined`
+ * @param relative - The relative URI to resolve
+ * @returns The resolved absolute URI, or the original if already absolute
+ *
+ * @example
+ * ```ts
+ * resolveUrl('https://example.com/dir/playlist.m3u8', 'segment.ts');
+ * // 'https://example.com/dir/segment.ts'
+ *
+ * resolveUrl(undefined, 'segment.ts');
+ * // 'segment.ts' (no base, returned as-is)
+ * ```
+ */
+declare function resolveUrl(base: string | undefined, relative: string): string;
+
+/**
+ * HLS Tag 常量定义
+ *
+ * 所有 M3U8 / HLS 标签名称的统一常量。
+ * 每个 tag 附带中英双语文档注释，
+ * 使用时通过 `TAGS.TAG_NAME` 引用，避免硬编码字符串。
+ *
+ * @module constants
+ * @category Types
+ *
+ * @example
+ * ```ts
+ * import { TAGS } from '@skax/hls-parse';
+ * // TAGS.EXT_X_TARGETDURATION === "#EXT-X-TARGETDURATION"
+ * ```
+ */
+/**
+ * 文件格式标识符
+ *
+ * Extended M3U Playlist format identifier.
+ * MUST be the first line of every Media or Master Playlist.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.1.1 | RFC 8216 §4.3.1.1}
+ */
+declare const EXTM3U = "EXTM3U";
+/**
+ * 协议兼容版本号
+ *
+ * Protocol compatibility version number.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.1.2 | RFC 8216 §4.3.1.2}
+ */
+declare const EXT_X_VERSION = "EXT-X-VERSION";
+/**
+ * 内容转向服务器配置
+ *
+ * Content Steering server URI.
+ *
+ * @beta  RFC 8216bis
+ */
+declare const EXT_X_CONTENT_STEERING = "EXT-X-CONTENT-STEERING";
+/**
+ * 片段时长及标题
+ *
+ * Segment duration and optional human-readable title.
+ * REQUIRED for each Media Segment.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.1 | RFC 8216 §4.3.2.1}
+ */
+declare const EXTINF = "EXTINF";
+/**
+ * 子范围字节区间
+ *
+ * Sub-range byte range within a resource.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.2 | RFC 8216 §4.3.2.2}
+ */
+declare const EXT_X_BYTERANGE = "EXT-X-BYTERANGE";
+/**
+ * 不连续标记
+ *
+ * Discontinuity between the following segment and the one before it.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.3 | RFC 8216 §4.3.2.3}
+ */
+declare const EXT_X_DISCONTINUITY = "EXT-X-DISCONTINUITY";
+/**
+ * LL-HLS 预取不连续
+ *
+ * Discontinuity marker for LL-HLS prefetch segments.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_PREFETCH_DISCONTINUITY = "EXT-X-PREFETCH-DISCONTINUITY";
+/**
+ * 加密密钥
+ *
+ * Encryption / decryption key for Media Segments.
+ * Method: NONE | AES-128 | SAMPLE-AES
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.4 | RFC 8216 §4.3.2.4}
+ */
+declare const EXT_X_KEY = "EXT-X-KEY";
+/**
+ * 媒体初始化段
+ *
+ * Media Initialization Section URI and optional byte range.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.5 | RFC 8216 §4.3.2.5}
+ */
+declare const EXT_X_MAP = "EXT-X-MAP";
+/**
+ * 绝对日期时间
+ *
+ * Associating the first sample of a Media Segment with an absolute wall-clock time.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.6 | RFC 8216 §4.3.2.6}
+ */
+declare const EXT_X_PROGRAM_DATE_TIME = "EXT-X-PROGRAM-DATE-TIME";
+/**
+ * 日期范围元数据
+ *
+ * Date Range metadata — carries SCTE-35 and ad-insertion data.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.7 | RFC 8216 §4.3.2.7}
+ */
+declare const EXT_X_DATERANGE = "EXT-X-DATERANGE";
+/**
+ * 广告插播开始
+ *
+ * Splice-out marker — indicates the start of an ad break.
+ */
+declare const EXT_X_CUE_OUT = "EXT-X-CUE-OUT";
+/**
+ * 广告插播结束
+ *
+ * Splice-in marker — indicates the end of an ad break.
+ */
+declare const EXT_X_CUE_IN = "EXT-X-CUE-IN";
+/**
+ * 广告插播延续
+ *
+ * Splice-out continuation marker.
+ */
+declare const EXT_X_CUE_OUT_CONT = "EXT-X-CUE-OUT-CONT";
+/**
+ * 通用提示标记
+ *
+ * Generic cue marker.
+ */
+declare const EXT_X_CUE = "EXT-X-CUE";
+/**
+ * OATCLS SCTE-35 数据
+ *
+ * OATCLS SCTE-35 payload marker.
+ */
+declare const EXT_OATCLS_SCTE35 = "EXT-OATCLS-SCTE35";
+/**
+ * 资产元数据
+ *
+ * Asset metadata (CAID) marker.
+ */
+declare const EXT_X_ASSET = "EXT-X-ASSET";
+/**
+ * SCTE-35 数据
+ *
+ * SCTE-35 payload marker.
+ */
+declare const EXT_X_SCTE35 = "EXT-X-SCTE35";
+/**
+ * LL-HLS 部分片段
+ *
+ * Partial Segment for Low-Latency HLS.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_PART = "EXT-X-PART";
+/**
+ * LL-HLS 预加载提示
+ *
+ * Preload Hint for Low-Latency HLS — TYPE=PART or TYPE=MAP.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_PRELOAD_HINT = "EXT-X-PRELOAD-HINT";
+/**
+ * 间隔片段标记
+ *
+ * Gap segment marker — indicates a Media Segment without media content.
+ * Extends target duration for timing but carries no samples.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.2.8 | RFC 8216 §4.3.2.8 (bis)}
+ */
+declare const EXT_X_GAP = "EXT-X-GAP";
+/**
+ * 媒体播放列表码率
+ *
+ * Indicates the segment bitrate of a Media Playlist.
+ * Enables ABR without a Master Playlist (RFC 8216bis).
+ *
+ * @beta
+ */
+declare const EXT_X_BITRATE = "EXT-X-BITRATE";
+/**
+ * 最大片段时长 (秒)
+ *
+ * Maximum Media Segment duration in seconds. REQUIRED for every Media Playlist.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.3.1 | RFC 8216 §4.3.3.1}
+ */
+declare const EXT_X_TARGETDURATION = "EXT-X-TARGETDURATION";
+/**
+ * 媒体序列号基数
+ *
+ * Base Media Sequence Number of the first Media Segment.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.3.2 | RFC 8216 §4.3.3.2}
+ */
+declare const EXT_X_MEDIA_SEQUENCE = "EXT-X-MEDIA-SEQUENCE";
+/**
+ * 不连续序列号基数
+ *
+ * Base Discontinuity Sequence Number.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.3.3 | RFC 8216 §4.3.3.3}
+ */
+declare const EXT_X_DISCONTINUITY_SEQUENCE = "EXT-X-DISCONTINUITY-SEQUENCE";
+/**
+ * 播放列表终止标记
+ *
+ * End-of-playlist marker — no more segments will be added.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.3.4 | RFC 8216 §4.3.3.4}
+ */
+declare const EXT_X_ENDLIST = "EXT-X-ENDLIST";
+/**
+ * 播放列表类型
+ *
+ * Playlist type — EVENT or VOD.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.3.5 | RFC 8216 §4.3.3.5}
+ */
+declare const EXT_X_PLAYLIST_TYPE = "EXT-X-PLAYLIST-TYPE";
+/**
+ * 仅 I 帧播放列表
+ *
+ * I-frame only playlist — each segment is a single I-frame (trick play).
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.3.6 | RFC 8216 §4.3.3.6}
+ */
+declare const EXT_X_I_FRAMES_ONLY = "EXT-X-I-FRAMES-ONLY";
+/**
+ * LL-HLS 服务端控制参数
+ *
+ * Low-Latency HLS server control — CAN-BLOCK-RELOAD, CAN-SKIP-UNTIL, HOLD-BACK, PART-HOLD-BACK.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_SERVER_CONTROL = "EXT-X-SERVER-CONTROL";
+/**
+ * LL-HLS 部分片段目标时长
+ *
+ * Partial Segment target duration for Low-Latency HLS — PART-TARGET.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_PART_INF = "EXT-X-PART-INF";
+/**
+ * LL-HLS 预取片段
+ *
+ * Prefetch segment for Low-Latency HLS.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_PREFETCH = "EXT-X-PREFETCH";
+/**
+ * LL-HLS 呈现报告
+ *
+ * Rendition Report for Low-Latency HLS — carries last MSN and last Part of a Rendition.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_RENDITION_REPORT = "EXT-X-RENDITION-REPORT";
+/**
+ * LL-HLS 跳过片段
+ *
+ * Skip indicator for Low-Latency HLS — SKIPPED-SEGMENTS count.
+ *
+ * @beta LL-HLS feature
+ */
+declare const EXT_X_SKIP = "EXT-X-SKIP";
+/**
+ * 替代呈现
+ *
+ * Alternative Rendition — TYPE: AUDIO | VIDEO | SUBTITLES | CLOSED-CAPTIONS.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.1 | RFC 8216 §4.3.4.1}
+ */
+declare const EXT_X_MEDIA = "EXT-X-MEDIA";
+/**
+ * 变体流
+ *
+ * Variant Stream — ABR adaptive bitrate stream.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.2 | RFC 8216 §4.3.4.2}
+ */
+declare const EXT_X_STREAM_INF = "EXT-X-STREAM-INF";
+/**
+ * I 帧变体流
+ *
+ * I-frame Variant Stream — independent I-frame playlist for trick-play.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.3 | RFC 8216 §4.3.4.3}
+ */
+declare const EXT_X_I_FRAME_STREAM_INF = "EXT-X-I-FRAME-STREAM-INF";
+/**
+ * 会话数据
+ *
+ * Session data — key-value pairs or JSON URI for arbitrary metadata.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.4 | RFC 8216 §4.3.4.4}
+ */
+declare const EXT_X_SESSION_DATA = "EXT-X-SESSION-DATA";
+/**
+ * 会话加密密钥
+ *
+ * Session-wide encryption key — preloaded keys for the entire Master Playlist.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.4.5 | RFC 8216 §4.3.4.5}
+ */
+declare const EXT_X_SESSION_KEY = "EXT-X-SESSION-KEY";
+/**
+ * 独立片段声明
+ *
+ * All Media Segments in the playlist are independently decodable.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.5.1 | RFC 8216 §4.3.5.1}
+ */
+declare const EXT_X_INDEPENDENT_SEGMENTS = "EXT-X-INDEPENDENT-SEGMENTS";
+/**
+ * 建议起始位置
+ *
+ * Preferred point at which to start playback — TIME-OFFSET.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc8216#section-4.3.5.2 | RFC 8216 §4.3.5.2}
+ */
+declare const EXT_X_START = "EXT-X-START";
+/**
+ * 变量定义
+ *
+ * Variable definition — NAME and VALUE pair for substitution.
+ */
+declare const EXT_X_DEFINE = "EXT-X-DEFINE";
+
+declare const constants_EXTINF: typeof EXTINF;
+declare const constants_EXTM3U: typeof EXTM3U;
+declare const constants_EXT_OATCLS_SCTE35: typeof EXT_OATCLS_SCTE35;
+declare const constants_EXT_X_ASSET: typeof EXT_X_ASSET;
+declare const constants_EXT_X_BITRATE: typeof EXT_X_BITRATE;
+declare const constants_EXT_X_BYTERANGE: typeof EXT_X_BYTERANGE;
+declare const constants_EXT_X_CONTENT_STEERING: typeof EXT_X_CONTENT_STEERING;
+declare const constants_EXT_X_CUE: typeof EXT_X_CUE;
+declare const constants_EXT_X_CUE_IN: typeof EXT_X_CUE_IN;
+declare const constants_EXT_X_CUE_OUT: typeof EXT_X_CUE_OUT;
+declare const constants_EXT_X_CUE_OUT_CONT: typeof EXT_X_CUE_OUT_CONT;
+declare const constants_EXT_X_DATERANGE: typeof EXT_X_DATERANGE;
+declare const constants_EXT_X_DEFINE: typeof EXT_X_DEFINE;
+declare const constants_EXT_X_DISCONTINUITY: typeof EXT_X_DISCONTINUITY;
+declare const constants_EXT_X_DISCONTINUITY_SEQUENCE: typeof EXT_X_DISCONTINUITY_SEQUENCE;
+declare const constants_EXT_X_ENDLIST: typeof EXT_X_ENDLIST;
+declare const constants_EXT_X_GAP: typeof EXT_X_GAP;
+declare const constants_EXT_X_INDEPENDENT_SEGMENTS: typeof EXT_X_INDEPENDENT_SEGMENTS;
+declare const constants_EXT_X_I_FRAMES_ONLY: typeof EXT_X_I_FRAMES_ONLY;
+declare const constants_EXT_X_I_FRAME_STREAM_INF: typeof EXT_X_I_FRAME_STREAM_INF;
+declare const constants_EXT_X_KEY: typeof EXT_X_KEY;
+declare const constants_EXT_X_MAP: typeof EXT_X_MAP;
+declare const constants_EXT_X_MEDIA: typeof EXT_X_MEDIA;
+declare const constants_EXT_X_MEDIA_SEQUENCE: typeof EXT_X_MEDIA_SEQUENCE;
+declare const constants_EXT_X_PART: typeof EXT_X_PART;
+declare const constants_EXT_X_PART_INF: typeof EXT_X_PART_INF;
+declare const constants_EXT_X_PLAYLIST_TYPE: typeof EXT_X_PLAYLIST_TYPE;
+declare const constants_EXT_X_PREFETCH: typeof EXT_X_PREFETCH;
+declare const constants_EXT_X_PREFETCH_DISCONTINUITY: typeof EXT_X_PREFETCH_DISCONTINUITY;
+declare const constants_EXT_X_PRELOAD_HINT: typeof EXT_X_PRELOAD_HINT;
+declare const constants_EXT_X_PROGRAM_DATE_TIME: typeof EXT_X_PROGRAM_DATE_TIME;
+declare const constants_EXT_X_RENDITION_REPORT: typeof EXT_X_RENDITION_REPORT;
+declare const constants_EXT_X_SCTE35: typeof EXT_X_SCTE35;
+declare const constants_EXT_X_SERVER_CONTROL: typeof EXT_X_SERVER_CONTROL;
+declare const constants_EXT_X_SESSION_DATA: typeof EXT_X_SESSION_DATA;
+declare const constants_EXT_X_SESSION_KEY: typeof EXT_X_SESSION_KEY;
+declare const constants_EXT_X_SKIP: typeof EXT_X_SKIP;
+declare const constants_EXT_X_START: typeof EXT_X_START;
+declare const constants_EXT_X_STREAM_INF: typeof EXT_X_STREAM_INF;
+declare const constants_EXT_X_TARGETDURATION: typeof EXT_X_TARGETDURATION;
+declare const constants_EXT_X_VERSION: typeof EXT_X_VERSION;
+declare namespace constants {
+  export {
+    constants_EXTINF as EXTINF,
+    constants_EXTM3U as EXTM3U,
+    constants_EXT_OATCLS_SCTE35 as EXT_OATCLS_SCTE35,
+    constants_EXT_X_ASSET as EXT_X_ASSET,
+    constants_EXT_X_BITRATE as EXT_X_BITRATE,
+    constants_EXT_X_BYTERANGE as EXT_X_BYTERANGE,
+    constants_EXT_X_CONTENT_STEERING as EXT_X_CONTENT_STEERING,
+    constants_EXT_X_CUE as EXT_X_CUE,
+    constants_EXT_X_CUE_IN as EXT_X_CUE_IN,
+    constants_EXT_X_CUE_OUT as EXT_X_CUE_OUT,
+    constants_EXT_X_CUE_OUT_CONT as EXT_X_CUE_OUT_CONT,
+    constants_EXT_X_DATERANGE as EXT_X_DATERANGE,
+    constants_EXT_X_DEFINE as EXT_X_DEFINE,
+    constants_EXT_X_DISCONTINUITY as EXT_X_DISCONTINUITY,
+    constants_EXT_X_DISCONTINUITY_SEQUENCE as EXT_X_DISCONTINUITY_SEQUENCE,
+    constants_EXT_X_ENDLIST as EXT_X_ENDLIST,
+    constants_EXT_X_GAP as EXT_X_GAP,
+    constants_EXT_X_INDEPENDENT_SEGMENTS as EXT_X_INDEPENDENT_SEGMENTS,
+    constants_EXT_X_I_FRAMES_ONLY as EXT_X_I_FRAMES_ONLY,
+    constants_EXT_X_I_FRAME_STREAM_INF as EXT_X_I_FRAME_STREAM_INF,
+    constants_EXT_X_KEY as EXT_X_KEY,
+    constants_EXT_X_MAP as EXT_X_MAP,
+    constants_EXT_X_MEDIA as EXT_X_MEDIA,
+    constants_EXT_X_MEDIA_SEQUENCE as EXT_X_MEDIA_SEQUENCE,
+    constants_EXT_X_PART as EXT_X_PART,
+    constants_EXT_X_PART_INF as EXT_X_PART_INF,
+    constants_EXT_X_PLAYLIST_TYPE as EXT_X_PLAYLIST_TYPE,
+    constants_EXT_X_PREFETCH as EXT_X_PREFETCH,
+    constants_EXT_X_PREFETCH_DISCONTINUITY as EXT_X_PREFETCH_DISCONTINUITY,
+    constants_EXT_X_PRELOAD_HINT as EXT_X_PRELOAD_HINT,
+    constants_EXT_X_PROGRAM_DATE_TIME as EXT_X_PROGRAM_DATE_TIME,
+    constants_EXT_X_RENDITION_REPORT as EXT_X_RENDITION_REPORT,
+    constants_EXT_X_SCTE35 as EXT_X_SCTE35,
+    constants_EXT_X_SERVER_CONTROL as EXT_X_SERVER_CONTROL,
+    constants_EXT_X_SESSION_DATA as EXT_X_SESSION_DATA,
+    constants_EXT_X_SESSION_KEY as EXT_X_SESSION_KEY,
+    constants_EXT_X_SKIP as EXT_X_SKIP,
+    constants_EXT_X_START as EXT_X_START,
+    constants_EXT_X_STREAM_INF as EXT_X_STREAM_INF,
+    constants_EXT_X_TARGETDURATION as EXT_X_TARGETDURATION,
+    constants_EXT_X_VERSION as EXT_X_VERSION,
+  };
+}
+
+export { InvalidPlaylistError, constants as TAGS, parse as default, isMasterPlaylist, isMediaPlaylist, parse, resolveUrl };
+export type { AllowedCpc, Byterange, ContentSteering, DateRange, ExtInfo, Key, LowLatencyCompatibility, MasterPlaylist, MediaInitializationSection, MediaPlaylist, ParseOptions, PartialSegment, Playlist, PrefetchSegment, Rendition, RenditionReport, Resolution, Segment, SessionData, SpliceInfo, StartData, UserAttribute, Variant };