@intactfile/engines 0.1.0 → 0.2.0

package/dist/archive/index.d.ts

@@ -1,18 +1,10 @@
-/**
- * Archive engine subpath export (`@intactfile/engines/archive`) — RAR/7z
- * SALVAGE extraction (recover intact entries from a damaged archive), not deep
- * repair. Kept out of the root export so browser bundles that never touch
- * archives never pull in the 7z-wasm dependency; even here, the wasm only loads
- * on the first salvageArchive call. diagnoseArchive is pure byte-sniffing and
- * loads no wasm.
- *
- * License note: extraction (including RAR via 7-Zip's unRAR-derived decoder) is
- * permitted; RAR CREATION is not and is never performed. The unRAR license text
- * ships next to this module at ./LICENSE-unrar.txt.
- */
 export { diagnoseArchive } from './diagnose.js';
 export type { ArchiveDiagnosis, ArchiveFormat, ArchiveDamageClass } from './diagnose.js';
-export { salvageArchive, parseSltListing } from './salvage.js';
+export declare const salvageArchive: (src: import("../byte-source.js").ByteSource, opts?: import("./salvage.js").SalvageOptions | undefined) => Promise<{
+    files: import("./salvage.js").SalvagedFile[];
+    report: import("./salvage.js").SalvageReport;
+}>;
+export { parseSltListing } from './salvage.js';
 export type { SalvagedFile, SalvageStatus, SalvageOutcome, SalvageReport, SalvageEntrySummary, SalvageOptions, } from './salvage.js';
 export { withSevenZip, ensureSevenZip, setSevenZipLoader, resetSevenZipHost, } from './host.js';
 export type { SevenZipLoader, SevenZipFactory, SevenZipModule, SevenZipModuleOptions, SevenZipSession, SevenZipResult, SevenZipFS, } from './host.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEzF,eAAO,MAAM,cAAc;;;EAAwB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}

package/dist/archive/index.js

@@ -10,8 +10,11 @@
  * permitted; RAR CREATION is not and is never performed. The unRAR license text
  * ships next to this module at ./LICENSE-unrar.txt.
  */
+import { gate } from '../license.js';
+import { salvageArchive as _salvageArchive } from './salvage.js';
 export { diagnoseArchive } from './diagnose.js';
-export { salvageArchive, parseSltListing } from './salvage.js';
+export const salvageArchive = gate(_salvageArchive);
+export { parseSltListing } from './salvage.js';
 export { withSevenZip, ensureSevenZip, setSevenZipLoader, resetSevenZipHost, } from './host.js';
 export { SIG_7Z, SIG_RAR4, SIG_RAR5, matchAt, indexOfSig, } from './format.js';
 /** Relative path (from this module) to the shipped unRAR license text. */

package/dist/archive/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAWnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAWnB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC"}

package/dist/audio/index.d.ts

@@ -0,0 +1,11 @@
+export declare const repairWav: (src: import("../byte-source.js").ByteSource) => Promise<{
+    audio: Uint8Array;
+    report: import("./wav.js").WavRepairReport;
+}>;
+export type { WavRepairReport, AudioOutcome } from "./wav.js";
+export declare const repairMp3: (src: import("../byte-source.js").ByteSource) => Promise<{
+    audio: Uint8Array;
+    report: import("./mp3.js").Mp3RepairReport;
+}>;
+export type { Mp3RepairReport } from "./mp3.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,SAAS;;;EAAmB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC9D,eAAO,MAAM,SAAS;;;EAAmB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/audio/index.js

@@ -0,0 +1,11 @@
+/**
+ * Audio engine subpath export (`@intactfile/engines/audio`). Pure-TS structural
+ * repair for WAV (RIFF) and MP3 (frame resync). Kept out of the root barrel so
+ * bundles that don't repair audio stay lean.
+ */
+import { gate } from "../license.js";
+import { repairWav as _repairWav } from "./wav.js";
+import { repairMp3 as _repairMp3 } from "./mp3.js";
+export const repairWav = gate(_repairWav);
+export const repairMp3 = gate(_repairMp3);
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC"}

package/dist/audio/mp3.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MP3 repair — pure TS, structural. Strips a broken/leading ID3 tag and any
+ * garbage, resynchronises on valid MPEG audio frames, drops corrupt frames, and
+ * concatenates the survivors into a playable stream. Honest: 0 valid frames = failed.
+ */
+import type { ByteSource } from "../byte-source.js";
+import type { AudioOutcome } from "./wav.js";
+export interface Mp3RepairReport {
+    outcome: AudioOutcome;
+    damageClass: string;
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    framesFound: number;
+    framesKept: number;
+    leadingGarbageBytes: number;
+}
+export declare function repairMp3(src: ByteSource): Promise<{
+    audio: Uint8Array;
+    report: Mp3RepairReport;
+}>;
+//# sourceMappingURL=mp3.d.ts.map

package/dist/audio/mp3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp3.d.ts","sourceRoot":"","sources":["../../src/audio/mp3.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AA8DD,wBAAsB,SAAS,CAC7B,GAAG,EAAE,UAAU,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAiFzD"}

package/dist/audio/mp3.js

@@ -0,0 +1,141 @@
+import { readAll } from "../bytes-util.js";
+// [version][layer] -> bitrate table (kbps); index 0 = free, 15 = bad (both skipped).
+// version: 0=MPEG2.5, 2=MPEG2, 3=MPEG1 (1 = reserved). layer: 1=III, 2=II, 3=I.
+const BR_MPEG1_L1 = [0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448, 0];
+const BR_MPEG1_L2 = [0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384, 0];
+const BR_MPEG1_L3 = [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 0];
+const BR_MPEG2_L1 = [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256, 0];
+const BR_MPEG2_L23 = [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0];
+const SR_MPEG1 = [44100, 48000, 32000];
+const SR_MPEG2 = [22050, 24000, 16000];
+const SR_MPEG25 = [11025, 12000, 8000];
+/** Parse a 4-byte frame header at `o`; null if not a valid frame header. */
+function parseHeader(b, o) {
+    if (o + 4 > b.length)
+        return null;
+    if (b[o] !== 0xff || ((b[o + 1] & 0xe0) !== 0xe0))
+        return null;
+    const version = (b[o + 1] >> 3) & 0x03; // 0=2.5,1=res,2=2,3=1
+    const layer = (b[o + 1] >> 1) & 0x03; // 0=res,1=III,2=II,3=I
+    if (version === 1 || layer === 0)
+        return null;
+    const brIdx = (b[o + 2] >> 4) & 0x0f;
+    const srIdx = (b[o + 2] >> 2) & 0x03;
+    const padding = (b[o + 2] >> 1) & 0x01;
+    if (brIdx === 0 || brIdx === 15 || srIdx === 3)
+        return null;
+    const mpeg1 = version === 3;
+    let brTable;
+    if (layer === 3)
+        brTable = mpeg1 ? BR_MPEG1_L1 : BR_MPEG2_L1;
+    else if (layer === 2)
+        brTable = mpeg1 ? BR_MPEG1_L2 : BR_MPEG2_L23;
+    else
+        brTable = mpeg1 ? BR_MPEG1_L3 : BR_MPEG2_L23;
+    const bitrate = (brTable[brIdx] ?? 0) * 1000;
+    const srTable = version === 3 ? SR_MPEG1 : version === 2 ? SR_MPEG2 : SR_MPEG25;
+    const sampleRate = srTable[srIdx] ?? 0;
+    if (bitrate === 0 || sampleRate === 0)
+        return null;
+    let length;
+    if (layer === 3) {
+        // Layer I
+        length = Math.floor((12 * bitrate) / sampleRate + padding) * 4;
+    }
+    else {
+        // Layer II & III
+        const coef = mpeg1 ? 144 : 72;
+        length = Math.floor((coef * bitrate) / sampleRate) + padding;
+    }
+    return length >= 4 ? { length } : null;
+}
+/** Length of a leading ID3v2 tag at offset 0, or 0 if none. */
+function id3v2Length(b) {
+    if (b.length < 10 || b[0] !== 0x49 || b[1] !== 0x44 || b[2] !== 0x33)
+        return 0; // "ID3"
+    // syncsafe 28-bit size in bytes 6..9
+    const size = ((b[6] & 0x7f) << 21) | ((b[7] & 0x7f) << 14) | ((b[8] & 0x7f) << 7) | (b[9] & 0x7f);
+    const footer = (b[5] & 0x10) !== 0 ? 10 : 0;
+    return 10 + size + footer;
+}
+export async function repairMp3(src) {
+    const buf = await readAll(src);
+    const notes = [];
+    let pos = 0;
+    let leadingGarbage = 0;
+    const id3 = id3v2Length(buf);
+    if (id3 > 0 && id3 <= buf.length) {
+        pos = id3;
+        notes.push(`skipped a ${id3}-byte ID3v2 tag`);
+    }
+    const parts = [];
+    let framesFound = 0;
+    let framesKept = 0;
+    let firstFrameSeen = false;
+    while (pos < buf.length) {
+        const h = parseHeader(buf, pos);
+        if (h && pos + h.length <= buf.length) {
+            // Confirm the next boundary is EOF or another sync — rejects false positives.
+            const next = pos + h.length;
+            if (next === buf.length || (buf[next] === 0xff && (buf[next + 1] & 0xe0) === 0xe0)) {
+                parts.push(buf.subarray(pos, next));
+                framesFound++;
+                framesKept++;
+                firstFrameSeen = true;
+                pos = next;
+                continue;
+            }
+        }
+        // Not a valid frame here.
+        if (!firstFrameSeen)
+            leadingGarbage++;
+        else
+            framesFound++; // a corrupt/dropped frame region
+        pos++;
+    }
+    const bytesIn = buf.length;
+    if (framesKept === 0) {
+        return {
+            audio: new Uint8Array(0),
+            report: {
+                outcome: "failed",
+                damageClass: "no-frames",
+                notes,
+                bytesIn,
+                bytesOut: 0,
+                framesFound,
+                framesKept: 0,
+                leadingGarbageBytes: leadingGarbage,
+            },
+        };
+    }
+    let total = 0;
+    for (const p of parts)
+        total += p.length;
+    const out = new Uint8Array(total);
+    let w = 0;
+    for (const p of parts) {
+        out.set(p, w);
+        w += p.length;
+    }
+    if (leadingGarbage > 0)
+        notes.push(`dropped ${leadingGarbage} bytes of leading garbage`);
+    const dropped = framesFound - framesKept;
+    if (dropped > 0)
+        notes.push(`dropped ${dropped} corrupt frame region(s)`);
+    const outcome = leadingGarbage > 0 || dropped > 0 ? "partial" : "success";
+    return {
+        audio: out,
+        report: {
+            outcome,
+            damageClass: outcome === "success" ? "clean" : "resynced",
+            notes,
+            bytesIn,
+            bytesOut: out.length,
+            framesFound,
+            framesKept,
+            leadingGarbageBytes: leadingGarbage,
+        },
+    };
+}
+//# sourceMappingURL=mp3.js.map

package/dist/audio/mp3.js.map

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

package/dist/audio/wav.d.ts

@@ -0,0 +1,23 @@
+/**
+ * WAV repair — pure TS, structural (RIFF). Rebuilds the RIFF/fmt/data headers
+ * when sizes are wrong or truncated and the PCM is intact. Honest: no 'fmt '
+ * means we can't know the format, so we fail rather than guess.
+ */
+import type { ByteSource } from "../byte-source.js";
+export type AudioOutcome = "success" | "partial" | "failed";
+export interface WavRepairReport {
+    outcome: AudioOutcome;
+    damageClass: string;
+    notes: string[];
+    bytesIn: number;
+    bytesOut: number;
+    sampleRateHz: number;
+    channels: number;
+    bitsPerSample: number;
+    pcmBytes: number;
+}
+export declare function repairWav(src: ByteSource): Promise<{
+    audio: Uint8Array;
+    report: WavRepairReport;
+}>;
+//# sourceMappingURL=wav.d.ts.map

package/dist/audio/wav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wav.d.ts","sourceRoot":"","sources":["../../src/audio/wav.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,UAAU,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAsFzD"}

package/dist/audio/wav.js

@@ -0,0 +1,86 @@
+import { indexOfAscii, readAll, u16le, u32le, writeAscii, writeU16le, writeU32le, } from "../bytes-util.js";
+export async function repairWav(src) {
+    const buf = await readAll(src);
+    const notes = [];
+    const fail = (damageClass) => ({
+        audio: new Uint8Array(0),
+        report: {
+            outcome: "failed",
+            damageClass,
+            notes,
+            bytesIn: buf.length,
+            bytesOut: 0,
+            sampleRateHz: 0,
+            channels: 0,
+            bitsPerSample: 0,
+            pcmBytes: 0,
+        },
+    });
+    if (buf.length < 44)
+        return fail("too-small");
+    const fmtOff = indexOfAscii(buf, "fmt ", 0);
+    if (fmtOff < 0 || fmtOff + 24 > buf.length)
+        return fail("no-fmt");
+    const fmtBody = fmtOff + 8;
+    const audioFormat = u16le(buf, fmtBody) || 1;
+    const channels = u16le(buf, fmtBody + 2);
+    const sampleRate = u32le(buf, fmtBody + 4);
+    const bitsPerSample = u16le(buf, fmtBody + 14);
+    if (channels === 0 || sampleRate === 0 || bitsPerSample === 0)
+        return fail("bad-fmt-params");
+    const blockAlign = channels * (bitsPerSample >> 3) || 1;
+    const byteRate = sampleRate * blockAlign;
+    let damageClass = "header";
+    let pcm;
+    const dataOff = indexOfAscii(buf, "data", fmtOff + 8);
+    if (dataOff >= 0 && dataOff + 8 <= buf.length) {
+        const declared = u32le(buf, dataOff + 4);
+        const avail = buf.length - (dataOff + 8);
+        if (declared > avail) {
+            notes.push(`data chunk declares ${declared} bytes but only ${avail} are present — recovered what remained`);
+            damageClass = "truncated-data";
+        }
+        pcm = buf.subarray(dataOff + 8, dataOff + 8 + Math.min(declared || avail, avail));
+    }
+    else {
+        notes.push("no 'data' chunk header found — treated the bytes after fmt as PCM");
+        damageClass = "no-data-header";
+        pcm = buf.subarray(fmtBody + 16);
+    }
+    // Trim to whole sample frames.
+    pcm = pcm.subarray(0, pcm.length - (pcm.length % blockAlign));
+    if (pcm.length === 0)
+        return fail("no-pcm");
+    const out = new Uint8Array(44 + pcm.length);
+    writeAscii(out, 0, "RIFF");
+    writeU32le(out, 4, 36 + pcm.length);
+    writeAscii(out, 8, "WAVE");
+    writeAscii(out, 12, "fmt ");
+    writeU32le(out, 16, 16);
+    writeU16le(out, 20, audioFormat);
+    writeU16le(out, 22, channels);
+    writeU32le(out, 24, sampleRate);
+    writeU32le(out, 28, byteRate);
+    writeU16le(out, 32, blockAlign);
+    writeU16le(out, 34, bitsPerSample);
+    writeAscii(out, 36, "data");
+    writeU32le(out, 40, pcm.length);
+    out.set(pcm, 44);
+    notes.unshift("rebuilt RIFF/fmt/data headers");
+    const outcome = damageClass === "truncated-data" || damageClass === "no-data-header" ? "partial" : "success";
+    return {
+        audio: out,
+        report: {
+            outcome,
+            damageClass,
+            notes,
+            bytesIn: buf.length,
+            bytesOut: out.length,
+            sampleRateHz: sampleRate,
+            channels,
+            bitsPerSample,
+            pcmBytes: pcm.length,
+        },
+    };
+}
+//# sourceMappingURL=wav.js.map

package/dist/audio/wav.js.map

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

package/dist/bytes-util.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Small byte helpers shared by the pure-TS structural engines (WAV/MP3/AVI).
+ * Little-endian readers/writers + ASCII fourcc matching + a whole-source read.
+ */
+import type { ByteSource } from "./byte-source.js";
+/** Read the entire source into one buffer (chunked, tolerant of short reads). */
+export declare function readAll(src: ByteSource): Promise<Uint8Array>;
+export declare const u16le: (b: Uint8Array, o: number) => number;
+export declare const u32le: (b: Uint8Array, o: number) => number;
+export declare function writeU16le(b: Uint8Array, o: number, v: number): void;
+export declare function writeU32le(b: Uint8Array, o: number, v: number): void;
+export declare function writeAscii(b: Uint8Array, o: number, s: string): void;
+/** True if the 4+ ASCII chars of `s` sit at offset `o`. */
+export declare function matchAscii(b: Uint8Array, o: number, s: string): boolean;
+/** First index of ASCII `s` in `b` at/after `from`, or -1. */
+export declare function indexOfAscii(b: Uint8Array, s: string, from?: number): number;
+//# sourceMappingURL=bytes-util.d.ts.map

package/dist/bytes-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes-util.d.ts","sourceRoot":"","sources":["../src/bytes-util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,iFAAiF;AACjF,wBAAsB,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAUlE;AAED,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,EAAE,GAAG,MAAM,KAAG,MAA8C,CAAC;AAEhG,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,EAAE,GAAG,MAAM,KAAG,MACmD,CAAC;AAErG,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAKpE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAMvE"}

package/dist/bytes-util.js

@@ -0,0 +1,46 @@
+/** Read the entire source into one buffer (chunked, tolerant of short reads). */
+export async function readAll(src) {
+    const out = new Uint8Array(src.size);
+    let off = 0;
+    while (off < src.size) {
+        const chunk = await src.read(off, Math.min(1 << 20, src.size - off));
+        if (chunk.length === 0)
+            break;
+        out.set(chunk, off);
+        off += chunk.length;
+    }
+    return off === out.length ? out : out.subarray(0, off);
+}
+export const u16le = (b, o) => (b[o] ?? 0) | ((b[o + 1] ?? 0) << 8);
+export const u32le = (b, o) => (((b[o] ?? 0) | ((b[o + 1] ?? 0) << 8) | ((b[o + 2] ?? 0) << 16) | ((b[o + 3] ?? 0) << 24)) >>> 0);
+export function writeU16le(b, o, v) {
+    b[o] = v & 0xff;
+    b[o + 1] = (v >>> 8) & 0xff;
+}
+export function writeU32le(b, o, v) {
+    b[o] = v & 0xff;
+    b[o + 1] = (v >>> 8) & 0xff;
+    b[o + 2] = (v >>> 16) & 0xff;
+    b[o + 3] = (v >>> 24) & 0xff;
+}
+export function writeAscii(b, o, s) {
+    for (let i = 0; i < s.length; i++)
+        b[o + i] = s.charCodeAt(i);
+}
+/** True if the 4+ ASCII chars of `s` sit at offset `o`. */
+export function matchAscii(b, o, s) {
+    for (let i = 0; i < s.length; i++)
+        if (b[o + i] !== s.charCodeAt(i))
+            return false;
+    return true;
+}
+/** First index of ASCII `s` in `b` at/after `from`, or -1. */
+export function indexOfAscii(b, s, from = 0) {
+    const last = b.length - s.length;
+    for (let i = Math.max(0, from); i <= last; i++) {
+        if (matchAscii(b, i, s))
+            return i;
+    }
+    return -1;
+}
+//# sourceMappingURL=bytes-util.js.map

package/dist/bytes-util.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { setLicense, clearLicense, getLicenseStatus, verifyLicense, assertLicensed, LicenseError, } from './license.js';
+export type { LicenseClaims, LicenseStatus, LicenseErrorCode } from './license.js';
 export type { ByteSource } from './byte-source.js';
 export { MemorySource } from './byte-source.js';
 export { BlobSource } from './bytesource/blob.js';
@@ -5,7 +7,10 @@ export { crc32 } from './crc32.js';
 export type { Confidence } from './types.js';
 export { diagnoseZip, analyzeZip } from './zip/diagnose.js';
 export type { ZipDiagnosis, DamageClass, ZipAnalysis } from './zip/diagnose.js';
-export { repairZip } from './zip/repair.js';
+export declare const repairZip: (src: import("./byte-source.js").ByteSource) => Promise<{
+    zip: Uint8Array;
+    report: import("./index.js").RepairReport;
+}>;
 export type { RepairReport, RepairEntryReport } from './zip/repair.js';
 export { scanLocalEntries, findEocd } from './zip/scan.js';
 export type { ScanResult, ScannedEntry, EocdResult } from './zip/scan.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEnF,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,eAAO,MAAM,SAAS;;;EAAmB,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,8 +1,12 @@
+import { gate } from './license.js';
+import { repairZip as _repairZip } from './zip/repair.js';
+// SDK/CLI license API (Node-only gate; the browser widget is unaffected).
+export { setLicense, clearLicense, getLicenseStatus, verifyLicense, assertLicensed, LicenseError, } from './license.js';
 export { MemorySource } from './byte-source.js';
 export { BlobSource } from './bytesource/blob.js';
 export { crc32 } from './crc32.js';
 export { diagnoseZip, analyzeZip } from './zip/diagnose.js';
-export { repairZip } from './zip/repair.js';
+export const repairZip = gate(_repairZip);
 export { scanLocalEntries, findEocd } from './zip/scan.js';
 export { validateEntry } from './zip/salvage.js';
 export { buildZip } from './zip/writer.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,0EAA0E;AAC1E,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1D,0EAA0E;AAC1E,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,0EAA0E;AAC1E,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/jpeg/index.d.ts

@@ -1,13 +1,7 @@
-/**
- * JPEG engine subpath export (`@intactfile/engines/jpeg`). Kept out of the
- * root export so browser bundles that never touch JPEGs never pull in the
- * @jsquash codec wasm or exifr; even here, the codec wasm only loads on the
- * first repairJpeg call. diagnoseJpeg is pure marker-scanning and safe to call
- * eagerly.
- */
 export { diagnoseJpeg, LOW_SCAN_ENTROPY, SOI_SCAN_WINDOW } from './diagnose.js';
 export type { JpegDiagnosis, JpegDamageClass } from './diagnose.js';
-export { repairJpeg, buildRepairCandidates, transplantHeader } from './repair.js';
+export declare const repairJpeg: (src: import("../byte-source.js").ByteSource, opts?: import("./repair.js").JpegRepairOptions | undefined) => Promise<import("./repair.js").JpegRepairResult>;
+export { buildRepairCandidates, transplantHeader } from './repair.js';
 export type { JpegRepairResult, JpegRepairReport, JpegRepairOptions, JpegRepairOutcome, JpegRepairStrategy, JpegRepairAttempt, } from './repair.js';
 export { extractExifThumbnail, extractExifOrientation } from './exif.js';
 export { decodeJpeg, encodeJpeg, setJpegLoader, resetJpegHost, SALVAGE_ENCODE_OPTIONS, } from './mozjpeg-host.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jpeg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExG,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jpeg/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE,eAAO,MAAM,UAAU,8JAAoB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExG,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/jpeg/index.js

@@ -5,8 +5,11 @@
  * first repairJpeg call. diagnoseJpeg is pure marker-scanning and safe to call
  * eagerly.
  */
+import { gate } from '../license.js';
+import { repairJpeg as _repairJpeg } from './repair.js';
 export { diagnoseJpeg, LOW_SCAN_ENTROPY, SOI_SCAN_WINDOW } from './diagnose.js';
-export { repairJpeg, buildRepairCandidates, transplantHeader } from './repair.js';
+export const repairJpeg = gate(_repairJpeg);
+export { buildRepairCandidates, transplantHeader } from './repair.js';
 export { extractExifThumbnail, extractExifOrientation } from './exif.js';
 export { decodeJpeg, encodeJpeg, setJpegLoader, resetJpegHost, SALVAGE_ENCODE_OPTIONS, } from './mozjpeg-host.js';
 export { createBrowserJpegLoader, DEFAULT_JPEG_BASE_URL } from './browser-loader.js';

package/dist/jpeg/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jpeg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhF,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUlF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jpeg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhF,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUtE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/license.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SDK/CLI license gate for the IntactFile repair engines.
+ *
+ * The repair engines are the paid product; diagnosis/detection stay free. On
+ * Node (CLI, MCP server, or the SDK imported directly) every repair entry
+ * point is gated behind a short-lived ES256 license minted by the API for
+ * ACTIVE Business subscribers and verified OFFLINE against the embedded PUBLIC
+ * key below — the API is the sole holder of the private key.
+ *
+ * In the BROWSER the gate is a no-op: the free in-browser widget calls these
+ * same functions and must stay free, so the gate only engages in a real Node
+ * runtime. DRM on a local library can't be unbreakable; this is a genuine,
+ * signed entitlement check plus the terms — not obfuscation. It never inspects
+ * file bytes and never phones home during a repair (verification is offline).
+ */
+export type LicenseErrorCode = "missing" | "invalid" | "expired" | "wrong-tier";
+export declare class LicenseError extends Error {
+    readonly code: LicenseErrorCode;
+    constructor(code: LicenseErrorCode, message: string);
+}
+export interface LicenseClaims {
+    sub: string;
+    tier: string;
+    iat: number;
+    exp: number;
+}
+export interface LicenseStatus {
+    licensed: boolean;
+    tier?: string;
+    /** ISO 8601 expiry, present when a valid license is applied. */
+    expiresAt?: string;
+    reason?: LicenseErrorCode;
+}
+/** @internal test hook — override the embedded public key (null = restore). */
+export declare function __setTestPublicKey(jwk: JsonWebKey | null): void;
+/** @internal test hook — force the browser (no-op) code path. */
+export declare function __setForceBrowser(on: boolean): void;
+/**
+ * Verify a compact ES256 license JWT offline and return its claims, or throw a
+ * LicenseError. Pure (no module state): the unit tests drive it with an
+ * ephemeral keypair via the `publicJwk` option.
+ */
+export declare function verifyLicense(token: string, opts?: {
+    publicJwk?: JsonWebKey;
+    now?: number;
+}): Promise<LicenseClaims>;
+/** Apply a license token so Node-side repairs can run. No-op-safe to re-call. */
+export declare function setLicense(token: string): void;
+/** Forget any applied license. */
+export declare function clearLicense(): void;
+/** Report whether a valid license is currently applied (verifies offline). */
+export declare function getLicenseStatus(): Promise<LicenseStatus>;
+/**
+ * The gate itself. In the browser it returns immediately (free widget). On
+ * Node it requires a valid, unexpired Business license, verified offline.
+ */
+export declare function assertLicensed(): Promise<void>;
+/**
+ * Wrap a repair entry point so it is licensed on Node and free in the browser.
+ * Preserves the wrapped function's signature.
+ */
+export declare function gate<A extends unknown[], R>(fn: (...args: A) => Promise<R>): (...args: A) => Promise<R>;
+//# sourceMappingURL=license.d.ts.map