npm - @kduma-oss/pcf - Versions diffs - 0.0.5 → 0.0.7 - Mend

@kduma-oss/pcf 0.0.5 → 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/README.md CHANGED Viewed

@@ -82,7 +82,7 @@ store.close();
 ## Project layout
 ```
-implementations/ts/
+implementations/ts/pcf/
 ├── package.json
 ├── tsconfig.json
 ├── vitest.config.ts

package/dist/consts.d.ts CHANGED Viewed

@@ -39,4 +39,23 @@ export declare const NIL_UID: Uint8Array;
  * is a `u8`).
  */
 export declare const MAX_ENTRIES_PER_BLOCK = 255;
+/**
+ * Sentinel value of `partition_table_offset` (header offset 12) meaning the
+ * partition-table head is recorded in the file trailer at the end of the file
+ * rather than in the header (spec section 4, "File Trailer"). The all-ones u64
+ * can never be a real offset, so it is unambiguous.
+ */
+export declare const PT_OFFSET_TRAILER = 18446744073709551615n;
+/** Fixed size of the optional file trailer, in bytes. */
+export declare const TRAILER_SIZE = 20;
+/**
+ * Trailer signature, 8 bytes: the file {@link MAGIC} reversed
+ * (`0x1A 0x0A 0x0D 'T' 'R' 'P' 'K' 0x89`). Placed as the final 8 bytes of the
+ * file so a reader can detect and validate the trailer at the end.
+ */
+export declare const TRAILER_MAGIC: Uint8Array;
+/** Chain-direction flag: forward chain, head = first block. */
+export declare const CHAIN_FORWARD = 0;
+/** Chain-direction flag: backward chain, head = last/newest block. */
+export declare const CHAIN_BACKWARD = 1;
 //# sourceMappingURL=consts.d.ts.map

package/dist/consts.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sEAAsE;AACtE,eAAO,MAAM,KAAK,EAAE,UAElB,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,wDAAwD;AACxD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,+CAA+C;AAC/C,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,wDAAwD;AACxD,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,+EAA+E;AAC/E,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,mDAAmD;AACnD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,iDAAiD;AACjD,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,aAAa,IAAc,CAAC;AACzC;;;GAGG;AACH,eAAO,MAAM,QAAQ,aAAc,CAAC;AAEpC,+DAA+D;AAC/D,eAAO,MAAM,OAAO,EAAE,UAAqC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC"}
1	+ {"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sEAAsE;AACtE,eAAO,MAAM,KAAK,EAAE,UAElB,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,wDAAwD;AACxD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,+CAA+C;AAC/C,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,wDAAwD;AACxD,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,+EAA+E;AAC/E,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,mDAAmD;AACnD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,iDAAiD;AACjD,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,aAAa,IAAc,CAAC;AACzC;;;GAGG;AACH,eAAO,MAAM,QAAQ,aAAc,CAAC;AAEpC,+DAA+D;AAC/D,eAAO,MAAM,OAAO,EAAE,UAAqC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,wBAAyB,CAAC;AAExD,yDAAyD;AACzD,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,UAE1B,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,sEAAsE;AACtE,eAAO,MAAM,cAAc,IAAI,CAAC"}

package/dist/consts.js CHANGED Viewed

@@ -41,4 +41,25 @@ export const NIL_UID = new Uint8Array(UID_SIZE);
  * is a `u8`).
  */
 export const MAX_ENTRIES_PER_BLOCK = 255;
+/**
+ * Sentinel value of `partition_table_offset` (header offset 12) meaning the
+ * partition-table head is recorded in the file trailer at the end of the file
+ * rather than in the header (spec section 4, "File Trailer"). The all-ones u64
+ * can never be a real offset, so it is unambiguous.
+ */
+export const PT_OFFSET_TRAILER = 0xffffffffffffffffn;
+/** Fixed size of the optional file trailer, in bytes. */
+export const TRAILER_SIZE = 20;
+/**
+ * Trailer signature, 8 bytes: the file {@link MAGIC} reversed
+ * (`0x1A 0x0A 0x0D 'T' 'R' 'P' 'K' 0x89`). Placed as the final 8 bytes of the
+ * file so a reader can detect and validate the trailer at the end.
+ */
+export const TRAILER_MAGIC = new Uint8Array([
+    0x1a, 0x0a, 0x0d, 0x54, 0x52, 0x50, 0x4b, 0x89,
+]);
+/** Chain-direction flag: forward chain, head = first block. */
+export const CHAIN_FORWARD = 0;
+/** Chain-direction flag: backward chain, head = last/newest block. */
+export const CHAIN_BACKWARD = 1;
 //# sourceMappingURL=consts.js.map

package/dist/consts.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,KAAK,GAAe,IAAI,UAAU,CAAC;IAC9C,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC,CAAC;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAE9B,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAe,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC"}
1	+ {"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,KAAK,GAAe,IAAI,UAAU,CAAC;IAC9C,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC,CAAC;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAE9B,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAe,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAsB,CAAC;AAExD,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAe,IAAI,UAAU,CAAC;IACtD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/dist/container.d.ts CHANGED Viewed

@@ -57,6 +57,14 @@ export declare class Container {
     private dataEof;
     private defaultCapacity;
     private tableHashAlgo;
+    /**
+     * Resolved absolute offset of the partition-table head: the header pointer
+     * for a classic file, or the offset from the file trailer when the header
+     * holds {@link PT_OFFSET_TRAILER}. 0 denotes an empty table.
+     */
+    private tableHeadOffset;
+    /** Chain-direction flags resolved at open time (see {@link Trailer}). */
+    private chainFlags;
     private constructor();
     /**
      * Create an empty container with sensible defaults (first block capacity 16,
@@ -68,12 +76,45 @@ export declare class Container {
      * the table-hash algorithm.
      */
     static createWith(storage: Storage, firstBlockCapacity: number, tableHashAlgo: HashAlgo): Container;
-    /** Open an existing container, validating the header (spec C1, C2). */
+    /**
+     * Open an existing container, validating the header (spec C1, C2).
+     *
+     * When the header's `partitionTableOffset` is the {@link PT_OFFSET_TRAILER}
+     * sentinel, the partition-table head and chain direction are read from the
+     * file trailer (located by scanning backward from the end of the file). Chain
+     * traversal is identical in both directions (follow `nextTableOffset` until
+     * 0); the direction only conveys which end is newest, exposed via
+     * {@link Container.chainIsBackward}.
+     */
     static open(storage: Storage): Container;
     /** Consume the container and return the backing store. */
     intoStorage(): Storage;
-    /** The parsed file header. */
+    /**
+     * The parsed file header. In trailer mode its `partitionTableOffset` holds
+     * the {@link PT_OFFSET_TRAILER} sentinel; use {@link Container.tableHead} for
+     * the resolved head.
+     */
     header(): FileHeader;
+    /**
+     * The resolved absolute offset of the partition-table head (0 if empty). This
+     * is the value to follow regardless of header-pointer vs trailer mode.
+     */
+    tableHead(): number;
+    /**
+     * Whether the chain is backward-linked (head = newest block,
+     * `nextTableOffset` points at the previous/older block). Classic
+     * header-pointer files are always forward.
+     */
+    chainIsBackward(): boolean;
+    /**
+     * Locate the most recent valid file trailer by scanning backward from the end
+     * of the file for the last 20-byte window ending in {@link TRAILER_MAGIC}
+     * whose recorded head is empty (0) or references a parseable table block.
+     * Bytes after that trailer — an incomplete or aborted append — are ignored,
+     * which gives append-only writers crash recovery for free. In the clean case
+     * the trailer is the final {@link TRAILER_SIZE} bytes.
+     */
+    private static locateTrailer;
     private readBlock;
     private writeBlock;
     /** All live partition entries, in chain order. */
@@ -120,5 +161,13 @@ export declare class Container {
     compactedImage(): Uint8Array;
     /** Write a compacted copy of the container to `out`. */
     compactInto(out: Storage): void;
+    /**
+     * Convert the file to trailer mode: append a fixed trailer at the end of the
+     * file recording the current partition-table head, then overwrite the
+     * header's `partitionTableOffset` with the {@link PT_OFFSET_TRAILER} sentinel
+     * so the head is located via that trailer. The chain built by this writer is
+     * forward-linked, so the trailer records {@link CHAIN_FORWARD}.
+     */
+    finalizeWithTrailer(): void;
 }
 //# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;~~AAYH~~,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAA+B,QAAQ,EAAY,MAAM,WAAW,CAAC;AAC5E,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;~~AAWpB~~;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAcD,mDAAmD;AACnD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAW;~~IAEhC~~,OAAO;IAkBP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,OAA6B,GAAG,SAAS;IAIhE;;;OAGG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,QAAQ,GACtB,SAAS;IA4BZ~~,uEAAuE~~;~~IACvE~~,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS;~~IA2BxC~~,0DAA0D;IAC1D,WAAW,IAAI,OAAO;IAItB~~,8BAA8B~~;~~IAC9B~~,MAAM,IAAI,UAAU;~~IAMpB~~,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,UAAU;IAyBlB,kDAAkD;IAClD,OAAO,IAAI,cAAc,EAAE;IAW3B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAKtC,oCAAoC;IACpC,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU;IAQpD,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,YAAY,CACV,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,EAChB,YAAY,GAAE,MAAM,GAAG,MAAU,EACjC,YAAY,GAAE,QAA0B,GACvC,IAAI;IAuEP;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAmB/D;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAatC;;;OAGG;IACH,MAAM,IAAI,IAAI;IA8Bd;;;;;OAKG;IACH,cAAc,IAAI,UAAU;IAqF5B,wDAAwD;IACxD,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;~~CAGhC~~"}
1	+ {"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAgBH,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAA+B,QAAQ,EAAY,MAAM,WAAW,CAAC;AAC5E,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAYpB;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAcD,mDAAmD;AACnD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAW;IAChC;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAe;IACtC,yEAAyE;IACzE,OAAO,CAAC,UAAU,CAAiB;IAEnC,OAAO;IAkBP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,OAA6B,GAAG,SAAS;IAIhE;;;OAGG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,QAAQ,GACtB,SAAS;IA4BZ;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS;IAiCxC,0DAA0D;IAC1D,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,MAAM,IAAI,UAAU;IAIpB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqC5B,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,UAAU;IAyBlB,kDAAkD;IAClD,OAAO,IAAI,cAAc,EAAE;IAW3B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAKtC,oCAAoC;IACpC,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU;IAQpD,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,YAAY,CACV,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,EAChB,YAAY,GAAE,MAAM,GAAG,MAAU,EACjC,YAAY,GAAE,QAA0B,GACvC,IAAI;IAuEP;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAmB/D;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAatC;;;OAGG;IACH,MAAM,IAAI,IAAI;IA8Bd;;;;;OAKG;IACH,cAAc,IAAI,UAAU;IAqF5B,wDAAwD;IACxD,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAM/B;;;;;;OAMG;IACH,mBAAmB,IAAI,IAAI;CAe5B"}

package/dist/container.js CHANGED Viewed

@@ -26,13 +26,14 @@
  *   fresh overflow blocks. {@link Container.compactedImage} rebuilds a tightly
  *   packed file.
  */
-import { ENTRY_SIZE, HEADER_SIZE, MAX_ENTRIES_PER_BLOCK, NIL_UID, TABLE_HEADER_SIZE, TYPE_RESERVED, VERSION_MAJOR, VERSION_MINOR, } from "./consts.js";
+import { CHAIN_FORWARD, ENTRY_SIZE, HEADER_SIZE, MAX_ENTRIES_PER_BLOCK, NIL_UID, PT_OFFSET_TRAILER, TABLE_HEADER_SIZE, TRAILER_MAGIC, TRAILER_SIZE, TYPE_RESERVED, VERSION_MAJOR, VERSION_MINOR, } from "./consts.js";
 import { encodeLabel, entryFromBytes, entryToBytes, validateEntry, } from "./entry.js";
 import { PcfError } from "./errors.js";
 import { computeHashField, digestLen, HashAlgo, verifies } from "./hash.js";
 import { headerFromBytes, headerToBytes, } from "./header.js";
 import { MemoryStorage } from "./storage.js";
 import { computeTableHash, tableHeaderFromBytes, tableHeaderToBytes, } from "./table.js";
+import { trailerFromBytes, trailerToBytes } from "./trailer.js";
 function bytesEqual(a, b) {
     if (a.length !== b.length) {
         return false;
@@ -52,6 +53,14 @@ export class Container {
     dataEof;
     defaultCapacity;
     tableHashAlgo;
+    /**
+     * Resolved absolute offset of the partition-table head: the header pointer
+     * for a classic file, or the offset from the file trailer when the header
+     * holds {@link PT_OFFSET_TRAILER}. 0 denotes an empty table.
+     */
+    tableHeadOffset = HEADER_SIZE;
+    /** Chain-direction flags resolved at open time (see {@link Trailer}). */
+    chainFlags = CHAIN_FORWARD;
     constructor(storage, fileHeader, blocks, dataEof, defaultCapacity, tableHashAlgo) {
         this.storage = storage;
         this.fileHeader = fileHeader;
@@ -94,13 +103,29 @@ export class Container {
         ];
         return new Container(storage, header, blocks, dataEof, cap, tableHashAlgo);
     }
-    /** Open an existing container, validating the header (spec C1, C2). */
+    /**
+     * Open an existing container, validating the header (spec C1, C2).
+     *
+     * When the header's `partitionTableOffset` is the {@link PT_OFFSET_TRAILER}
+     * sentinel, the partition-table head and chain direction are read from the
+     * file trailer (located by scanning backward from the end of the file). Chain
+     * traversal is identical in both directions (follow `nextTableOffset` until
+     * 0); the direction only conveys which end is newest, exposed via
+     * {@link Container.chainIsBackward}.
+     */
     static open(storage) {
         const hb = storage.readAt(0, HEADER_SIZE);
         const header = headerFromBytes(hb);
         const me = new Container(storage, header, [], 0, 16, HashAlgo.Sha256);
+        if (header.partitionTableOffset === PT_OFFSET_TRAILER) {
+            [me.tableHeadOffset, me.chainFlags] = Container.locateTrailer(storage);
+        }
+        else {
+            me.tableHeadOffset = Number(header.partitionTableOffset);
+            me.chainFlags = CHAIN_FORWARD;
+        }
         const blocks = [];
-        let off = Number(header.partitionTableOffset);
+        let off = me.tableHeadOffset;
         while (off !== 0) {
             const [h] = me.readBlock(off);
             blocks.push({
@@ -123,10 +148,72 @@ export class Container {
     intoStorage() {
         return this.storage;
     }
-    /** The parsed file header. */
+    /**
+     * The parsed file header. In trailer mode its `partitionTableOffset` holds
+     * the {@link PT_OFFSET_TRAILER} sentinel; use {@link Container.tableHead} for
+     * the resolved head.
+     */
     header() {
         return this.fileHeader;
     }
+    /**
+     * The resolved absolute offset of the partition-table head (0 if empty). This
+     * is the value to follow regardless of header-pointer vs trailer mode.
+     */
+    tableHead() {
+        return this.tableHeadOffset;
+    }
+    /**
+     * Whether the chain is backward-linked (head = newest block,
+     * `nextTableOffset` points at the previous/older block). Classic
+     * header-pointer files are always forward.
+     */
+    chainIsBackward() {
+        return (this.chainFlags & 1) !== 0;
+    }
+    /**
+     * Locate the most recent valid file trailer by scanning backward from the end
+     * of the file for the last 20-byte window ending in {@link TRAILER_MAGIC}
+     * whose recorded head is empty (0) or references a parseable table block.
+     * Bytes after that trailer — an incomplete or aborted append — are ignored,
+     * which gives append-only writers crash recovery for free. In the clean case
+     * the trailer is the final {@link TRAILER_SIZE} bytes.
+     */
+    static locateTrailer(storage) {
+        let end = storage.size();
+        while (end >= TRAILER_SIZE) {
+            const start = end - TRAILER_SIZE;
+            const window = storage.readAt(start, TRAILER_SIZE);
+            let magicOk = true;
+            for (let i = 0; i < TRAILER_MAGIC.length; i++) {
+                if (window[12 + i] !== TRAILER_MAGIC[i]) {
+                    magicOk = false;
+                    break;
+                }
+            }
+            if (magicOk) {
+                const t = trailerFromBytes(window);
+                if (t.partitionTableOffset === 0n) {
+                    return [0, t.chainFlags];
+                }
+                const head = Number(t.partitionTableOffset);
+                if (t.partitionTableOffset > 0n && head + TABLE_HEADER_SIZE <= start) {
+                    try {
+                        tableHeaderFromBytes(storage.readAt(head, TABLE_HEADER_SIZE));
+                        return [head, t.chainFlags];
+                    }
+                    catch (e) {
+                        if (!(e instanceof PcfError)) {
+                            throw e;
+                        }
+                        // Spurious magic in an aborted tail; keep scanning.
+                    }
+                }
+            }
+            end -= 1;
+        }
+        throw PcfError.badTrailer();
+    }
     // ---- low-level I/O ------------------------------------------------------
     readBlock(off) {
         const hb = this.storage.readAt(off, TABLE_HEADER_SIZE);
@@ -159,7 +246,7 @@ export class Container {
     /** All live partition entries, in chain order. */
     entries() {
         const out = [];
-        let off = Number(this.fileHeader.partitionTableOffset);
+        let off = this.tableHeadOffset;
         while (off !== 0) {
             const [h, entries] = this.readBlock(off);
             out.push(...entries);
@@ -187,7 +274,7 @@ export class Container {
         return this.storage.readAt(Number(entry.startOffset), used);
     }
     locate(uid) {
-        let off = Number(this.fileHeader.partitionTableOffset);
+        let off = this.tableHeadOffset;
         while (off !== 0) {
             const [h, entries] = this.readBlock(off);
             for (let i = 0; i < entries.length; i++) {
@@ -314,7 +401,7 @@ export class Container {
      * hash, and run the per-entry conformance checks (spec section 12).
      */
     verify() {
-        let off = Number(this.fileHeader.partitionTableOffset);
+        let off = this.tableHeadOffset;
         while (off !== 0) {
             const [h, entries] = this.readBlock(off);
             if (verifies(h.tableHashAlgo)) {
@@ -346,7 +433,7 @@ export class Container {
     compactedImage() {
         // Gather live entries and their data, in chain order.
         const live = [];
-        let off = Number(this.fileHeader.partitionTableOffset);
+        let off = this.tableHeadOffset;
         while (off !== 0) {
             const [h, entries] = this.readBlock(off);
             for (const e of entries) {
@@ -424,6 +511,29 @@ export class Container {
     compactInto(out) {
         out.writeAt(0, this.compactedImage());
     }
+    // ---- trailer mode ------------------------------------------------------
+    /**
+     * Convert the file to trailer mode: append a fixed trailer at the end of the
+     * file recording the current partition-table head, then overwrite the
+     * header's `partitionTableOffset` with the {@link PT_OFFSET_TRAILER} sentinel
+     * so the head is located via that trailer. The chain built by this writer is
+     * forward-linked, so the trailer records {@link CHAIN_FORWARD}.
+     */
+    finalizeWithTrailer() {
+        const trailer = {
+            partitionTableOffset: BigInt(this.tableHeadOffset),
+            chainFlags: CHAIN_FORWARD,
+        };
+        const pos = this.storage.size();
+        this.storage.writeAt(pos, trailerToBytes(trailer));
+        this.fileHeader = {
+            ...this.fileHeader,
+            partitionTableOffset: PT_OFFSET_TRAILER,
+        };
+        this.storage.writeAt(0, headerToBytes(this.fileHeader));
+        this.chainFlags = CHAIN_FORWARD;
+        this.dataEof = pos + TRAILER_SIZE;
+    }
 }
 function verifyDataHash(e, data) {
     if (!verifies(e.dataHashAlgo)) {

package/dist/container.js.map CHANGED Viewed

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

package/dist/errors.d.ts CHANGED Viewed

@@ -28,7 +28,9 @@ export declare enum PcfErrorKind {
     /** No partition with the requested UID exists. */
     NotFound = "NotFound",
     /** An attempt was made to add a partition whose UID already exists. */
-    DuplicateUid = "DuplicateUid"
+    DuplicateUid = "DuplicateUid",
+    /** The header requested trailer-based location but no valid trailer exists. */
+    BadTrailer = "BadTrailer"
 }
 /** All ways a PCF operation can fail. */
 export declare class PcfError extends Error {
@@ -52,5 +54,6 @@ export declare class PcfError extends Error {
     static dataTooLarge(): PcfError;
     static notFound(): PcfError;
     static duplicateUid(): PcfError;
+    static badTrailer(): PcfError;
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
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~~"}
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;IAC7B,+EAA+E;IAC/E,UAAU,eAAe;CAC1B;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;IAI/B,MAAM,CAAC,UAAU,IAAI,QAAQ;CAM9B"}

package/dist/errors.js CHANGED Viewed

@@ -30,6 +30,8 @@ export var PcfErrorKind;
     PcfErrorKind["NotFound"] = "NotFound";
     /** An attempt was made to add a partition whose UID already exists. */
     PcfErrorKind["DuplicateUid"] = "DuplicateUid";
+    /** The header requested trailer-based location but no valid trailer exists. */
+    PcfErrorKind["BadTrailer"] = "BadTrailer";
 })(PcfErrorKind || (PcfErrorKind = {}));
 /** All ways a PCF operation can fail. */
 export class PcfError extends Error {
@@ -84,5 +86,8 @@ export class PcfError extends Error {
     static duplicateUid() {
         return new PcfError(PcfErrorKind.DuplicateUid, "duplicate UID");
     }
+    static badTrailer() {
+        return new PcfError(PcfErrorKind.BadTrailer, "missing or invalid file trailer");
+    }
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wEAAwE;AACxE,MAAM,CAAN,IAAY,~~YA2BX~~;~~AA3BD~~,WAAY,YAAY;IACtB,8BAA8B;IAC9B,yBAAS,CAAA;IACT,kDAAkD;IAClD,qCAAqB,CAAA;IACrB,mEAAmE;IACnE,qDAAqC,CAAA;IACrC,0DAA0D;IAC1D,mDAAmC,CAAA;IACnC,wDAAwD;IACxD,6CAA6B,CAAA;IAC7B,qCAAqC;IACrC,iCAAiB,CAAA;IACjB,uDAAuD;IACvD,iDAAiC,CAAA;IACjC,2EAA2E;IAC3E,6CAA6B,CAAA;IAC7B,8CAA8C;IAC9C,uDAAuC,CAAA;IACvC,mDAAmD;IACnD,qDAAqC,CAAA;IACrC,8EAA8E;IAC9E,6CAA6B,CAAA;IAC7B,kDAAkD;IAClD,qCAAqB,CAAA;IACrB,uEAAuE;IACvE,6CAA6B,CAAA;~~AAC~~/B,CAAC,~~EA3BW~~,YAAY,KAAZ,YAAY,~~QA2BvB~~;AAED,yCAAyC;AACzC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,2BAA2B;IAClB,IAAI,CAAe;IAC5B;;;OAGG;IACM,KAAK,CAAU;IAExB,YAAY,IAAkB,EAAE,OAAe,EAAE,KAAc;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,6DAA6D;QAC7D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,CAAS;QAC/B,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,gBAAgB,EAC7B,6BAA6B,CAAC,EAAE,EAChC,CAAC,CACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,EAAU;QAC/B,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,eAAe,EAC5B,6BAA6B,EAAE,EAAE,EACjC,EAAE,CACH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,YAAY,EACzB,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,cAAc,EAC3B,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,iBAAiB;QACtB,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,iBAAiB,EAC9B,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,gBAAgB,EAC7B,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,YAAY,EACzB,wCAAwC,CACzC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClE,CAAC;CACF"}
1	+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts CHANGED Viewed

@@ -36,6 +36,7 @@ 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 Trailer, trailerToBytes, trailerFromBytes } from "./trailer.js";
 export { type Storage, MemoryStorage } from "./storage.js";
 export { NodeFileStorage } from "./node-storage.js";
 export { Container, type BlockView } from "./container.js";

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
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"}
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,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9E,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"}

package/dist/index.js CHANGED Viewed

@@ -36,6 +36,7 @@ export { crc32, crc32c, crc64 } from "./crc.js";
 export { headerToBytes, headerFromBytes, } from "./header.js";
 export { entryToBytes, entryFromBytes, validateEntry, freeBytes, entryLabelString, encodeLabel, decodeLabel, } from "./entry.js";
 export { tableHeaderToBytes, tableHeaderFromBytes, computeTableHash, } from "./table.js";
+export { trailerToBytes, trailerFromBytes } from "./trailer.js";
 export { MemoryStorage } from "./storage.js";
 export { NodeFileStorage } from "./node-storage.js";
 export { Container } from "./container.js";

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","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,EAEL,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC"}
1	+ {"version":3,"file":"index.js","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,EAEL,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAgB,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC"}

package/dist/trailer.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+/**
+ * The optional fixed 20-byte file trailer (spec section 4, "File Trailer").
+ *
+ * A trailer is present only when the file header's `partitionTableOffset` holds
+ * the {@link PT_OFFSET_TRAILER} sentinel. It occupies the final
+ * {@link TRAILER_SIZE} bytes of the file and records the real offset of the
+ * partition-table head together with the chain direction. Because every append
+ * places a fresh trailer at the new end of file, the file's last bytes always
+ * point at the newest table — enabling append-only writers with no in-place
+ * header rewrite.
+ */
+/** Parsed file trailer. */
+export interface Trailer {
+    /** Absolute offset of the partition-table head (0 = empty container). */
+    partitionTableOffset: bigint;
+    /** Chain-direction flags; bit 0 selects forward (0) or backward (1). */
+    chainFlags: number;
+}
+/** Serialise to the on-disk 20-byte layout (reserved bytes 9..12 are zero). */
+export declare function trailerToBytes(t: Trailer): Uint8Array;
+/**
+ * Parse from the on-disk 20-byte layout, validating the trailer magic. Throws
+ * {@link PcfError} (BadTrailer) if the magic does not match.
+ */
+export declare function trailerFromBytes(b: Uint8Array): Trailer;
+//# sourceMappingURL=trailer.d.ts.map

package/dist/trailer.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"trailer.d.ts","sourceRoot":"","sources":["../src/trailer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,2BAA2B;AAC3B,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,CAOrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAWvD"}

package/dist/trailer.js ADDED Viewed

@@ -0,0 +1,39 @@
+/**
+ * The optional fixed 20-byte file trailer (spec section 4, "File Trailer").
+ *
+ * A trailer is present only when the file header's `partitionTableOffset` holds
+ * the {@link PT_OFFSET_TRAILER} sentinel. It occupies the final
+ * {@link TRAILER_SIZE} bytes of the file and records the real offset of the
+ * partition-table head together with the chain direction. Because every append
+ * places a fresh trailer at the new end of file, the file's last bytes always
+ * point at the newest table — enabling append-only writers with no in-place
+ * header rewrite.
+ */
+import { TRAILER_MAGIC, TRAILER_SIZE } from "./consts.js";
+import { PcfError } from "./errors.js";
+/** Serialise to the on-disk 20-byte layout (reserved bytes 9..12 are zero). */
+export function trailerToBytes(t) {
+    const b = new Uint8Array(TRAILER_SIZE);
+    const view = new DataView(b.buffer);
+    view.setBigUint64(0, t.partitionTableOffset, true);
+    b[8] = t.chainFlags & 0xff;
+    b.set(TRAILER_MAGIC, 12);
+    return b;
+}
+/**
+ * Parse from the on-disk 20-byte layout, validating the trailer magic. Throws
+ * {@link PcfError} (BadTrailer) if the magic does not match.
+ */
+export function trailerFromBytes(b) {
+    if (b.length < TRAILER_SIZE) {
+        throw PcfError.badTrailer();
+    }
+    for (let i = 0; i < TRAILER_MAGIC.length; i++) {
+        if (b[12 + i] !== TRAILER_MAGIC[i]) {
+            throw PcfError.badTrailer();
+        }
+    }
+    const view = new DataView(b.buffer, b.byteOffset, b.byteLength);
+    return { partitionTableOffset: view.getBigUint64(0, true), chainFlags: b[8] };
+}
+//# sourceMappingURL=trailer.js.map

package/dist/trailer.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"trailer.js","sourceRoot":"","sources":["../src/trailer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUvC,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;IAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAa;IAC5C,IAAI,CAAC,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;QAC5B,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAChE,OAAO,EAAE,oBAAoB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC;AACjF,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@kduma-oss/pcf",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "TypeScript implementation of the Partitioned Container Format (PCF) v1.0",
   "license": "MIT OR Apache-2.0",
   "author": "Krystian Duma",
@@ -21,7 +21,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kduma-OSS/Partitioned-Container-Format.git",
-    "directory": "implementations/ts"
+    "directory": "implementations/ts/pcf"
   },
   "bugs": {
     "url": "https://github.com/kduma-OSS/Partitioned-Container-Format/issues"

package/src/consts.ts CHANGED Viewed

@@ -48,3 +48,28 @@ export const NIL_UID: Uint8Array = new Uint8Array(UID_SIZE);
  * is a `u8`).
  */
 export const MAX_ENTRIES_PER_BLOCK = 255;
+/**
+ * Sentinel value of `partition_table_offset` (header offset 12) meaning the
+ * partition-table head is recorded in the file trailer at the end of the file
+ * rather than in the header (spec section 4, "File Trailer"). The all-ones u64
+ * can never be a real offset, so it is unambiguous.
+ */
+export const PT_OFFSET_TRAILER = 0xffff_ffff_ffff_ffffn;
+/** Fixed size of the optional file trailer, in bytes. */
+export const TRAILER_SIZE = 20;
+/**
+ * Trailer signature, 8 bytes: the file {@link MAGIC} reversed
+ * (`0x1A 0x0A 0x0D 'T' 'R' 'P' 'K' 0x89`). Placed as the final 8 bytes of the
+ * file so a reader can detect and validate the trailer at the end.
+ */
+export const TRAILER_MAGIC: Uint8Array = new Uint8Array([
+  0x1a, 0x0a, 0x0d, 0x54, 0x52, 0x50, 0x4b, 0x89,
+]);
+/** Chain-direction flag: forward chain, head = first block. */
+export const CHAIN_FORWARD = 0;
+/** Chain-direction flag: backward chain, head = last/newest block. */
+export const CHAIN_BACKWARD = 1;

package/src/container.ts CHANGED Viewed

@@ -28,11 +28,15 @@
  */
 import {
+  CHAIN_FORWARD,
   ENTRY_SIZE,
   HEADER_SIZE,
   MAX_ENTRIES_PER_BLOCK,
   NIL_UID,
+  PT_OFFSET_TRAILER,
   TABLE_HEADER_SIZE,
+  TRAILER_MAGIC,
+  TRAILER_SIZE,
   TYPE_RESERVED,
   VERSION_MAJOR,
   VERSION_MINOR,
@@ -58,6 +62,7 @@ import {
   tableHeaderToBytes,
   type TableBlockHeader,
 } from "./table.js";
+import { type Trailer, trailerFromBytes, trailerToBytes } from "./trailer.js";
 /** In-memory bookkeeping for one table block (not stored on disk). */
 interface BlockInfo {
@@ -107,6 +112,14 @@ export class Container {
   private dataEof: number;
   private defaultCapacity: number;
   private tableHashAlgo: HashAlgo;
+  /**
+   * Resolved absolute offset of the partition-table head: the header pointer
+   * for a classic file, or the offset from the file trailer when the header
+   * holds {@link PT_OFFSET_TRAILER}. 0 denotes an empty table.
+   */
+  private tableHeadOffset = HEADER_SIZE;
+  /** Chain-direction flags resolved at open time (see {@link Trailer}). */
+  private chainFlags = CHAIN_FORWARD;
   private constructor(
     storage: Storage,
@@ -170,15 +183,30 @@ export class Container {
     return new Container(storage, header, blocks, dataEof, cap, tableHashAlgo);
   }
-  /** Open an existing container, validating the header (spec C1, C2). */
+  /**
+   * Open an existing container, validating the header (spec C1, C2).
+   *
+   * When the header's `partitionTableOffset` is the {@link PT_OFFSET_TRAILER}
+   * sentinel, the partition-table head and chain direction are read from the
+   * file trailer (located by scanning backward from the end of the file). Chain
+   * traversal is identical in both directions (follow `nextTableOffset` until
+   * 0); the direction only conveys which end is newest, exposed via
+   * {@link Container.chainIsBackward}.
+   */
   static open(storage: Storage): Container {
     const hb = storage.readAt(0, HEADER_SIZE);
     const header = headerFromBytes(hb);
     const me = new Container(storage, header, [], 0, 16, HashAlgo.Sha256);
+    if (header.partitionTableOffset === PT_OFFSET_TRAILER) {
+      [me.tableHeadOffset, me.chainFlags] = Container.locateTrailer(storage);
+    } else {
+      me.tableHeadOffset = Number(header.partitionTableOffset);
+      me.chainFlags = CHAIN_FORWARD;
+    }
     const blocks: BlockInfo[] = [];
-    let off = Number(header.partitionTableOffset);
+    let off = me.tableHeadOffset;
     while (off !== 0) {
       const [h] = me.readBlock(off);
       blocks.push({
@@ -203,11 +231,75 @@ export class Container {
     return this.storage;
   }
-  /** The parsed file header. */
+  /**
+   * The parsed file header. In trailer mode its `partitionTableOffset` holds
+   * the {@link PT_OFFSET_TRAILER} sentinel; use {@link Container.tableHead} for
+   * the resolved head.
+   */
   header(): FileHeader {
     return this.fileHeader;
   }
+  /**
+   * The resolved absolute offset of the partition-table head (0 if empty). This
+   * is the value to follow regardless of header-pointer vs trailer mode.
+   */
+  tableHead(): number {
+    return this.tableHeadOffset;
+  }
+  /**
+   * Whether the chain is backward-linked (head = newest block,
+   * `nextTableOffset` points at the previous/older block). Classic
+   * header-pointer files are always forward.
+   */
+  chainIsBackward(): boolean {
+    return (this.chainFlags & 1) !== 0;
+  }
+  /**
+   * Locate the most recent valid file trailer by scanning backward from the end
+   * of the file for the last 20-byte window ending in {@link TRAILER_MAGIC}
+   * whose recorded head is empty (0) or references a parseable table block.
+   * Bytes after that trailer — an incomplete or aborted append — are ignored,
+   * which gives append-only writers crash recovery for free. In the clean case
+   * the trailer is the final {@link TRAILER_SIZE} bytes.
+   */
+  private static locateTrailer(storage: Storage): [number, number] {
+    let end = storage.size();
+    while (end >= TRAILER_SIZE) {
+      const start = end - TRAILER_SIZE;
+      const window = storage.readAt(start, TRAILER_SIZE);
+      let magicOk = true;
+      for (let i = 0; i < TRAILER_MAGIC.length; i++) {
+        if (window[12 + i] !== TRAILER_MAGIC[i]) {
+          magicOk = false;
+          break;
+        }
+      }
+      if (magicOk) {
+        const t = trailerFromBytes(window);
+        if (t.partitionTableOffset === 0n) {
+          return [0, t.chainFlags];
+        }
+        const head = Number(t.partitionTableOffset);
+        if (t.partitionTableOffset > 0n && head + TABLE_HEADER_SIZE <= start) {
+          try {
+            tableHeaderFromBytes(storage.readAt(head, TABLE_HEADER_SIZE));
+            return [head, t.chainFlags];
+          } catch (e) {
+            if (!(e instanceof PcfError)) {
+              throw e;
+            }
+            // Spurious magic in an aborted tail; keep scanning.
+          }
+        }
+      }
+      end -= 1;
+    }
+    throw PcfError.badTrailer();
+  }
   // ---- low-level I/O ------------------------------------------------------
   private readBlock(off: number): [TableBlockHeader, PartitionEntry[]] {
@@ -252,7 +344,7 @@ export class Container {
   /** All live partition entries, in chain order. */
   entries(): PartitionEntry[] {
     const out: PartitionEntry[] = [];
-    let off = Number(this.fileHeader.partitionTableOffset);
+    let off = this.tableHeadOffset;
     while (off !== 0) {
       const [h, entries] = this.readBlock(off);
       out.push(...entries);
@@ -283,7 +375,7 @@ export class Container {
   }
   private locate(uid: Uint8Array): [number, number, PartitionEntry] {
-    let off = Number(this.fileHeader.partitionTableOffset);
+    let off = this.tableHeadOffset;
     while (off !== 0) {
       const [h, entries] = this.readBlock(off);
       for (let i = 0; i < entries.length; i++) {
@@ -434,7 +526,7 @@ export class Container {
    * hash, and run the per-entry conformance checks (spec section 12).
    */
   verify(): void {
-    let off = Number(this.fileHeader.partitionTableOffset);
+    let off = this.tableHeadOffset;
     while (off !== 0) {
       const [h, entries] = this.readBlock(off);
       if (verifies(h.tableHashAlgo)) {
@@ -472,7 +564,7 @@ export class Container {
   compactedImage(): Uint8Array {
     // Gather live entries and their data, in chain order.
     const live: Array<{ entry: PartitionEntry; data: Uint8Array }> = [];
-    let off = Number(this.fileHeader.partitionTableOffset);
+    let off = this.tableHeadOffset;
     while (off !== 0) {
       const [h, entries] = this.readBlock(off);
       for (const e of entries) {
@@ -558,6 +650,31 @@ export class Container {
   compactInto(out: Storage): void {
     out.writeAt(0, this.compactedImage());
   }
+  // ---- trailer mode ------------------------------------------------------
+  /**
+   * Convert the file to trailer mode: append a fixed trailer at the end of the
+   * file recording the current partition-table head, then overwrite the
+   * header's `partitionTableOffset` with the {@link PT_OFFSET_TRAILER} sentinel
+   * so the head is located via that trailer. The chain built by this writer is
+   * forward-linked, so the trailer records {@link CHAIN_FORWARD}.
+   */
+  finalizeWithTrailer(): void {
+    const trailer: Trailer = {
+      partitionTableOffset: BigInt(this.tableHeadOffset),
+      chainFlags: CHAIN_FORWARD,
+    };
+    const pos = this.storage.size();
+    this.storage.writeAt(pos, trailerToBytes(trailer));
+    this.fileHeader = {
+      ...this.fileHeader,
+      partitionTableOffset: PT_OFFSET_TRAILER,
+    };
+    this.storage.writeAt(0, headerToBytes(this.fileHeader));
+    this.chainFlags = CHAIN_FORWARD;
+    this.dataEof = pos + TRAILER_SIZE;
+  }
 }
 function verifyDataHash(e: PartitionEntry, data: Uint8Array): boolean {

package/src/errors.ts CHANGED Viewed

@@ -30,6 +30,8 @@ export enum PcfErrorKind {
   NotFound = "NotFound",
   /** An attempt was made to add a partition whose UID already exists. */
   DuplicateUid = "DuplicateUid",
+  /** The header requested trailer-based location but no valid trailer exists. */
+  BadTrailer = "BadTrailer",
 }
 /** All ways a PCF operation can fail. */
@@ -121,4 +123,11 @@ export class PcfError extends Error {
   static duplicateUid(): PcfError {
     return new PcfError(PcfErrorKind.DuplicateUid, "duplicate UID");
   }
+  static badTrailer(): PcfError {
+    return new PcfError(
+      PcfErrorKind.BadTrailer,
+      "missing or invalid file trailer",
+    );
+  }
 }

package/src/index.ts CHANGED Viewed

@@ -63,6 +63,7 @@ export {
   tableHeaderFromBytes,
   computeTableHash,
 } from "./table.js";
+export { type Trailer, trailerToBytes, trailerFromBytes } from "./trailer.js";
 export { type Storage, MemoryStorage } from "./storage.js";
 export { NodeFileStorage } from "./node-storage.js";
 export { Container, type BlockView } from "./container.js";

package/src/trailer.ts ADDED Viewed

@@ -0,0 +1,49 @@
+/**
+ * The optional fixed 20-byte file trailer (spec section 4, "File Trailer").
+ *
+ * A trailer is present only when the file header's `partitionTableOffset` holds
+ * the {@link PT_OFFSET_TRAILER} sentinel. It occupies the final
+ * {@link TRAILER_SIZE} bytes of the file and records the real offset of the
+ * partition-table head together with the chain direction. Because every append
+ * places a fresh trailer at the new end of file, the file's last bytes always
+ * point at the newest table — enabling append-only writers with no in-place
+ * header rewrite.
+ */
+import { TRAILER_MAGIC, TRAILER_SIZE } from "./consts.js";
+import { PcfError } from "./errors.js";
+/** Parsed file trailer. */
+export interface Trailer {
+  /** Absolute offset of the partition-table head (0 = empty container). */
+  partitionTableOffset: bigint;
+  /** Chain-direction flags; bit 0 selects forward (0) or backward (1). */
+  chainFlags: number;
+}
+/** Serialise to the on-disk 20-byte layout (reserved bytes 9..12 are zero). */
+export function trailerToBytes(t: Trailer): Uint8Array {
+  const b = new Uint8Array(TRAILER_SIZE);
+  const view = new DataView(b.buffer);
+  view.setBigUint64(0, t.partitionTableOffset, true);
+  b[8] = t.chainFlags & 0xff;
+  b.set(TRAILER_MAGIC, 12);
+  return b;
+}
+/**
+ * Parse from the on-disk 20-byte layout, validating the trailer magic. Throws
+ * {@link PcfError} (BadTrailer) if the magic does not match.
+ */
+export function trailerFromBytes(b: Uint8Array): Trailer {
+  if (b.length < TRAILER_SIZE) {
+    throw PcfError.badTrailer();
+  }
+  for (let i = 0; i < TRAILER_MAGIC.length; i++) {
+    if (b[12 + i] !== TRAILER_MAGIC[i]) {
+      throw PcfError.badTrailer();
+    }
+  }
+  const view = new DataView(b.buffer, b.byteOffset, b.byteLength);
+  return { partitionTableOffset: view.getBigUint64(0, true), chainFlags: b[8]! };
+}