video-fps-probe 0.3.0 → 0.4.0-beta.2

package/dist/cjs/client/types.d.cts

@@ -0,0 +1,96 @@
+import type { Agreement } from '../api/agreement.cjs';
+import type { ProbeError } from '../api/errors.cjs';
+import type { AnalyzeProgress, EngineId, FileResult } from '../core/types.cjs';
+import type { MediabunnyNative, Mp4boxNative, RvfcDetails } from '../engines/types.cjs';
+import type { ContainerFamily, EngineDescriptor, WorkerEngineId } from '../plugins/types.cjs';
+import type { WireOptions } from '../worker/protocol.cjs';
+export type IdOf<E> = E extends EngineDescriptor<infer I> ? I : never;
+export interface BaseOptions<Id extends EngineId> {
+    engine?: Id;
+    fallback?: readonly Id[];
+    workers?: number;
+    idleTimeoutMs?: number;
+    timeoutMs?: number;
+    defaults?: WireOptions;
+}
+export interface ProbeOptions<E extends readonly EngineDescriptor[] = []> extends BaseOptions<NoInfer<'own' | IdOf<E[number]>>> {
+    engines?: E;
+    worker?: 'auto' | 'inline';
+}
+export interface CustomWorker<W extends WorkerEngineId> {
+    create: () => Worker;
+    engines: readonly W[];
+    byContainer?: Readonly<Partial<Record<ContainerFamily, () => Worker>>>;
+}
+export interface ClientOptions<E extends readonly EngineDescriptor[] = [], W extends WorkerEngineId = never> extends BaseOptions<NoInfer<W | IdOf<E[number]> | 'own'>> {
+    worker: CustomWorker<W> | 'inline';
+    engines?: E;
+}
+export interface CallOptions<Id extends EngineId> extends WireOptions {
+    engine?: Id;
+    fallback?: readonly Id[];
+    name?: string;
+    host?: HTMLElement;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    onProgress?: (progress: AnalyzeProgress) => void;
+}
+export interface Attempt {
+    engine: EngineId;
+    error: string;
+}
+export type ProbeResult = FileResult & {
+    mp4box?: Mp4boxNative;
+    mediabunny?: MediabunnyNative;
+    rvfc?: RvfcDetails;
+    attempts?: readonly Attempt[];
+};
+export interface PrewarmOptions<Id extends EngineId> {
+    engines?: readonly Id[];
+    containers?: readonly ContainerFamily[];
+}
+export interface CompareOptions<K extends EngineId> {
+    engines?: readonly K[];
+    reference?: K;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    onProgress?: (progress: AnalyzeProgress & {
+        engine: K;
+    }) => void;
+}
+export type EngineOutcome = {
+    status: 'ok';
+    result: ProbeResult;
+    ms: number;
+} | {
+    status: 'failed';
+    result: ProbeResult;
+    error: string;
+    ms: number;
+} | {
+    status: 'skipped';
+    reason: 'unsupported-container' | 'unsupported-environment';
+} | {
+    status: 'timeout' | 'crashed';
+    error: ProbeError;
+};
+export interface CompareResult<K extends EngineId> {
+    name: string;
+    size: number;
+    reference: K | null;
+    outcomes: Partial<Record<K, EngineOutcome>>;
+    agreement: Agreement<K>;
+}
+export interface Probe<Id extends EngineId = 'own'> {
+    readonly engines: readonly Id[];
+    analyze(file: Blob, options?: CallOptions<Id>): Promise<ProbeResult>;
+    tryAnalyze(file: Blob, options?: CallOptions<Id>): Promise<ProbeResult | null>;
+    compare<K extends Id>(file: Blob, options?: CompareOptions<K>): Promise<CompareResult<K>>;
+    prewarm(options?: PrewarmOptions<Id>): Promise<void>;
+    dispose(): void;
+    destroy(): void;
+}
+export type LazyProbe<Id extends EngineId> = Probe<Id> & {
+    readonly loaded: boolean;
+    load(): Promise<Probe<Id>>;
+};

package/dist/cjs/color/index.d.cts

@@ -0,0 +1,7 @@
+import type { ColorInfo, FileResult, VideoTrackResult } from '../core/types.cjs';
+export type { CodecConfig, ColorInfo, ColorSource, DolbyVisionConfig } from '../core/types.cjs';
+export type ColorTrack = Pick<VideoTrackResult, 'codecName' | 'codecConfig'>;
+export declare function colorOf(track: ColorTrack): ColorInfo | null | undefined;
+export declare function withColor<R extends Pick<FileResult, 'videoTracks'>>(result: R, options?: {
+    keepCodecConfig?: boolean;
+}): R;

package/dist/cjs/color.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/color-xqJHSfhZ.cjs");exports.colorOf=e.r,exports.withColor=e.i;

package/dist/cjs/core/reader.d.cts

@@ -0,0 +1,47 @@
+import type { FileErrorCode } from './types.cjs';
+export interface BlobSlice {
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface BlobLike {
+    readonly size: number;
+    slice(start?: number, end?: number): BlobSlice;
+}
+export interface BlobReaderOptions {
+    headWindow?: number;
+    maxWindows?: number;
+    signal?: AbortSignal | null;
+}
+export declare const DEFAULT_HEAD_WINDOW: number;
+export declare const DEFAULT_MAX_WINDOWS = 4;
+export declare const MAX_SAFE_OFFSET: number;
+export declare function toSafeNumber(value: bigint, what?: string): number;
+export declare class BlobReader {
+    #private;
+    readonly size: number;
+    readonly headWindow: number;
+    readonly maxWindows: number;
+    readonly signal: AbortSignal | null;
+    constructor(source: BlobLike, options?: BlobReaderOptions);
+    get reads(): number;
+    get bytesFetched(): number;
+    checkAbort(): void;
+    read(offset: number, length: number): Promise<Uint8Array>;
+    readMany(ranges: ReadonlyArray<readonly [offset: number, length: number]>, concurrency?: number): Promise<Uint8Array[]>;
+    peek(offset: number, length: number): DataView | null;
+    view(offset: number, length: number, readAhead?: number): Promise<DataView>;
+    bytes(offset: number, length: number, readAhead?: number): Promise<Uint8Array>;
+}
+export declare function u8(dv: DataView, p: number): number;
+export declare function u16(dv: DataView, p: number): number;
+export declare function i16(dv: DataView, p: number): number;
+export declare function u24(dv: DataView, p: number): number;
+export declare function u32(dv: DataView, p: number): number;
+export declare function i32(dv: DataView, p: number): number;
+export declare function u64(dv: DataView, p: number): number;
+export declare function i64(dv: DataView, p: number): number;
+export declare function u64Big(dv: DataView, p: number): bigint;
+export declare function fixed16_16(dv: DataView, p: number): number;
+export declare function ascii(dv: DataView, p: number, length: number): string;
+export declare function fourcc(dv: DataView, p: number): string;
+export declare function withErrorCode(code: FileErrorCode, message: string): Error;
+export declare function whichErrorCode(e: unknown, fallback?: FileErrorCode): FileErrorCode;

package/dist/cjs/core/types.d.cts

@@ -0,0 +1,194 @@
+import type { BlobReader } from './reader.cjs';
+export type Provenance = 'header' | 'exact' | 'sampled' | 'estimated' | 'computed';
+export interface Rational {
+    num: number;
+    den: number;
+    value: number;
+}
+export type NominalKind = 'exact' | 'snapped' | 'declared';
+export interface NominalFps extends Rational {
+    kind: NominalKind;
+}
+export interface DominantFps {
+    rate: Rational;
+    share: number;
+}
+export type ContainerKind = 'mp4' | 'mov' | 'webm' | 'matroska' | 'unknown';
+export type EngineId = 'own' | 'mediabunny' | 'mp4box' | 'rvfc';
+export type MatroskaMode = 'header' | 'probe' | 'exact' | 'auto';
+export type ScanDepth = 'header' | 'probe' | 'exact';
+export type TrackField = 'codec' | 'dimensions' | 'rotation' | 'frames' | 'presentedFrames' | 'durationSec' | 'startSec' | 'avgFps' | 'nominalFps' | 'dominantFps' | 'minFps' | 'maxFps' | 'isVfr' | 'duplicateTimestamps' | 'medianFrameInterval';
+export type RateSegmentKind = 'steady' | 'variable';
+export interface RateSegment {
+    startSec: number;
+    endSec: number;
+    frames: number;
+    fps: number;
+    kind: RateSegmentKind;
+}
+export type RateAnomalyKind = 'rate-change' | 'freeze' | 'burst' | 'gap';
+export interface RateAnomaly {
+    kind: RateAnomalyKind;
+    atSec: number;
+    durationSec: number;
+    fromFps: number;
+    toFps: number;
+}
+export interface RateBuckets {
+    bucketSec: number;
+    fps: number[];
+}
+export interface RateProfile {
+    segments: RateSegment[];
+    moreSegments: number;
+    anomalies: RateAnomaly[];
+    moreAnomalies: number;
+    buckets: RateBuckets;
+    uneven: boolean;
+    dominantShare: number;
+    summary: string;
+}
+export interface VideoTrackResult {
+    trackId: number;
+    fourccOrCodecId: string;
+    codecName: string;
+    width: number;
+    height: number;
+    rotation: number;
+    timescale: number;
+    frames: number | null;
+    presentedFrames: number | null;
+    durationSec: number | null;
+    startSec: number | null;
+    avgFps: Rational | null;
+    avgFpsFfprobe: string | null;
+    rFpsFfprobe: string | null;
+    nominalFps: NominalFps | null;
+    dominantFps: DominantFps | null;
+    minFps: Rational | null;
+    maxFps: Rational | null;
+    isVfr: boolean | null;
+    vfrRatio: number;
+    distinctDeltas: number;
+    duplicateTimestamps: number;
+    timestampsQuantized: boolean;
+    isStill: boolean;
+    rateProfile?: RateProfile | null;
+    medianFrameInterval?: Rational | null;
+    enabled?: boolean;
+    codecConfig?: CodecConfig;
+    color?: ColorInfo | null;
+    sampleAspectRatio?: Rational | null;
+    displayAspectRatio?: Rational | null;
+    displayWidth?: number | null;
+    displayHeight?: number | null;
+    provenance: Partial<Record<TrackField, Provenance>>;
+    warnings: string[];
+}
+export type CodecConfig = {
+    family: 'isobmff';
+    stsd: Uint8Array | null;
+    tkhd: Uint8Array | null;
+    mvhd: Uint8Array | null;
+} | {
+    family: 'isobmff-moov';
+    moov: DataView;
+    trak: number;
+} | {
+    family: 'matroska';
+    trackEntry: Uint8Array | null;
+};
+export type ColorSource = 'sps' | 'colr' | 'vpcC' | 'Colour';
+export interface DolbyVisionConfig {
+    versionMajor: number;
+    versionMinor: number;
+    profile: number;
+    level: number;
+    rpu: boolean;
+    el: boolean;
+    bl: boolean;
+    compatibilityId: number;
+    mdCompression: number;
+}
+export interface ColorInfo {
+    range: 'tv' | 'pc' | null;
+    primaries: string | null;
+    transfer: string | null;
+    space: string | null;
+    source: ColorSource | null;
+    bitDepth: number | null;
+    profile: number | null;
+    codecString: string | null;
+    hdr: 'pq' | 'hlg' | null;
+    dolbyVision: DolbyVisionConfig | null;
+}
+export interface IoStats {
+    reads: number;
+    bytesRead: number;
+    ms: number;
+}
+export type FileErrorCode = 'empty-file' | 'unrecognised' | 'unsupported-container' | 'unsupported' | 'too-large' | 'no-header' | 'truncated' | 'corrupt' | 'no-duration' | 'byte-limit' | 'read-limit' | 'time-limit' | 'structure-limit' | 'read-failed' | 'load-failed' | 'engine-failed' | 'internal';
+export type LayoutKind = 'faststart' | 'moov-at-end' | 'fragmented';
+export interface ContainerLayout {
+    kind: LayoutKind;
+    moovOffset: number | null;
+    moovSize: number | null;
+    sidx: boolean;
+    emptyMoov: boolean;
+}
+export type WarningCode = 'invalid-timescale' | 'truncated-mdat' | 'truncated-box' | 'trailing-data' | 'fragment-index-unread' | 'duration-unresolved' | 'fragments-ignored' | 'structure-limit' | 'codec-config-unavailable' | 'metadata-unavailable';
+export interface FileResult {
+    name: string;
+    size: number;
+    container: ContainerKind;
+    brand: string | null;
+    formatDurationSec: number | null;
+    scan: ScanDepth | null;
+    videoTracks: VideoTrackResult[];
+    audioTrackCount: number;
+    primaryTrackId: number | null;
+    error: string | null;
+    errorCode?: FileErrorCode | null;
+    layout?: ContainerLayout | null;
+    warnings: string[];
+    io: IoStats;
+    engine: EngineId;
+}
+export type ContainerAnalysis = Omit<FileResult, 'name' | 'size' | 'io' | 'engine'>;
+export interface ReadAheadSizes {
+    head: number;
+    fragment: number;
+    matroskaScan: number;
+    tail: number;
+}
+export interface CostModel {
+    perReadMs: number;
+    bytesPerMs: number;
+    perBlockMs: number;
+}
+export interface AnalyzeProgress {
+    phase: string;
+    done: number;
+    total: number;
+}
+export interface AnalyzeOptions {
+    signal?: AbortSignal | null;
+    matroskaMode?: MatroskaMode;
+    exactBudgetMs?: number;
+    readAhead?: Partial<ReadAheadSizes>;
+    costModel?: Partial<CostModel>;
+    maxExpandedSamples?: number;
+    onProgress?: ((progress: AnalyzeProgress) => void) | null;
+    codecConfig?: boolean;
+}
+export interface ResolvedAnalyzeOptions {
+    signal: AbortSignal | null;
+    matroskaMode: MatroskaMode;
+    exactBudgetMs: number;
+    readAhead: ReadAheadSizes;
+    costModel: CostModel;
+    maxExpandedSamples: number;
+    onProgress: ((progress: AnalyzeProgress) => void) | null;
+    codecConfig?: boolean;
+}
+export type ContainerAnalyzer = (reader: BlobReader, opts: ResolvedAnalyzeOptions) => Promise<ContainerAnalysis>;

package/dist/cjs/engines/types.d.cts

@@ -0,0 +1,69 @@
+import type { FileResult } from '../core/types.cjs';
+export interface Mp4boxTrackNative {
+    trackId: number;
+    sampleCount: number;
+    sttsLastDelta: number | null;
+    lastSampleDuration: number | null;
+    lastDurationOverridden: boolean;
+    fpsFromSampleDurations: number | null;
+    fpsFromMdhdDuration: number | null;
+    fpsFromMovieDuration: number | null;
+}
+export interface Mp4boxNative {
+    version: string;
+    fedBuffers: number;
+    fedBytes: number;
+    moofsFed: number;
+    tracks: Mp4boxTrackNative[];
+}
+export type Mp4boxResult = FileResult & {
+    mp4box?: Mp4boxNative;
+};
+export interface MediabunnyTrackNative {
+    trackId: number;
+    packetCount: number;
+    averagePacketRate: number | null;
+    nativeCallSkipped: boolean;
+    timeResolution: number;
+    fpsFromTimestamps: number | null;
+}
+export interface MediabunnyNative {
+    version: string;
+    formatName: string;
+    tracks: MediabunnyTrackNative[];
+    nativeStatsMs: number;
+}
+export type MediabunnyResult = FileResult & {
+    mediabunny?: MediabunnyNative;
+};
+export interface RvfcPass {
+    rate: number;
+    callbacks: number;
+    fps: number;
+    avg: number;
+    pairs: number;
+    spread: number;
+    lo: number;
+    hi: number;
+}
+export type RvfcConfidence = 'high' | 'medium' | 'low';
+export interface RvfcDetails {
+    displayHz: number;
+    rate: number;
+    passes: RvfcPass[];
+    confidence: RvfcConfidence;
+    flags: string[];
+}
+export interface RvfcOptions {
+    host: HTMLElement;
+    name?: string;
+    signal?: AbortSignal;
+    onProgress?: (p: {
+        phase: string;
+        done: number;
+        total: number;
+    }) => void;
+}
+export type RvfcResult = FileResult & {
+    rvfc?: RvfcDetails;
+};

package/dist/cjs/header/index.d.cts

@@ -0,0 +1,28 @@
+import { type BlobLike } from '../core/reader.cjs';
+import type { FileResult, IoStats } from '../core/types.cjs';
+import { type HeaderLimits } from './limits.cjs';
+export { errorClass, errorCodeOf, warningCodeOf, warningCodesOf, type ErrorClass } from '../api/codes.cjs';
+export { isAbortError, isTimeoutError } from '../api/guards.cjs';
+export { HEADER_DEFAULT_LIMITS, type HeaderLimits } from './limits.cjs';
+export type { BlobLike, BlobSlice } from '../core/reader.cjs';
+export type * from '../core/types.cjs';
+export type FragmentedDuration = 'header' | 'index';
+export interface HeaderOptions {
+    name?: string;
+    signal?: AbortSignal | null;
+    limits?: HeaderLimits;
+    readAhead?: {
+        head?: number;
+        tail?: number;
+    };
+    fragmentedDuration?: FragmentedDuration;
+    codecConfig?: boolean;
+    color?: boolean;
+    aspect?: boolean;
+}
+export type HeaderResult = FileResult & {
+    io: IoStats & {
+        bytesRequested: number;
+    };
+};
+export declare function analyzeHeader(source: Blob | BlobLike, options?: HeaderOptions): Promise<HeaderResult>;

package/dist/cjs/header/limits.d.cts

@@ -0,0 +1,26 @@
+import type { BlobLike, BlobSlice } from '../core/reader.cjs';
+export interface HeaderLimits {
+    maxBytes?: number;
+    maxReads?: number;
+    maxMs?: number;
+    maxTracks?: number;
+    maxTopLevelBoxes?: number;
+}
+export declare const HEADER_DEFAULT_LIMITS: Readonly<Required<HeaderLimits>>;
+export type LimitCode = 'byte-limit' | 'read-limit' | 'time-limit' | 'structure-limit';
+export declare class LimitError extends Error {
+    readonly errorCode: LimitCode;
+    constructor(code: LimitCode, message: string);
+}
+export declare class LimitedSource implements BlobLike {
+    #private;
+    readonly size: number;
+    constructor(inner: BlobLike, size: number, limits: Required<Pick<HeaderLimits, 'maxBytes' | 'maxReads' | 'maxMs'>>, caller: AbortSignal | null);
+    get bytesLeft(): number;
+    get bytesRequested(): number;
+    checkTime(): void;
+    take(): LimitError | null;
+    race<T>(pending: Promise<T>): Promise<T>;
+    slice(start?: number, end?: number): BlobSlice;
+    dispose(): void;
+}

package/dist/cjs/header.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/guards-DbQNcAZS.cjs"),t=require("./chunks/reader-Dw11ozVU.cjs"),n=require("./chunks/options-B_vLHxHd.cjs"),r=require("./chunks/boxes-B0T2nt3e.cjs"),i=require("./chunks/build-DhETwJLO.cjs"),a=require("./chunks/sniff-CXwqOGwh.cjs"),o=67108864,s=new Set([`sidx`,`styp`,`prft`,`emsg`]);function count$1(e){if(++e.boxes>e.plan.maxTopLevelBoxes)throw new r.t(`structure-limit`,`limit reached: maxTopLevelBoxes ${e.plan.maxTopLevelBoxes}`)}function visit(e){e.budget.checkTime(),count$1(e)}function ahead(e,t,n){return Math.max(0,Math.min(n,e.budget.bytesLeft,e.reader.size-t))}async function peekAt(e,t,n){let r=Math.min(16,e.reader.size-t);return e.reader.peek(t,r)??e.reader.view(t,r,ahead(e,t,n))}function countTracks(e,t){let n;try{n=r.o(e,0,e.byteLength)}catch{return}if(!n)return;let i=0;for(let a=n.start+n.headerSize;a+8<=n.end;){let o;try{o=r.o(e,a,n.end)}catch{return}if(!o)return;if(o.type===`trak`&&++i>t)throw new r.t(`structure-limit`,`limit reached: maxTracks ${t}`);a=o.start+o.size}}function mehdDuration(e){let t;try{t=r.o(e,0,e.byteLength)}catch{return null}if(!t)return null;for(let n of r.a(e,t.start+t.headerSize,t.end))if(n.type===`mvex`)for(let t of r.a(e,n.start+n.headerSize,n.end)){let n=t.start+t.headerSize;if(t.type!==`mehd`||n+8>t.end)continue;if(e.getUint8(n)===1){if(n+12>t.end)return null;let r=e.getBigUint64(n+4);return r===0n||r>BigInt(2**53-1)?null:Number(r)}let r=e.getUint32(n+4);return r===0||r===4294967295?null:r}return null}async function readHeaderMoov(e,t){let n=e.reader.size,a=t.start+t.size>n;if(e.movie.moov=[t.start,t.size],!a&&t.size>268435456)throw new r.t(`too-large`,`unsupported: moov larger than 256 MiB`);let o=await e.reader.view(t.start,a?Math.min(n-t.start,i.r):t.size,a?0:ahead(e,t.start,t.size+32));return countTracks(o,e.plan.maxTracks),await i.f(e.reader,t,e.movie),o}async function walkTop(e){let{reader:n,movie:a}=e,o=n.size,c=0,l=null,u=!1,d=0,f=!1,walked=(e,t=null)=>({moov:l,fragments:a.hasMvex&&(e!==null||t!==null),firstMoof:e,run:e?e.start-d:0,limit:t});try{for(;c+8<=o;){let p=l!==null&&!a.hasMvex,m;if(p){if(m=n.peek(c,Math.min(16,o-c)),!m){if(f)break;f=!0;try{m=await peekAt(e,c,e.plan.head)}catch(t){if(i.c(t,n))throw t;let r=e.budget.take();if(r)throw r;a.warnings.push(`fragments ignored: read at ${c} after a moov without an mvex failed: ${t.message}`);break}}if(++e.boxes>e.plan.maxTopLevelBoxes){a.warnings.push(`too many top-level boxes`);break}}else visit(e),m=await peekAt(e,c,u&&!l?e.plan.tail:e.plan.head);let h;try{h=r.o(m,0,o-c,c)}catch(e){if(!l)throw e;a.warnings.push(`ignored trailing data at ${c}: ${e.message}`);break}if(!h)break;let g={...h,start:c,end:Math.min(c+h.size,o)},_=h.truncated&&l!==null&&g.type!==`mdat`&&g.type!==`moof`;h.truncated&&(a.truncated=!0,a.warnings.push(_?`ignored trailing data at ${c}: not a box`:`'${g.type}' at ${c} is truncated`));let v={type:g.type,start:c,end:g.end,sidx:null};if(a.topLevel.push(v),p&&g.type===`moof`&&a.warnings.push(`fragments ignored: moof at ${c} after a moov without an mvex`),_||p&&g.type===`moof`||l&&g.type===`mfra`)break;if(l&&g.type===`moof`)return walked(g);if(g.type===`ftyp`&&!p){let r=await n.view(c,Math.min(g.size,1024),ahead(e,c,e.plan.head)),i=g.headerSize;if(i+4<=r.byteLength){a.hasFtyp=!0,a.brand=t.n(r,i);for(let e=i+8;e+4<=r.byteLength;e+=4)a.compatibleBrands.push(t.n(r,e))}}else if(g.type===`moov`)l?a.warnings.push(`ignored a second moov at ${c}`):l=await readHeaderMoov(e,g);else if(g.type===`moof`)throw new r.t(`corrupt`,`corrupt file: movie fragment (moof) before moov`);else if(g.type===`sidx`&&!h.truncated){let t=p?n.peek(c,g.size):await n.view(c,g.size,ahead(e,c,e.plan.head)),a=t&&r.o(t,0,t.byteLength);a&&(v.sidx=i.S(t,a,c))}s.has(g.type)||(d=c+h.size),u=g.type===`mdat`,c+=h.size}}catch(t){if(!l||i.c(t,n))throw t;let r=e.budget.take()??(isLimit(t)?t:null);if(!r)throw t;return walked(null,r)}if(!l)throw new r.t(`no-header`,`incomplete file: no moov`);return walked(null)}async function readTailIndex(e){let{reader:n}=e,a=n.size,o=Math.min(a,65536);if(o<16)return null;let s=n.peek(a-o,o)??await n.view(a-o,o,0);if(t.n(s,o-12)!==`mfro`)return null;let c=s.getUint32(o-4);if(c<24||c>Math.min(a,16777216))return null;let l=c<=o?new DataView(s.buffer,s.byteOffset+o-c,c):await n.view(a-c,c,0),u;try{u=r.o(l,0,c)}catch{return null}if(!u||u.type!==`mfra`)return null;let d=new Map;for(let e of r.a(l,u.headerSize,u.end)){let t=e.start+e.headerSize;if(e.type!==`tfra`||t+8>e.end)continue;let n=l.getUint32(t+4),r=d.get(n)??new Set;i.y(l,e.start,e.end,r,a-c),r.size>0&&d.set(n,r)}return{mfraSize:c,offsets:d}}function parseFragment(e,t,a,o){let s=r.o(t,0,t.byteLength);s&&i.x(t,s,a,e.movie.moofCount,e.movie,n.r),e.movie.moofCount++,o.add(a)}async function walkFragments(e,t,n,a){let s=t;for(;s+8<=n;){visit(e);let t=await peekAt(e,s,e.plan.head),c;try{c=r.o(t,0,n-s,s)}catch{return!1}if(!c||c.truncated)return!1;if(c.type===`mfra`)return!0;if(c.type===`moof`&&!a.has(s)){if(c.size>o)throw new r.t(`too-large`,`corrupt file: moof larger than 64 MiB at ${s}`);parseFragment(e,await e.reader.view(s,c.size,ahead(e,s,e.plan.head)),s,a)}else c.type===`sidx`&&e.movie.topLevel.push({type:`sidx`,start:s,end:s+c.size,sidx:i.S(await e.reader.view(s,c.size,ahead(e,s,e.plan.head)),c,s)});s+=c.size}return!0}function runTo(e,t,n){let a=[];try{for(let o=t;o<e.byteLength;){let t=r.o(e,o,e.byteLength);if(!t||t.truncated||!s.has(t.type))return null;a.push({type:t.type,start:n+o,end:n+t.end,sidx:t.type===`sidx`?i.S(e,t,n+o):null}),o=t.end}}catch{return null}return a}async function preRun(e,t,n,r){let i=Math.max(r,t-Math.max(n,4096));if(t-i<8)return t;let a=await e.reader.view(i,t-i,ahead(e,i,e.plan.head));for(let t=0;t+8<=a.byteLength;t++){let n=a.getUint32(t+4)===1936286840?runTo(a,t,i):null;if(n){for(let t of n)count$1(e),e.movie.topLevel.push(t);return i+t}}return t}function lastSidx(e,t,n){let r=null;for(let i of e.topLevel){let e=i.sidx;e&&(!r||i.start>r.start)&&!e.hierarchical&&e.referenceId===t.id&&e.timescale===t.timescale&&(!n||n.includes(e.coverageEnd))&&(r=i)}return r}function timingOf(e,t,n){let r={...e,fragments:n},a=i._(r);return i.v(r,t,a,i.h(r,t.timescale,a))}function hasFragmentData(e,t,n){return t.trex.has(e.id)||(n?.offsets.has(e.id)??!1)||t.topLevel.some(t=>t.sidx?.referenceId===e.id)}function stillFragmented(e,t,n,r,a){if(!a)return!1;let o=i._({...e,fragments:[]}).moovSamples;for(let t of e.fragments)o+=t.count;if(o>1)return!1;for(let t of n?.offsets.get(e.id)??[])if(!r.has(t))return!1;for(let n of t.topLevel)if(n.sidx?.referenceId===e.id&&n.sidx.subsegments.some(([e])=>!r.has(e)))return!1;let s=e.fragments[0],c=t.trex.get(e.id)?.duration||(s?s.durations?.[0]??s.defaultDuration:0);return c>0&&a.ticks*e.timescale<=c*a.timescale}function fragmentedPrimary(e){let t=null,rank=e=>e.auxiliary?.5:e.enabled?2:1,area=e=>e.result.width*e.result.height;for(let n of e)t?rank(n)===rank(t)?n.result.isStill===t.result.isStill?area(n)===area(t)?n.result.trackId<t.result.trackId&&(t=n):t=area(n)>area(t)?n:t:t=t.result.isStill?n:t:t=rank(n)>rank(t)?n:t:t=n;return t?t.result.trackId:null}function headerTrack(e){e.presentedFrames=null,delete e.provenance.presentedFrames}function isLimit(e){let t=e?.errorCode;return typeof t==`string`&&t.endsWith(`-limit`)}function cachedBox(e,t){let n=e.size,i=t+8<=n?e.peek(t,Math.min(16,n-t)):null;try{let e=i&&r.o(i,0,n-t,t);return e&&!e.truncated?e:null}catch{return null}}function onlyFragment(e,t){let n=t.start+t.size,r=cachedBox(e,n);if(n===e.size)return!0;if(r?.type!==`mdat`)return!1;let i=n+r.size,a=cachedBox(e,i);return i===e.size||a?.type===`mfra`&&i+a.size===e.size}function lastOffset(e){let t=null;for(let n of e??[])(t===null||n>t)&&(t=n);return t}async function resolveFragmented(e,n,a,s,c){let{reader:l,plan:u,movie:d}=e,f=l.size,isMain=e=>a.includes(e)||e.handler===`soun`,p=d.tracks.filter(e=>isMain(e)||e.hasMdhd),m=new Map,h=new Map,g=new Set,_=new Set,v=new Map,y=n.firstMoof,b=null,x=n.limit,S=!1,C=f,open=()=>p.filter(e=>!m.has(e)&&(a.includes(e)||hasFragmentData(e,d,b))),settle=(e,t,n,r=m)=>{let i=lastSidx(d,e,t)?.sidx,a=i?i.earliestPts+i.durationSum:0,o=timingOf(e,d,n).durationTs;(t?!i:!S&&i&&i.start<C&&i.coverageEnd<=C&&a<o)||r.set(e,{ticks:Math.max(o,a),timescale:e.timescale,provenance:`header`})},bySidx=e=>{let t=open(),n=t.filter(t=>lastSidx(d,t,e)!==null);g.clear();for(let r of t)n.includes(r)?settle(r,e,r.fragments,n.length===t.length?m:h):g.add(r)};try{let t=y?l.peek(y.start,y.size)===null:!1;if(y&&!x&&(u.index||!t||open().some(e=>lastSidx(d,e,[f])!==null))){if(y.size>o)throw new r.t(`too-large`,`corrupt file: moof larger than 64 MiB at ${y.start}`);if(parseFragment(e,l.peek(y.start,y.size)??await l.view(y.start,y.size,ahead(e,y.start,u.head)),y.start,_),S=onlyFragment(l,y),S)for(let e of open())settle(e,null,e.fragments);else bySidx([f])}for(let e of p)v.set(e,e.fragments.length);if(u.index&&!x&&open().length>0&&(b=await readTailIndex(e),b)){let t=f-b.mfraSize;bySidx([f,t]),C=t;let r=!0;for(let t of[!0,!1]){let i=null;for(let e of open()){let n=isMain(e)===t?lastOffset(b.offsets.get(e.id)):null;n!==null&&n<C&&(i===null||n<i)&&(i=n)}if(i===null)continue;let a=p.map(e=>e.fragments.length),o=t&&y?await preRun(e,i,n.run,y.start+y.size):i;r=await walkFragments(e,i,C,_)&&r,p.forEach((e,t)=>{let n=e.fragments,r=v.get(e)??0;e.fragments=[...n.slice(0,r),...n.slice(a[t]),...n.slice(r,a[t])]}),C=o,S=r&&y!==null&&i<=y.start;for(let e of open()){let t=e.fragments.slice(v.get(e));(S||t.length>0&&t[0].baseDts!==null)&&settle(e,null,e.fragments)}}}}catch(t){if(i.c(t,l)||(x=e.budget.take()??(isLimit(t)?t:null),!x))throw t;for(let e of p)e.fragments.length=v.get(e)??0}let w=n.moov?mehdDuration(n.moov):null,T=open().length>0?x:null,E=[...h.keys()].filter(e=>!m.has(e));for(let e of E)m.set(e,h.get(e));for(let e of open())w!==null&&m.set(e,{ticks:w,timescale:d.timescale,provenance:`estimated`});for(let e of p)!m.has(e)&&!a.includes(e)&&!hasFragmentData(e,d,b)&&m.set(e,{ticks:timingOf(e,d,[]).durationTs,timescale:e.timescale,provenance:`header`});a.forEach((e,t)=>{let n=s[t].result,r=m.get(e)??null,i=n.provenance;n.frames=null,n.avgFps=null,n.avgFpsFfprobe=null,n.startSec=null,n.durationSec=r?r.ticks/r.timescale:null,n.isStill=stillFragmented(e,d,b,_,r),delete i.frames,delete i.avgFps,delete i.startSec,r?i.durationSec=r.provenance:delete i.durationSec});let D=open(),O=a.length>0?!a.some(e=>m.has(e)):![...m.keys()].some(isMain)&&D.some(isMain);T&&!O&&c.warnings.push(`fragment index not read: ${T.message}`);let k=[...m].some(([e,t])=>isMain(e)&&e.hasMdhd&&t.provenance===`estimated`),loose=e=>!k&&!isMain(e)&&p.some(e=>isMain(e)&&e.hasMdhd),A=D.filter(loose),j=D.filter(e=>!loose(e)),M=[],N=2**53-1,P={start:N,end:-N,dur:-N},F={...P},I=!0,L=0;for(let[e,t]of m){if(!e.hasMdhd)continue;let n=timingOf(e,d,S?e.fragments:e.fragments.slice(0,v.get(e)??0)).startPts,r=t.provenance!==`estimated`,a=n!==null||S||!hasFragmentData(e,d,b);if(loose(e)&&!(r&&a)){A.push(e);continue}L++;let o=isMain(e)?P:F,s=i.g(t.ticks,1e6,t.timescale);if(o.dur=Math.max(o.dur,s),!r)I=!1;else if(n!==null){let t=i.g(n,1e6,e.timescale);o.start=Math.min(o.start,t),o.end=Math.max(o.end,t+s)}else a||M.push(e)}(P.start===N||P.start>F.start&&P.start-F.start<1e6)&&(P.start=F.start),(P.end===-N||P.end<F.end&&F.end-P.end<1e6)&&(P.end=F.end);let R=P.dur===-N||P.dur<F.dur&&F.dur-P.dur<1e6?F.dur:P.dur;I&&P.start!==N&&P.end!==-N&&P.end>=P.start&&(R=Math.max(R,P.end-P.start)),(!I||L<2)&&(M.length=0);let z=E.length>0?[...g].filter(e=>m.get(e)?.provenance!==`header`):[];E.length>0&&z.length===0&&z.push(...E);let B=new Set([...j,...M,...A,...z]);if(!O)for(let e of p)B.has(e)&&c.warnings.push(`format duration unresolved: track ${e.id}`);if(c.formatDurationSec=j.length+M.length+z.length===0&&R>0?R/1e6:null,c.primaryTrackId=fragmentedPrimary(s),O){let e=x??new r.t(`no-duration`,`incomplete header: fragmented file without a sidx, mfra or mehd duration`);c.error=e.message,c.errorCode=t.i(e)}}function collapse(e){let t=new Map;for(let n of e)t.set(n,(t.get(n)??0)+1);if(t.size!==e.length){e.length=0;for(let[n,r]of t)e.push(r>1?`${n} (${r} times)`:n)}}let c,l;function loadCapture(){return l??=Promise.resolve().then(()=>require("./chunks/config-CSbXzEqr.cjs")).then(e=>c=e,e=>{throw l=void 0,e}),l}async function analyzeIsoBmffHeader(n,r,a){let o=i.b(n.size),s={reader:n,budget:r,plan:a,movie:o,boxes:0},l=e.c(`mp4`);l.scan=`header`,l.warnings=o.warnings,l.errorCode=null;try{let e=await walkTop(s);l.container=i.a(o),l.brand=o.brand;let u=o.ffprobeReject,d=u!==null&&u.moof<o.ffprobeMoofLimit;d&&o.warnings.push(`ffprobe 8.1.1 ${u.reason}`);let f=i.p(o.tracks);[...f].some(([e,t])=>e.id!==t)&&o.warnings.push(`duplicate track_ID values`);let p=o.tracks.filter(e=>i.l(e,o)),m=p.map(e=>i.i(e,o,{maxExpandedSamples:0},{reportedId:f.get(e)??e.id,ffprobeFails:d}));for(let e of m)headerTrack(e.result);let h=null;if(a.codecConfig)try{let{isoCodecConfig:e}=c??await r.race(loadCapture());p.forEach((t,n)=>m[n].result.codecConfig=e(o,t))}catch(e){if(i.c(e,n))throw e;h=e}l.videoTracks=m.map(e=>e.result),l.audioTrackCount=o.tracks.filter(e=>e.handler===`soun`).length,e.fragments?await resolveFragmented(s,e,p,m,l):(l.primaryTrackId=i.d(m),l.formatDurationSec=i.s(o,new Set(p)),e.limit&&(l.error=e.limit.message,l.errorCode=t.i(e.limit))),h!==null&&l.warnings.push(`codec configuration unavailable: ${h instanceof Error?h.message:String(h)}`)}catch(e){if(i.c(e,n))throw e;let a=r.take(),s=a?a.message:e instanceof Error?e.message:String(e);l.container=i.a(o),l.brand=o.brand,l.error=a||e?.errorCode?s:`corrupt file: ${s}`,l.errorCode=t.i(a??e),l.videoTracks=[],l.audioTrackCount=0,l.primaryTrackId=null,l.formatDurationSec=null}l.layout=i.u(o),collapse(l.warnings);for(let e of l.videoTracks)collapse(e.warnings);return l}const u=Object.freeze({maxBytes:16777216,maxReads:8,maxMs:1e4,maxTracks:64,maxTopLevelBoxes:1024});var LimitError=class extends Error{constructor(e,t){super(t),this.name=`LimitError`,this.errorCode=e}};const noop=()=>{};function sourceError(e){return Object.assign(Error(e),{name:``})}function bufferOf(e){if(ArrayBuffer.isView(e)){let t=new Uint8Array(e.buffer,e.byteOffset,e.byteLength);return t.byteOffset===0&&t.byteLength===t.buffer.byteLength&&t.buffer instanceof ArrayBuffer?t.buffer:t.slice().buffer}if(typeof e?.byteLength!=`number`)throw sourceError(`the source returned ${e===null?`null`:typeof e} instead of bytes`);return e}var LimitedSource=class{size;#e;#t;#n;#r;#i;#a=new AbortController;#o;#s;#c=()=>this.#a.abort(this.#s?.reason);#l=null;#u=!1;#d=0;#f=0;#p=null;constructor(e,t,n,r){this.size=t,this.#e=e,this.#t=n.maxBytes,this.#n=n.maxReads,this.#r=n.maxMs,this.#i=performance.now()+n.maxMs,this.#s=r;let i=this.#a.signal;this.#o=new Promise((e,t)=>i.addEventListener(`abort`,()=>t(i.reason),{once:!0})),this.#o.catch(noop),r&&(r.aborted?this.#c():r.addEventListener(`abort`,this.#c,{once:!0})),Number.isFinite(n.maxMs)&&!i.aborted&&this.#m(n.maxMs)}#m(e){let t=Math.min(e,2147483647);this.#l=setTimeout(()=>{if(e>t)return this.#m(e-t);this.#l=null,this.#u=!0,this.#a.abort(new LimitError(`time-limit`,`limit reached: maxMs ${this.#r}`))},t)}get bytesLeft(){return this.#t-this.#f}get bytesRequested(){return this.#f}checkTime(){if(this.#u||performance.now()>=this.#i)throw this.#h(`time-limit`,`limit reached: maxMs ${this.#r}`)}take(){let e=this.#p;return this.#p=null,e}race(e){return e.catch(noop),Promise.race([e,this.#o])}slice(e=0,t=this.size){return{arrayBuffer:()=>this.#_(e,t)}}dispose(){this.#l!==null&&clearTimeout(this.#l),this.#l=null,this.#s?.removeEventListener(`abort`,this.#c)}#h(e,t){return this.#p=new LimitError(e,t),this.#p}#g(e,t){if(this.#d+1>this.#n)return this.#h(`read-limit`,`limit reached: maxReads ${this.#n}`);if(this.#f+e>this.#t)return this.#h(`byte-limit`,`limit reached: maxBytes ${this.#t} (${this.#f+e-this.#t} more bytes needed at offset ${t})`);try{this.checkTime()}catch(e){return e}return null}#_(e,t){let n=Math.max(0,t-e),r=this.#g(n,e);if(r)return Promise.reject(r);this.#d++,this.#f+=n;let i;try{let n=this.#e;i=Promise.resolve(typeof n.read==`function`?n.read(e,t,this.#a.signal):n.slice(e,t).arrayBuffer()).then(bufferOf)}catch(e){i=Promise.reject(e)}return i.catch(noop),Promise.race([i,this.#o]).catch(e=>{if(e instanceof LimitError)this.#p=e;else if(!this.#a.signal.aborted&&e?.name===`AbortError`)throw sourceError(String(e));throw e})}};function shown(e){return typeof e==`string`?JSON.stringify(e):typeof e==`object`&&e?Array.isArray(e)?`an array`:`an object`:String(e)}function count(e,t,n=0,r=!1){if(r&&e===1/0)return e;if(typeof e!=`number`||!Number.isSafeInteger(e)||e<n)throw TypeError(`${t} must be a non-negative safe integer${n>0?` of at least ${n}`:``}${r?` or Infinity`:``}, got ${shown(e)}`);return e}function record(e,t){if(e===void 0)return{};if(typeof e!=`object`||!e||Array.isArray(e))throw TypeError(`${t} must be an object, got ${shown(e)}`);return e}function flag(e,t){if(e!==void 0&&typeof e!=`boolean`)throw TypeError(`${t} must be a boolean, got ${shown(e)}`);return e===!0}function resolveHeaderOptions(e,t){let r=e;if(typeof r!=`object`||!r||typeof r.slice!=`function`)throw TypeError(`source must be a Blob or a BlobLike with a size and a slice method, got ${shown(e)}`);let i=count(r.size,`source.size`),a=record(t,`options`);if(a.name!==void 0&&typeof a.name!=`string`)throw TypeError(`name must be a string, got ${shown(a.name)}`);let o=a.signal??null;if(o!==null){let e=o;if(typeof e!=`object`||typeof e.aborted!=`boolean`||typeof e.addEventListener!=`function`||typeof e.removeEventListener!=`function`)throw TypeError(`signal must be an AbortSignal, got ${shown(o)}`)}let s=record(a.limits,`limits`),c={...u};for(let e of Object.keys(u))s[e]!==void 0&&(c[e]=count(s[e],`limits.${e}`,0,!0));let l=record(a.readAhead,`readAhead`);for(let e of Object.keys(l))if(e!==`head`&&e!==`tail`&&l[e]!==void 0)throw TypeError(`readAhead takes only head and tail, got ${e}`);let d=l.head===void 0?n.n.head:count(l.head,`readAhead.head`,1024),f=l.tail===void 0?n.n.tail:count(l.tail,`readAhead.tail`,16),p=a.fragmentedDuration??`index`;if(p!==`index`&&p!==`header`)throw TypeError(`fragmentedDuration must be 'header' or 'index', got ${shown(p)}`);return{name:a.name??(typeof File<`u`&&e instanceof File?e.name:``),size:i,signal:o,limits:c,head:d,tail:f,index:p===`index`,codecConfig:flag(a.codecConfig,`codecConfig`),color:flag(a.color,`color`),aspect:flag(a.aspect,`aspect`)}}function docTypeOf(e){let t=4,vint=n=>{if(t>=e.length)return null;let r=e[t],i=1;for(;i<=8&&!(r&128>>i-1);)i++;if(i>8||t+i>e.length)return null;let a=n?r:r&255>>i;for(let n=1;n<i;n++)a=a*256+e[t+n];return t+=i,a},n=vint(!1);if(n===null)return null;let r=Math.min(e.length,t+n);for(;t<r;){let n=vint(!0),i=vint(!1);if(n===null||i===null||t+i>r)return null;if(n===17026)return String.fromCharCode(...e.subarray(t,t+i)).replace(/\0+$/,``);t+=i}return null}function failed(e,t,n){return e.error=t,e.errorCode=n,e}async function analyzeSource(t,n,r){let i={...e.c(`unknown`),scan:`header`,errorCode:null,layout:null},o=t.size;if(o===0)return failed(i,`not a recognised container: empty file`,`empty-file`);let s=await t.bytes(0,Math.min(1024,o),Math.min(o,r.head,n.bytesLeft)),c=a.n(s);if(c.kind===`unknown`)return failed(i,`not a recognised container: ${c.reason}`,`unrecognised`);if(c.kind===`matroska`)return i.container=docTypeOf(s)===`webm`?`webm`:`matroska`,failed(i,`container not read by the header entry: ${i.container}`,`unsupported-container`);let{maxTracks:l,maxTopLevelBoxes:u}=r.limits;return analyzeIsoBmffHeader(t,n,{head:r.head,tail:r.tail,maxTracks:l,maxTopLevelBoxes:u,index:r.index,codecConfig:r.codecConfig||r.color||r.aspect})}const messageOf=e=>e instanceof Error?e.message||e.name:String(e);let d,f;function loadMetadata(){return f??=Promise.resolve().then(()=>require("./chunks/metadata-ECdzNLkE.cjs")).then(e=>d=e,e=>{throw f=void 0,e}),f}async function withMetadata(e,n,r){try{let{withAspect:i,withColor:a}=d??await r.race(loadMetadata());t.o(n.signal);let o={keepCodecConfig:n.codecConfig},s=n.color?a(e,n.aspect?{keepCodecConfig:!0}:o):e;return n.aspect?i(s,o):s}catch(r){t.o(n.signal);let i=e.videoTracks.map(e=>{let t={...e};return n.codecConfig||delete t.codecConfig,t});return{...e,videoTracks:i,warnings:[...e.warnings,`color and aspect unavailable: ${messageOf(r)}`]}}}async function analyzeHeader(n,r={}){let i=performance.now(),a=resolveHeaderOptions(n,r);t.o(a.signal);let o=new LimitedSource(n,a.size,a.limits,a.signal),s=new t.t(o,{headWindow:a.head,signal:a.signal}),c;try{c=await analyzeSource(s,o,a),(a.color||a.aspect)&&c.videoTracks.some(e=>e.codecConfig)&&(c=await withMetadata(c,a,o))}catch(n){t.o(a.signal);let r=o.take();c={...e.c(`unknown`),scan:`header`,errorCode:null,layout:null},failed(c,r?r.message:messageOf(n),t.i(r??n))}finally{o.dispose()}return{name:a.name,size:a.size,...c,io:{reads:s.reads,bytesRead:s.bytesFetched,ms:performance.now()-i,bytesRequested:o.bytesRequested},engine:`own`}}exports.HEADER_DEFAULT_LIMITS=u,exports.analyzeHeader=analyzeHeader,exports.errorClass=e.i,exports.errorCodeOf=e.a,exports.isAbortError=e.t,exports.isTimeoutError=e.r,exports.warningCodeOf=e.o,exports.warningCodesOf=e.s;

package/dist/cjs/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/guards-DbQNcAZS.cjs"),t=require("./chunks/probe-Cn1DtL-C.cjs"),n=require("./chunks/errors-0oBg1Ai6.cjs");async function analyze(e,t={}){let{name:n=typeof File<`u`&&e instanceof File?e.name:``,engine:r,...i}=t,a=await(r?await r.load():(await Promise.resolve().then(()=>require("./chunks/runtime-BgAlQQee.cjs"))).ownEngine).run(e,n,i);if(!a.videoTracks.some(e=>e.codecConfig?.family===`isobmff-moov`))return a;try{let{isoBoxes:e}=await Promise.resolve().then(()=>require("./chunks/config-CSbXzEqr.cjs"));return{...a,videoTracks:a.videoTracks.map(t=>t.codecConfig?.family===`isobmff-moov`?{...t,codecConfig:e(t.codecConfig.moov,t.codecConfig.trak)}:t)}}catch{return a}}const r=new Set([`estimated`,`sampled`]);function summarize(e){let t=e.primaryTrackId===null?null:e.videoTracks.find(t=>t.trackId===e.primaryTrackId)??null,n=e.error??(t?t.avgFps?null:`no frame rate`:`no video track`);return{ok:n===null,name:e.name,container:e.container,engine:e.engine,fps:t?.avgFps?.value??null,fpsRational:t?.avgFps?`${t.avgFps.num}/${t.avgFps.den}`:null,nominalFps:t?.nominalFps?.value??null,frames:t?t.presentedFrames??t.frames:null,durationSec:t?.durationSec??e.formatDurationSec,width:t?.width??null,height:t?.height??null,rotation:t?.rotation??null,isVfr:t?.isVfr??null,minFps:t?.minFps?.value??null,maxFps:t?.maxFps?.value??null,approximate:!!t&&[`avgFps`,`nominalFps`,`frames`].some(e=>r.has(t.provenance[e])),error:n,warnings:[...e.warnings,...t?.warnings??[]]}}const i=[`isobmff`,`matroska`],splitBy=e=>(t,n,r,a,o,s)=>{let pool=e=>{let i=n[e];return i?r(`${t}-${e}`,i):r(t,s)},c=e(pool,a,o);return{kind:t,pool:()=>c,warmPools:e=>i.filter(t=>e.includes(t)).map(e=>[pool(e),[e]])}},a=[26,69,223,163],familyOf=(e,t)=>new Promise(n=>{let iso=()=>n(`isobmff`);if(t?.aborted)return iso();t?.addEventListener(`abort`,iso),Promise.resolve().then(()=>e.slice(0,4).arrayBuffer()).then(e=>{let t=new Uint8Array(e);return a.every((e,n)=>t[n]===e)?`matroska`:`isobmff`}).then(n,iso).finally(()=>t?.removeEventListener(`abort`,iso))}),runByHead=(e,t,n)=>({run:(r,i)=>t(familyOf(r.file,i.signal),r.engine).then(a=>n.aborted?t(Promise.reject(),r.engine):e(a).run(r,i))}),o=splitBy(runByHead),s={id:`own`,thread:`worker`,createWorkers:{isobmff:()=>new Worker(new URL(`../worker/own-isobmff.worker.js`,require("url").pathToFileURL(__filename).href),{type:`module`}),matroska:()=>new Worker(new URL(`../worker/own-matroska.worker.js`,require("url").pathToFileURL(__filename).href),{type:`module`})},load:()=>Promise.resolve().then(()=>require("./chunks/runtime-BgAlQQee.cjs")).then(e=>e.ownEngine)};function createProbe(e={}){let{engines:n=[],worker:r,...i}=e;return t.t({...i,engines:[s,...n],worker:r===`inline`?`inline`:void 0,split:o})}exports.ProbeError=n.t,exports.analyze=analyze,exports.compareResults=t.r,exports.createProbe=createProbe,exports.errorClass=e.i,exports.errorCodeOf=e.a,exports.isAbortError=e.t,exports.isTimeoutError=e.r,exports.summarize=summarize,exports.warningCodeOf=e.o,exports.warningCodesOf=e.s;

package/dist/cjs/index.d.cts

@@ -0,0 +1,13 @@
+export { analyze, type InThreadOptions } from './analyze.cjs';
+export { compareResults, type Agreement, type ComparedField, type ComparedFieldName, type ComparedValue } from './api/agreement.cjs';
+export { errorClass, errorCodeOf, warningCodeOf, warningCodesOf, type ErrorClass } from './api/codes.cjs';
+export { ProbeError, type ProbeErrorCode } from './api/errors.cjs';
+export { isAbortError, isTimeoutError } from './api/guards.cjs';
+export { summarize, type VideoFpsSummary } from './api/summary.cjs';
+export type * from './client/types.cjs';
+export type { BlobLike, BlobSlice } from './core/reader.cjs';
+export type * from './core/types.cjs';
+export type { MediabunnyNative, MediabunnyTrackNative, Mp4boxNative, Mp4boxTrackNative, RvfcConfidence, RvfcDetails, RvfcPass } from './engines/types.cjs';
+export type { ContainerFamily, EngineDescriptor, EngineModule, WorkerEngineId } from './plugins/types.cjs';
+export type { WireOptions } from './worker/protocol.cjs';
+export { createProbe } from './probe.cjs';

package/dist/cjs/plugins/types.d.cts

@@ -0,0 +1,17 @@
+import type { BlobLike } from '../core/reader.cjs';
+import type { AnalyzeOptions, EngineId, FileResult } from '../core/types.cjs';
+export type { EngineId };
+export type ContainerFamily = 'isobmff' | 'matroska';
+export type WorkerEngineId = 'own' | 'mp4box' | 'mediabunny';
+export interface EngineModule<R extends FileResult = FileResult> {
+    readonly run: (blob: BlobLike, name: string, opts: AnalyzeOptions) => Promise<R>;
+    readonly containers: readonly ContainerFamily[] | 'any';
+    readonly warm?: (containers: readonly ContainerFamily[]) => Promise<void>;
+}
+export interface EngineDescriptor<Id extends EngineId = EngineId> {
+    readonly id: Id;
+    readonly thread: 'worker' | 'main';
+    readonly createWorker?: () => Worker;
+    readonly load: () => Promise<EngineModule>;
+    readonly loadOwn?: () => Promise<EngineModule>;
+}

package/dist/cjs/presets/index.d.cts

@@ -0,0 +1,19 @@
+import type { CheckRules } from '../check/index.cjs';
+export type PresetSourceKind = 'official' | 'gateway';
+export interface ProviderPreset {
+    readonly name: string;
+    /** @deprecated Use video-fps-probe/presets/sources.json; sourceUrl will be removed in the next major. */
+    readonly sourceUrl: string;
+    readonly sourceKind: PresetSourceKind;
+    readonly verifiedAt: string;
+    readonly note: string;
+    readonly rules: {
+        readonly [K in keyof CheckRules]: Readonly<CheckRules[K]>;
+    };
+}
+export declare const klingO1ReferenceVideo: ProviderPreset;
+export declare const klingMotionControl: ProviderPreset;
+export declare const runwayAleph2: ProviderPreset;
+export declare const veoExtend: ProviderPreset;
+export declare const wan26ReferenceToVideoFal: ProviderPreset;
+export declare const seedance2ReferenceVideo: ProviderPreset;

package/dist/cjs/presets.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const frozen=e=>{for(let t of Object.values(e))t&&typeof t==`object`&&frozen(t);return Object.freeze(e)},e=frozen({name:`Kling O1 reference video`,sourceUrl:`https://kling.ai/document-api/api/video/o1/video-omni.md`,sourceKind:`official`,verifiedAt:`2026-10-25`,note:`The feature or base video of the Kling O1 omni video API, one per request. No codec, aspect ratio or audio rule is published for it. The page does not say whether 200 MB is decimal or binary; the larger reading, 209,715,200 bytes, is checked.`,rules:{fps:{min:24,max:60},duration:{min:3,max:10},frameSize:{minShortSide:700,maxLongSide:2160},fileSize:{max:209715200},containers:[`mp4`,`mov`]}}),t=frozen({name:`Kling Motion Control 3.0 reference video`,sourceUrl:`https://kling.ai/document-api/api/video/motion-control.md`,sourceKind:`official`,verifiedAt:`2026-10-25`,note:`The 30 s maximum applies when the character orientation follows the video; it is 10 s when it follows the image. No frame rate rule is published. The page does not say whether 100 MB is decimal or binary; the larger reading, 104,857,600 bytes, is checked.`,rules:{duration:{min:3,max:30},frameSize:{minShortSide:340,maxLongSide:3850},fileSize:{max:104857600},containers:[`mp4`,`mov`]}}),n=frozen({name:`Runway Aleph 2.0 input video`,sourceUrl:`https://docs.dev.runwayml.com/assets/inputs`,sourceKind:`official`,verifiedAt:`2026-10-25`,note:`The file size is the ephemeral upload limit; a URL is limited to 32 MB and a data URI to 16 MB. The codecs join what the four containers accept, including the discouraged ones, without pairing codec and container. Aleph keeps the input resolution up to 1080p, and the page does not say whether a larger input is refused, so no size rule. The page does not say whether 200 MB is decimal or binary; the larger reading, 209,715,200 bytes, is checked.`,rules:{fps:{max:30},duration:{min:2,max:30},fileSize:{max:209715200},containers:[`mp4`,`mov`,`matroska`,`webm`],codecs:[`h264`,`hevc`,`av1`,`prores`,`vp8`,`vp9`,`mjpeg`,`mpeg2video`]}}),r=frozen({name:`Google Veo 3.1 video to extend`,sourceUrl:`https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/video/extend-a-veo-video`,sourceKind:`official`,verifiedAt:`2026-10-25`,note:`The frame rate must be 24, so 23.976 fails. The resolution must be 720p, 1080p or 4k; 4k is not given in pixels, so only the 720 px short side is checked. No codec or file size limit is published.`,rules:{fps:{exact:24},duration:{min:1,max:30},frameSize:{minShortSide:720},aspectRatio:{oneOf:[`16/9`,`9/16`]},containers:[`mp4`]}}),i=frozen({name:`Wan 2.6 reference to video on fal`,sourceUrl:`https://fal.ai/models/wan/v2.6/reference-to-video/api`,sourceKind:`gateway`,verifiedAt:`2026-10-25`,note:`As the fal endpoint documents it, for each of 1 to 3 reference videos; fal serves a model it does not make, and no first-party page was verified. No resolution, aspect ratio or codec limit is published for the input. The page does not say whether 30 MB is decimal or binary; the larger reading, 31,457,280 bytes, is checked.`,rules:{fps:{min:16},duration:{min:2,max:30},fileSize:{max:31457280},containers:[`mp4`,`mov`],severity:`warn`}}),a=frozen({name:`Seedance 2.0 reference video`,sourceUrl:`https://evolink.ai/docs/en/api-manual/video-series/seedance2.0/seedance-2.0-reference-to-video`,sourceKind:`gateway`,verifiedAt:`2026-10-25`,note:`As the EvoLink gateway documents it; no first-party page was verified, and the Runware model page gives only the count. Up to 3 videos of at most 15 s together. The 480p, 720p or 1080p list is checked only through the pixel range. The page does not say whether 50 MB is decimal or binary; the larger reading, 52,428,800 bytes, is checked.`,rules:{fps:{min:24,max:60},duration:{min:2,max:15},frameSize:{minShortSide:300,maxLongSide:6e3},pixels:{min:409600,max:2086876},aspectRatio:{min:.4,max:2.5},fileSize:{max:52428800},containers:[`mp4`,`mov`],severity:`warn`}});exports.klingMotionControl=t,exports.klingO1ReferenceVideo=e,exports.runwayAleph2=n,exports.seedance2ReferenceVideo=a,exports.veoExtend=r,exports.wan26ReferenceToVideoFal=i;

package/dist/cjs/probe.d.cts

@@ -0,0 +1,3 @@
+import type { IdOf, Probe, ProbeOptions } from './client/types.cjs';
+import type { EngineDescriptor } from './plugins/types.cjs';
+export declare function createProbe<const E extends readonly EngineDescriptor[] = []>(options?: ProbeOptions<E>): Probe<'own' | IdOf<E[number]>>;

package/dist/cjs/url/index.d.cts

@@ -0,0 +1,47 @@
+import type { BlobLike } from '../core/reader.cjs';
+export type { BlobLike, BlobSlice } from '../core/reader.cjs';
+export interface RangeRequest {
+    readonly start: number;
+    readonly end: number;
+    readonly range: string;
+    readonly signal: AbortSignal | null;
+}
+export interface RangeReply {
+    readonly status?: number | null;
+    readonly contentRange?: string | null;
+    readonly contentLength?: number | null;
+    readonly bytes?: ArrayBuffer | ArrayBufferView | null;
+    readonly body?: (expectedLength: number) => Promise<ArrayBuffer | ArrayBufferView>;
+    readonly discard?: () => void;
+}
+export type RangeFetcher = (request: RangeRequest) => Promise<RangeReply>;
+export interface RangeSource extends BlobLike {
+    read(start: number, end: number, signal?: AbortSignal | null): Promise<Uint8Array>;
+}
+export interface RangeSourceInit {
+    size: number;
+    signal?: AbortSignal | null;
+}
+export interface OpenRangeSourceInit {
+    size?: number;
+    headBytes?: number;
+    signal?: AbortSignal | null;
+}
+export interface HttpRangeInit {
+    headers?: Readonly<Record<string, string>>;
+    fetch?: typeof globalThis.fetch;
+}
+export type RangeSourceErrorCode = 'unverifiable-reply' | 'unexpected-status' | 'range-mismatch' | 'size-changed' | 'length-mismatch' | 'body-too-long' | 'body-too-short' | 'invalid-reply';
+export interface RangeSourceErrorOptions {
+    status?: number | null;
+    cause?: unknown;
+}
+export declare class RangeSourceError extends Error {
+    readonly code: RangeSourceErrorCode;
+    readonly status: number | null;
+    constructor(code: RangeSourceErrorCode, message: string, options?: RangeSourceErrorOptions);
+}
+export declare function rangeSource(fetcher: RangeFetcher, init: RangeSourceInit): RangeSource;
+export declare function openRangeSource(fetcher: RangeFetcher, init?: OpenRangeSourceInit): Promise<RangeSource>;
+export declare function httpRange(url: string | URL, init?: HttpRangeInit): RangeFetcher;
+export declare function readCapped(body: ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>, expectedLength: number, signal?: AbortSignal | null): Promise<Uint8Array>;