avbridge 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -1,9 +1,133 @@
 # Changelog
 
-All notable changes to **avbridge** are documented here. The format follows
+All notable changes to **avbridge.js** are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0]
+
+This release makes avbridge.js production-ready for authenticated
+remote media, legacy codecs, and end-user embedding.
+
+### Added
+
+- **`<avbridge-player>` controls-bearing element** (new subpath:
+  `avbridge/player`). Full YouTube-style player UI — play/pause, seek
+  bar, time display, volume/mute, settings menu (playback speed,
+  subtitle + audio tracks, Stats for Nerds), fullscreen. Auto-hide
+  controls, keyboard shortcuts (space/k, f, m, j/l, arrows, >/<, Esc),
+  touch gestures (tap-to-toggle, double-tap ±10s with ripple,
+  tap-and-hold for 2x speed). `::part()` hooks on every control.
+- **Transport configurability** — `requestInit` and `fetchFn` on
+  `CreatePlayerOptions`; `probe()` takes a transport argument.
+  Threaded through probe Range requests, subtitle fetches, and the
+  libav HTTP reader. Unblocks signed URLs and custom auth headers.
+- **Bitstream fixups** — `mpeg4_unpack_bframes` BSF wired into the
+  fallback and hybrid decoders for DivX packed-B-frame files.
+  Annex B → AVCC normalization in the libav remux path. Applied
+  filters visible in diagnostics as `bsfApplied`.
+- **Structured errors** — new `AvbridgeError` class with
+  machine-readable `code` (`ERR_AVBRIDGE_*`) and human-readable
+  `recovery` hints. Applied to probe, codec, MSE, player-readiness,
+  and strategy-exhaustion paths.
+- **DTS, TrueHD, Theora decoder support** in the custom libav
+  variant. Probe re-runs via libav when mediabunny returns unknown
+  codecs. Hybrid strategy now used for "native video + fallback
+  audio" combos (e.g. H.264 + DTS in Blu-ray MKV rips) instead of
+  the much slower full WASM fallback.
+- **Streaming transcode output** via `outputStream` option. Pairs
+  with `showSaveFilePicker()` for multi-GB file transcoding without
+  loading the entire output into memory.
+- **Background tab pause/resume** — auto-pause on `visibilitychange`
+  when hidden, auto-resume on return. Prevents degraded playback
+  from Chrome's rAF/setTimeout throttling. Configurable via
+  `backgroundBehavior: "pause" | "continue"`.
+- **GitHub Pages demo** — deployed at `keishi.github.io/avbridge/`.
+  COOP/COEP service worker enables SharedArrayBuffer on static
+  hosting.
+- **Consolidated rebrand** — public-facing name is now "avbridge.js"
+  across README, docs, demos. npm package name unchanged (`avbridge`).
+
+### Fixed
+
+- **A/V sync for long-running hybrid playback** — video PTS and
+  `AudioContext.currentTime` drift ~7ms/s (different clock domains).
+  Now periodically re-snaps calibration every 10 seconds, keeping
+  max drift under 70ms (below human lip-sync threshold). See
+  `docs/dev/POSTMORTEMS.md` for the full investigation.
+- **Hybrid pump ordering** — audio decoded before video, with
+  sub-batch yields during heavy audio decode (DTS) to prevent rAF
+  starvation that caused visible stutter.
+- **Probe regression** for MKV files with unrecognized codecs —
+  now falls back to libav probe instead of returning "unknown".
+- **Variant picker** rewritten to use an allowlist (codecs
+  webcodecs variant can handle) instead of a denylist. New codecs
+  automatically route to the avbridge variant.
+- **Hybrid + fallback preserve HTMLMediaElement contract** —
+  dispatch standard `play`/`pause`/`volumechange` events and patch
+  `target.volume`/`muted` as getter/setters so `<avbridge-player>`'s
+  controls reflect real state.
+- **Seek bar click position** — custom pointer handler replaces
+  native range-input click math, eliminating the thumb-vs-cursor
+  offset at the track edges.
+
+### Changed
+
+- Classification now routes native-video + fallback-audio combos
+  to hybrid (WebCodecs video + libav audio) instead of full
+  fallback. Previously a Blu-ray MKV with H.264 + DTS went straight
+  to WASM software decode (unwatchable at 1080p).
+- Annex B → AVCC conversion is now applied during libav remux to
+  produce correct fMP4 output.
+- 269 unit tests across 17 files (up from 119 across 9). Three
+  testing tiers documented: unit (vitest + jsdom), browser
+  integration (Puppeteer), and strategy-to-element contract.
+
+## [2.2.1]
+
+### Fixed
+
+- **Canvas renderer no longer stretches non-stage-aspect video.** The
+  fallback + hybrid renderer's canvas sat at `width:100%;height:100%`
+  with no `object-fit`, so portrait or otherwise non-matching content
+  was stretched to fill the stage. Now uses `object-fit: contain` to
+  letterbox the bitmap inside the stage.
+- **Strategy switch to `remux` while playing now resumes playback.**
+  `doSetStrategy` calls `session.seek()` before `session.play()`, so
+  the remux pipeline used to start with `pendingAutoPlay=false`; the
+  subsequent `video.play()` would then hit an element whose `src`
+  wasn't yet assigned (the MseSink constructs lazily on first write)
+  and silently reject. `RemuxPipeline` gained `setAutoPlay()` so
+  `session.play()` can flip `pendingAutoPlay=true` mid-flight; the
+  MseSink fires `video.play()` as soon as buffered data lands.
+- **Strategy switch from `hybrid` / `fallback` to another backend now
+  preserves play state.** Those strategies hide the `<video>` and
+  drive playback from their own Web Audio clock, so the underlying
+  element's native `paused` was always `true`. `doSetStrategy` read
+  `!target.paused` and captured `wasPlaying=false`, skipping the
+  restore on the new session. Both strategies now patch a
+  configurable `paused` getter on the target that mirrors
+  `audio.isPlaying()`, and clean it up on `destroy()`.
+- **`initialStrategy` no longer retries the same failing strategy.**
+  `buildInitialDecision` inherited `natural.fallbackChain` verbatim,
+  so for a `RISKY_NATIVE` file with `initialStrategy: "remux"` the
+  chain still contained `"remux"` — on failure, `startSession` would
+  shift it off and retry `remux` before escalating. The synthetic
+  decision now filters `initial` out of the inherited chain.
+- **`UnifiedPlayer.destroy()` removes the `ended` listener it
+  attached during `bootstrap()`.** Previously the anonymous handler
+  leaked across player lifecycles on long-lived target elements
+  (e.g. `<avbridge-video>` swapping source), causing gradual
+  accumulation and duplicate `ended` events after source reloads.
+
+### Changed
+
+- Bundle audit ceiling for the `element-only` scenario raised to
+  20 KB eager gzip. The budget's purpose is catching
+  order-of-magnitude regressions (e.g. libav accidentally eager-
+  imported), not policing ±200 bytes; realistic first-play cost is
+  dominated by the multi-megabyte lazy wasm load.
+
 ## [2.2.0]
 
 ### Added

package/NOTICE.md

@@ -1,10 +1,10 @@
 # Third-party notices
 
-avbridge is distributed under the MIT License (see [LICENSE](./LICENSE)).
+avbridge.js is distributed under the MIT License (see [LICENSE](./LICENSE)).
 
 This package **bundles binary builds** of third-party libraries. Each
 bundled library retains its original license, which you must honor if you
-redistribute avbridge or works that include it.
+redistribute avbridge.js or works that include it.
 
 See [THIRD_PARTY_LICENSES.md](./THIRD_PARTY_LICENSES.md) for the full
 license texts. This file is a short index.

package/README.md

@@ -1,16 +1,16 @@
-# avbridge
+# avbridge.js
 
 [![npm](https://img.shields.io/npm/v/avbridge.svg)](https://www.npmjs.com/package/avbridge)
-[![bundle size](https://img.shields.io/bundlephobia/minzip/avbridge?label=gzipped)](https://bundlephobia.com/package/avbridge)
 [![license](https://img.shields.io/npm/l/avbridge.svg)](./LICENSE)
 [![CI](https://img.shields.io/github/actions/workflow/status/keishi/avbridge/ci.yml?branch=main&label=CI)](https://github.com/keishi/avbridge/actions/workflows/ci.yml)
 
-> **Play and convert arbitrary video files in the browser. Local files or remote URLs.**
+> **VLC-style media playback for the browser. Play and convert arbitrary video files — local or remote.**
 
 A media compatibility layer for the web. Drop in any file — MP4, MKV, AVI,
-WMV, FLV, MPEG-TS, DivX — and avbridge picks the best path: native `<video>`
-playback, mediabunny remux to fragmented MP4, libav.js demux + WebCodecs
-hardware decode, or full WASM software decode. Same API for all of them.
+WMV, FLV, MPEG-TS, DivX, RMVB — and avbridge picks the best path: native
+`<video>` playback, mediabunny remux to fragmented MP4, libav.js demux +
+WebCodecs hardware decode, or full WASM software decode. Same API for all
+of them.
 
 **Streaming-first.** Remote URLs are read via HTTP Range requests across all
 strategies — even AVI/WMV/FLV — so a 4 GB file plays without buffering 4 GB
@@ -46,6 +46,7 @@ MKV (H.264/AAC)  → remux     → fragmented MP4 via MSE
 MPEG-TS (H.264)  → remux     → fragmented MP4 via MSE
 AVI (H.264)      → hybrid    → libav demux + hardware decode
 AVI (DivX)       → fallback  → smooth software decode
+RMVB (rv40/cook) → fallback  → libav software decode
 ```
 
 ## Quick start
@@ -246,107 +247,132 @@ player.getDiagnostics();
 //   reason: "avi container requires libav demux; codecs are hardware-decodable",
 //   width: 1920, height: 1080, duration: 5400,
 //   probedBy: "libav",
+//   transport: "http-range",
+//   rangeSupported: true,
+//   runtime: { decoderType: "webcodecs-hybrid", videoFramesDecoded: 5432, ... },
 //   strategyHistory: [{ strategy: "hybrid", reason: "...", at: 1712764800000 }]
 // }
 ```
 
+### Debug logging
+
+Enable verbose per-stage logging for hard-to-diagnose issues:
+
+```js
+// In the browser console, or before avbridge loads:
+globalThis.AVBRIDGE_DEBUG = true;
+```
+
+The demo pages also accept `?avbridge_debug` in the URL. When enabled,
+every decision point emits a `[avbridge:<tag>]` log covering probe,
+classify, libav load, bootstrap, strategy execute, and cold-start gate
+timings.
+
+The following **unconditional diagnostics** also fire — even without the
+flag — when something smells off:
+
+- `[avbridge:bootstrap]` — bootstrap chain took >5 s end-to-end
+- `[avbridge:probe]` — probe took >3 s
+- `[avbridge:libav-load]` — libav variant load took >5 s (usually a
+  misconfigured base path or server MIME type)
+- `[avbridge:cold-start]` — fallback cold-start gate timed out or
+  released on video-only grace after waiting for audio
+- `[avbridge:decode-rate]` — fallback decoder is running under 60% of
+  realtime fps for more than 5 seconds (one-shot per session)
+- `[avbridge:overflow-drop]` — renderer is dropping more than 10% of
+  decoded frames because the decoder is bursting faster than the
+  canvas can drain (one-shot per session)
+
+These are designed so "it works on my machine but stutters on your
+file" surfaces the specific reason in the console instead of requiring
+a live debug session.
+
 ## Install
 
 ```bash
 npm install avbridge
 ```
 
-This gives you the **core package**: probe, classify, native playback, remux,
-transcode, and subtitles. No WASM. The full library is ~17 KB gzipped, but
-tree-shaking is aggressive — what you actually pay for depends on which
-exports you import:
+That's it. **No optional peers to install, no binaries to build, no static
+file path to configure.** Both libav.js variants (the 5 MB webcodecs build
+and the 6.5 MB custom avbridge build with AVI/WMV/DivX/rv40 decoders) ship
+inside the tarball under `node_modules/avbridge/vendor/libav/` and are
+lazy-loaded at runtime only if a file actually needs them.
 
-| Import | Eager (gzip) |
-|---|---|
-| `srtToVtt` | **0.5 KB** |
-| `probe`, `classify` | **3 KB** |
-| `transcode` | **3.3 KB** |
-| `remux` | **4.1 KB** |
-| `createPlayer` | **14 KB** |
-| `*` (everything) | **17 KB** |
+Packed tarball is **~4 MB**, unpacked **~15 MB** (mostly the two WASM
+binaries). If you only ever play native MP4, you never download a single
+byte of the libav WASM — the loader is behind a dynamic `import()` that
+never fires.
 
-The libav-loader path is split into a lazy chunk (~5 KB extra) that only
-loads when a consumer actually invokes the AVI/ASF/FLV remux path.
+### Two ways to consume
 
-Run `npm run audit:bundle` to verify these numbers in your fork.
+**Bundler (Vite, webpack, Rollup, esbuild):**
 
-### Optional: fallback / hybrid strategies
+```ts
+import { createPlayer, remux, transcode, probe, classify } from "avbridge";
+// or
+import "avbridge/element";  // registers <avbridge-video> custom element
+```
 
-For files that need software decode or libav.js demux (AVI, WMV, FLV,
-legacy codecs):
+The tree-shaking budgets below apply to this path. Your bundler resolves
+`mediabunny` and `libavjs-webcodecs-bridge` through normal dependency
+resolution. libav.js binaries live at
+`node_modules/avbridge/vendor/libav/` — the loader finds them
+automatically via `import.meta.url` in the generated chunk.
 
-```bash
-npm install @libav.js/variant-webcodecs libavjs-webcodecs-bridge
-```
+**Plain `<script type="module">` (no bundler):**
 
-This handles MKV/WebM/MP4 containers via the hybrid/fallback strategies.
+```html
+<script type="module"
+        src="/node_modules/avbridge/dist/element-browser.js"></script>
 
-### Optional: AVI, WMV3, DivX, and other legacy formats
+<avbridge-video src="/video.mkv" autoplay playsinline></avbridge-video>
+```
 
-For **AVI, WMV3, MPEG-4 Part 2, DivX**, and other legacy formats, you need
-a custom libav.js build — see [`vendor/libav/README.md`](./vendor/libav/README.md)
-for the build recipe.
+This is a second tsup entry (`dist/element-browser.js`) that inlines
+mediabunny + libavjs-webcodecs-bridge into a single ~1.3 MB file with
+zero bare specifiers at runtime. Perfect for self-hosted tools or static
+sites that don't want a build step. It loads libav.js from the same
+co-located `vendor/libav/` tree.
 
-### Package boundary summary
+### Bundle sizes (bundler path)
 
-| What you need | What to install |
+| Import | Eager (gzip) |
 |---|---|
-| Playback of MP4/MKV/WebM/**MPEG-TS** + remux/transcode export | `avbridge` (core, no WASM) |
-| Fallback/hybrid decode for modern codecs in legacy containers (AVI/ASF/FLV) | + `@libav.js/variant-webcodecs` + `libavjs-webcodecs-bridge` |
-| AVI, WMV3, DivX, MPEG-4 Part 2, VC-1 | + custom libav build (`scripts/build-libav.sh`) |
-
-### Serving the libav.js binaries
+| `srtToVtt` | **0.5 KB** |
+| `probe`, `classify` | **2.5 KB** |
+| `transcode` | **3 KB** |
+| `remux` | **3.7 KB** |
+| `createPlayer` | **15 KB** |
+| `*` (everything) | **17.5 KB** |
+| `avbridge/element` | **17 KB** |
 
-The optional libav variants ship as `.wasm` + `.mjs` files that need to be
-served by your app at a known URL. avbridge looks for them at
-`/libav/<variant>/libav-<variant>.mjs` (where `<variant>` is `webcodecs` or
-`avbridge`). You can override the base URL with
-`globalThis.AVBRIDGE_LIBAV_BASE = "/my-static-path"` before any avbridge
-code runs.
+Run `npm run audit:bundle` to verify in your fork.
 
-#### Vite
+### Overriding the libav path (advanced)
 
-Copy the variant binaries into your `public/libav/` directory at build
-time. The avbridge demo does this via `scripts/copy-libav.mjs`:
+If you want to host the libav binaries somewhere other than
+`node_modules/avbridge/vendor/libav/` — for example a CDN, a custom
+libav build, or a patched version — set `AVBRIDGE_LIBAV_BASE` **before**
+any avbridge code runs:
 
-```bash
-# In your project, after npm install:
-mkdir -p public/libav/webcodecs
-cp node_modules/@libav.js/variant-webcodecs/dist/* public/libav/webcodecs/
+```html
+<script>globalThis.AVBRIDGE_LIBAV_BASE = "https://cdn.example.com/libav";</script>
+<script type="module" src="..."></script>
 ```
 
-For the custom `avbridge` variant, after running `./scripts/build-libav.sh`
-in the avbridge repo, copy `vendor/libav/*` into `public/libav/avbridge/`.
-
-#### Webpack
-
-Use `copy-webpack-plugin` to ship the binaries to your output directory at
-the same `libav/<variant>/` path.
-
-#### Plain `<script>` / no bundler
-
-Drop the variant directory anywhere on your origin and set
-`globalThis.AVBRIDGE_LIBAV_BASE` to the matching URL before importing
-avbridge.
-
-If a libav-backed strategy is selected and the binary isn't reachable,
-avbridge throws a clear error mentioning the URL it tried to load. The
-core (native + remux for modern containers) doesn't need any of this.
+The loader will then fetch `<base>/<variant>/libav-<variant>.mjs` and its
+sibling `.wasm` files. This is the documented replaceability hook for
+LGPL compliance — see [`NOTICE.md`](./NOTICE.md) and
+[`THIRD_PARTY_LICENSES.md`](./THIRD_PARTY_LICENSES.md).
 
 ## Known limitations
 
-- The **fallback strategy** uses WASM software decoding and is CPU-intensive, especially for HD video on mobile devices.
-- **Remux of AVI/ASF/FLV** requires libav.js — the core package cannot demux these containers.
+- The **fallback strategy** uses WASM software decoding and is CPU-intensive, especially for HD video on mobile devices. The `[avbridge:decode-rate]` diagnostic fires if the decoder falls below 60% of realtime so you know that's what's happening. Codecs with no WebCodecs support (rv40, mpeg4 @ 720p+, wmv3, vc1 at high resolutions) are the usual suspects.
 - **Remote URL playback requires HTTP Range requests.** Servers that don't support `Range: bytes=...` will fail fast with a clear error rather than silently downloading the whole file. This applies to all strategies.
 - **H.264 + MP3 in MP4** is a best-effort combination that may produce playback issues in some browsers. Use `strict: true` to reject it, or re-encode audio to AAC via `transcode()`.
-- AVI files with **packed B-frames** (some DivX encodes) may have timing issues until the `mpeg4_unpack_bframes` BSF is wired in.
-- libav.js **threading is disabled** due to bugs in v6.8.8 — decode runs single-threaded with SIMD acceleration.
-- `transcode()` v1 only accepts mediabunny-readable inputs (MP4/MKV/WebM/OGG/MOV/MP3/FLAC/WAV). AVI/ASF/FLV transcoding is planned for v1.1.
+- libav.js **threading is disabled** due to known runtime bugs in the v6.8.8 pthreads build — decode runs single-threaded with WASM SIMD acceleration.
+- `transcode()` only accepts mediabunny-readable inputs (MP4/MKV/WebM/OGG/MOV/MP3/FLAC/WAV). AVI/ASF/FLV/RM transcoding means "play it first, record the output" — not yet plumbed.
 - `transcode()` uses **WebCodecs encoders only** — codec availability depends on the browser. AV1 encoding is not yet universal.
 - For the **hybrid and fallback strategies**, `<avbridge-video>.buffered` returns an empty `TimeRanges` because the canvas-based renderers don't track buffered ranges yet. Native and remux strategies expose the full `<video>.buffered` set as expected.
 

package/THIRD_PARTY_LICENSES.md

@@ -1,9 +1,9 @@
 # Third-party license texts
 
 This document contains the full license text of every third-party
-component bundled with avbridge. The short overview lives in
+component bundled with avbridge.js. The short overview lives in
 [NOTICE.md](./NOTICE.md); this file is what you need if you redistribute
-avbridge and have to comply with the underlying licenses.
+avbridge.js and have to comply with the underlying licenses.
 
 ---
 

package/dist/avi-2JPBSHGA.js

@@ -0,0 +1,183 @@
+import { loadLibav } from './chunk-IAYKFGFG.js';
+import { prepareLibavInput } from './chunk-DCSOQH2N.js';
+
+// src/probe/avi.ts
+async function probeWithLibav(source, sniffed) {
+  const libav = await loadLibav("avbridge");
+  const filename = source.name ?? `input.${sniffed === "unknown" ? "bin" : sniffed}`;
+  const handle = await prepareLibavInput(libav, filename, source);
+  let fmt_ctx;
+  let streams = [];
+  try {
+    const result = await libav.ff_init_demuxer_file(filename);
+    fmt_ctx = result[0];
+    streams = result[1];
+  } catch (err) {
+    await handle.detach().catch(() => {
+    });
+    const inner = err instanceof Error ? err.message : typeof err === "object" && err !== null ? JSON.stringify(err) : String(err);
+    console.error("[avbridge] ff_init_demuxer_file raw error:", err);
+    throw new Error(
+      `libav.js could not demux ${filename}. The current libav variant likely lacks the required demuxer (e.g. AVI). See vendor/libav/README.md for build instructions. (${inner || "no message \u2014 see console for raw error"})`
+    );
+  }
+  const videoTracks = [];
+  const audioTracks = [];
+  for (const stream of streams) {
+    const codecName = await safe(() => libav.avcodec_get_name(stream.codec_id)) ?? `unknown(${stream.codec_id})`;
+    const codecpar = await safe(() => libav.ff_copyout_codecpar(stream.codecpar));
+    if (stream.codec_type === libav.AVMEDIA_TYPE_VIDEO) {
+      videoTracks.push({
+        id: stream.index,
+        codec: ffmpegToAvbridgeVideo(codecName),
+        width: codecpar?.width ?? 0,
+        height: codecpar?.height ?? 0,
+        fps: framerate(stream)
+      });
+    } else if (stream.codec_type === libav.AVMEDIA_TYPE_AUDIO) {
+      audioTracks.push({
+        id: stream.index,
+        codec: ffmpegToAvbridgeAudio(codecName),
+        channels: codecpar?.channels ?? codecpar?.ch_layout_nb_channels ?? 0,
+        sampleRate: codecpar?.sample_rate ?? 0
+      });
+    }
+  }
+  const duration = await safeDuration(libav, fmt_ctx);
+  await libav.avformat_close_input_js(fmt_ctx).catch(() => {
+  });
+  await handle.detach().catch(() => {
+  });
+  return {
+    source: source.original,
+    name: source.name,
+    byteLength: source.byteLength,
+    container: sniffed === "unknown" ? "unknown" : sniffed,
+    videoTracks,
+    audioTracks,
+    subtitleTracks: [],
+    probedBy: "libav",
+    duration
+  };
+}
+function framerate(stream) {
+  if (typeof stream.avg_frame_rate_num === "number" && stream.avg_frame_rate_den) {
+    return stream.avg_frame_rate_num / stream.avg_frame_rate_den;
+  }
+  if (stream.avg_frame_rate && typeof stream.avg_frame_rate === "object") {
+    if (stream.avg_frame_rate.den === 0) return void 0;
+    return stream.avg_frame_rate.num / stream.avg_frame_rate.den;
+  }
+  return void 0;
+}
+async function safeDuration(libav, fmt_ctx) {
+  try {
+    const lo = await libav.AVFormatContext_duration?.(fmt_ctx);
+    const hi = await libav.AVFormatContext_durationhi?.(fmt_ctx);
+    if (typeof lo !== "number" || typeof hi !== "number") return void 0;
+    if (hi === -2147483648 && lo === 0) return void 0;
+    const us = typeof libav.i64tof64 === "function" ? libav.i64tof64(lo, hi) : hi * 4294967296 + lo + (lo < 0 ? 4294967296 : 0);
+    if (!Number.isFinite(us) || us <= 0) return void 0;
+    return us / 1e6;
+  } catch {
+    return void 0;
+  }
+}
+async function safe(fn) {
+  try {
+    return await fn();
+  } catch {
+    return void 0;
+  }
+}
+function ffmpegToAvbridgeVideo(name) {
+  switch (name) {
+    case "h264":
+      return "h264";
+    case "hevc":
+      return "h265";
+    case "vp8":
+      return "vp8";
+    case "vp9":
+      return "vp9";
+    case "av1":
+      return "av1";
+    case "mpeg4":
+      return "mpeg4";
+    // MPEG-4 Part 2 / DivX / Xvid
+    case "msmpeg4v1":
+    case "msmpeg4v2":
+    case "msmpeg4v3":
+      return "mpeg4";
+    case "wmv1":
+    case "wmv2":
+    case "wmv3":
+      return "wmv3";
+    case "vc1":
+      return "vc1";
+    case "mpeg2video":
+      return "mpeg2";
+    case "mpeg1video":
+      return "mpeg1";
+    case "theora":
+      return "theora";
+    case "rv10":
+      return "rv10";
+    case "rv20":
+      return "rv20";
+    case "rv30":
+      return "rv30";
+    case "rv40":
+      return "rv40";
+    default:
+      return name;
+  }
+}
+function ffmpegToAvbridgeAudio(name) {
+  switch (name) {
+    case "aac":
+      return "aac";
+    case "mp3":
+    case "mp3float":
+      return "mp3";
+    case "opus":
+      return "opus";
+    case "vorbis":
+      return "vorbis";
+    case "flac":
+      return "flac";
+    case "ac3":
+      return "ac3";
+    case "eac3":
+      return "eac3";
+    case "wmav1":
+    case "wmav2":
+      return "wmav2";
+    case "wmapro":
+      return "wmapro";
+    case "alac":
+      return "alac";
+    case "cook":
+      return "cook";
+    case "ra_144":
+      return "ra_144";
+    case "ra_288":
+      return "ra_288";
+    case "sipr":
+      return "sipr";
+    case "atrac3":
+      return "atrac3";
+    case "dca":
+    case "dts":
+      return "dts";
+    case "truehd":
+    case "mlp":
+      return "truehd";
+    default:
+      return name;
+  }
+}
+
+export { probeWithLibav };
+//# sourceMappingURL=avi-2JPBSHGA.js.map
+//# sourceMappingURL=avi-2JPBSHGA.js.map

package/dist/avi-2JPBSHGA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/probe/avi.ts"],"names":[],"mappings":"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","file":"avi-2JPBSHGA.js","sourcesContent":["import type {\n  AudioCodec,\n  AudioTrackInfo,\n  ContainerKind,\n  MediaContext,\n  VideoCodec,\n  VideoTrackInfo,\n} from \"../types.js\";\nimport type { NormalizedSource } from \"../util/source.js\";\nimport { prepareLibavInput, type LibavInputHandle } from \"../util/libav-http-reader.js\";\nimport { loadLibav } from \"../strategies/fallback/libav-loader.js\";\n\n/**\n * Probe AVI/ASF/FLV (and any other format mediabunny doesn't speak) via\n * libav.js. This module is `import()`-ed only when sniffing identifies one of\n * those containers.\n *\n * Critical: codec identification goes through `libav.avcodec_get_name(id)`\n * which returns the FFmpeg codec name as a string (e.g. \"h264\", \"mpeg4\",\n * \"wmv3\"). The numeric AV_CODEC_ID_* enum is *not* exposed on the libav\n * instance (only AVMEDIA_TYPE_*, AV_PIX_FMT_*, AV_SAMPLE_FMT_* and a handful\n * of others are), so comparing codec_ids against constants does not work.\n */\nexport async function probeWithLibav(\n  source: NormalizedSource,\n  sniffed: ContainerKind,\n): Promise<MediaContext> {\n  // AVI/ASF/FLV demuxers are not in any libav.js npm variant — they live in\n  // the custom \"avbridge\" build produced by `scripts/build-libav.sh`. The loader\n  // emits an actionable error if the build hasn't been run yet. Threading\n  // is OFF by default in `loadLibav` (see the comment there for why).\n  const libav = (await loadLibav(\"avbridge\")) as unknown as LibavInstance;\n\n  const filename = source.name ?? `input.${sniffed === \"unknown\" ? \"bin\" : sniffed}`;\n  // For Blob/File sources we use libav's in-memory readahead file. For URL\n  // sources we attach an HTTP block reader so libav demuxes via Range\n  // requests instead of buffering the whole file.\n  const handle: LibavInputHandle = await prepareLibavInput(libav as unknown as Parameters<typeof prepareLibavInput>[0], filename, source);\n\n  let fmt_ctx: number | undefined;\n  let streams: LibavStream[] = [];\n  try {\n    const result = await libav.ff_init_demuxer_file(filename);\n    fmt_ctx = result[0];\n    streams = result[1];\n  } catch (err) {\n    await handle.detach().catch(() => {});\n    // Errors thrown across the libav.js worker/pthread boundary aren't\n    // always Error instances — they can be plain objects, numbers (errno\n    // codes), or strings. Stringify defensively so the user-facing message\n    // never has `(undefined)` in it.\n    const inner =\n      err instanceof Error\n        ? err.message\n        : typeof err === \"object\" && err !== null\n          ? JSON.stringify(err)\n          : String(err);\n    // eslint-disable-next-line no-console\n    console.error(\"[avbridge] ff_init_demuxer_file raw error:\", err);\n    throw new Error(\n      `libav.js could not demux ${filename}. The current libav variant likely lacks the required demuxer (e.g. AVI). See vendor/libav/README.md for build instructions. (${inner || \"no message — see console for raw error\"})`,\n    );\n  }\n\n  const videoTracks: VideoTrackInfo[] = [];\n  const audioTracks: AudioTrackInfo[] = [];\n\n  for (const stream of streams) {\n    const codecName = (await safe(() => libav.avcodec_get_name(stream.codec_id))) ?? `unknown(${stream.codec_id})`;\n    // codecpar holds width/height/channels/sample_rate/profile/level/extradata\n    // for the actual stream. We have to copy it out of WASM memory.\n    const codecpar = await safe(() => libav.ff_copyout_codecpar(stream.codecpar));\n\n    if (stream.codec_type === libav.AVMEDIA_TYPE_VIDEO) {\n      videoTracks.push({\n        id: stream.index,\n        codec: ffmpegToAvbridgeVideo(codecName),\n        width: codecpar?.width ?? 0,\n        height: codecpar?.height ?? 0,\n        fps: framerate(stream),\n      });\n    } else if (stream.codec_type === libav.AVMEDIA_TYPE_AUDIO) {\n      audioTracks.push({\n        id: stream.index,\n        codec: ffmpegToAvbridgeAudio(codecName),\n        channels: codecpar?.channels ?? codecpar?.ch_layout_nb_channels ?? 0,\n        sampleRate: codecpar?.sample_rate ?? 0,\n      });\n    }\n  }\n\n  // We need this duration but cannot reliably get it from the streams alone\n  // for AVI; libav.js exposes it via the AVFormatContext duration helper.\n  const duration = await safeDuration(libav, fmt_ctx!);\n\n  // Close the demuxer; the strategy will reopen it later if it ends up being\n  // chosen. Probing should not pin native resources.\n  await libav.avformat_close_input_js(fmt_ctx!).catch(() => {});\n  await handle.detach().catch(() => {});\n\n  return {\n    source: source.original,\n    name: source.name,\n    byteLength: source.byteLength,\n    container: sniffed === \"unknown\" ? \"unknown\" : sniffed,\n    videoTracks,\n    audioTracks,\n    subtitleTracks: [],\n    probedBy: \"libav\",\n    duration,\n  };\n}\n\nfunction framerate(stream: LibavStream): number | undefined {\n  if (typeof stream.avg_frame_rate_num === \"number\" && stream.avg_frame_rate_den) {\n    return stream.avg_frame_rate_num / stream.avg_frame_rate_den;\n  }\n  if (stream.avg_frame_rate && typeof stream.avg_frame_rate === \"object\") {\n    if (stream.avg_frame_rate.den === 0) return undefined;\n    return stream.avg_frame_rate.num / stream.avg_frame_rate.den;\n  }\n  return undefined;\n}\n\nasync function safeDuration(libav: LibavInstance, fmt_ctx: number): Promise<number | undefined> {\n  try {\n    // `AVFormatContext.duration` is an int64 in microseconds (AV_TIME_BASE).\n    // libav.js exposes it as a split lo/hi pair the same way it does for\n    // packet pts — `AVFormatContext_duration(ctx)` returns the low 32 bits,\n    // `AVFormatContext_durationhi(ctx)` returns the high 32 bits. Reading\n    // only the low half (the previous bug) gave garbage for any file whose\n    // duration > ~35 minutes, and zero for shorter files where the value\n    // happened to live in the high half.\n    const lo = await libav.AVFormatContext_duration?.(fmt_ctx);\n    const hi = await libav.AVFormatContext_durationhi?.(fmt_ctx);\n    if (typeof lo !== \"number\" || typeof hi !== \"number\") return undefined;\n\n    // AV_NOPTS_VALUE = -2^63 → ptshi = -2147483648, pts = 0. Means \"unknown\".\n    if (hi === -2147483648 && lo === 0) return undefined;\n\n    // Reconstruct the 64-bit value. Prefer libav's helper when available\n    // because it correctly handles signed 32-bit two's complement.\n    const us =\n      typeof libav.i64tof64 === \"function\"\n        ? libav.i64tof64(lo, hi)\n        : hi * 0x100000000 + lo + (lo < 0 ? 0x100000000 : 0);\n\n    if (!Number.isFinite(us) || us <= 0) return undefined;\n    return us / 1_000_000;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function safe<T>(fn: () => Promise<T> | T): Promise<T | undefined> {\n  try { return await fn(); } catch { return undefined; }\n}\n\n/** Map FFmpeg codec names to avbridge video codec identifiers. */\nfunction ffmpegToAvbridgeVideo(name: string): VideoCodec {\n  switch (name) {\n    case \"h264\":   return \"h264\";\n    case \"hevc\":   return \"h265\";\n    case \"vp8\":    return \"vp8\";\n    case \"vp9\":    return \"vp9\";\n    case \"av1\":    return \"av1\";\n    case \"mpeg4\":  return \"mpeg4\";   // MPEG-4 Part 2 / DivX / Xvid\n    case \"msmpeg4v1\":\n    case \"msmpeg4v2\":\n    case \"msmpeg4v3\":                 // a.k.a. DIV3\n      return \"mpeg4\";\n    case \"wmv1\":\n    case \"wmv2\":\n    case \"wmv3\":\n      return \"wmv3\";\n    case \"vc1\":    return \"vc1\";\n    case \"mpeg2video\": return \"mpeg2\";\n    case \"mpeg1video\": return \"mpeg1\";\n    case \"theora\": return \"theora\";\n    case \"rv10\":   return \"rv10\";\n    case \"rv20\":   return \"rv20\";\n    case \"rv30\":   return \"rv30\";\n    case \"rv40\":   return \"rv40\";\n    default:       return name as VideoCodec;\n  }\n}\n\nfunction ffmpegToAvbridgeAudio(name: string): AudioCodec {\n  switch (name) {\n    case \"aac\":    return \"aac\";\n    case \"mp3\":\n    case \"mp3float\":\n      return \"mp3\";\n    case \"opus\":   return \"opus\";\n    case \"vorbis\": return \"vorbis\";\n    case \"flac\":   return \"flac\";\n    case \"ac3\":    return \"ac3\";\n    case \"eac3\":   return \"eac3\";\n    case \"wmav1\":\n    case \"wmav2\":  return \"wmav2\";\n    case \"wmapro\": return \"wmapro\";\n    case \"alac\":   return \"alac\";\n    case \"cook\":   return \"cook\";\n    case \"ra_144\": return \"ra_144\";\n    case \"ra_288\": return \"ra_288\";\n    case \"sipr\":   return \"sipr\";\n    case \"atrac3\": return \"atrac3\";\n    case \"dca\":\n    case \"dts\":    return \"dts\";\n    case \"truehd\":\n    case \"mlp\":    return \"truehd\";\n    default:       return name as AudioCodec;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Minimal structural types for the slice of libav.js we touch.\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface LibavStream {\n  index: number;\n  codec_type: number;\n  codec_id: number;\n  codecpar: number;\n  avg_frame_rate?: { num: number; den: number };\n  avg_frame_rate_num?: number;\n  avg_frame_rate_den?: number;\n}\n\ninterface LibavCodecpar {\n  width?: number;\n  height?: number;\n  channels?: number;\n  ch_layout_nb_channels?: number;\n  sample_rate?: number;\n  profile?: number;\n  level?: number;\n}\n\ninterface LibavInstance {\n  mkreadaheadfile(name: string, blob: Blob): Promise<void>;\n  unlinkreadaheadfile(name: string): Promise<void>;\n  ff_init_demuxer_file(name: string): Promise<[number, LibavStream[]]>;\n  ff_copyout_codecpar(codecpar: number): Promise<LibavCodecpar>;\n  avcodec_get_name(codec_id: number): Promise<string>;\n  avformat_close_input_js(ctx: number): Promise<void>;\n  AVFormatContext_duration?(ctx: number): Promise<number>;\n  AVFormatContext_durationhi?(ctx: number): Promise<number>;\n  i64tof64?(lo: number, hi: number): number;\n\n  AVMEDIA_TYPE_VIDEO: number;\n  AVMEDIA_TYPE_AUDIO: number;\n}\n"]}