@labacacia/nps-sdk 1.0.0-alpha.4 → 1.0.0-alpha.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (363) hide show
  1. package/CHANGELOG.cn.md +2 -73
  2. package/CHANGELOG.md +2 -82
  3. package/CONTRIBUTING.cn.md +0 -0
  4. package/CONTRIBUTING.md +0 -0
  5. package/LICENSE +0 -0
  6. package/NOTICE +0 -0
  7. package/README.cn.md +3 -3
  8. package/README.md +3 -3
  9. package/doc/nps-sdk.core.cn.md +0 -0
  10. package/doc/nps-sdk.core.md +0 -0
  11. package/doc/nps-sdk.ncp.cn.md +0 -0
  12. package/doc/nps-sdk.ncp.md +0 -0
  13. package/doc/nps-sdk.ndp.cn.md +0 -0
  14. package/doc/nps-sdk.ndp.md +0 -0
  15. package/doc/nps-sdk.nip.cn.md +30 -0
  16. package/doc/nps-sdk.nip.md +30 -0
  17. package/doc/nps-sdk.nop.cn.md +0 -0
  18. package/doc/nps-sdk.nop.md +0 -0
  19. package/doc/nps-sdk.nwp.cn.md +71 -0
  20. package/doc/nps-sdk.nwp.md +71 -0
  21. package/doc/overview.cn.md +0 -0
  22. package/doc/overview.md +0 -0
  23. package/nip-ca-server/Dockerfile +0 -0
  24. package/nip-ca-server/README.md +1 -1
  25. package/nip-ca-server/db/001_init.sql +0 -0
  26. package/nip-ca-server/docker-compose.yml +0 -0
  27. package/nip-ca-server/package.json +0 -0
  28. package/nip-ca-server/src/ca.ts +0 -0
  29. package/nip-ca-server/src/db.ts +0 -0
  30. package/nip-ca-server/src/index.ts +0 -0
  31. package/nip-ca-server/tsconfig.json +0 -0
  32. package/package.json +1 -1
  33. package/src/core/anchor-cache.ts +0 -0
  34. package/src/core/cache.ts +0 -0
  35. package/src/core/canonical-json.ts +0 -0
  36. package/src/core/codec.ts +0 -0
  37. package/src/core/codecs/index.ts +0 -0
  38. package/src/core/codecs/ncp-codec.ts +0 -0
  39. package/src/core/codecs/tier1-json-codec.ts +0 -0
  40. package/src/core/codecs/tier2-msgpack-codec.ts +0 -0
  41. package/src/core/crypto-provider.ts +0 -0
  42. package/src/core/exceptions.ts +0 -0
  43. package/src/core/frame-header.ts +0 -0
  44. package/src/core/frame-registry.ts +0 -0
  45. package/src/core/frames.ts +0 -0
  46. package/src/core/index.ts +0 -0
  47. package/src/core/registry.ts +0 -0
  48. package/src/core/status-codes.ts +1 -0
  49. package/src/ncp/frames/anchor-frame.ts +0 -0
  50. package/src/ncp/frames/caps-frame.ts +0 -0
  51. package/src/ncp/frames/diff-frame.ts +0 -0
  52. package/src/ncp/frames/error-frame.ts +0 -0
  53. package/src/ncp/frames/hello-frame.ts +0 -0
  54. package/src/ncp/frames/stream-frame.ts +0 -0
  55. package/src/ncp/frames.ts +0 -0
  56. package/src/ncp/handshake.ts +0 -0
  57. package/src/ncp/ncp-patch-format.ts +0 -0
  58. package/src/ncp/registry.ts +0 -0
  59. package/src/ncp/stream-manager.ts +0 -0
  60. package/src/ndp/dns-txt.ts +86 -0
  61. package/src/ndp/frames.ts +0 -0
  62. package/src/ndp/index.ts +1 -0
  63. package/src/ndp/ndp-registry.ts +34 -0
  64. package/src/ndp/registry.ts +0 -0
  65. package/src/ndp/validator.ts +0 -0
  66. package/src/nip/assurance-level.ts +6 -1
  67. package/src/nip/error-codes.ts +4 -2
  68. package/src/nip/identity.ts +0 -0
  69. package/src/nip/registry.ts +0 -0
  70. package/src/nip/x509/oids.ts +3 -4
  71. package/src/nop/client.ts +1 -1
  72. package/src/nop/frames.ts +0 -0
  73. package/src/nop/index.ts +0 -0
  74. package/src/nop/models.ts +0 -0
  75. package/src/nop/nop-types.ts +0 -0
  76. package/src/nop/registry.ts +0 -0
  77. package/src/nwp/client.ts +4 -4
  78. package/src/nwp/frames.ts +0 -0
  79. package/src/nwp/index.ts +0 -0
  80. package/src/nwp/registry.ts +0 -0
  81. package/src/setup.ts +0 -0
  82. package/tests/core/anchor-cache.test.ts +0 -0
  83. package/tests/core/codec.test.ts +0 -0
  84. package/tests/core/frame-registry.test.ts +0 -0
  85. package/tests/core.test.ts +0 -0
  86. package/tests/ncp/diff-binary-bitset.test.ts +0 -0
  87. package/tests/ncp/e2e-enc-reject.test.ts +0 -0
  88. package/tests/ncp/err-error-frame.test.ts +0 -0
  89. package/tests/ncp/frames.test.ts +0 -0
  90. package/tests/ncp/framing.test.ts +0 -0
  91. package/tests/ncp/hello-frame.test.ts +0 -0
  92. package/tests/ncp/inline-anchor.test.ts +0 -0
  93. package/tests/ncp/security.test.ts +0 -0
  94. package/tests/ncp/stream-window.test.ts +0 -0
  95. package/tests/ncp/stream.test.ts +0 -0
  96. package/tests/ncp/version-negotiation.test.ts +0 -0
  97. package/tests/ndp.test.ts +106 -0
  98. package/tests/nip.test.ts +0 -0
  99. package/tests/nop.test.ts +0 -0
  100. package/tests/nwp.test.ts +0 -0
  101. package/tsconfig.json +0 -0
  102. package/tsup.config.ts +0 -0
  103. package/vitest.config.ts +0 -0
  104. package/dist/core/anchor-cache.d.ts +0 -42
  105. package/dist/core/anchor-cache.d.ts.map +0 -1
  106. package/dist/core/anchor-cache.js +0 -104
  107. package/dist/core/anchor-cache.js.map +0 -1
  108. package/dist/core/cache.d.ts +0 -14
  109. package/dist/core/cache.d.ts.map +0 -1
  110. package/dist/core/cache.js +0 -80
  111. package/dist/core/cache.js.map +0 -1
  112. package/dist/core/canonical-json.d.ts +0 -12
  113. package/dist/core/canonical-json.d.ts.map +0 -1
  114. package/dist/core/canonical-json.js +0 -44
  115. package/dist/core/canonical-json.js.map +0 -1
  116. package/dist/core/codec.d.ts +0 -32
  117. package/dist/core/codec.d.ts.map +0 -1
  118. package/dist/core/codec.js +0 -119
  119. package/dist/core/codec.js.map +0 -1
  120. package/dist/core/codecs/index.d.ts +0 -4
  121. package/dist/core/codecs/index.d.ts.map +0 -1
  122. package/dist/core/codecs/index.js +0 -6
  123. package/dist/core/codecs/index.js.map +0 -1
  124. package/dist/core/codecs/ncp-codec.d.ts +0 -39
  125. package/dist/core/codecs/ncp-codec.d.ts.map +0 -1
  126. package/dist/core/codecs/ncp-codec.js +0 -93
  127. package/dist/core/codecs/ncp-codec.js.map +0 -1
  128. package/dist/core/codecs/tier1-json-codec.d.ts +0 -10
  129. package/dist/core/codecs/tier1-json-codec.d.ts.map +0 -1
  130. package/dist/core/codecs/tier1-json-codec.js +0 -28
  131. package/dist/core/codecs/tier1-json-codec.js.map +0 -1
  132. package/dist/core/codecs/tier2-msgpack-codec.d.ts +0 -10
  133. package/dist/core/codecs/tier2-msgpack-codec.d.ts.map +0 -1
  134. package/dist/core/codecs/tier2-msgpack-codec.js +0 -26
  135. package/dist/core/codecs/tier2-msgpack-codec.js.map +0 -1
  136. package/dist/core/crypto-provider.d.ts +0 -31
  137. package/dist/core/crypto-provider.d.ts.map +0 -1
  138. package/dist/core/crypto-provider.js +0 -10
  139. package/dist/core/crypto-provider.js.map +0 -1
  140. package/dist/core/exceptions.d.ts +0 -27
  141. package/dist/core/exceptions.d.ts.map +0 -1
  142. package/dist/core/exceptions.js +0 -52
  143. package/dist/core/exceptions.js.map +0 -1
  144. package/dist/core/frame-header.d.ts +0 -87
  145. package/dist/core/frame-header.d.ts.map +0 -1
  146. package/dist/core/frame-header.js +0 -185
  147. package/dist/core/frame-header.js.map +0 -1
  148. package/dist/core/frame-registry.d.ts +0 -35
  149. package/dist/core/frame-registry.d.ts.map +0 -1
  150. package/dist/core/frame-registry.js +0 -63
  151. package/dist/core/frame-registry.js.map +0 -1
  152. package/dist/core/frames.d.ts +0 -81
  153. package/dist/core/frames.d.ts.map +0 -1
  154. package/dist/core/frames.js +0 -154
  155. package/dist/core/frames.js.map +0 -1
  156. package/dist/core/index.d.ts +0 -11
  157. package/dist/core/index.d.ts.map +0 -1
  158. package/dist/core/index.js +0 -22
  159. package/dist/core/index.js.map +0 -1
  160. package/dist/core/registry.d.ts +0 -11
  161. package/dist/core/registry.d.ts.map +0 -1
  162. package/dist/core/registry.js +0 -17
  163. package/dist/core/registry.js.map +0 -1
  164. package/dist/core/status-codes.d.ts +0 -28
  165. package/dist/core/status-codes.d.ts.map +0 -1
  166. package/dist/core/status-codes.js +0 -38
  167. package/dist/core/status-codes.js.map +0 -1
  168. package/dist/index.d.ts +0 -2
  169. package/dist/index.d.ts.map +0 -1
  170. package/dist/index.js +0 -10
  171. package/dist/index.js.map +0 -1
  172. package/dist/ncp/frames/anchor-frame.d.ts +0 -29
  173. package/dist/ncp/frames/anchor-frame.d.ts.map +0 -1
  174. package/dist/ncp/frames/anchor-frame.js +0 -54
  175. package/dist/ncp/frames/anchor-frame.js.map +0 -1
  176. package/dist/ncp/frames/caps-frame.d.ts +0 -29
  177. package/dist/ncp/frames/caps-frame.d.ts.map +0 -1
  178. package/dist/ncp/frames/caps-frame.js +0 -29
  179. package/dist/ncp/frames/caps-frame.js.map +0 -1
  180. package/dist/ncp/frames/diff-frame.d.ts +0 -32
  181. package/dist/ncp/frames/diff-frame.d.ts.map +0 -1
  182. package/dist/ncp/frames/diff-frame.js +0 -37
  183. package/dist/ncp/frames/diff-frame.js.map +0 -1
  184. package/dist/ncp/frames/error-frame.d.ts +0 -16
  185. package/dist/ncp/frames/error-frame.d.ts.map +0 -1
  186. package/dist/ncp/frames/error-frame.js +0 -13
  187. package/dist/ncp/frames/error-frame.js.map +0 -1
  188. package/dist/ncp/frames/hello-frame.d.ts +0 -21
  189. package/dist/ncp/frames/hello-frame.d.ts.map +0 -1
  190. package/dist/ncp/frames/hello-frame.js +0 -25
  191. package/dist/ncp/frames/hello-frame.js.map +0 -1
  192. package/dist/ncp/frames/stream-frame.d.ts +0 -16
  193. package/dist/ncp/frames/stream-frame.d.ts.map +0 -1
  194. package/dist/ncp/frames/stream-frame.js +0 -18
  195. package/dist/ncp/frames/stream-frame.js.map +0 -1
  196. package/dist/ncp/frames.d.ts +0 -94
  197. package/dist/ncp/frames.d.ts.map +0 -1
  198. package/dist/ncp/frames.js +0 -192
  199. package/dist/ncp/frames.js.map +0 -1
  200. package/dist/ncp/handshake.d.ts +0 -30
  201. package/dist/ncp/handshake.d.ts.map +0 -1
  202. package/dist/ncp/handshake.js +0 -80
  203. package/dist/ncp/handshake.js.map +0 -1
  204. package/dist/ncp/index.d.ts +0 -12
  205. package/dist/ncp/index.d.ts.map +0 -1
  206. package/dist/ncp/index.js +0 -14
  207. package/dist/ncp/index.js.map +0 -1
  208. package/dist/ncp/ncp-error-codes.d.ts +0 -23
  209. package/dist/ncp/ncp-error-codes.d.ts.map +0 -1
  210. package/dist/ncp/ncp-error-codes.js +0 -34
  211. package/dist/ncp/ncp-error-codes.js.map +0 -1
  212. package/dist/ncp/ncp-patch-format.d.ts +0 -7
  213. package/dist/ncp/ncp-patch-format.d.ts.map +0 -1
  214. package/dist/ncp/ncp-patch-format.js +0 -13
  215. package/dist/ncp/ncp-patch-format.js.map +0 -1
  216. package/dist/ncp/preamble.d.ts +0 -47
  217. package/dist/ncp/preamble.d.ts.map +0 -1
  218. package/dist/ncp/preamble.js +0 -74
  219. package/dist/ncp/preamble.js.map +0 -1
  220. package/dist/ncp/registry.d.ts +0 -3
  221. package/dist/ncp/registry.d.ts.map +0 -1
  222. package/dist/ncp/registry.js +0 -13
  223. package/dist/ncp/registry.js.map +0 -1
  224. package/dist/ncp/stream-manager.d.ts +0 -57
  225. package/dist/ncp/stream-manager.d.ts.map +0 -1
  226. package/dist/ncp/stream-manager.js +0 -163
  227. package/dist/ncp/stream-manager.js.map +0 -1
  228. package/dist/ndp/frames.d.ts +0 -56
  229. package/dist/ndp/frames.d.ts.map +0 -1
  230. package/dist/ndp/frames.js +0 -87
  231. package/dist/ndp/frames.js.map +0 -1
  232. package/dist/ndp/index.d.ts +0 -5
  233. package/dist/ndp/index.d.ts.map +0 -1
  234. package/dist/ndp/index.js +0 -7
  235. package/dist/ndp/index.js.map +0 -1
  236. package/dist/ndp/ndp-registry.d.ts +0 -11
  237. package/dist/ndp/ndp-registry.d.ts.map +0 -1
  238. package/dist/ndp/ndp-registry.js +0 -79
  239. package/dist/ndp/ndp-registry.js.map +0 -1
  240. package/dist/ndp/registry.d.ts +0 -3
  241. package/dist/ndp/registry.d.ts.map +0 -1
  242. package/dist/ndp/registry.js +0 -10
  243. package/dist/ndp/registry.js.map +0 -1
  244. package/dist/ndp/validator.d.ts +0 -18
  245. package/dist/ndp/validator.d.ts.map +0 -1
  246. package/dist/ndp/validator.js +0 -48
  247. package/dist/ndp/validator.js.map +0 -1
  248. package/dist/nip/acme/client.d.ts +0 -31
  249. package/dist/nip/acme/client.d.ts.map +0 -1
  250. package/dist/nip/acme/client.js +0 -136
  251. package/dist/nip/acme/client.js.map +0 -1
  252. package/dist/nip/acme/index.d.ts +0 -6
  253. package/dist/nip/acme/index.d.ts.map +0 -1
  254. package/dist/nip/acme/index.js +0 -8
  255. package/dist/nip/acme/index.js.map +0 -1
  256. package/dist/nip/acme/jws.d.ts +0 -31
  257. package/dist/nip/acme/jws.d.ts.map +0 -1
  258. package/dist/nip/acme/jws.js +0 -76
  259. package/dist/nip/acme/jws.js.map +0 -1
  260. package/dist/nip/acme/messages.d.ts +0 -71
  261. package/dist/nip/acme/messages.d.ts.map +0 -1
  262. package/dist/nip/acme/messages.js +0 -4
  263. package/dist/nip/acme/messages.js.map +0 -1
  264. package/dist/nip/acme/server.d.ts +0 -41
  265. package/dist/nip/acme/server.d.ts.map +0 -1
  266. package/dist/nip/acme/server.js +0 -458
  267. package/dist/nip/acme/server.js.map +0 -1
  268. package/dist/nip/acme/wire.d.ts +0 -19
  269. package/dist/nip/acme/wire.d.ts.map +0 -1
  270. package/dist/nip/acme/wire.js +0 -21
  271. package/dist/nip/acme/wire.js.map +0 -1
  272. package/dist/nip/assurance-level.d.ts +0 -14
  273. package/dist/nip/assurance-level.d.ts.map +0 -1
  274. package/dist/nip/assurance-level.js +0 -33
  275. package/dist/nip/assurance-level.js.map +0 -1
  276. package/dist/nip/cert-format.d.ts +0 -5
  277. package/dist/nip/cert-format.d.ts.map +0 -1
  278. package/dist/nip/cert-format.js +0 -6
  279. package/dist/nip/cert-format.js.map +0 -1
  280. package/dist/nip/error-codes.d.ts +0 -23
  281. package/dist/nip/error-codes.d.ts.map +0 -1
  282. package/dist/nip/error-codes.js +0 -30
  283. package/dist/nip/error-codes.js.map +0 -1
  284. package/dist/nip/frames.d.ts +0 -53
  285. package/dist/nip/frames.d.ts.map +0 -1
  286. package/dist/nip/frames.js +0 -106
  287. package/dist/nip/frames.js.map +0 -1
  288. package/dist/nip/identity.d.ts +0 -18
  289. package/dist/nip/identity.d.ts.map +0 -1
  290. package/dist/nip/identity.js +0 -94
  291. package/dist/nip/identity.js.map +0 -1
  292. package/dist/nip/index.d.ts +0 -10
  293. package/dist/nip/index.d.ts.map +0 -1
  294. package/dist/nip/index.js +0 -13
  295. package/dist/nip/index.js.map +0 -1
  296. package/dist/nip/registry.d.ts +0 -3
  297. package/dist/nip/registry.d.ts.map +0 -1
  298. package/dist/nip/registry.js +0 -10
  299. package/dist/nip/registry.js.map +0 -1
  300. package/dist/nip/verifier.d.ts +0 -23
  301. package/dist/nip/verifier.d.ts.map +0 -1
  302. package/dist/nip/verifier.js +0 -90
  303. package/dist/nip/verifier.js.map +0 -1
  304. package/dist/nip/x509/builder.d.ts +0 -35
  305. package/dist/nip/x509/builder.d.ts.map +0 -1
  306. package/dist/nip/x509/builder.js +0 -59
  307. package/dist/nip/x509/builder.js.map +0 -1
  308. package/dist/nip/x509/index.d.ts +0 -4
  309. package/dist/nip/x509/index.d.ts.map +0 -1
  310. package/dist/nip/x509/index.js +0 -6
  311. package/dist/nip/x509/index.js.map +0 -1
  312. package/dist/nip/x509/oids.d.ts +0 -17
  313. package/dist/nip/x509/oids.d.ts.map +0 -1
  314. package/dist/nip/x509/oids.js +0 -23
  315. package/dist/nip/x509/oids.js.map +0 -1
  316. package/dist/nip/x509/verifier.d.ts +0 -26
  317. package/dist/nip/x509/verifier.d.ts.map +0 -1
  318. package/dist/nip/x509/verifier.js +0 -171
  319. package/dist/nip/x509/verifier.js.map +0 -1
  320. package/dist/nop/client.d.ts +0 -34
  321. package/dist/nop/client.d.ts.map +0 -1
  322. package/dist/nop/client.js +0 -90
  323. package/dist/nop/client.js.map +0 -1
  324. package/dist/nop/frames.d.ts +0 -65
  325. package/dist/nop/frames.d.ts.map +0 -1
  326. package/dist/nop/frames.js +0 -148
  327. package/dist/nop/frames.js.map +0 -1
  328. package/dist/nop/index.d.ts +0 -5
  329. package/dist/nop/index.d.ts.map +0 -1
  330. package/dist/nop/index.js +0 -7
  331. package/dist/nop/index.js.map +0 -1
  332. package/dist/nop/models.d.ts +0 -58
  333. package/dist/nop/models.d.ts.map +0 -1
  334. package/dist/nop/models.js +0 -50
  335. package/dist/nop/models.js.map +0 -1
  336. package/dist/nop/nop-types.d.ts +0 -136
  337. package/dist/nop/nop-types.d.ts.map +0 -1
  338. package/dist/nop/nop-types.js +0 -44
  339. package/dist/nop/nop-types.js.map +0 -1
  340. package/dist/nop/registry.d.ts +0 -3
  341. package/dist/nop/registry.d.ts.map +0 -1
  342. package/dist/nop/registry.js +0 -11
  343. package/dist/nop/registry.js.map +0 -1
  344. package/dist/nwp/client.d.ts +0 -22
  345. package/dist/nwp/client.d.ts.map +0 -1
  346. package/dist/nwp/client.js +0 -101
  347. package/dist/nwp/client.js.map +0 -1
  348. package/dist/nwp/frames.d.ts +0 -46
  349. package/dist/nwp/frames.d.ts.map +0 -1
  350. package/dist/nwp/frames.js +0 -81
  351. package/dist/nwp/frames.js.map +0 -1
  352. package/dist/nwp/index.d.ts +0 -4
  353. package/dist/nwp/index.d.ts.map +0 -1
  354. package/dist/nwp/index.js +0 -6
  355. package/dist/nwp/index.js.map +0 -1
  356. package/dist/nwp/registry.d.ts +0 -3
  357. package/dist/nwp/registry.d.ts.map +0 -1
  358. package/dist/nwp/registry.js +0 -9
  359. package/dist/nwp/registry.js.map +0 -1
  360. package/dist/setup.d.ts +0 -10
  361. package/dist/setup.d.ts.map +0 -1
  362. package/dist/setup.js +0 -29
  363. package/dist/setup.js.map +0 -1
@@ -1,27 +0,0 @@
1
- /** Base class for all NPS SDK errors. */
2
- export declare class NpsError extends Error {
3
- constructor(message: string);
4
- }
5
- /** Frame parse or structural error. */
6
- export declare class NpsFrameError extends NpsError {
7
- constructor(message: string);
8
- }
9
- /** Encode or decode error. */
10
- export declare class NpsCodecError extends NpsError {
11
- constructor(message: string);
12
- }
13
- /** Anchor cache miss — requested anchor ID not found. */
14
- export declare class NpsAnchorNotFoundError extends NpsError {
15
- readonly anchorId: string;
16
- constructor(anchorId: string, message?: string);
17
- }
18
- /** Anchor ID collision — same ID but different schema content. */
19
- export declare class NpsAnchorPoisonError extends NpsError {
20
- readonly anchorId: string;
21
- constructor(anchorId: string, message?: string);
22
- }
23
- /** Stream-level error (sequence gap, unknown stream ID, etc.). */
24
- export declare class NpsStreamError extends NpsError {
25
- constructor(message: string);
26
- }
27
- //# sourceMappingURL=exceptions.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../src/core/exceptions.ts"],"names":[],"mappings":"AAMA,yCAAyC;AACzC,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,uCAAuC;AACvC,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,8BAA8B;AAC9B,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,yDAAyD;AACzD,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK/C;AAED,kEAAkE;AAClE,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK/C;AAED,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM;CAI5B"}
@@ -1,52 +0,0 @@
1
- // SPDX-License-Identifier: Apache-2.0
2
- // Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
3
- //
4
- // NPS exception hierarchy — ported from nps_sdk/core/exceptions.py
5
- // NPS-1 §6
6
- /** Base class for all NPS SDK errors. */
7
- export class NpsError extends Error {
8
- constructor(message) {
9
- super(message);
10
- this.name = "NpsError";
11
- }
12
- }
13
- /** Frame parse or structural error. */
14
- export class NpsFrameError extends NpsError {
15
- constructor(message) {
16
- super(message);
17
- this.name = "NpsFrameError";
18
- }
19
- }
20
- /** Encode or decode error. */
21
- export class NpsCodecError extends NpsError {
22
- constructor(message) {
23
- super(message);
24
- this.name = "NpsCodecError";
25
- }
26
- }
27
- /** Anchor cache miss — requested anchor ID not found. */
28
- export class NpsAnchorNotFoundError extends NpsError {
29
- anchorId;
30
- constructor(anchorId, message) {
31
- super(message ?? `Anchor not found: ${anchorId}`);
32
- this.name = "NpsAnchorNotFoundError";
33
- this.anchorId = anchorId;
34
- }
35
- }
36
- /** Anchor ID collision — same ID but different schema content. */
37
- export class NpsAnchorPoisonError extends NpsError {
38
- anchorId;
39
- constructor(anchorId, message) {
40
- super(message ?? `Anchor poison detected: ${anchorId}`);
41
- this.name = "NpsAnchorPoisonError";
42
- this.anchorId = anchorId;
43
- }
44
- }
45
- /** Stream-level error (sequence gap, unknown stream ID, etc.). */
46
- export class NpsStreamError extends NpsError {
47
- constructor(message) {
48
- super(message);
49
- this.name = "NpsStreamError";
50
- }
51
- }
52
- //# sourceMappingURL=exceptions.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/core/exceptions.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,mEAAmE;AACnE,WAAW;AAEX,yCAAyC;AACzC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,uCAAuC;AACvC,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,8BAA8B;AAC9B,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IACzC,QAAQ,CAAS;IAC1B,YAAY,QAAgB,EAAE,OAAgB;QAC5C,KAAK,CAAC,OAAO,IAAI,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IACvC,QAAQ,CAAS;IAC1B,YAAY,QAAgB,EAAE,OAAgB;QAC5C,KAAK,CAAC,OAAO,IAAI,2BAA2B,QAAQ,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
@@ -1,87 +0,0 @@
1
- /** Wire encoding tier (NPS-1 §3.2, flags bits 0-1). */
2
- export declare enum EncodingTier {
3
- /** Tier-1: UTF-8 JSON — development & compatibility. */
4
- Json = 0,
5
- /** Tier-2: MessagePack binary — production (~60% compression). */
6
- MsgPack = 1
7
- }
8
- /** Unified frame type namespace for the full NPS suite (NPS-0 §9). */
9
- export declare enum FrameType {
10
- Anchor = 1,
11
- Diff = 2,
12
- Stream = 3,
13
- Caps = 4,
14
- Align = 5,// deprecated — use AlignStream (0x43)
15
- Hello = 6,
16
- Query = 16,
17
- Action = 17,
18
- Subscribe = 18,
19
- Ident = 32,
20
- Trust = 33,
21
- Revoke = 34,
22
- Announce = 48,
23
- Resolve = 49,
24
- Graph = 50,
25
- Task = 64,
26
- Delegate = 65,
27
- Sync = 66,
28
- AlignStream = 67,
29
- Error = 254
30
- }
31
- /** Default (compact) header size in bytes. */
32
- export declare const DEFAULT_HEADER_SIZE = 4;
33
- /** Extended header size in bytes (EXT=1). */
34
- export declare const EXTENDED_HEADER_SIZE = 8;
35
- /** Maximum payload in default mode (64 KiB − 1). */
36
- export declare const DEFAULT_MAX_PAYLOAD = 65535;
37
- /** Maximum payload in extended mode (4 GiB − 1). */
38
- export declare const EXTENDED_MAX_PAYLOAD = 4294967295;
39
- /** NCP protocol error with machine-readable error code. */
40
- export declare class NcpError extends Error {
41
- readonly code: string;
42
- constructor(code: string, message: string);
43
- }
44
- /** Parsed frame header. */
45
- export interface FrameHeader {
46
- /** Raw frame type byte. */
47
- frameType: number;
48
- /** Raw flags byte. */
49
- flags: number;
50
- /** Payload length in bytes. */
51
- payloadLength: number;
52
- /** Encoding tier extracted from flags bits 0-1. */
53
- tier: EncodingTier;
54
- /** True when FINAL flag (bit 2) is set. */
55
- isFinal: boolean;
56
- /** True when ENC flag (bit 3) is set. */
57
- isEncrypted: boolean;
58
- /** True when EXT flag (bit 7) is set — 8-byte header. */
59
- isExtended: boolean;
60
- /** Header size in bytes (4 or 8). */
61
- headerSize: number;
62
- }
63
- /**
64
- * Parse a frame header from the start of the buffer.
65
- * Reads 2 bytes first to determine EXT, then reads remaining bytes.
66
- *
67
- * @throws {NcpError} NCP-FRAME-FLAGS-INVALID if reserved bits 4-6 are non-zero.
68
- * @throws {NcpError} NCP-FRAME-PARSE-ERROR if buffer is too small.
69
- * @throws {NcpError} NCP-FRAME-PAYLOAD-TOO-LARGE if opts.max_frame_payload is set and exceeded.
70
- */
71
- export declare function parseFrameHeader(buffer: Uint8Array, opts?: {
72
- max_frame_payload?: number;
73
- }): FrameHeader;
74
- /**
75
- * Write a frame header into the buffer.
76
- * @returns Number of bytes written (4 or 8).
77
- * @throws {Error} if buffer is too small.
78
- */
79
- export declare function writeFrameHeader(header: FrameHeader, buffer: Uint8Array): number;
80
- /** Build a flags byte from individual options. */
81
- export declare function buildFlags(options: {
82
- tier?: EncodingTier;
83
- final?: boolean;
84
- encrypted?: boolean;
85
- extended?: boolean;
86
- }): number;
87
- //# sourceMappingURL=frame-header.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"frame-header.d.ts","sourceRoot":"","sources":["../../src/core/frame-header.ts"],"names":[],"mappings":"AAUA,uDAAuD;AACvD,oBAAY,YAAY;IACtB,wDAAwD;IACxD,IAAI,IAAO;IACX,kEAAkE;IAClE,OAAO,IAAO;CAGf;AAED,sEAAsE;AACtE,oBAAY,SAAS;IAEnB,MAAM,IAAO;IACb,IAAI,IAAO;IACX,MAAM,IAAO;IACb,IAAI,IAAO;IACX,KAAK,IAAO,CAAE,sCAAsC;IACpD,KAAK,IAAO;IAEZ,KAAK,KAAO;IACZ,MAAM,KAAO;IACb,SAAS,KAAO;IAEhB,KAAK,KAAO;IACZ,KAAK,KAAO;IACZ,MAAM,KAAO;IAEb,QAAQ,KAAO;IACf,OAAO,KAAO;IACd,KAAK,KAAO;IAEZ,IAAI,KAAO;IACX,QAAQ,KAAO;IACf,IAAI,KAAO;IACX,WAAW,KAAO;IAElB,KAAK,MAAO;CACb;AAMD,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAa/C,2DAA2D;AAC3D,qBAAa,QAAS,SAAQ,KAAK;aAKf,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAMD,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,IAAI,EAAE,YAAY,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,WAAW,CA6Fb;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,GACjB,MAAM,CA0BR;AAMD,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAMT"}
@@ -1,185 +0,0 @@
1
- // SPDX-License-Identifier: Apache-2.0
2
- // Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
3
- //
4
- // NCP Frame Header — Binary parse/write for NPS wire format
5
- // NPS-1 Neural Communication Protocol §3.1, §3.2
6
- // ---------------------------------------------------------------------------
7
- // Enums
8
- // ---------------------------------------------------------------------------
9
- /** Wire encoding tier (NPS-1 §3.2, flags bits 0-1). */
10
- export var EncodingTier;
11
- (function (EncodingTier) {
12
- /** Tier-1: UTF-8 JSON — development & compatibility. */
13
- EncodingTier[EncodingTier["Json"] = 0] = "Json";
14
- /** Tier-2: MessagePack binary — production (~60% compression). */
15
- EncodingTier[EncodingTier["MsgPack"] = 1] = "MsgPack";
16
- // 0x02 = Reserved
17
- // 0x03 = Reserved
18
- })(EncodingTier || (EncodingTier = {}));
19
- /** Unified frame type namespace for the full NPS suite (NPS-0 §9). */
20
- export var FrameType;
21
- (function (FrameType) {
22
- // NCP 0x01–0x0F
23
- FrameType[FrameType["Anchor"] = 1] = "Anchor";
24
- FrameType[FrameType["Diff"] = 2] = "Diff";
25
- FrameType[FrameType["Stream"] = 3] = "Stream";
26
- FrameType[FrameType["Caps"] = 4] = "Caps";
27
- FrameType[FrameType["Align"] = 5] = "Align";
28
- FrameType[FrameType["Hello"] = 6] = "Hello";
29
- // NWP 0x10–0x1F
30
- FrameType[FrameType["Query"] = 16] = "Query";
31
- FrameType[FrameType["Action"] = 17] = "Action";
32
- FrameType[FrameType["Subscribe"] = 18] = "Subscribe";
33
- // NIP 0x20–0x2F
34
- FrameType[FrameType["Ident"] = 32] = "Ident";
35
- FrameType[FrameType["Trust"] = 33] = "Trust";
36
- FrameType[FrameType["Revoke"] = 34] = "Revoke";
37
- // NDP 0x30–0x3F
38
- FrameType[FrameType["Announce"] = 48] = "Announce";
39
- FrameType[FrameType["Resolve"] = 49] = "Resolve";
40
- FrameType[FrameType["Graph"] = 50] = "Graph";
41
- // NOP 0x40–0x4F
42
- FrameType[FrameType["Task"] = 64] = "Task";
43
- FrameType[FrameType["Delegate"] = 65] = "Delegate";
44
- FrameType[FrameType["Sync"] = 66] = "Sync";
45
- FrameType[FrameType["AlignStream"] = 67] = "AlignStream";
46
- // System 0xF0–0xFF
47
- FrameType[FrameType["Error"] = 254] = "Error";
48
- })(FrameType || (FrameType = {}));
49
- // ---------------------------------------------------------------------------
50
- // Constants
51
- // ---------------------------------------------------------------------------
52
- /** Default (compact) header size in bytes. */
53
- export const DEFAULT_HEADER_SIZE = 4;
54
- /** Extended header size in bytes (EXT=1). */
55
- export const EXTENDED_HEADER_SIZE = 8;
56
- /** Maximum payload in default mode (64 KiB − 1). */
57
- export const DEFAULT_MAX_PAYLOAD = 0xffff;
58
- /** Maximum payload in extended mode (4 GiB − 1). */
59
- export const EXTENDED_MAX_PAYLOAD = 0xffffffff;
60
- // Flag bit positions (NPS-1 §3.2)
61
- const TIER_MASK = 0x03; // bits 0-1
62
- const FINAL_BIT = 0x04; // bit 2
63
- const ENC_BIT = 0x08; // bit 3
64
- const RESERVED_MASK = 0x70; // bits 4-6
65
- const EXT_BIT = 0x80; // bit 7
66
- // ---------------------------------------------------------------------------
67
- // Error
68
- // ---------------------------------------------------------------------------
69
- /** NCP protocol error with machine-readable error code. */
70
- export class NcpError extends Error {
71
- code;
72
- // `code` accepts NcpErrorCode constants (preferred) as well as NPS status
73
- // strings that are not NCP-prefixed (e.g. "NPS-CLIENT-CONFLICT") for cases
74
- // where the spec delegates to NPS-level codes without assigning an NCP code.
75
- constructor(code, message) {
76
- super(message);
77
- this.code = code;
78
- this.name = "NcpError";
79
- }
80
- }
81
- // ---------------------------------------------------------------------------
82
- // Parse
83
- // ---------------------------------------------------------------------------
84
- /**
85
- * Parse a frame header from the start of the buffer.
86
- * Reads 2 bytes first to determine EXT, then reads remaining bytes.
87
- *
88
- * @throws {NcpError} NCP-FRAME-FLAGS-INVALID if reserved bits 4-6 are non-zero.
89
- * @throws {NcpError} NCP-FRAME-PARSE-ERROR if buffer is too small.
90
- * @throws {NcpError} NCP-FRAME-PAYLOAD-TOO-LARGE if opts.max_frame_payload is set and exceeded.
91
- */
92
- export function parseFrameHeader(buffer, opts) {
93
- if (buffer.length < 2) {
94
- throw new NcpError("NCP-FRAME-PARSE-ERROR", `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buffer.length}`);
95
- }
96
- const frameType = buffer[0];
97
- const flags = buffer[1];
98
- // Validate reserved bits (NPS-1 §3.2: bits 4-6 MUST be 0)
99
- if ((flags & RESERVED_MASK) !== 0) {
100
- throw new NcpError("NCP-FRAME-FLAGS-INVALID", "Reserved flag bits 4-6 must be zero");
101
- }
102
- const isExtended = (flags & EXT_BIT) !== 0;
103
- if (isExtended) {
104
- if (buffer.length < EXTENDED_HEADER_SIZE) {
105
- throw new NcpError("NCP-FRAME-PARSE-ERROR", `Buffer too small for extended header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buffer.length}`);
106
- }
107
- const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
108
- const payloadLength = view.getUint32(2, false); // big-endian
109
- if (opts?.max_frame_payload !== undefined &&
110
- payloadLength > opts.max_frame_payload) {
111
- throw new NcpError("NCP-FRAME-PAYLOAD-TOO-LARGE", `Payload length ${payloadLength} exceeds max_frame_payload ${opts.max_frame_payload}`);
112
- }
113
- return {
114
- frameType,
115
- flags,
116
- payloadLength,
117
- tier: (flags & TIER_MASK),
118
- isFinal: (flags & FINAL_BIT) !== 0,
119
- isEncrypted: (flags & ENC_BIT) !== 0,
120
- isExtended: true,
121
- headerSize: EXTENDED_HEADER_SIZE,
122
- };
123
- }
124
- // Default 4-byte header
125
- if (buffer.length < DEFAULT_HEADER_SIZE) {
126
- throw new NcpError("NCP-FRAME-PARSE-ERROR", `Buffer too small for header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buffer.length}`);
127
- }
128
- const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
129
- const payloadLength = view.getUint16(2, false); // big-endian
130
- if (opts?.max_frame_payload !== undefined &&
131
- payloadLength > opts.max_frame_payload) {
132
- throw new NcpError("NCP-FRAME-PAYLOAD-TOO-LARGE", `Payload length ${payloadLength} exceeds max_frame_payload ${opts.max_frame_payload}`);
133
- }
134
- return {
135
- frameType,
136
- flags,
137
- payloadLength,
138
- tier: (flags & TIER_MASK),
139
- isFinal: (flags & FINAL_BIT) !== 0,
140
- isEncrypted: (flags & ENC_BIT) !== 0,
141
- isExtended: false,
142
- headerSize: DEFAULT_HEADER_SIZE,
143
- };
144
- }
145
- // ---------------------------------------------------------------------------
146
- // Write
147
- // ---------------------------------------------------------------------------
148
- /**
149
- * Write a frame header into the buffer.
150
- * @returns Number of bytes written (4 or 8).
151
- * @throws {Error} if buffer is too small.
152
- */
153
- export function writeFrameHeader(header, buffer) {
154
- const size = header.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
155
- if (buffer.length < size) {
156
- throw new Error(`Destination buffer must be at least ${size} bytes, got ${buffer.length}`);
157
- }
158
- buffer[0] = header.frameType;
159
- buffer[1] = header.flags;
160
- const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
161
- if (header.isExtended) {
162
- view.setUint32(2, header.payloadLength, false); // big-endian
163
- buffer[6] = 0; // reserved
164
- buffer[7] = 0; // reserved
165
- }
166
- else {
167
- view.setUint16(2, header.payloadLength, false); // big-endian
168
- }
169
- return size;
170
- }
171
- // ---------------------------------------------------------------------------
172
- // Helpers
173
- // ---------------------------------------------------------------------------
174
- /** Build a flags byte from individual options. */
175
- export function buildFlags(options) {
176
- let flags = (options.tier ?? EncodingTier.Json) & TIER_MASK;
177
- if (options.final)
178
- flags |= FINAL_BIT;
179
- if (options.encrypted)
180
- flags |= ENC_BIT;
181
- if (options.extended)
182
- flags |= EXT_BIT;
183
- return flags;
184
- }
185
- //# sourceMappingURL=frame-header.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"frame-header.js","sourceRoot":"","sources":["../../src/core/frame-header.ts"],"names":[],"mappings":"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"}
@@ -1,35 +0,0 @@
1
- export type Protocol = "ncp" | "nwp" | "nip" | "ndp" | "nop" | "system";
2
- export interface FrameRegistryEntry {
3
- /** Frame type byte. */
4
- frameType: number;
5
- /** Human-readable name. */
6
- name: string;
7
- /** Protocol this frame belongs to. */
8
- protocol: Protocol;
9
- }
10
- /**
11
- * Maps frame type bytes to metadata.
12
- * Built once at startup, then read-only.
13
- */
14
- export declare class FrameRegistry {
15
- private readonly map;
16
- constructor(entries: FrameRegistryEntry[]);
17
- /**
18
- * Resolve a frame type byte to its registry entry.
19
- * @throws {NcpError} NCP-FRAME-UNKNOWN-TYPE if not registered.
20
- */
21
- resolve(frameType: number): FrameRegistryEntry;
22
- /** Check if a frame type is registered. */
23
- has(frameType: number): boolean;
24
- /**
25
- * Create a registry pre-populated with all NCP core frames.
26
- * Upper-layer protocols can extend via the builder.
27
- */
28
- static createDefault(): FrameRegistry;
29
- }
30
- export declare class FrameRegistryBuilder {
31
- private readonly entries;
32
- add(frameType: number, name: string, protocol: Protocol): this;
33
- build(): FrameRegistry;
34
- }
35
- //# sourceMappingURL=frame-registry.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"frame-registry.d.ts","sourceRoot":"","sources":["../../src/core/frame-registry.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAMD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkC;gBAE1C,OAAO,EAAE,kBAAkB,EAAE;IAIzC;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB;IAW9C,2CAA2C;IAC3C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,aAAa;CAWtC;AAMD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK9D,KAAK,IAAI,aAAa;CAGvB"}
@@ -1,63 +0,0 @@
1
- // SPDX-License-Identifier: Apache-2.0
2
- // Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
3
- //
4
- // NCP Frame Registry — Maps frame type bytes to protocol identifiers
5
- // NPS-0 §9 Unified frame namespace
6
- import { FrameType, NcpError } from "./frame-header.js";
7
- // ---------------------------------------------------------------------------
8
- // Registry
9
- // ---------------------------------------------------------------------------
10
- /**
11
- * Maps frame type bytes to metadata.
12
- * Built once at startup, then read-only.
13
- */
14
- export class FrameRegistry {
15
- map;
16
- constructor(entries) {
17
- this.map = new Map(entries.map((e) => [e.frameType, e]));
18
- }
19
- /**
20
- * Resolve a frame type byte to its registry entry.
21
- * @throws {NcpError} NCP-FRAME-UNKNOWN-TYPE if not registered.
22
- */
23
- resolve(frameType) {
24
- const entry = this.map.get(frameType);
25
- if (!entry) {
26
- throw new NcpError("NCP-FRAME-UNKNOWN-TYPE", `No entry registered for frame type 0x${frameType.toString(16).padStart(2, "0")}`);
27
- }
28
- return entry;
29
- }
30
- /** Check if a frame type is registered. */
31
- has(frameType) {
32
- return this.map.has(frameType);
33
- }
34
- /**
35
- * Create a registry pre-populated with all NCP core frames.
36
- * Upper-layer protocols can extend via the builder.
37
- */
38
- static createDefault() {
39
- return new FrameRegistryBuilder()
40
- .add(FrameType.Anchor, "AnchorFrame", "ncp")
41
- .add(FrameType.Diff, "DiffFrame", "ncp")
42
- .add(FrameType.Stream, "StreamFrame", "ncp")
43
- .add(FrameType.Caps, "CapsFrame", "ncp")
44
- .add(FrameType.Align, "AlignFrame", "ncp") // deprecated
45
- .add(FrameType.Hello, "HelloFrame", "ncp")
46
- .add(FrameType.Error, "ErrorFrame", "system")
47
- .build();
48
- }
49
- }
50
- // ---------------------------------------------------------------------------
51
- // Builder
52
- // ---------------------------------------------------------------------------
53
- export class FrameRegistryBuilder {
54
- entries = [];
55
- add(frameType, name, protocol) {
56
- this.entries.push({ frameType, name, protocol });
57
- return this;
58
- }
59
- build() {
60
- return new FrameRegistry(this.entries);
61
- }
62
- }
63
- //# sourceMappingURL=frame-registry.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"frame-registry.js","sourceRoot":"","sources":["../../src/core/frame-registry.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,mCAAmC;AAEnC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAiBxD,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,OAAO,aAAa;IACP,GAAG,CAAkC;IAEtD,YAAY,OAA6B;QACvC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,QAAQ,CAChB,wBAAwB,EACxB,wCAAwC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa;QAClB,OAAO,IAAI,oBAAoB,EAAE;aAC9B,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC;aAC3C,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC;aACvC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC;aAC3C,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC;aACvC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,aAAa;aACvD,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC;aACzC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC;aAC5C,KAAK,EAAE,CAAC;IACb,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,OAAO,oBAAoB;IACd,OAAO,GAAyB,EAAE,CAAC;IAEpD,GAAG,CAAC,SAAiB,EAAE,IAAY,EAAE,QAAkB;QACrD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;CACF"}
@@ -1,81 +0,0 @@
1
- /** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
2
- export declare enum FrameType {
3
- ANCHOR = 1,
4
- DIFF = 2,
5
- STREAM = 3,
6
- CAPS = 4,
7
- ALIGN = 5,// deprecated — use AlignStream (0x43)
8
- HELLO = 6,
9
- QUERY = 16,
10
- ACTION = 17,
11
- IDENT = 32,
12
- TRUST = 33,
13
- REVOKE = 34,
14
- ANNOUNCE = 48,
15
- RESOLVE = 49,
16
- GRAPH = 50,
17
- TASK = 64,
18
- DELEGATE = 65,
19
- SYNC = 66,
20
- ALIGN_STREAM = 67,
21
- ERROR = 254
22
- }
23
- /**
24
- * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
25
- * 0x00 = Tier-1 JSON — human-readable; development / compatibility.
26
- * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
27
- */
28
- export declare enum EncodingTier {
29
- JSON = 0,
30
- MSGPACK = 1
31
- }
32
- /**
33
- * Flags byte in the NPS frame header (NPS-1 §3.2).
34
- * Bit layout (LSB = bit 0):
35
- * Bits 0–1 (T0,T1) : Encoding tier
36
- * Bit 2 (FINAL) : Last chunk of a StreamFrame; non-stream frames MUST set this
37
- * Bit 3 (ENC) : Payload encrypted
38
- * Bits 4–6 (RSV) : Reserved — sender MUST write 0
39
- * Bit 7 (EXT) : Extended 8-byte header
40
- */
41
- export declare const FrameFlags: {
42
- readonly NONE: 0;
43
- readonly TIER1_JSON: 0;
44
- readonly TIER2_MSGPACK: 1;
45
- readonly FINAL: 4;
46
- readonly ENCRYPTED: 8;
47
- readonly EXT: 128;
48
- };
49
- export declare const DEFAULT_HEADER_SIZE = 4;
50
- export declare const EXTENDED_HEADER_SIZE = 8;
51
- export declare const DEFAULT_MAX_PAYLOAD = 65535;
52
- export declare const EXTENDED_MAX_PAYLOAD = 4294967295;
53
- /**
54
- * NPS frame header, present at the start of every wire message (NPS-1 §3.1).
55
- *
56
- * Default (4 bytes, EXT=0):
57
- * Byte 0 : FrameType
58
- * Byte 1 : Flags
59
- * Byte 2–3 : PayloadLength (big-endian uint16)
60
- *
61
- * Extended (8 bytes, EXT=1):
62
- * Byte 0 : FrameType
63
- * Byte 1 : Flags (bit 7 = 1)
64
- * Byte 2–3 : Reserved (must be 0)
65
- * Byte 4–7 : PayloadLength (big-endian uint32)
66
- */
67
- export declare class FrameHeader {
68
- readonly frameType: FrameType;
69
- readonly flags: number;
70
- readonly payloadLength: number;
71
- constructor(frameType: FrameType, flags: number, payloadLength: number);
72
- get isExtended(): boolean;
73
- get headerSize(): number;
74
- get encodingTier(): EncodingTier;
75
- get isFinal(): boolean;
76
- get isEncrypted(): boolean;
77
- static parse(buf: Uint8Array): FrameHeader;
78
- toBytes(): Uint8Array;
79
- toString(): string;
80
- }
81
- //# sourceMappingURL=frames.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/core/frames.ts"],"names":[],"mappings":"AAWA,sEAAsE;AACtE,oBAAY,SAAS;IAEnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,MAAM,IAAa;IACnB,IAAI,IAAe;IACnB,KAAK,IAAc,CAAE,sCAAsC;IAC3D,KAAK,IAAc;IAGnB,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,KAAK,KAAc;IACnB,KAAK,KAAc;IACnB,MAAM,KAAa;IAGnB,QAAQ,KAAW;IACnB,OAAO,KAAY;IACnB,KAAK,KAAc;IAGnB,IAAI,KAAe;IACnB,QAAQ,KAAW;IACnB,IAAI,KAAe;IACnB,YAAY,KAAO;IAGnB,KAAK,MAAc;CACpB;AAID;;;;GAIG;AACH,oBAAY,YAAY;IACtB,IAAI,IAAU;IACd,OAAO,IAAO;CACf;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAIX,eAAO,MAAM,mBAAmB,IAAK,CAAC;AACtC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAC3C,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAI/C;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;aAEJ,SAAS,EAAE,SAAS;aACpB,KAAK,EAAE,MAAM;aACb,aAAa,EAAE,MAAM;gBAFrB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM;IAGvC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW;IAiC1C,OAAO,IAAI,UAAU;IAkBrB,QAAQ,IAAI,MAAM;CAGnB"}