@intactfile/engines 0.1.0

package/dist/video/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Video engine subpath export (`@intactfile/engines/video`). Kept out of the
+ * root export so browser bundles that never remux video never see the
+ * libav.js wasm dependency; even here, the wasm only loads on the first
+ * remuxVideo call. diagnoseVideo is pure parsing and is also re-exported from
+ * the package root.
+ */
+export { diagnoseVideo } from './diagnose.js';
+export type { VideoDiagnosis, VideoDamageClass, VideoContainer, VideoBoxInfo } from './diagnose.js';
+export { remuxVideo, planRemux, outputContainerFor, REMUX_STRATEGIES, AVFMT_FLAG_GENPTS, AVFMT_FLAG_IGNIDX, } from './remux.js';
+export type { RemuxPlan, RemuxOptions, RemuxStrategy, RemuxStrategyId, RemuxAttempt, OutputContainer, VideoRepairOutcome, VideoRepairReport, } from './remux.js';
+export { setLibAVLoader, resetLibAVHost, getLibAV } from './libav-host.js';
+export type { LibAVLoader, LibAVWrapper, LibAVInstance } from './libav-host.js';
+export { scanMp4Boxes, scanMkv, scanAvi, checkMoovIntegrity } from './format.js';
+export type { Mp4Scan, Mp4Box, MkvScan, AviScan } from './format.js';
+export { reconstructMoov, chooseSampleSizes } from './reconstruct.js';
+export type { VideoReconstructReport, VideoReconstructOutcome, ReconstructOptions, ReconstructStrategy, } from './reconstruct.js';
+export { setMp4BoxLoader, resetMp4BoxHost, getMp4Box, parseReferenceMoov, ReferenceParseError, } from './mp4box-host.js';
+export type { Mp4BoxLoader, Mp4BoxModule } from './mp4box-host.js';
+export type { MoovTemplate, MoovTemplateTrack } from './mp4-rebuild.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKrE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/video/index.js

@@ -0,0 +1,17 @@
+/**
+ * Video engine subpath export (`@intactfile/engines/video`). Kept out of the
+ * root export so browser bundles that never remux video never see the
+ * libav.js wasm dependency; even here, the wasm only loads on the first
+ * remuxVideo call. diagnoseVideo is pure parsing and is also re-exported from
+ * the package root.
+ */
+export { diagnoseVideo } from './diagnose.js';
+export { remuxVideo, planRemux, outputContainerFor, REMUX_STRATEGIES, AVFMT_FLAG_GENPTS, AVFMT_FLAG_IGNIDX, } from './remux.js';
+export { setLibAVLoader, resetLibAVHost, getLibAV } from './libav-host.js';
+export { scanMp4Boxes, scanMkv, scanAvi, checkMoovIntegrity } from './format.js';
+// Untrunc-class moov reconstruction (reference-file, clean-room TS). Kept out
+// of the pure root diagnose path; it only pulls in mp4box.js (a parser) on the
+// first reconstructMoov call, via the injectable mp4box host.
+export { reconstructMoov, chooseSampleSizes } from './reconstruct.js';
+export { setMp4BoxLoader, resetMp4BoxHost, getMp4Box, parseReferenceMoov, ReferenceParseError, } from './mp4box-host.js';
+//# sourceMappingURL=index.js.map

package/dist/video/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAWpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjF,8EAA8E;AAC9E,+EAA+E;AAC/E,8DAA8D;AAC9D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOtE,OAAO,EACL,eAAe,EACf,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/video/libav-host.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Isolated host for libav.js (@libav.js/variant-webcodecs 6.9.8, LGPL-2.1).
+ *
+ * Variant choice: `webcodecs` is the lightest official variant that carries
+ * the demuxers+muxers we need for container repair — mov/mp4/3gp demux, mp4 +
+ * mov mux, matroska demux (mkv AND webm), matroska + webm mux, ogg/flac/wav —
+ * with NO video encoders/decoders (only parsers/bsfs for h264/hevc/vp8/vp9/
+ * av1/aac, and small LGPL-safe audio codecs: libopus/flac/pcm).
+ * wasm size: ~2.30 MB single-threaded (libav-6.9.8.1-webcodecs.wasm.wasm).
+ * NOTE: no official variant ships an AVI demuxer; AVI remux honestly fails
+ * until we ship a custom fragment build (configs fragment `demuxer-avi`).
+ *
+ * Loading is injectable, same pattern as pdf/qpdf-host.ts: Node's default
+ * loader resolves the CJS wrapper from node_modules; a browser host calls
+ * setLibAVLoader() with the wrapper module and factory options (e.g. a
+ * `base`/`wasmurl` pointing at R2) before using remuxVideo.
+ */
+/** The (small) slice of the libav.js instance API this package calls. */
+export interface LibAVInstance {
+    AVERROR_EOF: number;
+    AVIO_FLAG_WRITE: number;
+    AVMEDIA_TYPE_VIDEO: number;
+    AVMEDIA_TYPE_AUDIO: number;
+    writeFile(name: string, content: Uint8Array): Promise<unknown>;
+    readFile(name: string): Promise<Uint8Array>;
+    unlink(name: string): Promise<void>;
+    avformat_open_input_js(url: string, fmt: number, options: number): Promise<number>;
+    avformat_find_stream_info(ic: number, options: number): Promise<number>;
+    avformat_close_input_js(ic: number): Promise<void>;
+    av_read_frame(ic: number, pkt: number): Promise<number>;
+    AVFormatContext_flags(ptr: number): Promise<number>;
+    AVFormatContext_flags_s(ptr: number, val: number): Promise<void>;
+    AVFormatContext_nb_streams(ptr: number): Promise<number>;
+    AVFormatContext_streams_a(ptr: number, idx: number): Promise<number>;
+    AVFormatContext_duration(ptr: number): Promise<number>;
+    AVFormatContext_durationhi(ptr: number): Promise<number>;
+    AVStream_codecpar(ptr: number): Promise<number>;
+    AVStream_time_base_num(ptr: number): Promise<number>;
+    AVStream_time_base_den(ptr: number): Promise<number>;
+    AVCodecParameters_codec_type(ptr: number): Promise<number>;
+    AVCodecParameters_codec_tag_s(ptr: number, val: number): Promise<void>;
+    avformat_alloc_output_context2_js(oformat: number, formatName: string | null, filename: string): Promise<number>;
+    avformat_new_stream(oc: number, c: number): Promise<number>;
+    avcodec_parameters_copy(dst: number, src: number): Promise<number>;
+    av_opt_set(obj: number, name: string, val: string, searchFlags: number): Promise<number>;
+    avio_open2_js(url: string, flags: number, intCb: number, options: number): Promise<number>;
+    avio_close(pb: number): Promise<number>;
+    AVFormatContext_pb_s(ptr: number, val: number): Promise<void>;
+    avformat_write_header(oc: number, options: number): Promise<number>;
+    av_interleaved_write_frame(oc: number, pkt: number): Promise<number>;
+    av_write_trailer(oc: number): Promise<number>;
+    avformat_free_context(oc: number): Promise<void>;
+    av_packet_alloc(): Promise<number>;
+    av_packet_free_js(pkt: number): Promise<void>;
+    av_packet_unref(pkt: number): Promise<void>;
+    av_packet_rescale_ts_js(pkt: number, tbSrcNum: number, tbSrcDen: number, tbDstNum: number, tbDstDen: number): Promise<void>;
+    AVPacket_stream_index(pkt: number): Promise<number>;
+    AVPacket_stream_index_s(pkt: number, val: number): Promise<void>;
+    AVPacket_flags(pkt: number): Promise<number>;
+    AVPacket_pts(pkt: number): Promise<number>;
+    AVPacket_ptshi(pkt: number): Promise<number>;
+    AVPacket_duration(pkt: number): Promise<number>;
+    AVPacket_durationhi(pkt: number): Promise<number>;
+    AVPacket_pos_s(pkt: number, val: number): Promise<void>;
+    AVPacket_poshi_s(pkt: number, val: number): Promise<void>;
+}
+/** A libav.js wrapper module (the thing whose `.LibAV()` creates instances). */
+export interface LibAVWrapper {
+    LibAV(opts?: Record<string, unknown>): Promise<unknown>;
+}
+export interface LibAVLoader {
+    wrapper: LibAVWrapper;
+    /** Options for the factory (noworker, base, wasmurl, ...). */
+    factoryOpts?: Record<string, unknown>;
+}
+/** Inject how the libav.js wrapper is obtained (browser hosts). */
+export declare function setLibAVLoader(load: () => Promise<LibAVLoader>): void;
+/** Drop the cached instance (tests, or after a wasm crash). */
+export declare function resetLibAVHost(): void;
+/**
+ * The libav.js instance is a reusable library (unlike the one-shot qpdf CLI):
+ * it is created once and cached. Runs are serialized so MEMFS filenames and
+ * memory pressure never interact between concurrent repairs.
+ */
+export declare function getLibAV(): Promise<LibAVInstance>;
+/** Serialized, exclusive access to the shared libav instance. */
+export declare function withLibAV<T>(fn: (libav: LibAVInstance, runId: number) => Promise<T>): Promise<T>;
+//# sourceMappingURL=libav-host.d.ts.map

package/dist/video/libav-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libav-host.d.ts","sourceRoot":"","sources":["../../src/video/libav-host.ts"],"names":[],"mappings":"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"}

package/dist/video/libav-host.js

@@ -0,0 +1,66 @@
+/**
+ * Isolated host for libav.js (@libav.js/variant-webcodecs 6.9.8, LGPL-2.1).
+ *
+ * Variant choice: `webcodecs` is the lightest official variant that carries
+ * the demuxers+muxers we need for container repair — mov/mp4/3gp demux, mp4 +
+ * mov mux, matroska demux (mkv AND webm), matroska + webm mux, ogg/flac/wav —
+ * with NO video encoders/decoders (only parsers/bsfs for h264/hevc/vp8/vp9/
+ * av1/aac, and small LGPL-safe audio codecs: libopus/flac/pcm).
+ * wasm size: ~2.30 MB single-threaded (libav-6.9.8.1-webcodecs.wasm.wasm).
+ * NOTE: no official variant ships an AVI demuxer; AVI remux honestly fails
+ * until we ship a custom fragment build (configs fragment `demuxer-avi`).
+ *
+ * Loading is injectable, same pattern as pdf/qpdf-host.ts: Node's default
+ * loader resolves the CJS wrapper from node_modules; a browser host calls
+ * setLibAVLoader() with the wrapper module and factory options (e.g. a
+ * `base`/`wasmurl` pointing at R2) before using remuxVideo.
+ */
+let loaderOverride = null;
+let instancePromise = null;
+/** Inject how the libav.js wrapper is obtained (browser hosts). */
+export function setLibAVLoader(load) {
+    loaderOverride = load;
+    instancePromise = null;
+}
+/** Drop the cached instance (tests, or after a wasm crash). */
+export function resetLibAVHost() {
+    instancePromise = null;
+}
+async function defaultNodeLoader() {
+    const isNode = typeof process !== 'undefined' && !!process.versions?.node;
+    if (!isNode) {
+        throw new Error('libav host: no loader configured. In the browser, call setLibAVLoader() with the ' +
+            '@libav.js/variant-webcodecs wrapper and a base/wasm URL before remuxing video.');
+    }
+    const { createRequire } = await import('node:module');
+    const require = createRequire(import.meta.url);
+    const wrapper = require('@libav.js/variant-webcodecs');
+    return { wrapper, factoryOpts: { noworker: true } };
+}
+async function createInstance() {
+    const { wrapper, factoryOpts } = await (loaderOverride ?? defaultNodeLoader)();
+    const instance = await wrapper.LibAV({ noworker: true, ...factoryOpts });
+    return instance;
+}
+/**
+ * The libav.js instance is a reusable library (unlike the one-shot qpdf CLI):
+ * it is created once and cached. Runs are serialized so MEMFS filenames and
+ * memory pressure never interact between concurrent repairs.
+ */
+export function getLibAV() {
+    instancePromise ??= createInstance().catch((e) => {
+        instancePromise = null;
+        throw e;
+    });
+    return instancePromise;
+}
+let runChain = Promise.resolve();
+let runCounter = 0;
+/** Serialized, exclusive access to the shared libav instance. */
+export function withLibAV(fn) {
+    const id = runCounter++;
+    const run = runChain.then(async () => fn(await getLibAV(), id));
+    runChain = run.catch(() => undefined);
+    return run;
+}
+//# sourceMappingURL=libav-host.js.map

package/dist/video/libav-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libav-host.js","sourceRoot":"","sources":["../../src/video/libav-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAwEH,IAAI,cAAc,GAAwC,IAAI,CAAC;AAC/D,IAAI,eAAe,GAAkC,IAAI,CAAC;AAE1D,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,IAAgC;IAC7D,cAAc,GAAG,IAAI,CAAC;IACtB,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc;IAC5B,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,gFAAgF,CACnF,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,6BAA6B,CAAiB,CAAC;IACvE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,cAAc,IAAI,iBAAiB,CAAC,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IACzE,OAAO,QAAyB,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,eAAe,KAAK,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;QACxD,eAAe,GAAG,IAAI,CAAC;QACvB,MAAM,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;IACH,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,IAAI,QAAQ,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;AACnD,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAI,EAAuD;IAClF,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAChE,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/video/mp4-rebuild.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Pure, wasm-free primitives for untrunc-class moov reconstruction:
+ *   - MP4 box byte writers (u8/u16/u32/u64, box, fullBox, cat);
+ *   - sample-boundary scanning of a raw mdat payload (length-prefixed H.264/
+ *     H.265 NAL units → access units, plus a standalone ADTS/AAC scanner);
+ *   - a sample-table (stbl) builder and moov assembler from a reference-derived
+ *     MoovTemplate.
+ *
+ * Nothing here touches mp4box.js or libav.js — the reference is parsed
+ * elsewhere (mp4box-host.ts) into a MoovTemplate of raw serialized boxes plus
+ * scalar cadence, and these functions turn a scanned sample list into a
+ * playable moov. That keeps the hard-to-test glue thin and everything below
+ * unit-testable with hand-built byte arrays.
+ *
+ * This is a clean-room reimplementation of the *idea* behind untrunc
+ * (reconstruct an index from raw media using a same-camera reference). No line
+ * of the GPL-2.0 untrunc source is copied or linked.
+ */
+export declare function u8(v: number): Uint8Array;
+export declare function u16(v: number): Uint8Array;
+export declare function u32(v: number): Uint8Array;
+export declare function u64(v: number): Uint8Array;
+export declare function cat(...parts: Uint8Array[]): Uint8Array;
+/** A plain box: [size][type][...children]. */
+export declare function box(type: string, ...children: Uint8Array[]): Uint8Array;
+/** A FullBox: [size][type][version][flags:24][...children]. */
+export declare function fullBox(type: string, version: number, flags: number, ...children: Uint8Array[]): Uint8Array;
+export declare function readU32(bytes: Uint8Array, offset: number): number;
+export type VideoNalCodec = 'avc' | 'hevc';
+/** Map an stsd sample-entry fourcc to the NAL codec family, or null. */
+export declare function nalCodecForFourcc(fourcc: string): VideoNalCodec | null;
+/**
+ * Read the NAL length field size from a serialized stsd box by locating the
+ * avcC / hvcC config record. Returns 1..4, or null when neither is present.
+ *
+ * avcC: lengthSizeMinusOne lives in the 5th payload byte (low 2 bits).
+ * hvcC: lengthSizeMinusOne lives in payload byte 21 (low 2 bits).
+ */
+export declare function nalLengthSizeFromStsd(stsd: Uint8Array): number | null;
+export interface NalUnit {
+    /** Offset of the length prefix, relative to the payload start. */
+    start: number;
+    /** Total bytes of this unit (length prefix + NAL body). */
+    size: number;
+    /** NAL unit type (H.264: byte&0x1f; H.265: (byte>>1)&0x3f). */
+    type: number;
+    isVcl: boolean;
+    isAud: boolean;
+}
+/**
+ * Walk a length-prefixed NAL stream (AVCC / HVCC in-mp4 storage). Stops at the
+ * first byte where a length prefix would read past the end (a truncated tail),
+ * or where a zero/implausible length appears (padding).
+ */
+export declare function scanLengthPrefixedNals(payload: Uint8Array, nalLengthSize: number, codec: VideoNalCodec): {
+    nals: NalUnit[];
+    bytesConsumed: number;
+    truncatedTail: boolean;
+};
+/**
+ * Group NAL units into access units (= samples). Heuristic (single-slice per
+ * picture, which covers recorder output and our corpus):
+ *   - non-VCL units (SPS/PPS/VPS/SEI/AUD) attach to the *following* sample;
+ *   - once a sample already contains a VCL unit, the next unit starts a new
+ *     sample.
+ * Multi-slice pictures would be over-split; the caller reconciles against the
+ * reference sample count and falls back to the reference size model when they
+ * disagree.
+ */
+export declare function groupNalsIntoSamples(nals: readonly NalUnit[]): number[];
+export interface SampleScan {
+    sizes: number[];
+    bytesAccounted: number;
+    leftoverBytes: number;
+    truncatedTail: boolean;
+    nalCount: number;
+}
+/** Full scan of a video mdat payload → per-sample sizes. */
+export declare function scanAvcHevcSamples(payload: Uint8Array, nalLengthSize: number, codec: VideoNalCodec): SampleScan;
+/**
+ * Standalone ADTS/AAC frame scanner. Only relevant when the raw payload is an
+ * ADTS elementary stream (some recorders); raw AAC stored inside mp4 mdat is
+ * *not* ADTS-framed and must instead be sized from the reference stsz. Provided
+ * for completeness and unit-tested independently.
+ */
+export declare function scanAdtsFrames(payload: Uint8Array): {
+    sizes: number[];
+    bytesAccounted: number;
+    leftoverBytes: number;
+};
+export interface MoovTemplateTrack {
+    trackId: number;
+    /** 'vide' | 'soun' | ... (from hdlr). */
+    handlerType: string;
+    /** stsd first sample-entry fourcc, e.g. 'avc1'. */
+    codecFourcc: string;
+    /** Full codec string when available, e.g. 'avc1.42c01e'. */
+    codec: string | null;
+    mediaTimescale: number;
+    /** stts entries from the reference (count/delta pairs). */
+    sttsEntries: {
+        count: number;
+        delta: number;
+    }[];
+    /** Reference sample count (stsz.sample_count). */
+    sampleCount: number;
+    /** stsz.sample_size (0 ⇒ per-sample table). */
+    constantSampleSize: number;
+    /** Reference per-sample size table (empty when constant). */
+    sampleSizes: number[];
+    /** stss present in the reference (sparse sync samples). */
+    hasStss: boolean;
+    syncSamples: number[];
+    /** NAL length field size (avc/hevc) or null. */
+    nalLengthSize: number | null;
+    tkhd: Uint8Array;
+    mdhd: Uint8Array;
+    hdlr: Uint8Array;
+    /** minf media header: vmhd / smhd / etc. */
+    minfHeader: Uint8Array;
+    dinf: Uint8Array;
+    stsd: Uint8Array;
+}
+export interface MoovTemplate {
+    movieTimescale: number;
+    movieDuration: number;
+    /** Raw serialized mvhd, reused verbatim. */
+    mvhd: Uint8Array;
+    tracks: MoovTemplateTrack[];
+}
+export interface StblParams {
+    /** Verbatim stsd box from the reference (codec config). */
+    stsd: Uint8Array;
+    /** Per-sample byte sizes, in decode order. */
+    sampleSizes: number[];
+    /** Time-to-sample entries (count/delta pairs). */
+    stts: {
+        count: number;
+        delta: number;
+    }[];
+    /** Absolute file offset of the first sample (mdat payload start). */
+    chunkOffset: number;
+    /** 1-based sync sample numbers, or null to omit stss (⇒ every sample syncs). */
+    syncSamples: number[] | null;
+}
+/** Build a complete stbl box (stsd, stts, stsc, stsz, stco/co64[, stss]). */
+export declare function buildStbl(p: StblParams): Uint8Array;
+/** Assemble a single-track moov: moov(mvhd, trak(tkhd, mdia(mdhd, hdlr, minf(header, dinf, stbl)))). */
+export declare function assembleMoov(template: MoovTemplate, track: MoovTemplateTrack, stbl: Uint8Array): Uint8Array;
+/** Minimal ftyp used only when the broken file has none. */
+export declare function defaultFtyp(): Uint8Array;
+/**
+ * Splice a faststart MP4: ftyp + moov + mdat(payload). The moov is built twice
+ * so the stco chunk offset can point at the final mdat payload location; the
+ * moov length is independent of the offset *value*, so the two builds are the
+ * same size and the offset is stable.
+ */
+export declare function spliceFaststartMp4(template: MoovTemplate, track: MoovTemplateTrack, params: {
+    stsd: Uint8Array;
+    sampleSizes: number[];
+    stts: {
+        count: number;
+        delta: number;
+    }[];
+    syncSamples: number[] | null;
+}, ftyp: Uint8Array, payload: Uint8Array): Uint8Array;
+//# sourceMappingURL=mp4-rebuild.d.ts.map

package/dist/video/mp4-rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp4-rebuild.d.ts","sourceRoot":"","sources":["../../src/video/mp4-rebuild.ts"],"names":[],"mappings":"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"}

package/dist/video/mp4-rebuild.js

@@ -0,0 +1,270 @@
+/**
+ * Pure, wasm-free primitives for untrunc-class moov reconstruction:
+ *   - MP4 box byte writers (u8/u16/u32/u64, box, fullBox, cat);
+ *   - sample-boundary scanning of a raw mdat payload (length-prefixed H.264/
+ *     H.265 NAL units → access units, plus a standalone ADTS/AAC scanner);
+ *   - a sample-table (stbl) builder and moov assembler from a reference-derived
+ *     MoovTemplate.
+ *
+ * Nothing here touches mp4box.js or libav.js — the reference is parsed
+ * elsewhere (mp4box-host.ts) into a MoovTemplate of raw serialized boxes plus
+ * scalar cadence, and these functions turn a scanned sample list into a
+ * playable moov. That keeps the hard-to-test glue thin and everything below
+ * unit-testable with hand-built byte arrays.
+ *
+ * This is a clean-room reimplementation of the *idea* behind untrunc
+ * (reconstruct an index from raw media using a same-camera reference). No line
+ * of the GPL-2.0 untrunc source is copied or linked.
+ */
+// ---------------------------------------------------------------------------
+// Byte writers (mirrors the corpus generator's box helpers, kept independent)
+// ---------------------------------------------------------------------------
+const te = new TextEncoder();
+export function u8(v) {
+    return new Uint8Array([v & 0xff]);
+}
+export function u16(v) {
+    return new Uint8Array([(v >>> 8) & 0xff, v & 0xff]);
+}
+export function u32(v) {
+    return new Uint8Array([(v >>> 24) & 0xff, (v >>> 16) & 0xff, (v >>> 8) & 0xff, v & 0xff]);
+}
+export function u64(v) {
+    const out = new Uint8Array(8);
+    out.set(u32(Math.floor(v / 0x1_0000_0000)), 0);
+    out.set(u32(v % 0x1_0000_0000), 4);
+    return out;
+}
+export function cat(...parts) {
+    let total = 0;
+    for (const p of parts)
+        total += p.length;
+    const out = new Uint8Array(total);
+    let pos = 0;
+    for (const p of parts) {
+        out.set(p, pos);
+        pos += p.length;
+    }
+    return out;
+}
+/** A plain box: [size][type][...children]. */
+export function box(type, ...children) {
+    const body = cat(...children);
+    return cat(u32(body.length + 8), te.encode(type), body);
+}
+/** A FullBox: [size][type][version][flags:24][...children]. */
+export function fullBox(type, version, flags, ...children) {
+    return box(type, new Uint8Array([version & 0xff, (flags >>> 16) & 0xff, (flags >>> 8) & 0xff, flags & 0xff]), ...children);
+}
+export function readU32(bytes, offset) {
+    return ((bytes[offset] << 24) | (bytes[offset + 1] << 16) | (bytes[offset + 2] << 8) | bytes[offset + 3]) >>> 0;
+}
+/** Map an stsd sample-entry fourcc to the NAL codec family, or null. */
+export function nalCodecForFourcc(fourcc) {
+    if (fourcc === 'avc1' || fourcc === 'avc3')
+        return 'avc';
+    if (fourcc === 'hvc1' || fourcc === 'hev1')
+        return 'hevc';
+    return null;
+}
+/**
+ * Read the NAL length field size from a serialized stsd box by locating the
+ * avcC / hvcC config record. Returns 1..4, or null when neither is present.
+ *
+ * avcC: lengthSizeMinusOne lives in the 5th payload byte (low 2 bits).
+ * hvcC: lengthSizeMinusOne lives in payload byte 21 (low 2 bits).
+ */
+export function nalLengthSizeFromStsd(stsd) {
+    const avcC = indexOfAscii(stsd, 'avcC');
+    if (avcC >= 0) {
+        const b = stsd[avcC + 4 + 4];
+        if (b !== undefined)
+            return (b & 0x03) + 1;
+    }
+    const hvcC = indexOfAscii(stsd, 'hvcC');
+    if (hvcC >= 0) {
+        const b = stsd[hvcC + 4 + 21];
+        if (b !== undefined)
+            return (b & 0x03) + 1;
+    }
+    return null;
+}
+function indexOfAscii(bytes, needle) {
+    const n = te.encode(needle);
+    outer: for (let i = 0; i + n.length <= bytes.length; i += 1) {
+        for (let j = 0; j < n.length; j += 1) {
+            if (bytes[i + j] !== n[j])
+                continue outer;
+        }
+        return i;
+    }
+    return -1;
+}
+/**
+ * Walk a length-prefixed NAL stream (AVCC / HVCC in-mp4 storage). Stops at the
+ * first byte where a length prefix would read past the end (a truncated tail),
+ * or where a zero/implausible length appears (padding).
+ */
+export function scanLengthPrefixedNals(payload, nalLengthSize, codec) {
+    const nals = [];
+    const end = payload.length;
+    let p = 0;
+    let truncatedTail = false;
+    while (p + nalLengthSize <= end) {
+        let len = 0;
+        for (let i = 0; i < nalLengthSize; i += 1)
+            len = len * 256 + payload[p + i];
+        if (len <= 0)
+            break; // padding / invalid: stop cleanly
+        const bodyStart = p + nalLengthSize;
+        const unitEnd = bodyStart + len;
+        if (unitEnd > end) {
+            truncatedTail = true; // a real unit is cut short
+            break;
+        }
+        const header = payload[bodyStart];
+        const secondByte = payload[bodyStart + 1] ?? 0;
+        const info = classifyNal(header, secondByte, codec);
+        nals.push({ start: p, size: nalLengthSize + len, type: info.type, isVcl: info.isVcl, isAud: info.isAud });
+        p = unitEnd;
+    }
+    return { nals, bytesConsumed: p, truncatedTail };
+}
+function classifyNal(header, _second, codec) {
+    if (codec === 'avc') {
+        const type = header & 0x1f;
+        return { type, isVcl: type >= 1 && type <= 5, isAud: type === 9 };
+    }
+    // HEVC: forbidden_zero_bit(1) | nal_unit_type(6) | layer_id | tid
+    const type = (header >> 1) & 0x3f;
+    return { type, isVcl: type <= 31, isAud: type === 35 };
+}
+/**
+ * Group NAL units into access units (= samples). Heuristic (single-slice per
+ * picture, which covers recorder output and our corpus):
+ *   - non-VCL units (SPS/PPS/VPS/SEI/AUD) attach to the *following* sample;
+ *   - once a sample already contains a VCL unit, the next unit starts a new
+ *     sample.
+ * Multi-slice pictures would be over-split; the caller reconciles against the
+ * reference sample count and falls back to the reference size model when they
+ * disagree.
+ */
+export function groupNalsIntoSamples(nals) {
+    const sizes = [];
+    let curSize = 0;
+    let curHasVcl = false;
+    for (const nal of nals) {
+        const startNew = curSize > 0 && (curHasVcl || nal.isAud);
+        if (startNew) {
+            sizes.push(curSize);
+            curSize = 0;
+            curHasVcl = false;
+        }
+        curSize += nal.size;
+        if (nal.isVcl)
+            curHasVcl = true;
+    }
+    if (curSize > 0)
+        sizes.push(curSize);
+    return sizes;
+}
+/** Full scan of a video mdat payload → per-sample sizes. */
+export function scanAvcHevcSamples(payload, nalLengthSize, codec) {
+    const { nals, bytesConsumed, truncatedTail } = scanLengthPrefixedNals(payload, nalLengthSize, codec);
+    const sizes = groupNalsIntoSamples(nals);
+    const bytesAccounted = sizes.reduce((n, s) => n + s, 0);
+    return {
+        sizes,
+        bytesAccounted,
+        leftoverBytes: payload.length - bytesConsumed,
+        truncatedTail,
+        nalCount: nals.length,
+    };
+}
+/**
+ * Standalone ADTS/AAC frame scanner. Only relevant when the raw payload is an
+ * ADTS elementary stream (some recorders); raw AAC stored inside mp4 mdat is
+ * *not* ADTS-framed and must instead be sized from the reference stsz. Provided
+ * for completeness and unit-tested independently.
+ */
+export function scanAdtsFrames(payload) {
+    const sizes = [];
+    const end = payload.length;
+    let p = 0;
+    while (p + 7 <= end) {
+        // syncword: 0xFFF (12 bits)
+        if (payload[p] !== 0xff || (payload[p + 1] & 0xf0) !== 0xf0)
+            break;
+        // aac_frame_length: 13 bits spanning bytes 3..5
+        const len = ((payload[p + 3] & 0x03) << 11) | (payload[p + 4] << 3) | ((payload[p + 5] & 0xe0) >> 5);
+        if (len < 7 || p + len > end)
+            break;
+        sizes.push(len);
+        p += len;
+    }
+    const bytesAccounted = sizes.reduce((n, s) => n + s, 0);
+    return { sizes, bytesAccounted, leftoverBytes: end - p };
+}
+/** Build a complete stbl box (stsd, stts, stsc, stsz, stco/co64[, stss]). */
+export function buildStbl(p) {
+    const n = p.sampleSizes.length;
+    const sttsEntries = p.stts.length > 0 ? p.stts : [{ count: n, delta: 0 }];
+    const sttsBody = [u32(sttsEntries.length)];
+    for (const e of sttsEntries)
+        sttsBody.push(u32(e.count), u32(e.delta));
+    const stts = fullBox('stts', 0, 0, ...sttsBody);
+    // One chunk holding every sample: first_chunk=1, samples_per_chunk=n, sdi=1.
+    const stsc = fullBox('stsc', 0, 0, u32(1), u32(1), u32(n), u32(1));
+    const allEqual = n > 0 && p.sampleSizes.every((s) => s === p.sampleSizes[0]);
+    let stsz;
+    if (allEqual) {
+        stsz = fullBox('stsz', 0, 0, u32(p.sampleSizes[0]), u32(n));
+    }
+    else {
+        const sizes = p.sampleSizes.map((s) => u32(s));
+        stsz = fullBox('stsz', 0, 0, u32(0), u32(n), ...sizes);
+    }
+    let stco;
+    if (p.chunkOffset > 0xffffffff) {
+        stco = fullBox('co64', 0, 0, u32(1), u64(p.chunkOffset));
+    }
+    else {
+        stco = fullBox('stco', 0, 0, u32(1), u32(p.chunkOffset));
+    }
+    const children = [p.stsd, stts, stsc, stsz, stco];
+    if (p.syncSamples && p.syncSamples.length > 0) {
+        const body = [u32(p.syncSamples.length)];
+        for (const s of p.syncSamples)
+            body.push(u32(s));
+        children.push(fullBox('stss', 0, 0, ...body));
+    }
+    return box('stbl', ...children);
+}
+/** Assemble a single-track moov: moov(mvhd, trak(tkhd, mdia(mdhd, hdlr, minf(header, dinf, stbl)))). */
+export function assembleMoov(template, track, stbl) {
+    const minf = box('minf', track.minfHeader, track.dinf, stbl);
+    const mdia = box('mdia', track.mdhd, track.hdlr, minf);
+    const trak = box('trak', track.tkhd, mdia);
+    return box('moov', template.mvhd, trak);
+}
+/** Minimal ftyp used only when the broken file has none. */
+export function defaultFtyp() {
+    return box('ftyp', te.encode('isom'), u32(512), te.encode('isomiso2avc1mp41'));
+}
+/**
+ * Splice a faststart MP4: ftyp + moov + mdat(payload). The moov is built twice
+ * so the stco chunk offset can point at the final mdat payload location; the
+ * moov length is independent of the offset *value*, so the two builds are the
+ * same size and the offset is stable.
+ */
+export function spliceFaststartMp4(template, track, params, ftyp, payload) {
+    const MDAT_HEADER = 8;
+    const probe = buildStbl({ ...params, chunkOffset: 0 });
+    const probeMoov = assembleMoov(template, track, probe);
+    const chunkOffset = ftyp.length + probeMoov.length + MDAT_HEADER;
+    const stbl = buildStbl({ ...params, chunkOffset });
+    const moov = assembleMoov(template, track, stbl);
+    const mdat = box('mdat', payload);
+    return cat(ftyp, moov, mdat);
+}
+//# sourceMappingURL=mp4-rebuild.js.map