@labacacia/nps-sdk 1.0.0-alpha.1

package/dist/core/frames.d.ts

@@ -0,0 +1,80 @@
+/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
+export declare enum FrameType {
+    ANCHOR = 1,
+    DIFF = 2,
+    STREAM = 3,
+    CAPS = 4,
+    ALIGN = 5,// deprecated — use AlignStream (0x43)
+    QUERY = 16,
+    ACTION = 17,
+    IDENT = 32,
+    TRUST = 33,
+    REVOKE = 34,
+    ANNOUNCE = 48,
+    RESOLVE = 49,
+    GRAPH = 50,
+    TASK = 64,
+    DELEGATE = 65,
+    SYNC = 66,
+    ALIGN_STREAM = 67,
+    ERROR = 254
+}
+/**
+ * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
+ * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
+ * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
+ */
+export declare enum EncodingTier {
+    JSON = 0,
+    MSGPACK = 1
+}
+/**
+ * Flags byte in the NPS frame header (NPS-1 §3.2).
+ * Bit layout (LSB = bit 0):
+ *   Bits 0–1 (T0,T1) : Encoding tier
+ *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this
+ *   Bit 3  (ENC)     : Payload encrypted
+ *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0
+ *   Bit 7  (EXT)     : Extended 8-byte header
+ */
+export declare const FrameFlags: {
+    readonly NONE: 0;
+    readonly TIER1_JSON: 0;
+    readonly TIER2_MSGPACK: 1;
+    readonly FINAL: 4;
+    readonly ENCRYPTED: 8;
+    readonly EXT: 128;
+};
+export declare const DEFAULT_HEADER_SIZE = 4;
+export declare const EXTENDED_HEADER_SIZE = 8;
+export declare const DEFAULT_MAX_PAYLOAD = 65535;
+export declare const EXTENDED_MAX_PAYLOAD = 4294967295;
+/**
+ * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
+ *
+ * Default (4 bytes, EXT=0):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags
+ *   Byte 2–3 : PayloadLength (big-endian uint16)
+ *
+ * Extended (8 bytes, EXT=1):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags (bit 7 = 1)
+ *   Byte 2–3 : Reserved (must be 0)
+ *   Byte 4–7 : PayloadLength (big-endian uint32)
+ */
+export declare class FrameHeader {
+    readonly frameType: FrameType;
+    readonly flags: number;
+    readonly payloadLength: number;
+    constructor(frameType: FrameType, flags: number, payloadLength: number);
+    get isExtended(): boolean;
+    get headerSize(): number;
+    get encodingTier(): EncodingTier;
+    get isFinal(): boolean;
+    get isEncrypted(): boolean;
+    static parse(buf: Uint8Array): FrameHeader;
+    toBytes(): Uint8Array;
+    toString(): string;
+}
+//# sourceMappingURL=frames.d.ts.map

package/dist/core/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/core/frames.ts"],"names":[],"mappings":"AAWA,sEAAsE;AACtE,oBAAY,SAAS;IAEnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,KAAK,IAAc,CAAE,sCAAsC;IAG3D,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,KAAK,KAAc;IACnB,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,QAAQ,KAAW;IACnB,OAAO,KAAY;IACnB,KAAK,KAAc;IAGnB,IAAI,KAAe;IACnB,QAAQ,KAAW;IACnB,IAAI,KAAe;IACnB,YAAY,KAAO;IAGnB,KAAK,MAAc;CACpB;AAID;;;;GAIG;AACH,oBAAY,YAAY;IACtB,IAAI,IAAU;IACd,OAAO,IAAO;CACf;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAIX,eAAO,MAAM,mBAAmB,IAAK,CAAC;AACtC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAC3C,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAI/C;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;aAEJ,SAAS,EAAE,SAAS;aACpB,KAAK,EAAE,MAAM;aACb,aAAa,EAAE,MAAM;gBAFrB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM;IAGvC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW;IAiC1C,OAAO,IAAI,UAAU;IAkBrB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/core/frames.js

@@ -0,0 +1,153 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * NPS wire-level frame primitives: FrameType, FrameFlags, EncodingTier, FrameHeader.
+ */
+import { NpsFrameError } from "./exceptions.js";
+// ── FrameType ────────────────────────────────────────────────────────────────
+/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
+export var FrameType;
+(function (FrameType) {
+    // NCP  0x01–0x0F
+    FrameType[FrameType["ANCHOR"] = 1] = "ANCHOR";
+    FrameType[FrameType["DIFF"] = 2] = "DIFF";
+    FrameType[FrameType["STREAM"] = 3] = "STREAM";
+    FrameType[FrameType["CAPS"] = 4] = "CAPS";
+    FrameType[FrameType["ALIGN"] = 5] = "ALIGN";
+    // NWP  0x10–0x1F
+    FrameType[FrameType["QUERY"] = 16] = "QUERY";
+    FrameType[FrameType["ACTION"] = 17] = "ACTION";
+    // NIP  0x20–0x2F
+    FrameType[FrameType["IDENT"] = 32] = "IDENT";
+    FrameType[FrameType["TRUST"] = 33] = "TRUST";
+    FrameType[FrameType["REVOKE"] = 34] = "REVOKE";
+    // NDP  0x30–0x3F
+    FrameType[FrameType["ANNOUNCE"] = 48] = "ANNOUNCE";
+    FrameType[FrameType["RESOLVE"] = 49] = "RESOLVE";
+    FrameType[FrameType["GRAPH"] = 50] = "GRAPH";
+    // NOP  0x40–0x4F
+    FrameType[FrameType["TASK"] = 64] = "TASK";
+    FrameType[FrameType["DELEGATE"] = 65] = "DELEGATE";
+    FrameType[FrameType["SYNC"] = 66] = "SYNC";
+    FrameType[FrameType["ALIGN_STREAM"] = 67] = "ALIGN_STREAM";
+    // Reserved / System  0xF0–0xFF
+    FrameType[FrameType["ERROR"] = 254] = "ERROR";
+})(FrameType || (FrameType = {}));
+// ── EncodingTier ─────────────────────────────────────────────────────────────
+/**
+ * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
+ * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
+ * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
+ */
+export var EncodingTier;
+(function (EncodingTier) {
+    EncodingTier[EncodingTier["JSON"] = 0] = "JSON";
+    EncodingTier[EncodingTier["MSGPACK"] = 1] = "MSGPACK";
+})(EncodingTier || (EncodingTier = {}));
+// ── FrameFlags ───────────────────────────────────────────────────────────────
+/**
+ * Flags byte in the NPS frame header (NPS-1 §3.2).
+ * Bit layout (LSB = bit 0):
+ *   Bits 0–1 (T0,T1) : Encoding tier
+ *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this
+ *   Bit 3  (ENC)     : Payload encrypted
+ *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0
+ *   Bit 7  (EXT)     : Extended 8-byte header
+ */
+export const FrameFlags = {
+    NONE: 0x00,
+    TIER1_JSON: 0x00,
+    TIER2_MSGPACK: 0x01,
+    FINAL: 0x04,
+    ENCRYPTED: 0x08,
+    EXT: 0x80,
+};
+// ── Constants ─────────────────────────────────────────────────────────────────
+export const DEFAULT_HEADER_SIZE = 4;
+export const EXTENDED_HEADER_SIZE = 8;
+export const DEFAULT_MAX_PAYLOAD = 0xffff; // 65 535 bytes
+export const EXTENDED_MAX_PAYLOAD = 0xffffffff; // 4 GiB - 1
+// ── FrameHeader ──────────────────────────────────────────────────────────────
+/**
+ * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
+ *
+ * Default (4 bytes, EXT=0):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags
+ *   Byte 2–3 : PayloadLength (big-endian uint16)
+ *
+ * Extended (8 bytes, EXT=1):
+ *   Byte 0   : FrameType
+ *   Byte 1   : Flags (bit 7 = 1)
+ *   Byte 2–3 : Reserved (must be 0)
+ *   Byte 4–7 : PayloadLength (big-endian uint32)
+ */
+export class FrameHeader {
+    frameType;
+    flags;
+    payloadLength;
+    constructor(frameType, flags, payloadLength) {
+        this.frameType = frameType;
+        this.flags = flags;
+        this.payloadLength = payloadLength;
+    }
+    get isExtended() {
+        return (this.flags & FrameFlags.EXT) !== 0;
+    }
+    get headerSize() {
+        return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
+    }
+    get encodingTier() {
+        return (this.flags & 0x03);
+    }
+    get isFinal() {
+        return (this.flags & 0x04) !== 0;
+    }
+    get isEncrypted() {
+        return (this.flags & 0x08) !== 0;
+    }
+    // ── Parsing ───────────────────────────────────────────────────────────────
+    static parse(buf) {
+        if (buf.length < 2) {
+            throw new NpsFrameError(`Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`);
+        }
+        const flags = buf[1];
+        const ext = (flags & FrameFlags.EXT) !== 0;
+        if (ext) {
+            if (buf.length < EXTENDED_HEADER_SIZE) {
+                throw new NpsFrameError(`Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`);
+            }
+            const view = new DataView(buf.buffer, buf.byteOffset);
+            const payloadLength = view.getUint32(4, false); // big-endian
+            return new FrameHeader(buf[0], flags, payloadLength);
+        }
+        if (buf.length < DEFAULT_HEADER_SIZE) {
+            throw new NpsFrameError(`Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`);
+        }
+        const view = new DataView(buf.buffer, buf.byteOffset);
+        const payloadLength = view.getUint16(2, false); // big-endian
+        return new FrameHeader(buf[0], flags, payloadLength);
+    }
+    // ── Serialisation ─────────────────────────────────────────────────────────
+    toBytes() {
+        if (this.isExtended) {
+            const buf = new Uint8Array(EXTENDED_HEADER_SIZE);
+            const view = new DataView(buf.buffer);
+            view.setUint8(0, this.frameType);
+            view.setUint8(1, this.flags);
+            view.setUint16(2, 0, false); // reserved
+            view.setUint32(4, this.payloadLength, false);
+            return buf;
+        }
+        const buf = new Uint8Array(DEFAULT_HEADER_SIZE);
+        const view = new DataView(buf.buffer);
+        view.setUint8(0, this.frameType);
+        view.setUint8(1, this.flags);
+        view.setUint16(2, this.payloadLength, false);
+        return buf;
+    }
+    toString() {
+        return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, "0")}, flags=0x${this.flags.toString(16).padStart(2, "0")}, payloadLength=${this.payloadLength})`;
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/core/frames.js.map

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

package/dist/core/index.cjs

@@ -0,0 +1,371 @@
+'use strict';
+
+var msgpack = require('@msgpack/msgpack');
+var crypto = require('crypto');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var msgpack__namespace = /*#__PURE__*/_interopNamespace(msgpack);
+
+// src/core/exceptions.ts
+var NpsError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = new.target.name;
+  }
+};
+var NpsFrameError = class extends NpsError {
+};
+var NpsCodecError = class extends NpsError {
+};
+var NpsAnchorNotFoundError = class extends NpsError {
+  constructor(anchorId) {
+    super(`AnchorFrame not found in cache: ${anchorId}`);
+    this.anchorId = anchorId;
+  }
+  anchorId;
+};
+var NpsAnchorPoisonError = class extends NpsError {
+  constructor(anchorId) {
+    super(
+      `Anchor poisoning detected: anchor_id ${anchorId} already exists with a different schema.`
+    );
+    this.anchorId = anchorId;
+  }
+  anchorId;
+};
+
+// src/core/frames.ts
+var FrameType = /* @__PURE__ */ ((FrameType3) => {
+  FrameType3[FrameType3["ANCHOR"] = 1] = "ANCHOR";
+  FrameType3[FrameType3["DIFF"] = 2] = "DIFF";
+  FrameType3[FrameType3["STREAM"] = 3] = "STREAM";
+  FrameType3[FrameType3["CAPS"] = 4] = "CAPS";
+  FrameType3[FrameType3["ALIGN"] = 5] = "ALIGN";
+  FrameType3[FrameType3["QUERY"] = 16] = "QUERY";
+  FrameType3[FrameType3["ACTION"] = 17] = "ACTION";
+  FrameType3[FrameType3["IDENT"] = 32] = "IDENT";
+  FrameType3[FrameType3["TRUST"] = 33] = "TRUST";
+  FrameType3[FrameType3["REVOKE"] = 34] = "REVOKE";
+  FrameType3[FrameType3["ANNOUNCE"] = 48] = "ANNOUNCE";
+  FrameType3[FrameType3["RESOLVE"] = 49] = "RESOLVE";
+  FrameType3[FrameType3["GRAPH"] = 50] = "GRAPH";
+  FrameType3[FrameType3["TASK"] = 64] = "TASK";
+  FrameType3[FrameType3["DELEGATE"] = 65] = "DELEGATE";
+  FrameType3[FrameType3["SYNC"] = 66] = "SYNC";
+  FrameType3[FrameType3["ALIGN_STREAM"] = 67] = "ALIGN_STREAM";
+  FrameType3[FrameType3["ERROR"] = 254] = "ERROR";
+  return FrameType3;
+})(FrameType || {});
+var EncodingTier = /* @__PURE__ */ ((EncodingTier2) => {
+  EncodingTier2[EncodingTier2["JSON"] = 0] = "JSON";
+  EncodingTier2[EncodingTier2["MSGPACK"] = 1] = "MSGPACK";
+  return EncodingTier2;
+})(EncodingTier || {});
+var FrameFlags = {
+  NONE: 0,
+  TIER1_JSON: 0,
+  TIER2_MSGPACK: 1,
+  FINAL: 4,
+  ENCRYPTED: 8,
+  EXT: 128
+};
+var DEFAULT_HEADER_SIZE = 4;
+var EXTENDED_HEADER_SIZE = 8;
+var DEFAULT_MAX_PAYLOAD = 65535;
+var EXTENDED_MAX_PAYLOAD = 4294967295;
+var FrameHeader = class _FrameHeader {
+  constructor(frameType, flags, payloadLength) {
+    this.frameType = frameType;
+    this.flags = flags;
+    this.payloadLength = payloadLength;
+  }
+  frameType;
+  flags;
+  payloadLength;
+  get isExtended() {
+    return (this.flags & FrameFlags.EXT) !== 0;
+  }
+  get headerSize() {
+    return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
+  }
+  get encodingTier() {
+    return this.flags & 3;
+  }
+  get isFinal() {
+    return (this.flags & 4) !== 0;
+  }
+  get isEncrypted() {
+    return (this.flags & 8) !== 0;
+  }
+  // ── Parsing ───────────────────────────────────────────────────────────────
+  static parse(buf) {
+    if (buf.length < 2) {
+      throw new NpsFrameError(
+        `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`
+      );
+    }
+    const flags = buf[1];
+    const ext = (flags & FrameFlags.EXT) !== 0;
+    if (ext) {
+      if (buf.length < EXTENDED_HEADER_SIZE) {
+        throw new NpsFrameError(
+          `Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`
+        );
+      }
+      const view2 = new DataView(buf.buffer, buf.byteOffset);
+      const payloadLength2 = view2.getUint32(4, false);
+      return new _FrameHeader(buf[0], flags, payloadLength2);
+    }
+    if (buf.length < DEFAULT_HEADER_SIZE) {
+      throw new NpsFrameError(
+        `Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`
+      );
+    }
+    const view = new DataView(buf.buffer, buf.byteOffset);
+    const payloadLength = view.getUint16(2, false);
+    return new _FrameHeader(buf[0], flags, payloadLength);
+  }
+  // ── Serialisation ─────────────────────────────────────────────────────────
+  toBytes() {
+    if (this.isExtended) {
+      const buf2 = new Uint8Array(EXTENDED_HEADER_SIZE);
+      const view2 = new DataView(buf2.buffer);
+      view2.setUint8(0, this.frameType);
+      view2.setUint8(1, this.flags);
+      view2.setUint16(2, 0, false);
+      view2.setUint32(4, this.payloadLength, false);
+      return buf2;
+    }
+    const buf = new Uint8Array(DEFAULT_HEADER_SIZE);
+    const view = new DataView(buf.buffer);
+    view.setUint8(0, this.frameType);
+    view.setUint8(1, this.flags);
+    view.setUint16(2, this.payloadLength, false);
+    return buf;
+  }
+  toString() {
+    return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, "0")}, flags=0x${this.flags.toString(16).padStart(2, "0")}, payloadLength=${this.payloadLength})`;
+  }
+};
+var Tier1JsonCodec = class {
+  encode(frame) {
+    try {
+      const json = JSON.stringify(frame.toDict());
+      return new TextEncoder().encode(json);
+    } catch (err) {
+      throw new NpsCodecError(
+        `Tier-1 JSON encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
+      );
+    }
+  }
+  decode(frameType, payload, registry) {
+    const cls = registry.resolve(frameType);
+    try {
+      const text = new TextDecoder().decode(payload);
+      const data = JSON.parse(text);
+      return cls.fromDict(data);
+    } catch (err) {
+      throw new NpsCodecError(
+        `Tier-1 JSON decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
+      );
+    }
+  }
+};
+var Tier2MsgPackCodec = class {
+  encode(frame) {
+    try {
+      return msgpack__namespace.encode(frame.toDict());
+    } catch (err) {
+      throw new NpsCodecError(
+        `Tier-2 MsgPack encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
+      );
+    }
+  }
+  decode(frameType, payload, registry) {
+    const cls = registry.resolve(frameType);
+    try {
+      const data = msgpack__namespace.decode(payload);
+      return cls.fromDict(data);
+    } catch (err) {
+      throw new NpsCodecError(
+        `Tier-2 MsgPack decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
+      );
+    }
+  }
+};
+var NpsFrameCodec = class {
+  _registry;
+  _maxPayload;
+  _json = new Tier1JsonCodec();
+  _msgpack = new Tier2MsgPackCodec();
+  constructor(registry, options = {}) {
+    this._registry = registry;
+    this._maxPayload = options.maxPayload ?? DEFAULT_MAX_PAYLOAD;
+  }
+  // ── Encode ────────────────────────────────────────────────────────────────
+  encode(frame, options = {}) {
+    const tier = options.overrideTier ?? frame.preferredTier;
+    const tierCodec = this._selectCodec(tier);
+    let payload;
+    try {
+      payload = tierCodec.encode(frame);
+    } catch (err) {
+      if (err instanceof NpsCodecError) throw err;
+      throw new NpsCodecError(`Encode failed for 0x${frame.frameType.toString(16)}.`);
+    }
+    if (payload.length > this._maxPayload) {
+      throw new NpsCodecError(
+        `Encoded payload for 0x${frame.frameType.toString(16).padStart(2, "0")} exceeds max_frame_payload (${payload.length} bytes > ${this._maxPayload}). Use StreamFrame (0x03) for large payloads.`
+      );
+    }
+    const useExt = payload.length > DEFAULT_MAX_PAYLOAD;
+    let flags = this._buildFlags(frame, tier);
+    if (useExt) flags |= FrameFlags.EXT;
+    const header = new FrameHeader(frame.frameType, flags, payload.length);
+    const headerBytes = header.toBytes();
+    const wire = new Uint8Array(headerBytes.length + payload.length);
+    wire.set(headerBytes, 0);
+    wire.set(payload, headerBytes.length);
+    return wire;
+  }
+  // ── Decode ────────────────────────────────────────────────────────────────
+  decode(wire) {
+    const header = FrameHeader.parse(wire);
+    const payload = wire.slice(header.headerSize, header.headerSize + header.payloadLength);
+    const codec = this._selectCodec(header.encodingTier);
+    return codec.decode(header.frameType, payload, this._registry);
+  }
+  static peekHeader(wire) {
+    return FrameHeader.parse(wire);
+  }
+  // ── Private ───────────────────────────────────────────────────────────────
+  _buildFlags(frame, tier) {
+    let flags = tier === 0 /* JSON */ ? FrameFlags.TIER1_JSON : FrameFlags.TIER2_MSGPACK;
+    const isStreamFrame = "isLast" in frame;
+    const isFinal = !isStreamFrame || frame.isLast;
+    if (isFinal) flags |= FrameFlags.FINAL;
+    return flags;
+  }
+  _selectCodec(tier) {
+    if (tier === 0 /* JSON */) return this._json;
+    if (tier === 1 /* MSGPACK */) return this._msgpack;
+    throw new NpsCodecError(`Unsupported encoding tier: 0x${tier.toString(16).padStart(2, "0")}.`);
+  }
+};
+
+// src/core/registry.ts
+var FrameRegistry = class {
+  _map = /* @__PURE__ */ new Map();
+  register(frameType, cls) {
+    this._map.set(frameType, cls);
+  }
+  resolve(frameType) {
+    const cls = this._map.get(frameType);
+    if (cls === void 0) {
+      throw new NpsFrameError(
+        `No frame class registered for type 0x${frameType.toString(16).padStart(2, "0")}.`
+      );
+    }
+    return cls;
+  }
+};
+var AnchorFrameCache = class _AnchorFrameCache {
+  _store = /* @__PURE__ */ new Map();
+  // Allow clock injection for testing
+  clock = () => Date.now();
+  // ── Public API ────────────────────────────────────────────────────────────
+  set(frame) {
+    const anchorId = frame.anchorId.startsWith("sha256:") ? frame.anchorId : _AnchorFrameCache.computeAnchorId(frame.schema);
+    const existing = this._store.get(anchorId);
+    if (existing !== void 0 && this.clock() < existing.expiresAt) {
+      if (!_AnchorFrameCache._schemasEqual(existing.frame.schema, frame.schema)) {
+        throw new NpsAnchorPoisonError(anchorId);
+      }
+    }
+    const ttlMs = (frame.ttl ?? 3600) * 1e3;
+    const expiresAt = this.clock() + ttlMs;
+    this._store.set(anchorId, { frame, expiresAt });
+    return anchorId;
+  }
+  get(anchorId) {
+    const entry = this._store.get(anchorId);
+    if (entry === void 0) return void 0;
+    if (this.clock() > entry.expiresAt) {
+      this._store.delete(anchorId);
+      return void 0;
+    }
+    return entry.frame;
+  }
+  getRequired(anchorId) {
+    const frame = this.get(anchorId);
+    if (frame === void 0) throw new NpsAnchorNotFoundError(anchorId);
+    return frame;
+  }
+  invalidate(anchorId) {
+    this._store.delete(anchorId);
+  }
+  get size() {
+    this._evictExpired();
+    return this._store.size;
+  }
+  // ── Static helpers ────────────────────────────────────────────────────────
+  static computeAnchorId(schema) {
+    const sorted = [...schema.fields].map((f) => {
+      const obj = { name: f.name, type: f.type };
+      if (f.semantic !== void 0) obj["semantic"] = f.semantic;
+      if (f.nullable !== void 0) obj["nullable"] = f.nullable;
+      return obj;
+    }).sort((a, b) => String(a["name"]).localeCompare(String(b["name"])));
+    const canonical = JSON.stringify(sorted);
+    const digest = crypto.createHash("sha256").update(canonical, "utf8").digest("hex");
+    return `sha256:${digest}`;
+  }
+  // ── Private ───────────────────────────────────────────────────────────────
+  _evictExpired() {
+    const now = this.clock();
+    for (const [k, entry] of this._store) {
+      if (now > entry.expiresAt) this._store.delete(k);
+    }
+  }
+  static _schemasEqual(a, b) {
+    return _AnchorFrameCache.computeAnchorId(a) === _AnchorFrameCache.computeAnchorId(b);
+  }
+};
+
+exports.AnchorFrameCache = AnchorFrameCache;
+exports.DEFAULT_HEADER_SIZE = DEFAULT_HEADER_SIZE;
+exports.DEFAULT_MAX_PAYLOAD = DEFAULT_MAX_PAYLOAD;
+exports.EXTENDED_HEADER_SIZE = EXTENDED_HEADER_SIZE;
+exports.EXTENDED_MAX_PAYLOAD = EXTENDED_MAX_PAYLOAD;
+exports.EncodingTier = EncodingTier;
+exports.FrameFlags = FrameFlags;
+exports.FrameHeader = FrameHeader;
+exports.FrameRegistry = FrameRegistry;
+exports.FrameType = FrameType;
+exports.NpsAnchorNotFoundError = NpsAnchorNotFoundError;
+exports.NpsAnchorPoisonError = NpsAnchorPoisonError;
+exports.NpsCodecError = NpsCodecError;
+exports.NpsError = NpsError;
+exports.NpsFrameCodec = NpsFrameCodec;
+exports.NpsFrameError = NpsFrameError;
+exports.Tier1JsonCodec = Tier1JsonCodec;
+exports.Tier2MsgPackCodec = Tier2MsgPackCodec;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map