@intactfile/engines 0.1.0

package/dist/video/reconstruct.js

@@ -0,0 +1,271 @@
+import { MemorySource } from '../byte-source.js';
+import { diagnoseVideo } from './diagnose.js';
+import { scanMp4Boxes } from './format.js';
+import { defaultFtyp, nalCodecForFourcc, scanAvcHevcSamples, spliceFaststartMp4, } from './mp4-rebuild.js';
+import { getMp4Box, parseReferenceMoov, ReferenceParseError, setMp4BoxLoader, resetMp4BoxHost, } from './mp4box-host.js';
+export { setMp4BoxLoader, resetMp4BoxHost, getMp4Box, parseReferenceMoov, ReferenceParseError };
+const MP4_CONTAINERS = new Set(['mp4', 'mov']);
+/**
+ * Reconstruct a missing moov for `broken` using `reference` as a template.
+ * Returns the rebuilt file plus an honest report. On any failure the returned
+ * `video` is empty (0 bytes) — never fabricated.
+ */
+export async function reconstructMoov(broken, reference, opts = {}) {
+    const notes = [];
+    const diagnosis = opts.diagnosis ?? (await diagnoseVideo(broken));
+    const base = {
+        damageClass: diagnosis.damageClass,
+        container: diagnosis.container,
+        bytesIn: broken.size,
+    };
+    const fail = (reason, extra = {}) => {
+        notes.push(reason);
+        return {
+            video: new Uint8Array(0),
+            report: {
+                outcome: 'failed',
+                ...base,
+                confidence: extra.confidence ?? 'high',
+                reason,
+                usedReference: extra.usedReference ?? false,
+                referenceTracks: extra.referenceTracks ?? 0,
+                referenceCodec: extra.referenceCodec ?? null,
+                strategy: extra.strategy ?? null,
+                samplesRecovered: extra.samplesRecovered ?? 0,
+                mdatPayloadBytes: extra.mdatPayloadBytes ?? 0,
+                bytesAccounted: extra.bytesAccounted ?? 0,
+                leftoverBytes: extra.leftoverBytes ?? 0,
+                truncatedTail: extra.truncatedTail ?? false,
+                sampleCountMismatch: extra.sampleCountMismatch ?? false,
+                reDiagnosis: extra.reDiagnosis ?? null,
+                notes,
+                bytesIn: broken.size,
+                bytesOut: 0,
+            },
+        };
+    };
+    // --- 1. The broken file must be a missing-moov MP4/MOV with an mdat. ------
+    if (!MP4_CONTAINERS.has(diagnosis.container)) {
+        return fail(`moov reconstruction only applies to MP4/MOV; input diagnosed as "${diagnosis.container}". ` +
+            'MKV/WebM/AVI indexes are rebuilt by the remux engine instead.');
+    }
+    const brokenScan = await scanMp4Boxes(broken, diagnosis.dataOffset);
+    if (brokenScan.hasMoov) {
+        return fail('the broken file already has a moov: this is a remux/broken-index case, not moov ' +
+            'reconstruction. Use remuxVideo instead.');
+    }
+    const mdat = brokenScan.boxes.find((b) => b.type === 'mdat');
+    if (!mdat) {
+        return fail('no mdat box in the broken file: there is no media payload to reconstruct an index from.');
+    }
+    // --- 2. Parse the reference moov (mp4box.js) into a template. -------------
+    if (opts.mp4boxLoader) {
+        // setMp4BoxLoader also clears the cached module, so the override takes hold.
+        setMp4BoxLoader(opts.mp4boxLoader);
+    }
+    if (reference.size < 8) {
+        return fail('no reference provided: reconstruction needs a healthy same-camera reference clip.');
+    }
+    let template;
+    try {
+        const refBytes = await reference.read(0, reference.size);
+        template = await parseReferenceMoov(refBytes);
+    }
+    catch (e) {
+        if (e instanceof ReferenceParseError) {
+            return fail(e.message, { usedReference: false });
+        }
+        return fail(`mp4box could not load/parse the reference: ${e instanceof Error ? e.message : String(e)}`, { usedReference: false });
+    }
+    const referenceCodec = template.tracks[0]?.codec ?? template.tracks[0]?.codecFourcc ?? null;
+    const refInfo = { usedReference: true, referenceTracks: template.tracks.length, referenceCodec };
+    // --- 3. Scope: single-track reconstruction (timebox). --------------------
+    if (template.tracks.length !== 1) {
+        return fail(`reference has ${template.tracks.length} tracks; multi-track reconstruction is not yet supported. ` +
+            'Interleaved video+audio needs mdat de-interleaving from the reference chunk cadence (see TODO).', refInfo);
+    }
+    const track = template.tracks[0];
+    const nalCodec = nalCodecForFourcc(track.codecFourcc);
+    // --- 4. Read the mdat payload and scan for sample boundaries. ------------
+    const headerSize = mdat.largesize ? 16 : 8;
+    const payloadStart = mdat.offset + headerSize;
+    const declaredEnd = mdat.offset + mdat.size;
+    const payloadEnd = Math.min(declaredEnd > mdat.offset ? declaredEnd : broken.size, broken.size);
+    const payload = await broken.read(payloadStart, Math.max(0, payloadEnd - payloadStart));
+    if (payload.length === 0) {
+        return fail('the mdat payload is empty; nothing to reconstruct.', refInfo);
+    }
+    let scan = null;
+    if (track.handlerType === 'vide' && nalCodec && track.nalLengthSize) {
+        scan = scanAvcHevcSamples(payload, track.nalLengthSize, nalCodec);
+    }
+    const chosen = chooseSampleSizes(scan, track, payload.length);
+    if (!chosen) {
+        return fail(track.handlerType === 'vide'
+            ? 'could not determine sample boundaries from the mdat: the NAL scan did not tile the payload ' +
+                'and the reference size model does not fit either (likely a codec/reference mismatch).'
+            : `single-track reconstruction of a "${track.handlerType}" track needs the reference sample-size ` +
+                'model to tile the payload exactly; it does not (raw audio in mdat has no self-delimiting frames).', { ...refInfo, strategy: scan ? 'nal-scan' : null, mdatPayloadBytes: payload.length });
+    }
+    const bytesAccounted = chosen.sizes.reduce((n, s) => n + s, 0);
+    const leftoverBytes = payload.length - bytesAccounted;
+    const sampleCountMismatch = track.sampleCount > 0 && chosen.sizes.length !== track.sampleCount;
+    if (chosen.strategy === 'nal-scan') {
+        notes.push(`recovered ${chosen.sizes.length} sample(s) by scanning length-prefixed ${nalCodec} NAL units`);
+    }
+    else {
+        notes.push(`recovered ${chosen.sizes.length} sample(s) using the reference size model ` +
+            '(sample boundaries taken from the reference, not byte-verified against the payload)');
+    }
+    if (chosen.truncated)
+        notes.push('the mdat payload is truncated: the final sample was cut and dropped');
+    if (leftoverBytes > 0)
+        notes.push(`${leftoverBytes} trailing byte(s) did not form a sample and were dropped`);
+    if (sampleCountMismatch) {
+        notes.push(`recovered ${chosen.sizes.length} samples vs ${track.sampleCount} in the reference; ` +
+            'reused reference durations may be approximate');
+    }
+    // --- 5. Build the moov and splice a faststart MP4. -----------------------
+    const ftyp = await readFtyp(broken, brokenScan);
+    const stts = buildStts(track, chosen.sizes.length);
+    const output = spliceFaststartMp4(template, track, {
+        stsd: track.stsd,
+        sampleSizes: chosen.sizes,
+        stts,
+        syncSamples: track.hasStss && !sampleCountMismatch ? track.syncSamples : null,
+    }, ftyp, payload.subarray(0, bytesAccounted));
+    // --- 6. Verify: the rebuilt file must re-parse and NOT be missing-moov. ---
+    const verify = await diagnoseVideo(new MemorySource(output));
+    notes.push(...diagnosis.notes.map((n) => `input: ${n}`));
+    const reportBody = {
+        ...base,
+        reason: null,
+        usedReference: true,
+        referenceTracks: template.tracks.length,
+        referenceCodec,
+        strategy: chosen.strategy,
+        samplesRecovered: chosen.sizes.length,
+        mdatPayloadBytes: payload.length,
+        bytesAccounted,
+        leftoverBytes,
+        truncatedTail: chosen.truncated,
+        sampleCountMismatch,
+        reDiagnosis: verify.damageClass,
+        notes,
+        bytesIn: broken.size,
+        bytesOut: output.length,
+    };
+    if (verify.damageClass === 'missing-moov' || verify.container === 'unknown') {
+        return {
+            video: new Uint8Array(0),
+            report: {
+                ...reportBody,
+                outcome: 'failed',
+                confidence: 'high',
+                bytesOut: 0,
+                reason: `verification failed: rebuilt output re-diagnosed as "${verify.damageClass}"; not claiming success`,
+                notes: [...notes, `verification failed: rebuilt output re-diagnosed as "${verify.damageClass}"`],
+            },
+        };
+    }
+    if (verify.damageClass !== 'none') {
+        // The moov is present (not missing-moov) but the container still has a
+        // caveat (e.g. broken-index/truncated-mdat). Honest partial, not success.
+        notes.push(`rebuilt output re-diagnoses as "${verify.damageClass}" — index present but imperfect`);
+        return {
+            video: output,
+            report: {
+                ...reportBody,
+                outcome: 'partial',
+                confidence: 'medium',
+                reason: `index rebuilt; output still re-diagnoses as "${verify.damageClass}"`,
+            },
+        };
+    }
+    // Re-diagnoses fully clean.
+    const clean = !chosen.truncated && leftoverBytes === 0 && !sampleCountMismatch && chosen.strategy === 'nal-scan';
+    if (clean) {
+        notes.push('rebuilt output re-diagnoses as clean (none)');
+        return { video: output, report: { ...reportBody, outcome: 'success', confidence: 'high' } };
+    }
+    notes.push('rebuilt output re-diagnoses as clean, but with recovery caveats (see notes): honest partial');
+    let partialReason;
+    if (chosen.truncated)
+        partialReason = 'mdat truncated: recovered the samples before the cut; the rest is physically gone';
+    else if (leftoverBytes > 0)
+        partialReason = `${leftoverBytes} trailing byte(s) could not be assigned to a sample and were dropped`;
+    else if (chosen.strategy === 'reference-size-guided')
+        partialReason = 'sample boundaries taken from the reference size model (not byte-verified)';
+    else if (sampleCountMismatch)
+        partialReason = `recovered ${chosen.sizes.length} samples vs ${track.sampleCount} in the reference`;
+    else
+        partialReason = 'partial recovery';
+    return {
+        video: output,
+        report: { ...reportBody, outcome: 'partial', confidence: 'medium', reason: partialReason },
+    };
+}
+/**
+ * Reconcile the NAL scan with the reference size model:
+ *   - a scan that tiles the payload exactly wins (byte-accurate);
+ *   - else a reference model that tiles the payload exactly is used;
+ *   - else a partial scan is used as best-effort (with dropped tail);
+ *   - else give up (null → honest failure).
+ */
+export function chooseSampleSizes(scan, track, payloadLen) {
+    if (scan && scan.sizes.length > 0 && scan.bytesAccounted === payloadLen && !scan.truncatedTail) {
+        return { sizes: scan.sizes, strategy: 'nal-scan', truncated: false };
+    }
+    const refModel = referenceSizeModel(track, payloadLen);
+    if (refModel) {
+        return { sizes: refModel, strategy: 'reference-size-guided', truncated: scan ? scan.truncatedTail || scan.leftoverBytes > 0 : false };
+    }
+    if (scan && scan.sizes.length > 0) {
+        return { sizes: scan.sizes, strategy: 'nal-scan', truncated: scan.truncatedTail || scan.leftoverBytes > 0 };
+    }
+    return null;
+}
+/** Reference stsz model, only when it tiles the payload exactly. */
+function referenceSizeModel(track, payloadLen) {
+    if (track.constantSampleSize > 0 && payloadLen % track.constantSampleSize === 0) {
+        return new Array(payloadLen / track.constantSampleSize).fill(track.constantSampleSize);
+    }
+    if (track.sampleSizes.length > 0) {
+        const total = track.sampleSizes.reduce((n, s) => n + s, 0);
+        if (total === payloadLen)
+            return track.sampleSizes.slice();
+    }
+    return null;
+}
+/** Time-to-sample: reuse the reference cadence when its count matches; else a single-delta run. */
+function buildStts(track, sampleCount) {
+    const refTotal = track.sttsEntries.reduce((n, e) => n + e.count, 0);
+    if (track.sttsEntries.length > 0 && refTotal === sampleCount)
+        return track.sttsEntries.map((e) => ({ ...e }));
+    const delta = track.sttsEntries[0]?.delta ?? Math.max(1, Math.round(track.mediaTimescale / 30));
+    return [{ count: sampleCount, delta }];
+}
+/** Return the broken file's ftyp bytes, or a synthesized default. */
+async function readFtyp(broken, scan) {
+    const ftyp = scan.boxes.find((b) => b.type === 'ftyp');
+    if (ftyp)
+        return broken.read(ftyp.offset, ftyp.size);
+    return defaultFtyp();
+}
+// ---------------------------------------------------------------------------
+// TODO (documented gap — see the timebox note in the header):
+//   * Multi-track (video+audio) and audio-only reconstruction. Raw AAC inside
+//     mdat is not self-delimiting, so audio samples must be sized from the
+//     reference stsz, and interleaved tracks must be de-multiplexed by walking
+//     the mdat in the reference's chunk order (stsc/chunk cadence). This needs
+//     a per-chunk assignment pass and per-track stco tables; the single-track
+//     path above is the foundation for it.
+//   * Multi-slice-per-picture H.264/H.265: the AU grouper treats every VCL NAL
+//     as a new sample. Multi-slice frames are reconciled today by falling back
+//     to the reference size model; a first_mb_in_slice==0 check would make the
+//     NAL scan itself slice-aware.
+//   * B-frame reordering (ctts/composition offsets) is not reconstructed; the
+//     rebuilt moov assumes decode order == presentation order. For streams with
+//     B-frames this is a playable approximation, not frame-accurate timing.
+// ---------------------------------------------------------------------------
+//# sourceMappingURL=reconstruct.js.map

package/dist/video/reconstruct.js.map

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

package/dist/video/remux.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Stream-copy video remux on libav.js (LGPL) — the production replacement for
+ * the dev-only GPL ffmpeg.wasm path.
+ *
+ * Strategy ladder mirrors the app prototype's `-c copy` ladder:
+ *   (a) copy-faststart — plain stream copy, moov/index moved to the front;
+ *   (b) genpts-copy    — retry with AVFMT_FLAG_GENPTS|AVFMT_FLAG_IGNIDX
+ *                        (the `-fflags +genpts+ignidx` semantics of docs/04 §2).
+ *
+ * Honesty rules: 'missing-moov' fails with an explanation pointing at future
+ * moov reconstruction (never a fake success); 'truncated-mdat' is at best a
+ * partial (frames past the cut are physically gone); an output is only
+ * claimed when libav actually produced bytes and copied at least one packet.
+ */
+import type { ByteSource } from '../byte-source.js';
+import { type VideoDamageClass, type VideoDiagnosis } from './diagnose.js';
+export declare const AVFMT_FLAG_GENPTS = 1;
+export declare const AVFMT_FLAG_IGNIDX = 2;
+export type RemuxStrategyId = 'copy-faststart' | 'genpts-copy';
+export interface RemuxStrategy {
+    id: RemuxStrategyId;
+    label: string;
+    description: string;
+    /** AVFormatContext flags OR-ed onto the demuxer before reading. */
+    demuxFlags: number;
+}
+/** Ordered ladder: the first strategy is tried first. */
+export declare const REMUX_STRATEGIES: readonly RemuxStrategy[];
+export type OutputContainer = 'mp4' | 'mkv' | 'webm';
+export interface RemuxPlan {
+    /** False when a remux is pointless; `skipReason` explains why. */
+    attempt: boolean;
+    skipReason: string | null;
+    /** Bytes to strip from the front (garbage prefix) before demuxing. */
+    stripPrefixBytes: number;
+    output: OutputContainer;
+    /** libav muxer name for the output. */
+    formatName: string;
+    /** mov muxer option; null for non-mp4 outputs. */
+    movflags: string | null;
+    strategies: readonly RemuxStrategy[];
+}
+/** Map input container to output: mkv stays mkv, webm stays webm, rest → mp4. */
+export declare function outputContainerFor(diagnosis: Pick<VideoDiagnosis, 'container'>): OutputContainer;
+/** Pure planning step: what to run for a given diagnosis (unit-testable). */
+export declare function planRemux(diagnosis: VideoDiagnosis): RemuxPlan;
+export interface RemuxAttempt {
+    strategy: RemuxStrategyId;
+    ok: boolean;
+    packetsCopied: number;
+    error: string | null;
+}
+export type VideoRepairOutcome = 'success' | 'partial' | 'failed';
+export interface VideoRepairReport {
+    outcome: VideoRepairOutcome;
+    damageClass: VideoDamageClass;
+    container: VideoDiagnosis['container'];
+    outputContainer: OutputContainer | null;
+    /** Winning ladder rung, or null when everything failed. */
+    strategy: RemuxStrategyId | null;
+    streamsFound: number;
+    streamsCopied: number;
+    packetsCopied: number;
+    /** Packets the demuxer flagged as corrupt (copied anyway, counted honestly). */
+    corruptPackets: number;
+    /** True when packet reading stopped on an error before end-of-file. */
+    stoppedEarly: boolean;
+    /** Container-declared duration of the input, in seconds, if derivable. */
+    durationSeconds: number | null;
+    /** Duration actually recovered (last copied packet end), in seconds, if derivable. */
+    recoveredSeconds: number | null;
+    attempts: RemuxAttempt[];
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+}
+export interface RemuxOptions {
+    /** Reuse an existing diagnosis instead of re-scanning. */
+    diagnosis?: VideoDiagnosis;
+}
+export declare function remuxVideo(src: ByteSource, opts?: RemuxOptions): Promise<{
+    video: Uint8Array;
+    report: VideoRepairReport;
+}>;
+//# sourceMappingURL=remux.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remux.d.ts","sourceRoot":"","sources":["../../src/video/remux.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAiB,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAI1F,eAAO,MAAM,iBAAiB,IAAS,CAAC;AACxC,eAAO,MAAM,iBAAiB,IAAS,CAAC;AAKxC,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAepD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CACtC;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,eAAe,CAIhG;AAQD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,CAuB9D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACvC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sFAAsF;IACtF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAeD,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAyH3D"}