@labacacia/nps-sdk 1.0.0-alpha.2 → 1.0.0-alpha.3

package/CHANGELOG.cn.md

@@ -8,6 +8,23 @@
 
 ---
 
+## [1.0.0-alpha.3] —— 2026-04-25
+
+### Changed
+
+- 版本升级至 `1.0.0-alpha.3`，与 NPS `v1.0.0-alpha.3` 套件同步。本次 TypeScript SDK 无功能变更。
+- 264 tests, ≥98% 覆盖率仍全绿。
+
+### 套件级 alpha.3 要点（各语言 helper 在 alpha.4 跟进）
+
+- **NPS-RFC-0001 —— NCP 连接前导**（Accepted）。原生模式连接现以字面量 `b"NPS/1.0\n"`（8 字节）开头。.NET SDK 已落地参考实现；TypeScript helper 在 alpha.4 跟进。
+- **NPS-RFC-0003 —— Agent 身份保证等级**（Accepted）。NIP IdentFrame 与 NWM 新增三态 `assurance_level`（`anonymous`/`attested`/`verified`）。.NET 参考类型已落地；TypeScript 同步在 alpha.4。
+- **NPS-RFC-0004 —— NID 声誉日志（CT 风格）**（Accepted）。append-only Merkle 日志条目结构发布；.NET 参考签名器已落地（并以 `nps-ledger` daemon Phase 1 形态发布）。TypeScript helper 在 alpha.4 跟进。
+- **NPS-CR-0001 —— Anchor / Bridge 节点拆分。** 旧的 "Gateway Node" 角色更名为 **Anchor Node**；"NPS↔外部协议翻译" 单独成为 **Bridge Node** 类型。AnnounceFrame 新增 `node_kind` / `cluster_anchor` / `bridge_protocols`。源代码层面变更落在 `spec/` + .NET 参考实现。
+- **6 个 NPS 常驻 daemon。** NPS-Dev 新建 `daemons/` 目录，定义 `npsd` / `nps-runner` / `nps-gateway` / `nps-registry` / `nps-cloud-ca` / `nps-ledger`；其中 `npsd` 提供 L1 功能性参考实现，其余为 Phase 1 骨架。
+
+---
+
 ## [1.0.0-alpha.2] —— 2026-04-19
 
 ### Fixed
@@ -35,5 +52,6 @@
 
 作为 NPS 套件 `v1.0.0-alpha.1` 的一部分首次公开 alpha。
 
-[1.0.0-alpha.2]: https://github.com/LabAcacia/nps/releases/tag/v1.0.0-alpha.2
-[1.0.0-alpha.1]: https://github.com/LabAcacia/nps/releases/tag/v1.0.0-alpha.1
+[1.0.0-alpha.3]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.3
+[1.0.0-alpha.2]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.2
+[1.0.0-alpha.1]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.1

package/CHANGELOG.md

@@ -8,6 +8,23 @@ Until NPS reaches v1.0 stable, every repository in the suite is synchronized to
 
 ---
 
+## [1.0.0-alpha.3] — 2026-04-25
+
+### Changed
+
+- Version bump to `1.0.0-alpha.3` for suite-wide synchronization with the NPS `v1.0.0-alpha.3` release. No functional changes in the TypeScript SDK at this milestone.
+- 264 tests, ≥98% coverage still green.
+
+### Suite-wide highlights at alpha.3 (per-language helpers planned for alpha.4)
+
+- **NPS-RFC-0001 — NCP connection preamble** (Accepted). Native-mode connections now begin with the literal `b"NPS/1.0\n"` (8 bytes). Reference helper landed in the .NET SDK; TypeScript helper deferred to alpha.4.
+- **NPS-RFC-0003 — Agent identity assurance levels** (Accepted). NIP IdentFrame and NWM gain a tri-state `assurance_level` (`anonymous`/`attested`/`verified`). Reference types landed in .NET; TypeScript parity deferred to alpha.4.
+- **NPS-RFC-0004 — NID reputation log (CT-style)** (Accepted). Append-only Merkle log entry shape published; reference signer landed in .NET (and shipped as the `nps-ledger` daemon Phase 1). TypeScript helpers deferred to alpha.4.
+- **NPS-CR-0001 — Anchor / Bridge node split.** The legacy "Gateway Node" role is renamed to **Anchor Node**; the "translate NPS↔external protocol" role is now its own **Bridge Node** type. AnnounceFrame gained `node_kind` / `cluster_anchor` / `bridge_protocols`. Source-of-truth changes are in `spec/` + the .NET reference implementation.
+- **6 NPS resident daemons.** New `daemons/` tree in NPS-Dev defines `npsd` / `nps-runner` / `nps-gateway` / `nps-registry` / `nps-cloud-ca` / `nps-ledger`; `npsd` ships an L1-functional reference and the rest ship as Phase 1 skeletons.
+
+---
+
 ## [1.0.0-alpha.2] — 2026-04-19
 
 ### Fixed
@@ -35,5 +52,6 @@ Until NPS reaches v1.0 stable, every repository in the suite is synchronized to
 
 First public alpha as part of the NPS suite `v1.0.0-alpha.1` release.
 
-[1.0.0-alpha.2]: https://github.com/LabAcacia/nps/releases/tag/v1.0.0-alpha.2
-[1.0.0-alpha.1]: https://github.com/LabAcacia/nps/releases/tag/v1.0.0-alpha.1
+[1.0.0-alpha.3]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.3
+[1.0.0-alpha.2]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.2
+[1.0.0-alpha.1]: https://github.com/LabAcacia/NPS-Dev/releases/tag/v1.0.0-alpha.1

package/README.cn.md

@@ -7,7 +7,7 @@
 
 ## 状态
 
-**v1.0.0-alpha.2 — Phase 2** · 5 个协议 · 264 个测试 · 覆盖率 ≥ 98%
+**v1.0.0-alpha.3 — Phase 2** · 5 个协议 · 264 个测试 · 覆盖率 ≥ 98%
 
 | 协议 | 类 | 状态 |
 |------|----|------|

package/README.md

@@ -7,7 +7,7 @@ Part of the [LabAcacia](https://github.com/LabAcacia) / INNO LOTUS PTY LTD open-
 
 ## Status
 
-**v1.0.0-alpha.2 — Phase 2** · 5 protocols · 264 tests · ≥ 98% coverage
+**v1.0.0-alpha.3 — Phase 2** · 5 protocols · 264 tests · ≥ 98% coverage
 
 | Protocol | Class | Status |
 |----------|-------|--------|

package/dist/core/index.cjs

@@ -2,6 +2,9 @@
 
 var msgpack = require('@msgpack/msgpack');
 var crypto = require('crypto');
+var canonicalizeImport = require('canonicalize');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -22,33 +25,48 @@ function _interopNamespace(e) {
 }
 
 var msgpack__namespace = /*#__PURE__*/_interopNamespace(msgpack);
+var canonicalizeImport__default = /*#__PURE__*/_interopDefault(canonicalizeImport);
 
 // src/core/exceptions.ts
 var NpsError = class extends Error {
   constructor(message) {
     super(message);
-    this.name = new.target.name;
+    this.name = "NpsError";
   }
 };
 var NpsFrameError = class extends NpsError {
+  constructor(message) {
+    super(message);
+    this.name = "NpsFrameError";
+  }
 };
 var NpsCodecError = class extends NpsError {
+  constructor(message) {
+    super(message);
+    this.name = "NpsCodecError";
+  }
 };
 var NpsAnchorNotFoundError = class extends NpsError {
-  constructor(anchorId) {
-    super(`AnchorFrame not found in cache: ${anchorId}`);
+  anchorId;
+  constructor(anchorId, message) {
+    super(message ?? `Anchor not found: ${anchorId}`);
+    this.name = "NpsAnchorNotFoundError";
     this.anchorId = anchorId;
   }
-  anchorId;
 };
 var NpsAnchorPoisonError = class extends NpsError {
-  constructor(anchorId) {
-    super(
-      `Anchor poisoning detected: anchor_id ${anchorId} already exists with a different schema.`
-    );
+  anchorId;
+  constructor(anchorId, message) {
+    super(message ?? `Anchor poison detected: ${anchorId}`);
+    this.name = "NpsAnchorPoisonError";
     this.anchorId = anchorId;
   }
-  anchorId;
+};
+var NpsStreamError = class extends NpsError {
+  constructor(message) {
+    super(message);
+    this.name = "NpsStreamError";
+  }
 };
 
 // src/core/frames.ts
@@ -58,6 +76,7 @@ var FrameType = /* @__PURE__ */ ((FrameType3) => {
   FrameType3[FrameType3["STREAM"] = 3] = "STREAM";
   FrameType3[FrameType3["CAPS"] = 4] = "CAPS";
   FrameType3[FrameType3["ALIGN"] = 5] = "ALIGN";
+  FrameType3[FrameType3["HELLO"] = 6] = "HELLO";
   FrameType3[FrameType3["QUERY"] = 16] = "QUERY";
   FrameType3[FrameType3["ACTION"] = 17] = "ACTION";
   FrameType3[FrameType3["IDENT"] = 32] = "IDENT";
@@ -349,6 +368,64 @@ var AnchorFrameCache = class _AnchorFrameCache {
   }
 };
 
+// src/core/status-codes.ts
+var NpsStatusCodes = {
+  // Success
+  NPS_OK: "NPS-OK",
+  NPS_OK_ACCEPTED: "NPS-OK-ACCEPTED",
+  NPS_OK_NO_CONTENT: "NPS-OK-NO-CONTENT",
+  // Auth
+  NPS_AUTH_UNAUTHENTICATED: "NPS-AUTH-UNAUTHENTICATED",
+  NPS_AUTH_FORBIDDEN: "NPS-AUTH-FORBIDDEN",
+  // Client errors
+  NPS_CLIENT_BAD_FRAME: "NPS-CLIENT-BAD-FRAME",
+  NPS_CLIENT_BAD_PARAM: "NPS-CLIENT-BAD-PARAM",
+  NPS_CLIENT_NOT_FOUND: "NPS-CLIENT-NOT-FOUND",
+  NPS_CLIENT_CONFLICT: "NPS-CLIENT-CONFLICT",
+  NPS_CLIENT_GONE: "NPS-CLIENT-GONE",
+  NPS_CLIENT_UNPROCESSABLE: "NPS-CLIENT-UNPROCESSABLE",
+  // Server errors
+  NPS_SERVER_INTERNAL: "NPS-SERVER-INTERNAL",
+  NPS_SERVER_UNAVAILABLE: "NPS-SERVER-UNAVAILABLE",
+  NPS_SERVER_TIMEOUT: "NPS-SERVER-TIMEOUT",
+  NPS_SERVER_ENCODING_UNSUPPORTED: "NPS-SERVER-ENCODING-UNSUPPORTED",
+  // Stream
+  NPS_STREAM_SEQ_GAP: "NPS-STREAM-SEQ-GAP",
+  NPS_STREAM_NOT_FOUND: "NPS-STREAM-NOT-FOUND",
+  NPS_STREAM_LIMIT: "NPS-STREAM-LIMIT",
+  // Limit
+  NPS_LIMIT_RATE: "NPS-LIMIT-RATE",
+  NPS_LIMIT_BUDGET: "NPS-LIMIT-BUDGET",
+  NPS_LIMIT_PAYLOAD: "NPS-LIMIT-PAYLOAD",
+  NPS_LIMIT_EXCEEDED: "NPS-LIMIT-EXCEEDED",
+  // Protocol
+  NPS_PROTO_VERSION_INCOMPATIBLE: "NPS-PROTO-VERSION-INCOMPATIBLE"
+};
+var canonicalize = canonicalizeImport__default.default;
+function jcsStringify(obj) {
+  const result = canonicalize(obj);
+  if (result === void 0) {
+    throw new Error("canonicalize returned undefined for input");
+  }
+  return result;
+}
+function sortKeysStringify(obj) {
+  return JSON.stringify(sortKeys(obj));
+}
+function sortKeys(value) {
+  if (Array.isArray(value)) {
+    return value.map(sortKeys);
+  }
+  if (value !== null && typeof value === "object") {
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+      sorted[key] = sortKeys(value[key]);
+    }
+    return sorted;
+  }
+  return value;
+}
+
 exports.AnchorFrameCache = AnchorFrameCache;
 exports.DEFAULT_HEADER_SIZE = DEFAULT_HEADER_SIZE;
 exports.DEFAULT_MAX_PAYLOAD = DEFAULT_MAX_PAYLOAD;
@@ -365,7 +442,11 @@ exports.NpsCodecError = NpsCodecError;
 exports.NpsError = NpsError;
 exports.NpsFrameCodec = NpsFrameCodec;
 exports.NpsFrameError = NpsFrameError;
+exports.NpsStatusCodes = NpsStatusCodes;
+exports.NpsStreamError = NpsStreamError;
 exports.Tier1JsonCodec = Tier1JsonCodec;
 exports.Tier2MsgPackCodec = Tier2MsgPackCodec;
+exports.jcsStringify = jcsStringify;
+exports.sortKeysStringify = sortKeysStringify;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -1 +1 @@
-{"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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAIO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClC,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AAAA,EACzB;AACF;AAGO,IAAM,aAAA,GAAN,cAA4B,QAAA,CAAS;AAAC;AAGtC,IAAM,aAAA,GAAN,cAA4B,QAAA,CAAS;AAAC;AAGtC,IAAM,sBAAA,GAAN,cAAqC,QAAA,CAAS;AAAA,EACnD,YAA4B,QAAA,EAAkB;AAC5C,IAAA,KAAA,CAAM,CAAA,gCAAA,EAAmC,QAAQ,CAAA,CAAE,CAAA;AADzB,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAAA,EAE5B;AAAA,EAF4B,QAAA;AAG9B;AAMO,IAAM,oBAAA,GAAN,cAAmC,QAAA,CAAS;AAAA,EACjD,YAA4B,QAAA,EAAkB;AAC5C,IAAA,KAAA;AAAA,MACE,wCAAwC,QAAQ,CAAA,wCAAA;AAAA,KAClD;AAH0B,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAAA,EAI5B;AAAA,EAJ4B,QAAA;AAK9B;;;ACtBO,IAAK,SAAA,qBAAAA,UAAAA,KAAL;AAEL,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,YAAe,CAAA,CAAA,GAAf,QAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,UAAe,CAAA,CAAA,GAAf,MAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,YAAe,CAAA,CAAA,GAAf,QAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,UAAe,CAAA,CAAA,GAAf,MAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,WAAe,CAAA,CAAA,GAAf,OAAA;AAGA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,WAAe,EAAA,CAAA,GAAf,OAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,YAAe,EAAA,CAAA,GAAf,QAAA;AAGA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,WAAe,EAAA,CAAA,GAAf,OAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,WAAe,EAAA,CAAA,GAAf,OAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,YAAe,EAAA,CAAA,GAAf,QAAA;AAGA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,cAAe,EAAA,CAAA,GAAf,UAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,aAAe,EAAA,CAAA,GAAf,SAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,WAAe,EAAA,CAAA,GAAf,OAAA;AAGA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,UAAe,EAAA,CAAA,GAAf,MAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,cAAe,EAAA,CAAA,GAAf,UAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,UAAe,EAAA,CAAA,GAAf,MAAA;AACA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,kBAAe,EAAA,CAAA,GAAf,cAAA;AAGA,EAAAA,UAAAA,CAAAA,UAAAA,CAAA,WAAe,GAAA,CAAA,GAAf,OAAA;AA7BU,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA;AAuCL,IAAK,YAAA,qBAAAC,aAAAA,KAAL;AACL,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,UAAU,CAAA,CAAA,GAAV,MAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,aAAU,CAAA,CAAA,GAAV,SAAA;AAFU,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA;AAgBL,IAAM,UAAA,GAAa;AAAA,EACxB,IAAA,EAAe,CAAA;AAAA,EACf,UAAA,EAAe,CAAA;AAAA,EACf,aAAA,EAAe,CAAA;AAAA,EACf,KAAA,EAAe,CAAA;AAAA,EACf,SAAA,EAAe,CAAA;AAAA,EACf,GAAA,EAAe;AACjB;AAIO,IAAM,mBAAA,GAAuB;AAC7B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,mBAAA,GAAuB;AAC7B,IAAM,oBAAA,GAAuB;AAkB7B,IAAM,WAAA,GAAN,MAAM,YAAA,CAAY;AAAA,EACvB,WAAA,CACkB,SAAA,EACA,KAAA,EACA,aAAA,EAChB;AAHgB,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AACA,IAAA,IAAA,CAAA,aAAA,GAAA,aAAA;AAAA,EACf;AAAA,EAHe,SAAA;AAAA,EACA,KAAA;AAAA,EACA,aAAA;AAAA,EAGlB,IAAI,UAAA,GAAsB;AACxB,IAAA,OAAA,CAAQ,IAAA,CAAK,KAAA,GAAQ,UAAA,CAAW,GAAA,MAAS,CAAA;AAAA,EAC3C;AAAA,EAEA,IAAI,UAAA,GAAqB;AACvB,IAAA,OAAO,IAAA,CAAK,aAAa,oBAAA,GAAuB,mBAAA;AAAA,EAClD;AAAA,EAEA,IAAI,YAAA,GAA6B;AAC/B,IAAA,OAAQ,KAAK,KAAA,GAAQ,CAAA;AAAA,EACvB;AAAA,EAEA,IAAI,OAAA,GAAmB;AACrB,IAAA,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAA,MAAU,CAAA;AAAA,EACjC;AAAA,EAEA,IAAI,WAAA,GAAuB;AACzB,IAAA,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAA,MAAU,CAAA;AAAA,EACjC;AAAA;AAAA,EAIA,OAAO,MAAM,GAAA,EAA8B;AACzC,IAAA,IAAI,GAAA,CAAI,SAAS,CAAA,EAAG;AAClB,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,oEAAA,EAAuE,IAAI,MAAM,CAAA,CAAA;AAAA,OACnF;AAAA,IACF;AAEA,IAAA,MAAM,KAAA,GAAQ,IAAI,CAAC,CAAA;AACnB,IAAA,MAAM,GAAA,GAAA,CAAS,KAAA,GAAQ,UAAA,CAAW,GAAA,MAAS,CAAA;AAE3C,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,IAAI,GAAA,CAAI,SAAS,oBAAA,EAAsB;AACrC,QAAA,MAAM,IAAI,aAAA;AAAA,UACR,CAAA,iDAAA,EAAoD,oBAAoB,CAAA,YAAA,EAAe,GAAA,CAAI,MAAM,CAAA,CAAA;AAAA,SACnG;AAAA,MACF;AACA,MAAA,MAAMC,QAAO,IAAI,QAAA,CAAS,GAAA,CAAI,MAAA,EAAQ,IAAI,UAAU,CAAA;AACpD,MAAA,MAAMC,cAAAA,GAAgBD,KAAAA,CAAK,SAAA,CAAU,CAAA,EAAG,KAAK,CAAA;AAC7C,MAAA,OAAO,IAAI,YAAA,CAAY,GAAA,CAAI,CAAC,CAAA,EAAiB,OAAOC,cAAa,CAAA;AAAA,IACnE;AAEA,IAAA,IAAI,GAAA,CAAI,SAAS,mBAAA,EAAqB;AACpC,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,wCAAA,EAA2C,mBAAmB,CAAA,YAAA,EAAe,GAAA,CAAI,MAAM,CAAA,CAAA;AAAA,OACzF;AAAA,IACF;AACA,IAAA,MAAM,OAAO,IAAI,QAAA,CAAS,GAAA,CAAI,MAAA,EAAQ,IAAI,UAAU,CAAA;AACpD,IAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,KAAK,CAAA;AAC7C,IAAA,OAAO,IAAI,YAAA,CAAY,GAAA,CAAI,CAAC,CAAA,EAAiB,OAAO,aAAa,CAAA;AAAA,EACnE;AAAA;AAAA,EAIA,OAAA,GAAsB;AACpB,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA,MAAMC,IAAAA,GAAO,IAAI,UAAA,CAAW,oBAAoB,CAAA;AAChD,MAAA,MAAMF,KAAAA,GAAO,IAAI,QAAA,CAASE,IAAAA,CAAI,MAAM,CAAA;AACpC,MAAAF,KAAAA,CAAK,QAAA,CAAS,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA;AAC/B,MAAAA,KAAAA,CAAK,QAAA,CAAS,CAAA,EAAG,IAAA,CAAK,KAAK,CAAA;AAC3B,MAAAA,KAAAA,CAAK,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,KAAK,CAAA;AAC1B,MAAAA,KAAAA,CAAK,SAAA,CAAU,CAAA,EAAG,IAAA,CAAK,eAAe,KAAK,CAAA;AAC3C,MAAA,OAAOE,IAAAA;AAAA,IACT;AACA,IAAA,MAAM,GAAA,GAAO,IAAI,UAAA,CAAW,mBAAmB,CAAA;AAC/C,IAAA,MAAM,IAAA,GAAO,IAAI,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA;AACpC,IAAA,IAAA,CAAK,QAAA,CAAS,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA;AAC/B,IAAA,IAAA,CAAK,QAAA,CAAS,CAAA,EAAG,IAAA,CAAK,KAAK,CAAA;AAC3B,IAAA,IAAA,CAAK,SAAA,CAAU,CAAA,EAAG,IAAA,CAAK,aAAA,EAAe,KAAK,CAAA;AAC3C,IAAA,OAAO,GAAA;AAAA,EACT;AAAA,EAEA,QAAA,GAAmB;AACjB,IAAA,OAAO,CAAA,wBAAA,EAA2B,KAAK,SAAA,CAAU,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,UAAA,EAAa,KAAK,KAAA,CAAM,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAC,CAAA,gBAAA,EAAmB,IAAA,CAAK,aAAa,CAAA,CAAA,CAAA;AAAA,EAC1K;AACF;ACzJO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,OAAO,KAAA,EAA6B;AAClC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,QAAQ,CAAA;AAC1C,MAAA,OAAO,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAI,CAAA;AAAA,IACtC,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,gCAAA,EAAmC,KAAA,CAAM,SAAA,CAAU,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,EAAA,EAAK,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,OAClG;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAA,CAAO,SAAA,EAAsB,OAAA,EAAqB,QAAA,EAAmC;AACnF,IAAA,MAAM,GAAA,GAAM,QAAA,CAAS,OAAA,CAAQ,SAAS,CAAA;AACtC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,IAAI,WAAA,EAAY,CAAE,OAAO,OAAO,CAAA;AAC7C,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAC5B,MAAA,OAAO,GAAA,CAAI,SAAS,IAAI,CAAA;AAAA,IAC1B,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,gCAAA,EAAmC,SAAA,CAAU,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,EAAA,EAAK,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,OAC5F;AAAA,IACF;AAAA,EACF;AACF;AAIO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,OAAO,KAAA,EAA6B;AAClC,IAAA,IAAI;AACF,MAAA,OAAeC,kBAAA,CAAA,MAAA,CAAO,KAAA,CAAM,MAAA,EAAQ,CAAA;AAAA,IACtC,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,mCAAA,EAAsC,KAAA,CAAM,SAAA,CAAU,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,EAAA,EAAK,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,OACrG;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAA,CAAO,SAAA,EAAsB,OAAA,EAAqB,QAAA,EAAmC;AACnF,IAAA,MAAM,GAAA,GAAM,QAAA,CAAS,OAAA,CAAQ,SAAS,CAAA;AACtC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAeA,0BAAO,OAAO,CAAA;AACnC,MAAA,OAAO,GAAA,CAAI,SAAS,IAAI,CAAA;AAAA,IAC1B,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,mCAAA,EAAsC,SAAA,CAAU,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,EAAA,EAAK,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,OAC/F;AAAA,IACF;AAAA,EACF;AACF;AAIO,IAAM,gBAAN,MAAoB;AAAA,EACR,SAAA;AAAA,EACA,WAAA;AAAA,EACA,KAAA,GAAW,IAAI,cAAA,EAAe;AAAA,EAC9B,QAAA,GAAW,IAAI,iBAAA,EAAkB;AAAA,EAElD,WAAA,CAAY,QAAA,EAAyB,OAAA,GAAmC,EAAC,EAAG;AAC1E,IAAA,IAAA,CAAK,SAAA,GAAc,QAAA;AACnB,IAAA,IAAA,CAAK,WAAA,GAAc,QAAQ,UAAA,IAAc,mBAAA;AAAA,EAC3C;AAAA;AAAA,EAIA,MAAA,CAAO,KAAA,EAAiB,OAAA,GAA2C,EAAC,EAAe;AACjF,IAAA,MAAM,IAAA,GAAU,OAAA,CAAQ,YAAA,IAAgB,KAAA,CAAM,aAAA;AAC9C,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,YAAA,CAAa,IAAI,CAAA;AAExC,IAAA,IAAI,OAAA;AACJ,IAAA,IAAI;AACF,MAAA,OAAA,GAAU,SAAA,CAAU,OAAO,KAAK,CAAA;AAAA,IAClC,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,GAAA,YAAe,eAAe,MAAM,GAAA;AACxC,MAAA,MAAM,IAAI,cAAc,CAAA,oBAAA,EAAuB,KAAA,CAAM,UAAU,QAAA,CAAS,EAAE,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,IAChF;AAEA,IAAA,IAAI,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,WAAA,EAAa;AACrC,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,sBAAA,EAAyB,KAAA,CAAM,SAAA,CAAU,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,4BAAA,EACjE,OAAA,CAAQ,MAAM,CAAA,SAAA,EAAY,KAAK,WAAW,CAAA,6CAAA;AAAA,OACjD;AAAA,IACF;AAEA,IAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,GAAS,mBAAA;AAChC,IAAA,IAAI,KAAA,GAAW,IAAA,CAAK,WAAA,CAAY,KAAA,EAAO,IAAI,CAAA;AAC3C,IAAA,IAAI,MAAA,WAAiB,UAAA,CAAW,GAAA;AAEhC,IAAA,MAAM,SAAa,IAAI,WAAA,CAAY,MAAM,SAAA,EAAW,KAAA,EAAO,QAAQ,MAAM,CAAA;AACzE,IAAA,MAAM,WAAA,GAAc,OAAO,OAAA,EAAQ;AACnC,IAAA,MAAM,OAAa,IAAI,UAAA,CAAW,WAAA,CAAY,MAAA,GAAS,QAAQ,MAAM,CAAA;AACrE,IAAA,IAAA,CAAK,GAAA,CAAI,aAAa,CAAC,CAAA;AACvB,IAAA,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,WAAA,CAAY,MAAM,CAAA;AACpC,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAIA,OAAO,IAAA,EAA4B;AACjC,IAAA,MAAM,MAAA,GAAU,WAAA,CAAY,KAAA,CAAM,IAAI,CAAA;AACtC,IAAA,MAAM,OAAA,GAAU,KAAK,KAAA,CAAM,MAAA,CAAO,YAAY,MAAA,CAAO,UAAA,GAAa,OAAO,aAAa,CAAA;AACtF,IAAA,MAAM,KAAA,GAAU,IAAA,CAAK,YAAA,CAAa,MAAA,CAAO,YAAY,CAAA;AACrD,IAAA,OAAO,MAAM,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,EAAS,KAAK,SAAS,CAAA;AAAA,EAC/D;AAAA,EAEA,OAAO,WAAW,IAAA,EAA+B;AAC/C,IAAA,OAAO,WAAA,CAAY,MAAM,IAAI,CAAA;AAAA,EAC/B;AAAA;AAAA,EAIQ,WAAA,CAAY,OAAiB,IAAA,EAA4B;AAC/D,IAAA,IAAI,KAAA,GAAQ,IAAA,KAAA,CAAA,cAA6B,UAAA,CAAW,UAAA,GAAa,UAAA,CAAW,aAAA;AAE5E,IAAA,MAAM,gBAAgB,QAAA,IAAY,KAAA;AAClC,IAAA,MAAM,OAAA,GAAgB,CAAC,aAAA,IAAkB,KAAA,CAA8B,MAAA;AACvE,IAAA,IAAI,OAAA,WAAkB,UAAA,CAAW,KAAA;AAEjC,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEQ,aAAa,IAAA,EAAwD;AAC3E,IAAA,IAAI,IAAA,KAAA,CAAA,oBAAsC,IAAA,CAAK,KAAA;AAC/C,IAAA,IAAI,IAAA,KAAA,CAAA,uBAAsC,IAAA,CAAK,QAAA;AAC/C,IAAA,MAAM,IAAI,aAAA,CAAc,CAAA,6BAAA,EAAiC,IAAA,CAAgB,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,EAC3G;AACF;;;AClJO,IAAM,gBAAN,MAAoB;AAAA,EACR,IAAA,uBAAW,GAAA,EAA2B;AAAA,EAEvD,QAAA,CAAS,WAAsB,GAAA,EAAuB;AACpD,IAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,SAAA,EAAW,GAAG,CAAA;AAAA,EAC9B;AAAA,EAEA,QAAQ,SAAA,EAAkC;AACxC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,SAAS,CAAA;AACnC,IAAA,IAAI,QAAQ,MAAA,EAAW;AACrB,MAAA,MAAM,IAAI,aAAA;AAAA,QACR,CAAA,qCAAA,EAAwC,UAAU,QAAA,CAAS,EAAE,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AAAA,OACjF;AAAA,IACF;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AACF;AChBO,IAAM,gBAAA,GAAN,MAAM,iBAAA,CAAiB;AAAA,EACX,MAAA,uBAAa,GAAA,EAAuD;AAAA;AAAA,EAGrF,KAAA,GAAsB,MAAM,IAAA,CAAK,GAAA,EAAI;AAAA;AAAA,EAIrC,IAAI,KAAA,EAA4B;AAC9B,IAAA,MAAM,QAAA,GAAW,KAAA,CAAM,QAAA,CAAS,UAAA,CAAW,SAAS,CAAA,GAChD,KAAA,CAAM,QAAA,GACN,iBAAA,CAAiB,eAAA,CAAgB,KAAA,CAAM,MAAM,CAAA;AAEjD,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,QAAQ,CAAA;AACzC,IAAA,IAAI,aAAa,MAAA,IAAa,IAAA,CAAK,KAAA,EAAM,GAAI,SAAS,SAAA,EAAW;AAC/D,MAAA,IAAI,CAAC,kBAAiB,aAAA,CAAc,QAAA,CAAS,MAAM,MAAA,EAAQ,KAAA,CAAM,MAAM,CAAA,EAAG;AACxE,QAAA,MAAM,IAAI,qBAAqB,QAAQ,CAAA;AAAA,MACzC;AAAA,IAEF;AAEA,IAAA,MAAM,KAAA,GAAA,CAAW,KAAA,CAAM,GAAA,IAAO,IAAA,IAAQ,GAAA;AACtC,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,KAAA,EAAM,GAAI,KAAA;AACjC,IAAA,IAAA,CAAK,OAAO,GAAA,CAAI,QAAA,EAAU,EAAE,KAAA,EAAO,WAAW,CAAA;AAC9C,IAAA,OAAO,QAAA;AAAA,EACT;AAAA,EAEA,IAAI,QAAA,EAA2C;AAC7C,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,QAAQ,CAAA;AACtC,IAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,IAAA,IAAI,IAAA,CAAK,KAAA,EAAM,GAAI,KAAA,CAAM,SAAA,EAAW;AAClC,MAAA,IAAA,CAAK,MAAA,CAAO,OAAO,QAAQ,CAAA;AAC3B,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAO,KAAA,CAAM,KAAA;AAAA,EACf;AAAA,EAEA,YAAY,QAAA,EAA+B;AACzC,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,QAAQ,CAAA;AAC/B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,MAAM,IAAI,uBAAuB,QAAQ,CAAA;AAClE,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,WAAW,QAAA,EAAwB;AACjC,IAAA,IAAA,CAAK,MAAA,CAAO,OAAO,QAAQ,CAAA;AAAA,EAC7B;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,IAAA,CAAK,aAAA,EAAc;AACnB,IAAA,OAAO,KAAK,MAAA,CAAO,IAAA;AAAA,EACrB;AAAA;AAAA,EAIA,OAAO,gBAAgB,MAAA,EAA6B;AAClD,IAAA,MAAM,MAAA,GAAS,CAAC,GAAG,MAAA,CAAO,MAAM,CAAA,CAC7B,GAAA,CAAI,CAAC,CAAA,KAAM;AACV,MAAA,MAAM,MAA+B,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,IAAA,EAAM,EAAE,IAAA,EAAK;AAClE,MAAA,IAAI,EAAE,QAAA,KAAa,MAAA,EAAW,GAAA,CAAI,UAAU,IAAI,CAAA,CAAE,QAAA;AAClD,MAAA,IAAI,EAAE,QAAA,KAAa,MAAA,EAAW,GAAA,CAAI,UAAU,IAAI,CAAA,CAAE,QAAA;AAClD,MAAA,OAAO,GAAA;AAAA,IACT,CAAC,CAAA,CACA,IAAA,CAAK,CAAC,CAAA,EAAG,MAAM,MAAA,CAAO,CAAA,CAAE,MAAM,CAAC,EAAE,aAAA,CAAc,MAAA,CAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAEpE,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AACvC,IAAA,MAAM,MAAA,GAAYC,kBAAW,QAAQ,CAAA,CAAE,OAAO,SAAA,EAAW,MAAM,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA;AAC7E,IAAA,OAAO,UAAU,MAAM,CAAA,CAAA;AAAA,EACzB;AAAA;AAAA,EAIQ,aAAA,GAAsB;AAC5B,IAAA,MAAM,GAAA,GAAM,KAAK,KAAA,EAAM;AACvB,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,KAAK,CAAA,IAAK,KAAK,MAAA,EAAQ;AACpC,MAAA,IAAI,MAAM,KAAA,CAAM,SAAA,EAAW,IAAA,CAAK,MAAA,CAAO,OAAO,CAAC,CAAA;AAAA,IACjD;AAAA,EACF;AAAA,EAEA,OAAe,aAAA,CAAc,CAAA,EAAgB,CAAA,EAAyB;AACpE,IAAA,OAAO,kBAAiB,eAAA,CAAgB,CAAC,CAAA,KAAM,iBAAA,CAAiB,gBAAgB,CAAC,CAAA;AAAA,EACnF;AACF","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"]}
+{"version":3,"sources":["../../src/core/exceptions.ts","../../src/core/frames.ts","../../src/core/codec.ts","../../src/core/registry.ts","../../src/core/cache.ts","../../src/core/status-codes.ts","../../src/core/canonical-json.ts"],"names":["FrameType","EncodingTier","view","payloadLength","buf","msgpack","createHash","canonicalizeImport"],"mappings":"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","file":"index.cjs","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// NPS exception hierarchy — ported from nps_sdk/core/exceptions.py\n// NPS-1 §6\n\n/** Base class for all NPS SDK errors. */\nexport class NpsError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"NpsError\";\n  }\n}\n\n/** Frame parse or structural error. */\nexport class NpsFrameError extends NpsError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"NpsFrameError\";\n  }\n}\n\n/** Encode or decode error. */\nexport class NpsCodecError extends NpsError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"NpsCodecError\";\n  }\n}\n\n/** Anchor cache miss — requested anchor ID not found. */\nexport class NpsAnchorNotFoundError extends NpsError {\n  readonly anchorId: string;\n  constructor(anchorId: string, message?: string) {\n    super(message ?? `Anchor not found: ${anchorId}`);\n    this.name = \"NpsAnchorNotFoundError\";\n    this.anchorId = anchorId;\n  }\n}\n\n/** Anchor ID collision — same ID but different schema content. */\nexport class NpsAnchorPoisonError extends NpsError {\n  readonly anchorId: string;\n  constructor(anchorId: string, message?: string) {\n    super(message ?? `Anchor poison detected: ${anchorId}`);\n    this.name = \"NpsAnchorPoisonError\";\n    this.anchorId = anchorId;\n  }\n}\n\n/** Stream-level error (sequence gap, unknown stream ID, etc.). */\nexport class NpsStreamError extends NpsError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"NpsStreamError\";\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  HELLO        = 0x06,\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","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// NPS native status codes — per spec/status-codes.md\n\n/** NPS native status code constants. */\nexport const NpsStatusCodes = {\n  // Success\n  NPS_OK: \"NPS-OK\",\n  NPS_OK_ACCEPTED: \"NPS-OK-ACCEPTED\",\n  NPS_OK_NO_CONTENT: \"NPS-OK-NO-CONTENT\",\n\n  // Auth\n  NPS_AUTH_UNAUTHENTICATED: \"NPS-AUTH-UNAUTHENTICATED\",\n  NPS_AUTH_FORBIDDEN: \"NPS-AUTH-FORBIDDEN\",\n\n  // Client errors\n  NPS_CLIENT_BAD_FRAME: \"NPS-CLIENT-BAD-FRAME\",\n  NPS_CLIENT_BAD_PARAM: \"NPS-CLIENT-BAD-PARAM\",\n  NPS_CLIENT_NOT_FOUND: \"NPS-CLIENT-NOT-FOUND\",\n  NPS_CLIENT_CONFLICT: \"NPS-CLIENT-CONFLICT\",\n  NPS_CLIENT_GONE: \"NPS-CLIENT-GONE\",\n  NPS_CLIENT_UNPROCESSABLE: \"NPS-CLIENT-UNPROCESSABLE\",\n\n  // Server errors\n  NPS_SERVER_INTERNAL: \"NPS-SERVER-INTERNAL\",\n  NPS_SERVER_UNAVAILABLE: \"NPS-SERVER-UNAVAILABLE\",\n  NPS_SERVER_TIMEOUT: \"NPS-SERVER-TIMEOUT\",\n  NPS_SERVER_ENCODING_UNSUPPORTED: \"NPS-SERVER-ENCODING-UNSUPPORTED\",\n\n  // Stream\n  NPS_STREAM_SEQ_GAP: \"NPS-STREAM-SEQ-GAP\",\n  NPS_STREAM_NOT_FOUND: \"NPS-STREAM-NOT-FOUND\",\n  NPS_STREAM_LIMIT: \"NPS-STREAM-LIMIT\",\n\n  // Limit\n  NPS_LIMIT_RATE: \"NPS-LIMIT-RATE\",\n  NPS_LIMIT_BUDGET: \"NPS-LIMIT-BUDGET\",\n  NPS_LIMIT_PAYLOAD: \"NPS-LIMIT-PAYLOAD\",\n  NPS_LIMIT_EXCEEDED: \"NPS-LIMIT-EXCEEDED\",\n\n  // Protocol\n  NPS_PROTO_VERSION_INCOMPATIBLE: \"NPS-PROTO-VERSION-INCOMPATIBLE\",\n} as const;\n\nexport type NpsStatusCode = (typeof NpsStatusCodes)[keyof typeof NpsStatusCodes];\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD\n//\n// Canonical JSON helpers — two distinct serialisation paths used in NPS.\n//\n// AnchorFrame uses JCS (RFC 8785) for anchor_id hashing → jcsStringify.\n// NIP signing uses Python-compatible sorted-key JSON → sortKeysStringify.\n\nimport canonicalizeImport from \"canonicalize\";\n\n// `canonicalize` is a CJS module whose default export resolves to a namespace\n// under NodeNext. Cast once to the call signature its .d.ts promises.\nconst canonicalize = canonicalizeImport as unknown as (\n  input: unknown,\n) => string | undefined;\n\n/**\n * JCS (RFC 8785) canonical JSON stringify.\n * Used for AnchorFrame anchor_id computation.\n */\nexport function jcsStringify(obj: unknown): string {\n  const result = canonicalize(obj);\n  if (result === undefined) {\n    throw new Error(\"canonicalize returned undefined for input\");\n  }\n  return result;\n}\n\n/**\n * Sorted-key JSON stringify — matches Python's\n * `json.dumps(obj, sort_keys=True, separators=(\",\",\":\"))`.\n * Used for NIP signing.\n */\nexport function sortKeysStringify(obj: unknown): string {\n  return JSON.stringify(sortKeys(obj));\n}\n\nfunction sortKeys(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(sortKeys);\n  }\n  if (value !== null && typeof value === \"object\") {\n    const sorted: Record<string, unknown> = {};\n    for (const key of Object.keys(value as object).sort()) {\n      sorted[key] = sortKeys((value as Record<string, unknown>)[key]);\n    }\n    return sorted;\n  }\n  return value;\n}\n"]}