@labacacia/nps-sdk 1.0.0-alpha.1 → 1.0.0-alpha.13

package/dist/core/index.cjs

@@ -1,371 +0,0 @@
-'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

package/dist/core/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/exceptions.ts","../../src/core/frames.ts","../../src/core/codec.ts","../../src/core/registry.ts","../../src/core/cache.ts"],"names":["FrameType","EncodingTier","view","payloadLength","buf","msgpack","createHash"],"mappings":"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","file":"index.cjs","sourcesContent":["// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/** Base class for all NPS errors. */\nexport class NpsError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = new.target.name;\n  }\n}\n\n/** Raised when a wire buffer cannot be parsed as a valid NPS frame. */\nexport class NpsFrameError extends NpsError {}\n\n/** Raised when frame serialisation or deserialisation fails. */\nexport class NpsCodecError extends NpsError {}\n\n/** Raised when an anchor_id is not found in the cache. */\nexport class NpsAnchorNotFoundError extends NpsError {\n  constructor(public readonly anchorId: string) {\n    super(`AnchorFrame not found in cache: ${anchorId}`);\n  }\n}\n\n/**\n * Raised when the same anchor_id is stored with a different schema (NPS-1 §7.2).\n * This indicates a potential anchor-poisoning attack.\n */\nexport class NpsAnchorPoisonError extends NpsError {\n  constructor(public readonly anchorId: string) {\n    super(\n      `Anchor poisoning detected: anchor_id ${anchorId} already exists with a different schema.`,\n    );\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * NPS wire-level frame primitives: FrameType, FrameFlags, EncodingTier, FrameHeader.\n */\n\nimport { NpsFrameError } from \"./exceptions.js\";\n\n// ── FrameType ────────────────────────────────────────────────────────────────\n\n/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */\nexport enum FrameType {\n  // NCP  0x01–0x0F\n  ANCHOR       = 0x01,\n  DIFF         = 0x02,\n  STREAM       = 0x03,\n  CAPS         = 0x04,\n  ALIGN        = 0x05, // deprecated — use AlignStream (0x43)\n\n  // NWP  0x10–0x1F\n  QUERY        = 0x10,\n  ACTION       = 0x11,\n\n  // NIP  0x20–0x2F\n  IDENT        = 0x20,\n  TRUST        = 0x21,\n  REVOKE       = 0x22,\n\n  // NDP  0x30–0x3F\n  ANNOUNCE     = 0x30,\n  RESOLVE      = 0x31,\n  GRAPH        = 0x32,\n\n  // NOP  0x40–0x4F\n  TASK         = 0x40,\n  DELEGATE     = 0x41,\n  SYNC         = 0x42,\n  ALIGN_STREAM = 0x43,\n\n  // Reserved / System  0xF0–0xFF\n  ERROR        = 0xFE,\n}\n\n// ── EncodingTier ─────────────────────────────────────────────────────────────\n\n/**\n * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).\n * 0x00 = Tier-1 JSON — human-readable; development / compatibility.\n * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.\n */\nexport enum EncodingTier {\n  JSON    = 0x00,\n  MSGPACK = 0x01,\n}\n\n// ── FrameFlags ───────────────────────────────────────────────────────────────\n\n/**\n * Flags byte in the NPS frame header (NPS-1 §3.2).\n * Bit layout (LSB = bit 0):\n *   Bits 0–1 (T0,T1) : Encoding tier\n *   Bit 2  (FINAL)   : Last chunk of a StreamFrame; non-stream frames MUST set this\n *   Bit 3  (ENC)     : Payload encrypted\n *   Bits 4–6 (RSV)   : Reserved — sender MUST write 0\n *   Bit 7  (EXT)     : Extended 8-byte header\n */\nexport const FrameFlags = {\n  NONE:          0x00,\n  TIER1_JSON:    0x00,\n  TIER2_MSGPACK: 0x01,\n  FINAL:         0x04,\n  ENCRYPTED:     0x08,\n  EXT:           0x80,\n} as const;\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_HEADER_SIZE  = 4;\nexport const EXTENDED_HEADER_SIZE = 8;\nexport const DEFAULT_MAX_PAYLOAD  = 0xffff;        // 65 535 bytes\nexport const EXTENDED_MAX_PAYLOAD = 0xffffffff;    // 4 GiB - 1\n\n// ── FrameHeader ──────────────────────────────────────────────────────────────\n\n/**\n * NPS frame header, present at the start of every wire message (NPS-1 §3.1).\n *\n * Default (4 bytes, EXT=0):\n *   Byte 0   : FrameType\n *   Byte 1   : Flags\n *   Byte 2–3 : PayloadLength (big-endian uint16)\n *\n * Extended (8 bytes, EXT=1):\n *   Byte 0   : FrameType\n *   Byte 1   : Flags (bit 7 = 1)\n *   Byte 2–3 : Reserved (must be 0)\n *   Byte 4–7 : PayloadLength (big-endian uint32)\n */\nexport class FrameHeader {\n  constructor(\n    public readonly frameType: FrameType,\n    public readonly flags: number,\n    public readonly payloadLength: number,\n  ) {}\n\n  get isExtended(): boolean {\n    return (this.flags & FrameFlags.EXT) !== 0;\n  }\n\n  get headerSize(): number {\n    return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;\n  }\n\n  get encodingTier(): EncodingTier {\n    return (this.flags & 0x03) as EncodingTier;\n  }\n\n  get isFinal(): boolean {\n    return (this.flags & 0x04) !== 0;\n  }\n\n  get isEncrypted(): boolean {\n    return (this.flags & 0x08) !== 0;\n  }\n\n  // ── Parsing ───────────────────────────────────────────────────────────────\n\n  static parse(buf: Uint8Array): FrameHeader {\n    if (buf.length < 2) {\n      throw new NpsFrameError(\n        `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`,\n      );\n    }\n\n    const flags = buf[1]!;\n    const ext   = (flags & FrameFlags.EXT) !== 0;\n\n    if (ext) {\n      if (buf.length < EXTENDED_HEADER_SIZE) {\n        throw new NpsFrameError(\n          `Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`,\n        );\n      }\n      const view = new DataView(buf.buffer, buf.byteOffset);\n      const payloadLength = view.getUint32(4, false); // big-endian\n      return new FrameHeader(buf[0]! as FrameType, flags, payloadLength);\n    }\n\n    if (buf.length < DEFAULT_HEADER_SIZE) {\n      throw new NpsFrameError(\n        `Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`,\n      );\n    }\n    const view = new DataView(buf.buffer, buf.byteOffset);\n    const payloadLength = view.getUint16(2, false); // big-endian\n    return new FrameHeader(buf[0]! as FrameType, flags, payloadLength);\n  }\n\n  // ── Serialisation ─────────────────────────────────────────────────────────\n\n  toBytes(): Uint8Array {\n    if (this.isExtended) {\n      const buf  = new Uint8Array(EXTENDED_HEADER_SIZE);\n      const view = new DataView(buf.buffer);\n      view.setUint8(0, this.frameType);\n      view.setUint8(1, this.flags);\n      view.setUint16(2, 0, false);             // reserved\n      view.setUint32(4, this.payloadLength, false);\n      return buf;\n    }\n    const buf  = new Uint8Array(DEFAULT_HEADER_SIZE);\n    const view = new DataView(buf.buffer);\n    view.setUint8(0, this.frameType);\n    view.setUint8(1, this.flags);\n    view.setUint16(2, this.payloadLength, false);\n    return buf;\n  }\n\n  toString(): string {\n    return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, \"0\")}, flags=0x${this.flags.toString(16).padStart(2, \"0\")}, payloadLength=${this.payloadLength})`;\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * NPS frame codec: Tier-1 (JSON) and Tier-2 (MsgPack) encode/decode,\n * plus the top-level NpsFrameCodec dispatcher.\n */\n\nimport * as msgpack from \"@msgpack/msgpack\";\nimport { NpsCodecError } from \"./exceptions.js\";\nimport {\n  DEFAULT_MAX_PAYLOAD,\n  EncodingTier,\n  FrameFlags,\n  FrameHeader,\n  FrameType,\n} from \"./frames.js\";\nimport type { FrameRegistry } from \"./registry.js\";\n\n// ── NpsFrame interface ────────────────────────────────────────────────────────\n\nexport interface NpsFrame {\n  readonly frameType: FrameType;\n  readonly preferredTier: EncodingTier;\n  toDict(): Record<string, unknown>;\n}\n\n// ── Tier-1 JSON codec ─────────────────────────────────────────────────────────\n\nexport class Tier1JsonCodec {\n  encode(frame: NpsFrame): Uint8Array {\n    try {\n      const json = JSON.stringify(frame.toDict());\n      return new TextEncoder().encode(json);\n    } catch (err) {\n      throw new NpsCodecError(\n        `Tier-1 JSON encode failed for 0x${frame.frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n      );\n    }\n  }\n\n  decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame {\n    const cls = registry.resolve(frameType);\n    try {\n      const text = new TextDecoder().decode(payload);\n      const data = JSON.parse(text) as Record<string, unknown>;\n      return cls.fromDict(data);\n    } catch (err) {\n      throw new NpsCodecError(\n        `Tier-1 JSON decode failed for 0x${frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n      );\n    }\n  }\n}\n\n// ── Tier-2 MsgPack codec ──────────────────────────────────────────────────────\n\nexport class Tier2MsgPackCodec {\n  encode(frame: NpsFrame): Uint8Array {\n    try {\n      return msgpack.encode(frame.toDict());\n    } catch (err) {\n      throw new NpsCodecError(\n        `Tier-2 MsgPack encode failed for 0x${frame.frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n      );\n    }\n  }\n\n  decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame {\n    const cls = registry.resolve(frameType);\n    try {\n      const data = msgpack.decode(payload) as Record<string, unknown>;\n      return cls.fromDict(data);\n    } catch (err) {\n      throw new NpsCodecError(\n        `Tier-2 MsgPack decode failed for 0x${frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n      );\n    }\n  }\n}\n\n// ── NpsFrameCodec (dispatcher) ────────────────────────────────────────────────\n\nexport class NpsFrameCodec {\n  private readonly _registry: FrameRegistry;\n  private readonly _maxPayload: number;\n  private readonly _json    = new Tier1JsonCodec();\n  private readonly _msgpack = new Tier2MsgPackCodec();\n\n  constructor(registry: FrameRegistry, options: { maxPayload?: number } = {}) {\n    this._registry   = registry;\n    this._maxPayload = options.maxPayload ?? DEFAULT_MAX_PAYLOAD;\n  }\n\n  // ── Encode ────────────────────────────────────────────────────────────────\n\n  encode(frame: NpsFrame, options: { overrideTier?: EncodingTier } = {}): Uint8Array {\n    const tier    = options.overrideTier ?? frame.preferredTier;\n    const tierCodec = this._selectCodec(tier);\n\n    let payload: Uint8Array;\n    try {\n      payload = tierCodec.encode(frame);\n    } catch (err) {\n      if (err instanceof NpsCodecError) throw err;\n      throw new NpsCodecError(`Encode failed for 0x${frame.frameType.toString(16)}.`);\n    }\n\n    if (payload.length > this._maxPayload) {\n      throw new NpsCodecError(\n        `Encoded payload for 0x${frame.frameType.toString(16).padStart(2, \"0\")} exceeds max_frame_payload` +\n        ` (${payload.length} bytes > ${this._maxPayload}). Use StreamFrame (0x03) for large payloads.`,\n      );\n    }\n\n    const useExt = payload.length > DEFAULT_MAX_PAYLOAD;\n    let flags    = this._buildFlags(frame, tier);\n    if (useExt) flags |= FrameFlags.EXT;\n\n    const header     = new FrameHeader(frame.frameType, flags, payload.length);\n    const headerBytes = header.toBytes();\n    const wire       = new Uint8Array(headerBytes.length + payload.length);\n    wire.set(headerBytes, 0);\n    wire.set(payload, headerBytes.length);\n    return wire;\n  }\n\n  // ── Decode ────────────────────────────────────────────────────────────────\n\n  decode(wire: Uint8Array): NpsFrame {\n    const header  = FrameHeader.parse(wire);\n    const payload = wire.slice(header.headerSize, header.headerSize + header.payloadLength);\n    const codec   = this._selectCodec(header.encodingTier);\n    return codec.decode(header.frameType, payload, this._registry);\n  }\n\n  static peekHeader(wire: Uint8Array): FrameHeader {\n    return FrameHeader.parse(wire);\n  }\n\n  // ── Private ───────────────────────────────────────────────────────────────\n\n  private _buildFlags(frame: NpsFrame, tier: EncodingTier): number {\n    let flags = tier === EncodingTier.JSON ? FrameFlags.TIER1_JSON : FrameFlags.TIER2_MSGPACK;\n\n    const isStreamFrame = \"isLast\" in frame;\n    const isFinal       = !isStreamFrame || (frame as { isLast: boolean }).isLast;\n    if (isFinal) flags |= FrameFlags.FINAL;\n\n    return flags;\n  }\n\n  private _selectCodec(tier: EncodingTier): Tier1JsonCodec | Tier2MsgPackCodec {\n    if (tier === EncodingTier.JSON)    return this._json;\n    if (tier === EncodingTier.MSGPACK) return this._msgpack;\n    throw new NpsCodecError(`Unsupported encoding tier: 0x${(tier as number).toString(16).padStart(2, \"0\")}.`);\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport { NpsFrameError } from \"./exceptions.js\";\nimport { FrameType } from \"./frames.js\";\nimport type { NpsFrame } from \"./codec.js\";\n\nexport interface FrameClass {\n  fromDict(data: Record<string, unknown>): NpsFrame;\n}\n\nexport class FrameRegistry {\n  private readonly _map = new Map<FrameType, FrameClass>();\n\n  register(frameType: FrameType, cls: FrameClass): void {\n    this._map.set(frameType, cls);\n  }\n\n  resolve(frameType: FrameType): FrameClass {\n    const cls = this._map.get(frameType);\n    if (cls === undefined) {\n      throw new NpsFrameError(\n        `No frame class registered for type 0x${frameType.toString(16).padStart(2, \"0\")}.`,\n      );\n    }\n    return cls;\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * AnchorFrameCache — in-process cache for AnchorFrame instances (NPS-1 §4.1).\n */\n\nimport { createHash } from \"node:crypto\";\nimport { NpsAnchorNotFoundError, NpsAnchorPoisonError } from \"./exceptions.js\";\nimport type { AnchorFrame, FrameSchema } from \"../ncp/frames.js\";\n\nexport class AnchorFrameCache {\n  private readonly _store = new Map<string, { frame: AnchorFrame; expiresAt: number }>();\n\n  // Allow clock injection for testing\n  clock: () => number = () => Date.now();\n\n  // ── Public API ────────────────────────────────────────────────────────────\n\n  set(frame: AnchorFrame): string {\n    const anchorId = frame.anchorId.startsWith(\"sha256:\")\n      ? frame.anchorId\n      : AnchorFrameCache.computeAnchorId(frame.schema);\n\n    const existing = this._store.get(anchorId);\n    if (existing !== undefined && this.clock() < existing.expiresAt) {\n      if (!AnchorFrameCache._schemasEqual(existing.frame.schema, frame.schema)) {\n        throw new NpsAnchorPoisonError(anchorId);\n      }\n      // Same schema — idempotent; refresh TTL below\n    }\n\n    const ttlMs   = (frame.ttl ?? 3600) * 1000;\n    const expiresAt = this.clock() + ttlMs;\n    this._store.set(anchorId, { frame, expiresAt });\n    return anchorId;\n  }\n\n  get(anchorId: string): AnchorFrame | undefined {\n    const entry = this._store.get(anchorId);\n    if (entry === undefined) return undefined;\n    if (this.clock() > entry.expiresAt) {\n      this._store.delete(anchorId);\n      return undefined;\n    }\n    return entry.frame;\n  }\n\n  getRequired(anchorId: string): AnchorFrame {\n    const frame = this.get(anchorId);\n    if (frame === undefined) throw new NpsAnchorNotFoundError(anchorId);\n    return frame;\n  }\n\n  invalidate(anchorId: string): void {\n    this._store.delete(anchorId);\n  }\n\n  get size(): number {\n    this._evictExpired();\n    return this._store.size;\n  }\n\n  // ── Static helpers ────────────────────────────────────────────────────────\n\n  static computeAnchorId(schema: FrameSchema): string {\n    const sorted = [...schema.fields]\n      .map((f) => {\n        const obj: Record<string, unknown> = { name: f.name, type: f.type };\n        if (f.semantic !== undefined) obj[\"semantic\"] = f.semantic;\n        if (f.nullable !== undefined) obj[\"nullable\"] = f.nullable;\n        return obj;\n      })\n      .sort((a, b) => String(a[\"name\"]).localeCompare(String(b[\"name\"])));\n\n    const canonical = JSON.stringify(sorted);\n    const digest    = createHash(\"sha256\").update(canonical, \"utf8\").digest(\"hex\");\n    return `sha256:${digest}`;\n  }\n\n  // ── Private ───────────────────────────────────────────────────────────────\n\n  private _evictExpired(): void {\n    const now = this.clock();\n    for (const [k, entry] of this._store) {\n      if (now > entry.expiresAt) this._store.delete(k);\n    }\n  }\n\n  private static _schemasEqual(a: FrameSchema, b: FrameSchema): boolean {\n    return AnchorFrameCache.computeAnchorId(a) === AnchorFrameCache.computeAnchorId(b);\n  }\n}\n"]}

package/dist/core/index.d.cts

@@ -1,41 +0,0 @@
-export { D as DEFAULT_HEADER_SIZE, a as DEFAULT_MAX_PAYLOAD, E as EXTENDED_HEADER_SIZE, b as EXTENDED_MAX_PAYLOAD, c as EncodingTier, d as FrameClass, e as FrameFlags, f as FrameHeader, F as FrameRegistry, g as FrameType, N as NpsFrame, h as NpsFrameCodec, T as Tier1JsonCodec, i as Tier2MsgPackCodec } from '../codec-CmHeovTV.cjs';
-import { A as AnchorFrame, F as FrameSchema } from '../frames-B3qLdl_g.cjs';
-
-/** Base class for all NPS errors. */
-declare class NpsError extends Error {
-    constructor(message: string);
-}
-/** Raised when a wire buffer cannot be parsed as a valid NPS frame. */
-declare class NpsFrameError extends NpsError {
-}
-/** Raised when frame serialisation or deserialisation fails. */
-declare class NpsCodecError extends NpsError {
-}
-/** Raised when an anchor_id is not found in the cache. */
-declare class NpsAnchorNotFoundError extends NpsError {
-    readonly anchorId: string;
-    constructor(anchorId: string);
-}
-/**
- * Raised when the same anchor_id is stored with a different schema (NPS-1 §7.2).
- * This indicates a potential anchor-poisoning attack.
- */
-declare class NpsAnchorPoisonError extends NpsError {
-    readonly anchorId: string;
-    constructor(anchorId: string);
-}
-
-declare class AnchorFrameCache {
-    private readonly _store;
-    clock: () => number;
-    set(frame: AnchorFrame): string;
-    get(anchorId: string): AnchorFrame | undefined;
-    getRequired(anchorId: string): AnchorFrame;
-    invalidate(anchorId: string): void;
-    get size(): number;
-    static computeAnchorId(schema: FrameSchema): string;
-    private _evictExpired;
-    private static _schemasEqual;
-}
-
-export { AnchorFrameCache, NpsAnchorNotFoundError, NpsAnchorPoisonError, NpsCodecError, NpsError, NpsFrameError };

package/dist/frames-B3qLdl_g.d.cts

@@ -1,77 +0,0 @@
-import { N as NpsFrame, g as FrameType, c as EncodingTier } from './codec-CmHeovTV.cjs';
-
-interface SchemaField {
-    name: string;
-    type: string;
-    semantic?: string;
-    nullable?: boolean;
-}
-interface FrameSchema {
-    fields: readonly SchemaField[];
-}
-declare class AnchorFrame implements NpsFrame {
-    readonly anchorId: string;
-    readonly schema: FrameSchema;
-    readonly ttl: number;
-    readonly frameType = FrameType.ANCHOR;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(anchorId: string, schema: FrameSchema, ttl?: number);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): AnchorFrame;
-}
-interface JsonPatchOperation {
-    op: string;
-    path: string;
-    value?: unknown;
-}
-declare class DiffFrame implements NpsFrame {
-    readonly anchorRef: string;
-    readonly baseSeq: number;
-    readonly patch: readonly JsonPatchOperation[];
-    readonly entityId?: string | undefined;
-    readonly frameType = FrameType.DIFF;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(anchorRef: string, baseSeq: number, patch: readonly JsonPatchOperation[], entityId?: string | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): DiffFrame;
-}
-declare class StreamFrame implements NpsFrame {
-    readonly streamId: string;
-    readonly seq: number;
-    readonly isLast: boolean;
-    readonly data: readonly Record<string, unknown>[];
-    readonly anchorRef?: string | undefined;
-    readonly windowSize?: number | undefined;
-    readonly frameType = FrameType.STREAM;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(streamId: string, seq: number, isLast: boolean, data: readonly Record<string, unknown>[], anchorRef?: string | undefined, windowSize?: number | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): StreamFrame;
-}
-declare class CapsFrame implements NpsFrame {
-    readonly anchorRef: string;
-    readonly count: number;
-    readonly data: readonly Record<string, unknown>[];
-    readonly nextCursor?: string | undefined;
-    readonly tokenEst?: number | undefined;
-    readonly cached?: boolean | undefined;
-    readonly tokenizerUsed?: string | undefined;
-    readonly frameType = FrameType.CAPS;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(anchorRef: string, count: number, data: readonly Record<string, unknown>[], nextCursor?: string | undefined, tokenEst?: number | undefined, cached?: boolean | undefined, tokenizerUsed?: string | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): CapsFrame;
-}
-declare class ErrorFrame implements NpsFrame {
-    readonly status: string;
-    readonly error: string;
-    readonly message?: string | undefined;
-    readonly details?: Record<string, unknown> | undefined;
-    readonly frameType = FrameType.ERROR;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(status: string, error: string, message?: string | undefined, details?: Record<string, unknown> | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): ErrorFrame;
-}
-
-export { AnchorFrame as A, CapsFrame as C, DiffFrame as D, ErrorFrame as E, type FrameSchema as F, type JsonPatchOperation as J, type SchemaField as S, StreamFrame as a };

package/dist/frames-Ff7-ZPUl.d.ts

@@ -1,77 +0,0 @@
-import { N as NpsFrame, g as FrameType, c as EncodingTier } from './codec-CmHeovTV.js';
-
-interface SchemaField {
-    name: string;
-    type: string;
-    semantic?: string;
-    nullable?: boolean;
-}
-interface FrameSchema {
-    fields: readonly SchemaField[];
-}
-declare class AnchorFrame implements NpsFrame {
-    readonly anchorId: string;
-    readonly schema: FrameSchema;
-    readonly ttl: number;
-    readonly frameType = FrameType.ANCHOR;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(anchorId: string, schema: FrameSchema, ttl?: number);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): AnchorFrame;
-}
-interface JsonPatchOperation {
-    op: string;
-    path: string;
-    value?: unknown;
-}
-declare class DiffFrame implements NpsFrame {
-    readonly anchorRef: string;
-    readonly baseSeq: number;
-    readonly patch: readonly JsonPatchOperation[];
-    readonly entityId?: string | undefined;
-    readonly frameType = FrameType.DIFF;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(anchorRef: string, baseSeq: number, patch: readonly JsonPatchOperation[], entityId?: string | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): DiffFrame;
-}
-declare class StreamFrame implements NpsFrame {
-    readonly streamId: string;
-    readonly seq: number;
-    readonly isLast: boolean;
-    readonly data: readonly Record<string, unknown>[];
-    readonly anchorRef?: string | undefined;
-    readonly windowSize?: number | undefined;
-    readonly frameType = FrameType.STREAM;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(streamId: string, seq: number, isLast: boolean, data: readonly Record<string, unknown>[], anchorRef?: string | undefined, windowSize?: number | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): StreamFrame;
-}
-declare class CapsFrame implements NpsFrame {
-    readonly anchorRef: string;
-    readonly count: number;
-    readonly data: readonly Record<string, unknown>[];
-    readonly nextCursor?: string | undefined;
-    readonly tokenEst?: number | undefined;
-    readonly cached?: boolean | undefined;
-    readonly tokenizerUsed?: string | undefined;
-    readonly frameType = FrameType.CAPS;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(anchorRef: string, count: number, data: readonly Record<string, unknown>[], nextCursor?: string | undefined, tokenEst?: number | undefined, cached?: boolean | undefined, tokenizerUsed?: string | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): CapsFrame;
-}
-declare class ErrorFrame implements NpsFrame {
-    readonly status: string;
-    readonly error: string;
-    readonly message?: string | undefined;
-    readonly details?: Record<string, unknown> | undefined;
-    readonly frameType = FrameType.ERROR;
-    readonly preferredTier = EncodingTier.MSGPACK;
-    constructor(status: string, error: string, message?: string | undefined, details?: Record<string, unknown> | undefined);
-    toDict(): Record<string, unknown>;
-    static fromDict(data: Record<string, unknown>): ErrorFrame;
-}
-
-export { AnchorFrame as A, CapsFrame as C, DiffFrame as D, ErrorFrame as E, type FrameSchema as F, type JsonPatchOperation as J, type SchemaField as S, StreamFrame as a };