@kduma-oss/pcf 0.0.1

package/dist/entry.js

@@ -0,0 +1,118 @@
+/**
+ * The fixed 141-byte partition entry (spec section 5.2).
+ */
+import { ENTRY_SIZE, HASH_FIELD_SIZE, LABEL_SIZE, NIL_UID, TYPE_RESERVED, } from "./consts.js";
+import { PcfError } from "./errors.js";
+import { HashAlgo, hashAlgoFromId, hashAlgoId } from "./hash.js";
+/** Serialise an entry to its on-disk 141-byte layout. */
+export function entryToBytes(e) {
+    const b = new Uint8Array(ENTRY_SIZE);
+    const view = new DataView(b.buffer);
+    view.setUint32(0, e.partitionType >>> 0, true);
+    b.set(e.uid, 4);
+    b.set(e.label, 20);
+    view.setBigUint64(52, e.startOffset, true);
+    view.setBigUint64(60, e.maxLength, true);
+    view.setBigUint64(68, e.usedBytes, true);
+    b[76] = hashAlgoId(e.dataHashAlgo);
+    b.set(e.dataHash, 77);
+    return b;
+}
+/** Parse an entry from its on-disk 141-byte layout. */
+export function entryFromBytes(b) {
+    const view = new DataView(b.buffer, b.byteOffset, b.byteLength);
+    const partitionType = view.getUint32(0, true);
+    const uid = b.slice(4, 20);
+    const label = b.slice(20, 52);
+    const startOffset = view.getBigUint64(52, true);
+    const maxLength = view.getBigUint64(60, true);
+    const usedBytes = view.getBigUint64(68, true);
+    const dataHashAlgo = hashAlgoFromId(b[76]);
+    const dataHash = b.slice(77, 77 + HASH_FIELD_SIZE);
+    return {
+        partitionType,
+        uid,
+        label,
+        startOffset,
+        maxLength,
+        usedBytes,
+        dataHashAlgo,
+        dataHash,
+    };
+}
+/**
+ * Apply the conformance checks a reader must run on a live entry
+ * (spec C5, C6, C7).
+ */
+export function validateEntry(e) {
+    if (e.partitionType === TYPE_RESERVED) {
+        throw PcfError.reservedType();
+    }
+    if (bytesEqual(e.uid, NIL_UID)) {
+        throw PcfError.nilUid();
+    }
+    if (e.usedBytes > e.maxLength) {
+        throw PcfError.usedExceedsMax();
+    }
+    decodeLabel(e.label); // validates label bytes
+}
+/** Free bytes remaining in a partition (`max_length - used_bytes`). */
+export function freeBytes(e) {
+    return e.usedBytes > e.maxLength ? 0n : e.maxLength - e.usedBytes;
+}
+/** Decode an entry's label as a string (reads up to the first NUL). */
+export function entryLabelString(e) {
+    return decodeLabel(e.label);
+}
+/** Build a 32-byte label field from a string (spec section 10). */
+export function encodeLabel(s) {
+    // Labels are ASCII (0x01..0x7F); reject anything that is not.
+    const out = new Uint8Array(LABEL_SIZE);
+    let n = 0;
+    for (const ch of s) {
+        const code = ch.codePointAt(0);
+        if (code === 0 || code >= 0x80) {
+            throw PcfError.invalidLabel();
+        }
+        if (n >= LABEL_SIZE) {
+            throw PcfError.invalidLabel();
+        }
+        out[n] = code;
+        n++;
+    }
+    return out;
+}
+/**
+ * Decode a 32-byte label field: read until the first NUL or 32 bytes,
+ * rejecting any byte >= 0x80 (spec section 10).
+ */
+export function decodeLabel(label) {
+    let end = LABEL_SIZE;
+    for (let i = 0; i < LABEL_SIZE; i++) {
+        const c = label[i];
+        if (c === 0) {
+            end = i;
+            break;
+        }
+        if (c >= 0x80) {
+            throw PcfError.invalidLabel();
+        }
+    }
+    let s = "";
+    for (let i = 0; i < end; i++) {
+        s += String.fromCharCode(label[i]);
+    }
+    return s;
+}
+function bytesEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Error type shared across the library (mirrors the reference `Error` enum).
+ */
+/** Discriminant identifying which kind of {@link PcfError} occurred. */
+export declare enum PcfErrorKind {
+    /** Underlying I/O failure. */
+    Io = "Io",
+    /** The file does not begin with the PCF magic. */
+    BadMagic = "BadMagic",
+    /** The file's major version is not implemented by this library. */
+    UnsupportedMajor = "UnsupportedMajor",
+    /** A hash-algorithm identifier is not in the registry. */
+    UnknownHashAlgo = "UnknownHashAlgo",
+    /** A live entry used the reserved type `0x00000000`. */
+    ReservedType = "ReservedType",
+    /** A live entry used the NIL UID. */
+    NilUid = "NilUid",
+    /** `used_bytes` exceeded `max_length` for an entry. */
+    UsedExceedsMax = "UsedExceedsMax",
+    /** A label byte was outside the permitted range (>= 0x80), or too long. */
+    InvalidLabel = "InvalidLabel",
+    /** A table block failed hash verification. */
+    TableHashMismatch = "TableHashMismatch",
+    /** A partition's data failed hash verification. */
+    DataHashMismatch = "DataHashMismatch",
+    /** An in-place update supplied more data than the partition's reservation. */
+    DataTooLarge = "DataTooLarge",
+    /** No partition with the requested UID exists. */
+    NotFound = "NotFound",
+    /** An attempt was made to add a partition whose UID already exists. */
+    DuplicateUid = "DuplicateUid"
+}
+/** All ways a PCF operation can fail. */
+export declare class PcfError extends Error {
+    /** The kind of failure. */
+    readonly kind: PcfErrorKind;
+    /**
+     * Optional numeric detail (e.g. the unsupported major version or the unknown
+     * hash-algorithm id), preserved for the variants that carry one.
+     */
+    readonly value?: number;
+    constructor(kind: PcfErrorKind, message: string, value?: number);
+    static badMagic(): PcfError;
+    static unsupportedMajor(v: number): PcfError;
+    static unknownHashAlgo(id: number): PcfError;
+    static reservedType(): PcfError;
+    static nilUid(): PcfError;
+    static usedExceedsMax(): PcfError;
+    static invalidLabel(): PcfError;
+    static tableHashMismatch(): PcfError;
+    static dataHashMismatch(): PcfError;
+    static dataTooLarge(): PcfError;
+    static notFound(): PcfError;
+    static duplicateUid(): PcfError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wEAAwE;AACxE,oBAAY,YAAY;IACtB,8BAA8B;IAC9B,EAAE,OAAO;IACT,kDAAkD;IAClD,QAAQ,aAAa;IACrB,mEAAmE;IACnE,gBAAgB,qBAAqB;IACrC,0DAA0D;IAC1D,eAAe,oBAAoB;IACnC,wDAAwD;IACxD,YAAY,iBAAiB;IAC7B,qCAAqC;IACrC,MAAM,WAAW;IACjB,uDAAuD;IACvD,cAAc,mBAAmB;IACjC,2EAA2E;IAC3E,YAAY,iBAAiB;IAC7B,8CAA8C;IAC9C,iBAAiB,sBAAsB;IACvC,mDAAmD;IACnD,gBAAgB,qBAAqB;IACrC,8EAA8E;IAC9E,YAAY,iBAAiB;IAC7B,kDAAkD;IAClD,QAAQ,aAAa;IACrB,uEAAuE;IACvE,YAAY,iBAAiB;CAC9B;AAED,yCAAyC;AACzC,qBAAa,QAAS,SAAQ,KAAK;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAS/D,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ;IAQ5C,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAQ5C,MAAM,CAAC,YAAY,IAAI,QAAQ;IAO/B,MAAM,CAAC,MAAM,IAAI,QAAQ;IAIzB,MAAM,CAAC,cAAc,IAAI,QAAQ;IAOjC,MAAM,CAAC,YAAY,IAAI,QAAQ;IAI/B,MAAM,CAAC,iBAAiB,IAAI,QAAQ;IAOpC,MAAM,CAAC,gBAAgB,IAAI,QAAQ;IAOnC,MAAM,CAAC,YAAY,IAAI,QAAQ;IAO/B,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B,MAAM,CAAC,YAAY,IAAI,QAAQ;CAGhC"}

package/dist/errors.js

@@ -0,0 +1,88 @@
+/**
+ * Error type shared across the library (mirrors the reference `Error` enum).
+ */
+/** Discriminant identifying which kind of {@link PcfError} occurred. */
+export var PcfErrorKind;
+(function (PcfErrorKind) {
+    /** Underlying I/O failure. */
+    PcfErrorKind["Io"] = "Io";
+    /** The file does not begin with the PCF magic. */
+    PcfErrorKind["BadMagic"] = "BadMagic";
+    /** The file's major version is not implemented by this library. */
+    PcfErrorKind["UnsupportedMajor"] = "UnsupportedMajor";
+    /** A hash-algorithm identifier is not in the registry. */
+    PcfErrorKind["UnknownHashAlgo"] = "UnknownHashAlgo";
+    /** A live entry used the reserved type `0x00000000`. */
+    PcfErrorKind["ReservedType"] = "ReservedType";
+    /** A live entry used the NIL UID. */
+    PcfErrorKind["NilUid"] = "NilUid";
+    /** `used_bytes` exceeded `max_length` for an entry. */
+    PcfErrorKind["UsedExceedsMax"] = "UsedExceedsMax";
+    /** A label byte was outside the permitted range (>= 0x80), or too long. */
+    PcfErrorKind["InvalidLabel"] = "InvalidLabel";
+    /** A table block failed hash verification. */
+    PcfErrorKind["TableHashMismatch"] = "TableHashMismatch";
+    /** A partition's data failed hash verification. */
+    PcfErrorKind["DataHashMismatch"] = "DataHashMismatch";
+    /** An in-place update supplied more data than the partition's reservation. */
+    PcfErrorKind["DataTooLarge"] = "DataTooLarge";
+    /** No partition with the requested UID exists. */
+    PcfErrorKind["NotFound"] = "NotFound";
+    /** An attempt was made to add a partition whose UID already exists. */
+    PcfErrorKind["DuplicateUid"] = "DuplicateUid";
+})(PcfErrorKind || (PcfErrorKind = {}));
+/** All ways a PCF operation can fail. */
+export class PcfError extends Error {
+    /** The kind of failure. */
+    kind;
+    /**
+     * Optional numeric detail (e.g. the unsupported major version or the unknown
+     * hash-algorithm id), preserved for the variants that carry one.
+     */
+    value;
+    constructor(kind, message, value) {
+        super(message);
+        this.name = "PcfError";
+        this.kind = kind;
+        this.value = value;
+        // Restore the prototype chain when targeting older runtimes.
+        Object.setPrototypeOf(this, PcfError.prototype);
+    }
+    static badMagic() {
+        return new PcfError(PcfErrorKind.BadMagic, "bad magic: not a PCF file");
+    }
+    static unsupportedMajor(v) {
+        return new PcfError(PcfErrorKind.UnsupportedMajor, `unsupported major version ${v}`, v);
+    }
+    static unknownHashAlgo(id) {
+        return new PcfError(PcfErrorKind.UnknownHashAlgo, `unknown hash algorithm id ${id}`, id);
+    }
+    static reservedType() {
+        return new PcfError(PcfErrorKind.ReservedType, "reserved partition type used for a live entry");
+    }
+    static nilUid() {
+        return new PcfError(PcfErrorKind.NilUid, "NIL UID used for a live entry");
+    }
+    static usedExceedsMax() {
+        return new PcfError(PcfErrorKind.UsedExceedsMax, "used_bytes exceeds max_length");
+    }
+    static invalidLabel() {
+        return new PcfError(PcfErrorKind.InvalidLabel, "invalid label");
+    }
+    static tableHashMismatch() {
+        return new PcfError(PcfErrorKind.TableHashMismatch, "table block hash mismatch");
+    }
+    static dataHashMismatch() {
+        return new PcfError(PcfErrorKind.DataHashMismatch, "partition data hash mismatch");
+    }
+    static dataTooLarge() {
+        return new PcfError(PcfErrorKind.DataTooLarge, "data larger than partition reservation");
+    }
+    static notFound() {
+        return new PcfError(PcfErrorKind.NotFound, "partition not found");
+    }
+    static duplicateUid() {
+        return new PcfError(PcfErrorKind.DuplicateUid, "duplicate UID");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Hash-algorithm registry (spec section 8).
+ *
+ * Each hash field in the format is a fixed 64-byte field accompanied by a
+ * `u8` algorithm identifier. Digests are stored left-aligned and zero-padded;
+ * CRC values are stored as little-endian integers, left-aligned and
+ * zero-padded (spec section 8.2).
+ *
+ * Digests are provided by the audited `@noble/hashes` package; the CRC variants
+ * are implemented locally in {@link "./crc"}.
+ */
+/**
+ * A hash algorithm from the PCF registry (spec section 8.1).
+ *
+ * The numeric value of each member is exactly its on-disk registry id, so
+ * `algo as number` yields the id byte.
+ */
+export declare enum HashAlgo {
+    /** `0` — no verification. */
+    None = 0,
+    /** `1` — CRC-32/ISO-HDLC. */
+    Crc32 = 1,
+    /** `2` — CRC-32C (Castagnoli). */
+    Crc32c = 2,
+    /** `3` — CRC-64/XZ. */
+    Crc64 = 3,
+    /** `4` — MD5 (checksum use only). */
+    Md5 = 4,
+    /** `5` — SHA-1 (checksum use only). */
+    Sha1 = 5,
+    /** `16` — SHA-256 (default). */
+    Sha256 = 16,
+    /** `17` — SHA-512. */
+    Sha512 = 17,
+    /** `18` — BLAKE3. */
+    Blake3 = 18
+}
+/** Map a registry id byte to an algorithm (spec section 8.1). */
+export declare function hashAlgoFromId(id: number): HashAlgo;
+/** The registry id byte for an algorithm. */
+export declare function hashAlgoId(algo: HashAlgo): number;
+/** Number of significant bytes an algorithm writes into a hash field. */
+export declare function digestLen(algo: HashAlgo): number;
+/** Whether an algorithm performs any verification (everything but `None`). */
+export declare function verifies(algo: HashAlgo): boolean;
+/**
+ * Compute the full 64-byte hash field for `data` per spec section 8.2.
+ *
+ * Digest-producing algorithms write their digest starting at byte 0; CRCs write
+ * a little-endian integer of their width; all remaining bytes are 0x00.
+ * Algorithm `None` yields an all-zero field.
+ */
+export declare function computeHashField(algo: HashAlgo, data: Uint8Array): Uint8Array;
+/**
+ * Verify `data` against a stored 64-byte hash field. `None` always succeeds
+ * (no verification). Only the significant prefix is compared, per spec 8.2.
+ */
+export declare function verifyHashField(algo: HashAlgo, data: Uint8Array, stored: Uint8Array): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH;;;;;GAKG;AACH,oBAAY,QAAQ;IAClB,6BAA6B;IAC7B,IAAI,IAAI;IACR,6BAA6B;IAC7B,KAAK,IAAI;IACT,kCAAkC;IAClC,MAAM,IAAI;IACV,uBAAuB;IACvB,KAAK,IAAI;IACT,qCAAqC;IACrC,GAAG,IAAI;IACP,uCAAuC;IACvC,IAAI,IAAI;IACR,gCAAgC;IAChC,MAAM,KAAK;IACX,sBAAsB;IACtB,MAAM,KAAK;IACX,qBAAqB;IACrB,MAAM,KAAK;CACZ;AAID,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAKnD;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAmBhD;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEhD;AAiBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CA+B7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GACjB,OAAO,CAYT"}

package/dist/hash.js

@@ -0,0 +1,151 @@
+/**
+ * Hash-algorithm registry (spec section 8).
+ *
+ * Each hash field in the format is a fixed 64-byte field accompanied by a
+ * `u8` algorithm identifier. Digests are stored left-aligned and zero-padded;
+ * CRC values are stored as little-endian integers, left-aligned and
+ * zero-padded (spec section 8.2).
+ *
+ * Digests are provided by the audited `@noble/hashes` package; the CRC variants
+ * are implemented locally in {@link "./crc"}.
+ */
+import { sha256, sha512 } from "@noble/hashes/sha2";
+import { md5, sha1 } from "@noble/hashes/legacy";
+import { blake3 } from "@noble/hashes/blake3";
+import { HASH_FIELD_SIZE } from "./consts.js";
+import { crc32, crc32c, crc64 } from "./crc.js";
+import { PcfError } from "./errors.js";
+/**
+ * A hash algorithm from the PCF registry (spec section 8.1).
+ *
+ * The numeric value of each member is exactly its on-disk registry id, so
+ * `algo as number` yields the id byte.
+ */
+export var HashAlgo;
+(function (HashAlgo) {
+    /** `0` — no verification. */
+    HashAlgo[HashAlgo["None"] = 0] = "None";
+    /** `1` — CRC-32/ISO-HDLC. */
+    HashAlgo[HashAlgo["Crc32"] = 1] = "Crc32";
+    /** `2` — CRC-32C (Castagnoli). */
+    HashAlgo[HashAlgo["Crc32c"] = 2] = "Crc32c";
+    /** `3` — CRC-64/XZ. */
+    HashAlgo[HashAlgo["Crc64"] = 3] = "Crc64";
+    /** `4` — MD5 (checksum use only). */
+    HashAlgo[HashAlgo["Md5"] = 4] = "Md5";
+    /** `5` — SHA-1 (checksum use only). */
+    HashAlgo[HashAlgo["Sha1"] = 5] = "Sha1";
+    /** `16` — SHA-256 (default). */
+    HashAlgo[HashAlgo["Sha256"] = 16] = "Sha256";
+    /** `17` — SHA-512. */
+    HashAlgo[HashAlgo["Sha512"] = 17] = "Sha512";
+    /** `18` — BLAKE3. */
+    HashAlgo[HashAlgo["Blake3"] = 18] = "Blake3";
+})(HashAlgo || (HashAlgo = {}));
+const KNOWN_IDS = new Set([0, 1, 2, 3, 4, 5, 16, 17, 18]);
+/** Map a registry id byte to an algorithm (spec section 8.1). */
+export function hashAlgoFromId(id) {
+    if (!KNOWN_IDS.has(id)) {
+        throw PcfError.unknownHashAlgo(id);
+    }
+    return id;
+}
+/** The registry id byte for an algorithm. */
+export function hashAlgoId(algo) {
+    return algo;
+}
+/** Number of significant bytes an algorithm writes into a hash field. */
+export function digestLen(algo) {
+    switch (algo) {
+        case HashAlgo.None:
+            return 0;
+        case HashAlgo.Crc32:
+        case HashAlgo.Crc32c:
+            return 4;
+        case HashAlgo.Crc64:
+            return 8;
+        case HashAlgo.Md5:
+            return 16;
+        case HashAlgo.Sha1:
+            return 20;
+        case HashAlgo.Sha256:
+        case HashAlgo.Blake3:
+            return 32;
+        case HashAlgo.Sha512:
+            return 64;
+    }
+}
+/** Whether an algorithm performs any verification (everything but `None`). */
+export function verifies(algo) {
+    return algo !== HashAlgo.None;
+}
+function writeU32Le(field, value) {
+    field[0] = value & 0xff;
+    field[1] = (value >>> 8) & 0xff;
+    field[2] = (value >>> 16) & 0xff;
+    field[3] = (value >>> 24) & 0xff;
+}
+function writeU64Le(field, value) {
+    let v = value;
+    for (let i = 0; i < 8; i++) {
+        field[i] = Number(v & 0xffn);
+        v >>= 8n;
+    }
+}
+/**
+ * Compute the full 64-byte hash field for `data` per spec section 8.2.
+ *
+ * Digest-producing algorithms write their digest starting at byte 0; CRCs write
+ * a little-endian integer of their width; all remaining bytes are 0x00.
+ * Algorithm `None` yields an all-zero field.
+ */
+export function computeHashField(algo, data) {
+    const field = new Uint8Array(HASH_FIELD_SIZE);
+    switch (algo) {
+        case HashAlgo.None:
+            break;
+        case HashAlgo.Crc32:
+            writeU32Le(field, crc32(data));
+            break;
+        case HashAlgo.Crc32c:
+            writeU32Le(field, crc32c(data));
+            break;
+        case HashAlgo.Crc64:
+            writeU64Le(field, crc64(data));
+            break;
+        case HashAlgo.Md5:
+            field.set(md5(data), 0);
+            break;
+        case HashAlgo.Sha1:
+            field.set(sha1(data), 0);
+            break;
+        case HashAlgo.Sha256:
+            field.set(sha256(data), 0);
+            break;
+        case HashAlgo.Sha512:
+            field.set(sha512(data), 0);
+            break;
+        case HashAlgo.Blake3:
+            field.set(blake3(data), 0);
+            break;
+    }
+    return field;
+}
+/**
+ * Verify `data` against a stored 64-byte hash field. `None` always succeeds
+ * (no verification). Only the significant prefix is compared, per spec 8.2.
+ */
+export function verifyHashField(algo, data, stored) {
+    if (!verifies(algo)) {
+        return true;
+    }
+    const computed = computeHashField(algo, data);
+    const n = digestLen(algo);
+    for (let i = 0; i < n; i++) {
+        if (computed[i] !== stored[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,CAAN,IAAY,QAmBX;AAnBD,WAAY,QAAQ;IAClB,6BAA6B;IAC7B,uCAAQ,CAAA;IACR,6BAA6B;IAC7B,yCAAS,CAAA;IACT,kCAAkC;IAClC,2CAAU,CAAA;IACV,uBAAuB;IACvB,yCAAS,CAAA;IACT,qCAAqC;IACrC,qCAAO,CAAA;IACP,uCAAuC;IACvC,uCAAQ,CAAA;IACR,gCAAgC;IAChC,4CAAW,CAAA;IACX,sBAAsB;IACtB,4CAAW,CAAA;IACX,qBAAqB;IACrB,4CAAW,CAAA;AACb,CAAC,EAnBW,QAAQ,KAAR,QAAQ,QAmBnB;AAED,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAE/E,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,EAAc,CAAC;AACxB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,IAAI;YAChB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,KAAK,CAAC;QACpB,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,KAAK;YACjB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,GAAG;YACf,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC,IAAI;YAChB,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC,MAAM,CAAC;QACrB,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,OAAO,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB,EAAE,KAAa;IAClD,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB,EAAE,KAAa;IAClD,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC7B,CAAC,KAAK,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc,EAAE,IAAgB;IAC/D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC,CAAC;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,IAAI;YAChB,MAAM;QACR,KAAK,QAAQ,CAAC,KAAK;YACjB,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,MAAM;QACR,KAAK,QAAQ,CAAC,MAAM;YAClB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAChC,MAAM;QACR,KAAK,QAAQ,CAAC,KAAK;YACjB,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,MAAM;QACR,KAAK,QAAQ,CAAC,GAAG;YACf,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,QAAQ,CAAC,IAAI;YAChB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,QAAQ,CAAC,MAAM;YAClB,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,QAAQ,CAAC,MAAM;YAClB,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,QAAQ,CAAC,MAAM;YAClB,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3B,MAAM;IACV,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAc,EACd,IAAgB,EAChB,MAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/header.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The fixed 20-byte file header (spec section 4).
+ */
+/** Parsed file header. */
+export interface FileHeader {
+    /** Major format version. */
+    versionMajor: number;
+    /** Minor format version. */
+    versionMinor: number;
+    /** Absolute offset of the first table block. */
+    partitionTableOffset: bigint;
+}
+/** Serialise a header to its on-disk 20-byte layout. */
+export declare function headerToBytes(h: FileHeader): Uint8Array;
+/**
+ * Parse a header from its on-disk 20-byte layout, validating magic and major
+ * version (spec conformance checks C1, C2).
+ */
+export declare function headerFromBytes(b: Uint8Array): FileHeader;
+//# sourceMappingURL=header.d.ts.map

package/dist/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../src/header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,0BAA0B;AAC1B,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CAQvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CAiBzD"}

package/dist/header.js

@@ -0,0 +1,38 @@
+/**
+ * The fixed 20-byte file header (spec section 4).
+ */
+import { HEADER_SIZE, MAGIC, VERSION_MAJOR } from "./consts.js";
+import { PcfError } from "./errors.js";
+/** Serialise a header to its on-disk 20-byte layout. */
+export function headerToBytes(h) {
+    const b = new Uint8Array(HEADER_SIZE);
+    b.set(MAGIC, 0);
+    const view = new DataView(b.buffer);
+    view.setUint16(8, h.versionMajor, true);
+    view.setUint16(10, h.versionMinor, true);
+    view.setBigUint64(12, h.partitionTableOffset, true);
+    return b;
+}
+/**
+ * Parse a header from its on-disk 20-byte layout, validating magic and major
+ * version (spec conformance checks C1, C2).
+ */
+export function headerFromBytes(b) {
+    if (b.length < HEADER_SIZE) {
+        throw PcfError.badMagic();
+    }
+    for (let i = 0; i < MAGIC.length; i++) {
+        if (b[i] !== MAGIC[i]) {
+            throw PcfError.badMagic();
+        }
+    }
+    const view = new DataView(b.buffer, b.byteOffset, b.byteLength);
+    const versionMajor = view.getUint16(8, true);
+    if (versionMajor !== VERSION_MAJOR) {
+        throw PcfError.unsupportedMajor(versionMajor);
+    }
+    const versionMinor = view.getUint16(10, true);
+    const partitionTableOffset = view.getBigUint64(12, true);
+    return { versionMajor, versionMinor, partitionTableOffset };
+}
+//# sourceMappingURL=header.js.map

package/dist/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../src/header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,CAAa;IACzC,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChB,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAa;IAC3C,IAAI,CAAC,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * # `pcf` — Partitioned Container Format (TypeScript implementation)
+ *
+ * A language-agnostic binary container that stores multiple independent regions
+ * of bytes ("partitions") in a single file. This package mirrors the written
+ * specification (`PCF-spec-v1.0.txt`) and the Rust reference implementation
+ * field-for-field and favours auditability over performance.
+ *
+ * ## Layout at a glance
+ *
+ * ```text
+ * [ 20-byte header ] [ table block(s) ] [ partition data regions ]
+ * ```
+ *
+ * All integers are little-endian. Free space is derived as
+ * `maxLength - usedBytes`.
+ *
+ * ## Example
+ *
+ * ```ts
+ * import { Container, HashAlgo } from "pcf";
+ *
+ * const c = Container.create();
+ * const uid = new Uint8Array(16).fill(1);
+ * c.addPartition(0x10, uid, "notes", new TextEncoder().encode("hello world"), 64, HashAlgo.Sha256);
+ *
+ * c.verify();
+ * const entries = c.entries();
+ * console.log(new TextDecoder().decode(c.readPartitionData(entries[0]))); // "hello world"
+ * ```
+ */
+export * from "./consts.js";
+export { PcfError, PcfErrorKind } from "./errors.js";
+export { HashAlgo, hashAlgoFromId, hashAlgoId, digestLen, verifies, computeHashField, verifyHashField, } from "./hash.js";
+export { crc32, crc32c, crc64 } from "./crc.js";
+export { type FileHeader, headerToBytes, headerFromBytes, } from "./header.js";
+export { type PartitionEntry, entryToBytes, entryFromBytes, validateEntry, freeBytes, entryLabelString, encodeLabel, decodeLabel, } from "./entry.js";
+export { type TableBlockHeader, tableHeaderToBytes, tableHeaderFromBytes, computeTableHash, } from "./table.js";
+export { type Storage, MemoryStorage } from "./storage.js";
+export { NodeFileStorage } from "./node-storage.js";
+export { Container, type BlockView } from "./container.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,KAAK,UAAU,EACf,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC"}