zephyra-codec 0.1.3

package/dist/format.js

@@ -0,0 +1,3 @@
+/** Top-level ISO-BMFF box type used to carry the embedded Zephyra payload. */
+export const ZEPHYRA_BOX_TYPE = "zeph";
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Exporter } from "./exporter.js";
+export { Deconstructor } from "./deconstructor.js";
+export { ZEPHYRA_BOX_TYPE } from "./format.js";
+export type { LayerInstruction, ZephyraTimeline, ZephyraPayload, ExportOptions, ExportResult, DeconstructOptions, DeconstructResult, } from "./types.js";
+export { ZephyraFormatError } from "./types.js";
+export { encodePayload, decodePayload } from "./serialization/payload.js";
+export { encode as msgpackEncode, decode as msgpackDecode } from "./serialization/msgpack.js";
+export { listTopLevelBoxes, findTopLevelBox, readBoxPayload, appendBox, stripTopLevelBox, } from "./container/mp4Box.js";
+export type { BoxInfo } from "./container/mp4Box.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKhD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,SAAS,EACT,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { Exporter } from "./exporter.js";
+export { Deconstructor } from "./deconstructor.js";
+export { ZEPHYRA_BOX_TYPE } from "./format.js";
+export { ZephyraFormatError } from "./types.js";
+// Pure, I/O-free building blocks — exposed so a future HTTP server or
+// sidecar wrapper can operate on in-memory buffers without going through
+// the filesystem-bound Exporter/Deconstructor classes.
+export { encodePayload, decodePayload } from "./serialization/payload.js";
+export { encode as msgpackEncode, decode as msgpackDecode } from "./serialization/msgpack.js";
+export { listTopLevelBoxes, findTopLevelBox, readBoxPayload, appendBox, stripTopLevelBox, } from "./container/mp4Box.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAW/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,sEAAsE;AACtE,yEAAyE;AACzE,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,SAAS,EACT,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/serialization/msgpack.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A small, dependency-free MessagePack implementation.
+ *
+ * Rationale: the SDK's core logic (encode/decode, container parsing) is
+ * meant to be portable into a pkg/nexe-compiled sidecar and, eventually, an
+ * HTTP service. Every external dependency is one more thing that can fail
+ * to bundle correctly under those targets. MessagePack's spec is small
+ * enough that hand-rolling exactly the subset we need (maps, arrays,
+ * strings, binary, numbers, booleans, null) keeps this module at zero
+ * runtime dependencies. It is wire-compatible with the standard, so a
+ * future host is free to swap in `@msgpack/msgpack` or `msgpackr` without
+ * changing the payload format.
+ *
+ * Supported JS <-> MessagePack type mapping:
+ *   null/undefined -> nil
+ *   boolean         -> bool
+ *   number (int)    -> (u)int family, chosen by magnitude
+ *   number (float)  -> float64
+ *   string          -> str family
+ *   Uint8Array      -> bin family
+ *   Array           -> array family
+ *   plain object    -> map family (string keys only)
+ */
+export declare function encode(value: unknown): Buffer;
+export declare function decode(buf: Buffer): unknown;
+//# sourceMappingURL=msgpack.d.ts.map

package/dist/serialization/msgpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.d.ts","sourceRoot":"","sources":["../../src/serialization/msgpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAoMH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7C;AA4GD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3C"}

package/dist/serialization/msgpack.js

@@ -0,0 +1,334 @@
+/**
+ * A small, dependency-free MessagePack implementation.
+ *
+ * Rationale: the SDK's core logic (encode/decode, container parsing) is
+ * meant to be portable into a pkg/nexe-compiled sidecar and, eventually, an
+ * HTTP service. Every external dependency is one more thing that can fail
+ * to bundle correctly under those targets. MessagePack's spec is small
+ * enough that hand-rolling exactly the subset we need (maps, arrays,
+ * strings, binary, numbers, booleans, null) keeps this module at zero
+ * runtime dependencies. It is wire-compatible with the standard, so a
+ * future host is free to swap in `@msgpack/msgpack` or `msgpackr` without
+ * changing the payload format.
+ *
+ * Supported JS <-> MessagePack type mapping:
+ *   null/undefined -> nil
+ *   boolean         -> bool
+ *   number (int)    -> (u)int family, chosen by magnitude
+ *   number (float)  -> float64
+ *   string          -> str family
+ *   Uint8Array      -> bin family
+ *   Array           -> array family
+ *   plain object    -> map family (string keys only)
+ */
+class Writer {
+    chunks = [];
+    push(buf) {
+        this.chunks.push(buf);
+    }
+    concat() {
+        return Buffer.concat(this.chunks);
+    }
+}
+function writeValue(w, value) {
+    if (value === null || value === undefined) {
+        w.push(Buffer.from([0xc0]));
+        return;
+    }
+    if (typeof value === "boolean") {
+        w.push(Buffer.from([value ? 0xc3 : 0xc2]));
+        return;
+    }
+    if (typeof value === "number") {
+        writeNumber(w, value);
+        return;
+    }
+    if (typeof value === "string") {
+        writeString(w, value);
+        return;
+    }
+    if (value instanceof Uint8Array) {
+        writeBinary(w, value);
+        return;
+    }
+    if (Array.isArray(value)) {
+        writeArray(w, value);
+        return;
+    }
+    if (typeof value === "object") {
+        writeMap(w, value);
+        return;
+    }
+    throw new TypeError(`msgpack: unsupported value type: ${typeof value}`);
+}
+function writeNumber(w, n) {
+    if (Number.isInteger(n)) {
+        if (n >= 0) {
+            if (n <= 0x7f) {
+                w.push(Buffer.from([n]));
+                return;
+            }
+            if (n <= 0xff) {
+                w.push(Buffer.from([0xcc, n]));
+                return;
+            }
+            if (n <= 0xffff) {
+                const b = Buffer.alloc(3);
+                b[0] = 0xcd;
+                b.writeUInt16BE(n, 1);
+                w.push(b);
+                return;
+            }
+            if (n <= 0xffffffff) {
+                const b = Buffer.alloc(5);
+                b[0] = 0xce;
+                b.writeUInt32BE(n, 1);
+                w.push(b);
+                return;
+            }
+            // Fall through to double for values beyond safe 32-bit uint;
+            // covers 53-bit safe integers (e.g. millisecond timestamps).
+            const b = Buffer.alloc(9);
+            b[0] = 0xcf;
+            b.writeBigUInt64BE(BigInt(n), 1);
+            w.push(b);
+            return;
+        }
+        if (n >= -32) {
+            w.push(Buffer.from([0x100 + n])); // negative fixint
+            return;
+        }
+        if (n >= -128) {
+            const b = Buffer.alloc(2);
+            b[0] = 0xd0;
+            b.writeInt8(n, 1);
+            w.push(b);
+            return;
+        }
+        if (n >= -32768) {
+            const b = Buffer.alloc(3);
+            b[0] = 0xd1;
+            b.writeInt16BE(n, 1);
+            w.push(b);
+            return;
+        }
+        if (n >= -2147483648) {
+            const b = Buffer.alloc(5);
+            b[0] = 0xd2;
+            b.writeInt32BE(n, 1);
+            w.push(b);
+            return;
+        }
+        const b = Buffer.alloc(9);
+        b[0] = 0xd3;
+        b.writeBigInt64BE(BigInt(n), 1);
+        w.push(b);
+        return;
+    }
+    // Non-integer: always float64 for simplicity/precision.
+    const b = Buffer.alloc(9);
+    b[0] = 0xcb;
+    b.writeDoubleBE(n, 1);
+    w.push(b);
+}
+function writeString(w, s) {
+    const strBuf = Buffer.from(s, "utf-8");
+    const len = strBuf.length;
+    if (len <= 31) {
+        w.push(Buffer.from([0xa0 | len]));
+    }
+    else if (len <= 0xff) {
+        w.push(Buffer.from([0xd9, len]));
+    }
+    else if (len <= 0xffff) {
+        const b = Buffer.alloc(3);
+        b[0] = 0xda;
+        b.writeUInt16BE(len, 1);
+        w.push(b);
+    }
+    else {
+        const b = Buffer.alloc(5);
+        b[0] = 0xdb;
+        b.writeUInt32BE(len, 1);
+        w.push(b);
+    }
+    w.push(strBuf);
+}
+function writeBinary(w, bin) {
+    const len = bin.length;
+    if (len <= 0xff) {
+        w.push(Buffer.from([0xc4, len]));
+    }
+    else if (len <= 0xffff) {
+        const b = Buffer.alloc(3);
+        b[0] = 0xc5;
+        b.writeUInt16BE(len, 1);
+        w.push(b);
+    }
+    else {
+        const b = Buffer.alloc(5);
+        b[0] = 0xc6;
+        b.writeUInt32BE(len, 1);
+        w.push(b);
+    }
+    w.push(Buffer.from(bin.buffer, bin.byteOffset, bin.byteLength));
+}
+function writeArray(w, arr) {
+    const len = arr.length;
+    if (len <= 15) {
+        w.push(Buffer.from([0x90 | len]));
+    }
+    else if (len <= 0xffff) {
+        const b = Buffer.alloc(3);
+        b[0] = 0xdc;
+        b.writeUInt16BE(len, 1);
+        w.push(b);
+    }
+    else {
+        const b = Buffer.alloc(5);
+        b[0] = 0xdd;
+        b.writeUInt32BE(len, 1);
+        w.push(b);
+    }
+    for (const item of arr)
+        writeValue(w, item);
+}
+function writeMap(w, obj) {
+    const keys = Object.keys(obj);
+    const len = keys.length;
+    if (len <= 15) {
+        w.push(Buffer.from([0x80 | len]));
+    }
+    else if (len <= 0xffff) {
+        const b = Buffer.alloc(3);
+        b[0] = 0xde;
+        b.writeUInt16BE(len, 1);
+        w.push(b);
+    }
+    else {
+        const b = Buffer.alloc(5);
+        b[0] = 0xdf;
+        b.writeUInt32BE(len, 1);
+        w.push(b);
+    }
+    for (const key of keys) {
+        writeString(w, key);
+        writeValue(w, obj[key]);
+    }
+}
+export function encode(value) {
+    const w = new Writer();
+    writeValue(w, value);
+    return w.concat();
+}
+class Reader {
+    buf;
+    offset = 0;
+    constructor(buf) {
+        this.buf = buf;
+    }
+    u8() {
+        return this.buf[this.offset++];
+    }
+    peek() {
+        return this.buf[this.offset];
+    }
+    slice(len) {
+        const s = this.buf.subarray(this.offset, this.offset + len);
+        this.offset += len;
+        return s;
+    }
+}
+function readValue(r) {
+    const first = r.u8();
+    if (first <= 0x7f)
+        return first; // positive fixint
+    if (first >= 0xe0)
+        return first - 0x100; // negative fixint
+    if ((first & 0xf0) === 0x80)
+        return readMap(r, first & 0x0f);
+    if ((first & 0xf0) === 0x90)
+        return readArray(r, first & 0x0f);
+    if ((first & 0xe0) === 0xa0)
+        return readString(r, first & 0x1f);
+    switch (first) {
+        case 0xc0:
+            return null;
+        case 0xc2:
+            return false;
+        case 0xc3:
+            return true;
+        case 0xc4:
+            return readBinary(r, r.u8());
+        case 0xc5:
+            return readBinary(r, r.slice(2).readUInt16BE(0));
+        case 0xc6:
+            return readBinary(r, r.slice(4).readUInt32BE(0));
+        case 0xca:
+            return r.slice(4).readFloatBE(0);
+        case 0xcb:
+            return r.slice(8).readDoubleBE(0);
+        case 0xcc:
+            return r.u8();
+        case 0xcd:
+            return r.slice(2).readUInt16BE(0);
+        case 0xce:
+            return r.slice(4).readUInt32BE(0);
+        case 0xcf:
+            return Number(r.slice(8).readBigUInt64BE(0));
+        case 0xd0:
+            return r.slice(1).readInt8(0);
+        case 0xd1:
+            return r.slice(2).readInt16BE(0);
+        case 0xd2:
+            return r.slice(4).readInt32BE(0);
+        case 0xd3:
+            return Number(r.slice(8).readBigInt64BE(0));
+        case 0xd9:
+            return readString(r, r.u8());
+        case 0xda:
+            return readString(r, r.slice(2).readUInt16BE(0));
+        case 0xdb:
+            return readString(r, r.slice(4).readUInt32BE(0));
+        case 0xdc:
+            return readArray(r, r.slice(2).readUInt16BE(0));
+        case 0xdd:
+            return readArray(r, r.slice(4).readUInt32BE(0));
+        case 0xde:
+            return readMap(r, r.slice(2).readUInt16BE(0));
+        case 0xdf:
+            return readMap(r, r.slice(4).readUInt32BE(0));
+        default:
+            throw new Error(`msgpack: unsupported type byte 0x${first.toString(16)}`);
+    }
+}
+function readString(r, len) {
+    return r.slice(len).toString("utf-8");
+}
+function readBinary(r, len) {
+    // Copy out of the shared backing buffer so the returned value has its
+    // own lifetime independent of the reader's source buffer.
+    return Uint8Array.from(r.slice(len));
+}
+function readArray(r, len) {
+    const out = new Array(len);
+    for (let i = 0; i < len; i++)
+        out[i] = readValue(r);
+    return out;
+}
+function readMap(r, len) {
+    const out = {};
+    for (let i = 0; i < len; i++) {
+        const key = readValue(r);
+        if (typeof key !== "string") {
+            throw new Error("msgpack: only string map keys are supported");
+        }
+        out[key] = readValue(r);
+    }
+    return out;
+}
+export function decode(buf) {
+    const r = new Reader(buf);
+    return readValue(r);
+}
+//# sourceMappingURL=msgpack.js.map

package/dist/serialization/msgpack.js.map

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

package/dist/serialization/payload.d.ts

@@ -0,0 +1,16 @@
+import type { ZephyraPayload, ZephyraTimeline } from "../types.js";
+export declare const PAYLOAD_MAGIC = "ZEPH";
+export declare const PAYLOAD_VERSION = 1;
+/**
+ * Pure function: build the wire bytes for a Zephyra payload from a timeline
+ * and the original base video bytes. No filesystem access here — this is
+ * the "core" half of encode/decode that a future HTTP handler or sidecar
+ * could call directly with in-memory buffers.
+ */
+export declare function encodePayload(timeline: ZephyraTimeline, baseVideoBytes: Uint8Array, createdAt?: number): Buffer;
+/**
+ * Pure function: inverse of encodePayload. Throws ZephyraFormatError if the
+ * bytes don't decode to a well-formed Zephyra payload.
+ */
+export declare function decodePayload(compressed: Buffer): ZephyraPayload;
+//# sourceMappingURL=payload.d.ts.map

package/dist/serialization/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/serialization/payload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnE,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,EACzB,cAAc,EAAE,UAAU,EAC1B,SAAS,GAAE,MAAmB,GAC7B,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CA2DhE"}

package/dist/serialization/payload.js

@@ -0,0 +1,80 @@
+import { gzipSync, gunzipSync } from "node:zlib";
+import { encode as mpEncode, decode as mpDecode } from "./msgpack.js";
+import { ZephyraFormatError } from "../types.js";
+export const PAYLOAD_MAGIC = "ZEPH";
+export const PAYLOAD_VERSION = 1;
+/**
+ * Pure function: build the wire bytes for a Zephyra payload from a timeline
+ * and the original base video bytes. No filesystem access here — this is
+ * the "core" half of encode/decode that a future HTTP handler or sidecar
+ * could call directly with in-memory buffers.
+ */
+export function encodePayload(timeline, baseVideoBytes, createdAt = Date.now()) {
+    const shape = {
+        magic: PAYLOAD_MAGIC,
+        version: PAYLOAD_VERSION,
+        createdAt,
+        timeline: {
+            baseVideoFilename: timeline.baseVideoFilename,
+            fps: timeline.fps ?? null,
+            layers: timeline.layers,
+        },
+        baseVideoBytes,
+    };
+    const packed = mpEncode(shape);
+    return gzipSync(packed, { level: 9 });
+}
+/**
+ * Pure function: inverse of encodePayload. Throws ZephyraFormatError if the
+ * bytes don't decode to a well-formed Zephyra payload.
+ */
+export function decodePayload(compressed) {
+    let packed;
+    try {
+        packed = gunzipSync(compressed);
+    }
+    catch (err) {
+        throw new ZephyraFormatError(`Payload is not valid gzip data: ${err.message}`);
+    }
+    let decoded;
+    try {
+        decoded = mpDecode(packed);
+    }
+    catch (err) {
+        throw new ZephyraFormatError(`Payload is not valid MessagePack data: ${err.message}`);
+    }
+    if (typeof decoded !== "object" || decoded === null) {
+        throw new ZephyraFormatError("Payload did not decode to an object");
+    }
+    const obj = decoded;
+    if (obj.magic !== PAYLOAD_MAGIC) {
+        throw new ZephyraFormatError(`Bad payload magic: expected "${PAYLOAD_MAGIC}", got ${JSON.stringify(obj.magic)}`);
+    }
+    if (typeof obj.version !== "number") {
+        throw new ZephyraFormatError("Payload missing numeric version");
+    }
+    if (obj.version > PAYLOAD_VERSION) {
+        throw new ZephyraFormatError(`Payload version ${obj.version} is newer than this SDK supports (max ${PAYLOAD_VERSION})`);
+    }
+    const timelineRaw = obj.timeline;
+    if (!timelineRaw || !Array.isArray(timelineRaw.layers)) {
+        throw new ZephyraFormatError("Payload missing valid timeline.layers");
+    }
+    if (!(obj.baseVideoBytes instanceof Uint8Array)) {
+        throw new ZephyraFormatError("Payload missing baseVideoBytes");
+    }
+    return {
+        magic: "ZEPH",
+        version: obj.version,
+        createdAt: typeof obj.createdAt === "number" ? obj.createdAt : 0,
+        timeline: {
+            baseVideoFilename: typeof timelineRaw.baseVideoFilename === "string"
+                ? timelineRaw.baseVideoFilename
+                : "base-video.bin",
+            fps: typeof timelineRaw.fps === "number" ? timelineRaw.fps : undefined,
+            layers: timelineRaw.layers,
+        },
+        baseVideoBytes: obj.baseVideoBytes,
+    };
+}
+//# sourceMappingURL=payload.js.map

package/dist/serialization/payload.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Public types for the Zephyra Core SDK.
+ *
+ * These types intentionally avoid Node-specific I/O shapes (no fs.Stats,
+ * no Buffer-only assumptions where Uint8Array will do) so that the same
+ * shapes can later be reused by an HTTP/WebSocket wrapper or a compiled
+ * sidecar without redesign.
+ */
+/** A single overlay/layer instruction that was composited on top of the base video. */
+export interface LayerInstruction {
+    /** Stable identifier for this layer, unique within an export. */
+    id: string;
+    /** What kind of thing this layer renders. */
+    type: "video" | "image" | "text" | "shape";
+    /** Seconds from the start of the base video when this layer becomes visible. */
+    startTime: number;
+    /** Seconds from the start of the base video when this layer stops being visible. */
+    endTime: number;
+    /** Position/scale/rotation applied to the layer. */
+    transform: {
+        x: number;
+        y: number;
+        scale: number;
+        rotation: number;
+    };
+    /** 0-1 opacity. */
+    opacity: number;
+    /**
+     * Layer-type-specific data. For "text" this holds string content and font
+     * info; for "image"/"video" it holds a source reference; for "shape" it
+     * holds geometry. Left as a free-form record so new layer kinds don't
+     * require a payload/schema migration.
+     */
+    data: Record<string, unknown>;
+}
+/** Everything needed to reproduce an export: the source video and how it was layered. */
+export interface ZephyraTimeline {
+    /** Original filename of the base video, preserved for restoration. */
+    baseVideoFilename: string;
+    /** Frames per second of the base video, informational only. */
+    fps?: number;
+    /** Ordered layer instructions, bottom-to-top. */
+    layers: LayerInstruction[];
+}
+/** The decoded structure embedded inside an exported Zephyra file. */
+export interface ZephyraPayload {
+    magic: "ZEPH";
+    /** Payload format version. Bump on any breaking change to this shape. */
+    version: number;
+    /** Unix ms timestamp of export. */
+    createdAt: number;
+    timeline: ZephyraTimeline;
+    /** Raw bytes of the untouched original base video, stored verbatim. */
+    baseVideoBytes: Uint8Array;
+}
+export interface ExportOptions {
+    /** Path to the original, un-layered base video. */
+    baseVideoPath: string;
+    /** Layer/overlay instructions to composite and later restore. */
+    layers: LayerInstruction[];
+    /** Where to write the resulting flattened + payload-embedded file. */
+    outputPath: string;
+    /** Optional path to an ffmpeg binary. Defaults to "ffmpeg" on PATH. */
+    ffmpegPath?: string;
+    /** Optional: override the base video's declared fps in the stored timeline. */
+    fps?: number;
+}
+export interface ExportResult {
+    outputPath: string;
+    /** Total size of the exported file in bytes. */
+    fileSizeBytes: number;
+    /** Size of the embedded Zephyra payload in bytes (post-compression). */
+    payloadSizeBytes: number;
+    /** SHA-256 hex digest of the original base video, for later verification. */
+    baseVideoChecksum: string;
+}
+export interface DeconstructOptions {
+    /** Path to a file previously produced by Exporter.export(). */
+    inputPath: string;
+    /** Directory to write the restored base video into. */
+    outDir: string;
+}
+export interface DeconstructResult {
+    /** Path to the restored, byte-identical base video. */
+    baseVideoPath: string;
+    /** The restored layer/overlay instructions. */
+    timeline: ZephyraTimeline;
+    /** SHA-256 hex digest of the restored base video. */
+    baseVideoChecksum: string;
+    version: number;
+    createdAt: number;
+}
+/** Thrown when a file does not contain a Zephyra payload, or it's corrupt/unreadable. */
+export declare class ZephyraFormatError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,uEAAuE;IACvE,cAAc,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,eAAe,CAAC;IAC1B,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yFAAyF;AACzF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * Public types for the Zephyra Core SDK.
+ *
+ * These types intentionally avoid Node-specific I/O shapes (no fs.Stats,
+ * no Buffer-only assumptions where Uint8Array will do) so that the same
+ * shapes can later be reused by an HTTP/WebSocket wrapper or a compiled
+ * sidecar without redesign.
+ */
+/** Thrown when a file does not contain a Zephyra payload, or it's corrupt/unreadable. */
+export class ZephyraFormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ZephyraFormatError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6FH,yFAAyF;AACzF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function sha256Hex(data: Uint8Array): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAElD"}