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

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 (212) hide show
  1. package/CHANGELOG.cn.md +53 -0
  2. package/CHANGELOG.md +62 -0
  3. package/README.cn.md +8 -2
  4. package/README.md +8 -2
  5. package/dist/core/anchor-cache.js +104 -0
  6. package/dist/core/anchor-cache.js.map +1 -0
  7. package/dist/core/cache.js +80 -0
  8. package/dist/core/cache.js.map +1 -0
  9. package/dist/core/canonical-json.js +44 -0
  10. package/dist/core/canonical-json.js.map +1 -0
  11. package/dist/core/codec.js +119 -0
  12. package/dist/core/codec.js.map +1 -0
  13. package/dist/core/codecs/index.js +6 -0
  14. package/dist/core/codecs/index.js.map +1 -0
  15. package/dist/core/codecs/ncp-codec.js +93 -0
  16. package/dist/core/codecs/ncp-codec.js.map +1 -0
  17. package/dist/core/codecs/tier1-json-codec.js +28 -0
  18. package/dist/core/codecs/tier1-json-codec.js.map +1 -0
  19. package/dist/core/codecs/tier2-msgpack-codec.js +26 -0
  20. package/dist/core/codecs/tier2-msgpack-codec.js.map +1 -0
  21. package/dist/core/crypto-provider.js +10 -0
  22. package/dist/core/crypto-provider.js.map +1 -0
  23. package/dist/core/exceptions.js +52 -0
  24. package/dist/core/exceptions.js.map +1 -0
  25. package/dist/core/frame-header.js +185 -0
  26. package/dist/core/frame-header.js.map +1 -0
  27. package/dist/core/frame-registry.js +63 -0
  28. package/dist/core/frame-registry.js.map +1 -0
  29. package/dist/core/frames.js +154 -0
  30. package/dist/core/frames.js.map +1 -0
  31. package/dist/core/index.js +21 -405
  32. package/dist/core/index.js.map +1 -1
  33. package/dist/core/registry.js +17 -0
  34. package/dist/core/registry.js.map +1 -0
  35. package/dist/core/status-codes.js +38 -0
  36. package/dist/core/status-codes.js.map +1 -0
  37. package/dist/index.d.ts +1 -1
  38. package/dist/index.js +9 -5
  39. package/dist/index.js.map +1 -1
  40. package/dist/ncp/frames/anchor-frame.js +54 -0
  41. package/dist/ncp/frames/anchor-frame.js.map +1 -0
  42. package/dist/ncp/frames/caps-frame.js +29 -0
  43. package/dist/ncp/frames/caps-frame.js.map +1 -0
  44. package/dist/ncp/frames/diff-frame.js +37 -0
  45. package/dist/ncp/frames/diff-frame.js.map +1 -0
  46. package/dist/ncp/frames/error-frame.js +13 -0
  47. package/dist/ncp/frames/error-frame.js.map +1 -0
  48. package/dist/ncp/frames/hello-frame.js +25 -0
  49. package/dist/ncp/frames/hello-frame.js.map +1 -0
  50. package/dist/ncp/frames/stream-frame.js +18 -0
  51. package/dist/ncp/frames/stream-frame.js.map +1 -0
  52. package/dist/ncp/frames.js +192 -0
  53. package/dist/ncp/frames.js.map +1 -0
  54. package/dist/ncp/handshake.js +80 -0
  55. package/dist/ncp/handshake.js.map +1 -0
  56. package/dist/ncp/index.d.ts +1 -0
  57. package/dist/ncp/index.d.ts.map +1 -1
  58. package/dist/ncp/index.js +13 -368
  59. package/dist/ncp/index.js.map +1 -1
  60. package/dist/ncp/ncp-error-codes.d.ts +1 -0
  61. package/dist/ncp/ncp-error-codes.d.ts.map +1 -1
  62. package/dist/ncp/ncp-error-codes.js +34 -0
  63. package/dist/ncp/ncp-error-codes.js.map +1 -0
  64. package/dist/ncp/ncp-patch-format.js +13 -0
  65. package/dist/ncp/ncp-patch-format.js.map +1 -0
  66. package/dist/ncp/preamble.d.ts +47 -0
  67. package/dist/ncp/preamble.d.ts.map +1 -0
  68. package/dist/ncp/preamble.js +74 -0
  69. package/dist/ncp/preamble.js.map +1 -0
  70. package/dist/ncp/registry.js +13 -0
  71. package/dist/ncp/registry.js.map +1 -0
  72. package/dist/ncp/stream-manager.js +163 -0
  73. package/dist/ncp/stream-manager.js.map +1 -0
  74. package/dist/ndp/frames.js +87 -0
  75. package/dist/ndp/frames.js.map +1 -0
  76. package/dist/ndp/index.js +6 -223
  77. package/dist/ndp/index.js.map +1 -1
  78. package/dist/ndp/ndp-registry.js +79 -0
  79. package/dist/ndp/ndp-registry.js.map +1 -0
  80. package/dist/ndp/registry.js +10 -0
  81. package/dist/ndp/registry.js.map +1 -0
  82. package/dist/ndp/validator.js +48 -0
  83. package/dist/ndp/validator.js.map +1 -0
  84. package/dist/nip/acme/client.d.ts +31 -0
  85. package/dist/nip/acme/client.d.ts.map +1 -0
  86. package/dist/nip/acme/client.js +136 -0
  87. package/dist/nip/acme/client.js.map +1 -0
  88. package/dist/nip/acme/index.d.ts +6 -0
  89. package/dist/nip/acme/index.d.ts.map +1 -0
  90. package/dist/nip/acme/index.js +8 -0
  91. package/dist/nip/acme/index.js.map +1 -0
  92. package/dist/nip/acme/jws.d.ts +31 -0
  93. package/dist/nip/acme/jws.d.ts.map +1 -0
  94. package/dist/nip/acme/jws.js +76 -0
  95. package/dist/nip/acme/jws.js.map +1 -0
  96. package/dist/nip/acme/messages.d.ts +71 -0
  97. package/dist/nip/acme/messages.d.ts.map +1 -0
  98. package/dist/nip/acme/messages.js +4 -0
  99. package/dist/nip/acme/messages.js.map +1 -0
  100. package/dist/nip/acme/server.d.ts +41 -0
  101. package/dist/nip/acme/server.d.ts.map +1 -0
  102. package/dist/nip/acme/server.js +458 -0
  103. package/dist/nip/acme/server.js.map +1 -0
  104. package/dist/nip/acme/wire.d.ts +19 -0
  105. package/dist/nip/acme/wire.d.ts.map +1 -0
  106. package/dist/nip/acme/wire.js +21 -0
  107. package/dist/nip/acme/wire.js.map +1 -0
  108. package/dist/nip/assurance-level.d.ts +14 -0
  109. package/dist/nip/assurance-level.d.ts.map +1 -0
  110. package/dist/nip/assurance-level.js +33 -0
  111. package/dist/nip/assurance-level.js.map +1 -0
  112. package/dist/nip/cert-format.d.ts +5 -0
  113. package/dist/nip/cert-format.d.ts.map +1 -0
  114. package/dist/nip/cert-format.js +6 -0
  115. package/dist/nip/cert-format.js.map +1 -0
  116. package/dist/nip/error-codes.d.ts +23 -0
  117. package/dist/nip/error-codes.d.ts.map +1 -0
  118. package/dist/nip/error-codes.js +30 -0
  119. package/dist/nip/error-codes.js.map +1 -0
  120. package/dist/nip/frames.d.ts +10 -1
  121. package/dist/nip/frames.d.ts.map +1 -1
  122. package/dist/nip/frames.js +106 -0
  123. package/dist/nip/frames.js.map +1 -0
  124. package/dist/nip/identity.js +94 -0
  125. package/dist/nip/identity.js.map +1 -0
  126. package/dist/nip/index.d.ts +6 -0
  127. package/dist/nip/index.d.ts.map +1 -1
  128. package/dist/nip/index.js +12 -187
  129. package/dist/nip/index.js.map +1 -1
  130. package/dist/nip/registry.js +10 -0
  131. package/dist/nip/registry.js.map +1 -0
  132. package/dist/nip/verifier.d.ts +23 -0
  133. package/dist/nip/verifier.d.ts.map +1 -0
  134. package/dist/nip/verifier.js +90 -0
  135. package/dist/nip/verifier.js.map +1 -0
  136. package/dist/nip/x509/builder.d.ts +35 -0
  137. package/dist/nip/x509/builder.d.ts.map +1 -0
  138. package/dist/nip/x509/builder.js +59 -0
  139. package/dist/nip/x509/builder.js.map +1 -0
  140. package/dist/nip/x509/index.d.ts +4 -0
  141. package/dist/nip/x509/index.d.ts.map +1 -0
  142. package/dist/nip/x509/index.js +6 -0
  143. package/dist/nip/x509/index.js.map +1 -0
  144. package/dist/nip/x509/oids.d.ts +17 -0
  145. package/dist/nip/x509/oids.d.ts.map +1 -0
  146. package/dist/nip/x509/oids.js +23 -0
  147. package/dist/nip/x509/oids.js.map +1 -0
  148. package/dist/nip/x509/verifier.d.ts +26 -0
  149. package/dist/nip/x509/verifier.d.ts.map +1 -0
  150. package/dist/nip/x509/verifier.js +171 -0
  151. package/dist/nip/x509/verifier.js.map +1 -0
  152. package/dist/nop/client.js +90 -0
  153. package/dist/nop/client.js.map +1 -0
  154. package/dist/nop/frames.js +148 -0
  155. package/dist/nop/frames.js.map +1 -0
  156. package/dist/nop/index.js +6 -789
  157. package/dist/nop/index.js.map +1 -1
  158. package/dist/nop/models.js +50 -0
  159. package/dist/nop/models.js.map +1 -0
  160. package/dist/nop/nop-types.js +44 -0
  161. package/dist/nop/nop-types.js.map +1 -0
  162. package/dist/nop/registry.js +11 -0
  163. package/dist/nop/registry.js.map +1 -0
  164. package/dist/nwp/client.js +101 -0
  165. package/dist/nwp/client.js.map +1 -0
  166. package/dist/nwp/frames.js +81 -0
  167. package/dist/nwp/frames.js.map +1 -0
  168. package/dist/nwp/index.js +5 -693
  169. package/dist/nwp/index.js.map +1 -1
  170. package/dist/nwp/registry.js +9 -0
  171. package/dist/nwp/registry.js.map +1 -0
  172. package/dist/setup.js +29 -0
  173. package/dist/setup.js.map +1 -0
  174. package/package.json +2 -1
  175. package/src/index.ts +1 -1
  176. package/src/ncp/index.ts +1 -0
  177. package/src/ncp/ncp-error-codes.ts +2 -0
  178. package/src/ncp/preamble.ts +79 -0
  179. package/src/nip/acme/client.ts +185 -0
  180. package/src/nip/acme/index.ts +8 -0
  181. package/src/nip/acme/jws.ts +109 -0
  182. package/src/nip/acme/messages.ts +85 -0
  183. package/src/nip/acme/server.ts +480 -0
  184. package/src/nip/acme/wire.ts +24 -0
  185. package/src/nip/assurance-level.ts +35 -0
  186. package/src/nip/cert-format.ts +9 -0
  187. package/src/nip/error-codes.ts +36 -0
  188. package/src/nip/frames.ts +35 -3
  189. package/src/nip/index.ts +8 -0
  190. package/src/nip/verifier.ts +122 -0
  191. package/src/nip/x509/builder.ts +91 -0
  192. package/src/nip/x509/index.ts +6 -0
  193. package/src/nip/x509/oids.ts +28 -0
  194. package/src/nip/x509/verifier.ts +214 -0
  195. package/tests/_rfc0002-keys.ts +57 -0
  196. package/tests/ncp/preamble.test.ts +93 -0
  197. package/tests/nip-acme-agent01.test.ts +192 -0
  198. package/tests/nip-x509.test.ts +280 -0
  199. package/dist/core/index.cjs +0 -452
  200. package/dist/core/index.cjs.map +0 -1
  201. package/dist/index.cjs +0 -8
  202. package/dist/index.cjs.map +0 -1
  203. package/dist/ncp/index.cjs +0 -388
  204. package/dist/ncp/index.cjs.map +0 -1
  205. package/dist/ndp/index.cjs +0 -252
  206. package/dist/ndp/index.cjs.map +0 -1
  207. package/dist/nip/index.cjs +0 -214
  208. package/dist/nip/index.cjs.map +0 -1
  209. package/dist/nop/index.cjs +0 -823
  210. package/dist/nop/index.cjs.map +0 -1
  211. package/dist/nwp/index.cjs +0 -720
  212. package/dist/nwp/index.cjs.map +0 -1
@@ -1,823 +0,0 @@
1
- 'use strict';
2
-
3
- var msgpack = require('@msgpack/msgpack');
4
-
5
- function _interopNamespace(e) {
6
- if (e && e.__esModule) return e;
7
- var n = Object.create(null);
8
- if (e) {
9
- Object.keys(e).forEach(function (k) {
10
- if (k !== 'default') {
11
- var d = Object.getOwnPropertyDescriptor(e, k);
12
- Object.defineProperty(n, k, d.get ? d : {
13
- enumerable: true,
14
- get: function () { return e[k]; }
15
- });
16
- }
17
- });
18
- }
19
- n.default = e;
20
- return Object.freeze(n);
21
- }
22
-
23
- var msgpack__namespace = /*#__PURE__*/_interopNamespace(msgpack);
24
-
25
- // src/nop/models.ts
26
- var TaskState = /* @__PURE__ */ ((TaskState2) => {
27
- TaskState2["PENDING"] = "pending";
28
- TaskState2["PREFLIGHT"] = "preflight";
29
- TaskState2["RUNNING"] = "running";
30
- TaskState2["WAITING_SYNC"] = "waiting_sync";
31
- TaskState2["COMPLETED"] = "completed";
32
- TaskState2["FAILED"] = "failed";
33
- TaskState2["CANCELLED"] = "cancelled";
34
- TaskState2["SKIPPED"] = "skipped";
35
- return TaskState2;
36
- })(TaskState || {});
37
- var TaskPriority = /* @__PURE__ */ ((TaskPriority2) => {
38
- TaskPriority2["LOW"] = "low";
39
- TaskPriority2["NORMAL"] = "normal";
40
- TaskPriority2["HIGH"] = "high";
41
- return TaskPriority2;
42
- })(TaskPriority || {});
43
- var BackoffStrategy = /* @__PURE__ */ ((BackoffStrategy2) => {
44
- BackoffStrategy2["FIXED"] = "fixed";
45
- BackoffStrategy2["LINEAR"] = "linear";
46
- BackoffStrategy2["EXPONENTIAL"] = "exponential";
47
- return BackoffStrategy2;
48
- })(BackoffStrategy || {});
49
- var AggregateStrategy = /* @__PURE__ */ ((AggregateStrategy2) => {
50
- AggregateStrategy2["MERGE"] = "merge";
51
- AggregateStrategy2["FIRST"] = "first";
52
- AggregateStrategy2["FASTEST_K"] = "fastest_k";
53
- AggregateStrategy2["ALL"] = "all";
54
- return AggregateStrategy2;
55
- })(AggregateStrategy || {});
56
- function computeDelayMs(policy, attempt) {
57
- const base = policy.baseDelayMs ?? 1e3;
58
- const cap = policy.maxDelayMs ?? 3e4;
59
- let delay;
60
- switch (policy.backoff) {
61
- case "fixed" /* FIXED */:
62
- delay = base;
63
- break;
64
- case "linear" /* LINEAR */:
65
- delay = base * (attempt + 1);
66
- break;
67
- case "exponential" /* EXPONENTIAL */:
68
- delay = base * Math.pow(2, attempt);
69
- break;
70
- }
71
- return Math.min(delay, cap);
72
- }
73
-
74
- // src/core/exceptions.ts
75
- var NpsError = class extends Error {
76
- constructor(message) {
77
- super(message);
78
- this.name = "NpsError";
79
- }
80
- };
81
- var NpsFrameError = class extends NpsError {
82
- constructor(message) {
83
- super(message);
84
- this.name = "NpsFrameError";
85
- }
86
- };
87
- var NpsCodecError = class extends NpsError {
88
- constructor(message) {
89
- super(message);
90
- this.name = "NpsCodecError";
91
- }
92
- };
93
-
94
- // src/core/frames.ts
95
- var FrameFlags = {
96
- TIER1_JSON: 0,
97
- TIER2_MSGPACK: 1,
98
- FINAL: 4,
99
- EXT: 128
100
- };
101
- var DEFAULT_HEADER_SIZE = 4;
102
- var EXTENDED_HEADER_SIZE = 8;
103
- var DEFAULT_MAX_PAYLOAD = 65535;
104
- var FrameHeader = class _FrameHeader {
105
- constructor(frameType, flags, payloadLength) {
106
- this.frameType = frameType;
107
- this.flags = flags;
108
- this.payloadLength = payloadLength;
109
- }
110
- frameType;
111
- flags;
112
- payloadLength;
113
- get isExtended() {
114
- return (this.flags & FrameFlags.EXT) !== 0;
115
- }
116
- get headerSize() {
117
- return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
118
- }
119
- get encodingTier() {
120
- return this.flags & 3;
121
- }
122
- get isFinal() {
123
- return (this.flags & 4) !== 0;
124
- }
125
- get isEncrypted() {
126
- return (this.flags & 8) !== 0;
127
- }
128
- // ── Parsing ───────────────────────────────────────────────────────────────
129
- static parse(buf) {
130
- if (buf.length < 2) {
131
- throw new NpsFrameError(
132
- `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`
133
- );
134
- }
135
- const flags = buf[1];
136
- const ext = (flags & FrameFlags.EXT) !== 0;
137
- if (ext) {
138
- if (buf.length < EXTENDED_HEADER_SIZE) {
139
- throw new NpsFrameError(
140
- `Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`
141
- );
142
- }
143
- const view2 = new DataView(buf.buffer, buf.byteOffset);
144
- const payloadLength2 = view2.getUint32(4, false);
145
- return new _FrameHeader(buf[0], flags, payloadLength2);
146
- }
147
- if (buf.length < DEFAULT_HEADER_SIZE) {
148
- throw new NpsFrameError(
149
- `Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`
150
- );
151
- }
152
- const view = new DataView(buf.buffer, buf.byteOffset);
153
- const payloadLength = view.getUint16(2, false);
154
- return new _FrameHeader(buf[0], flags, payloadLength);
155
- }
156
- // ── Serialisation ─────────────────────────────────────────────────────────
157
- toBytes() {
158
- if (this.isExtended) {
159
- const buf2 = new Uint8Array(EXTENDED_HEADER_SIZE);
160
- const view2 = new DataView(buf2.buffer);
161
- view2.setUint8(0, this.frameType);
162
- view2.setUint8(1, this.flags);
163
- view2.setUint16(2, 0, false);
164
- view2.setUint32(4, this.payloadLength, false);
165
- return buf2;
166
- }
167
- const buf = new Uint8Array(DEFAULT_HEADER_SIZE);
168
- const view = new DataView(buf.buffer);
169
- view.setUint8(0, this.frameType);
170
- view.setUint8(1, this.flags);
171
- view.setUint16(2, this.payloadLength, false);
172
- return buf;
173
- }
174
- toString() {
175
- return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, "0")}, flags=0x${this.flags.toString(16).padStart(2, "0")}, payloadLength=${this.payloadLength})`;
176
- }
177
- };
178
-
179
- // src/nop/frames.ts
180
- var TaskFrame = class _TaskFrame {
181
- constructor(taskId, dag, timeoutMs, callbackUrl, context, priority, depth) {
182
- this.taskId = taskId;
183
- this.dag = dag;
184
- this.timeoutMs = timeoutMs;
185
- this.callbackUrl = callbackUrl;
186
- this.context = context;
187
- this.priority = priority;
188
- this.depth = depth;
189
- }
190
- taskId;
191
- dag;
192
- timeoutMs;
193
- callbackUrl;
194
- context;
195
- priority;
196
- depth;
197
- frameType = 64 /* TASK */;
198
- preferredTier = 1 /* MSGPACK */;
199
- toDict() {
200
- return {
201
- task_id: this.taskId,
202
- dag: this.dag,
203
- timeout_ms: this.timeoutMs ?? null,
204
- callback_url: this.callbackUrl ?? null,
205
- context: this.context ?? null,
206
- priority: this.priority ?? null,
207
- depth: this.depth ?? null
208
- };
209
- }
210
- static fromDict(data) {
211
- return new _TaskFrame(
212
- data["task_id"],
213
- data["dag"],
214
- data["timeout_ms"] ?? void 0,
215
- data["callback_url"] ?? void 0,
216
- data["context"] ?? void 0,
217
- data["priority"] ?? void 0,
218
- data["depth"] ?? void 0
219
- );
220
- }
221
- };
222
- var DelegateFrame = class _DelegateFrame {
223
- constructor(taskId, subtaskId, action, agentNid, inputs, params, idempotencyKey) {
224
- this.taskId = taskId;
225
- this.subtaskId = subtaskId;
226
- this.action = action;
227
- this.agentNid = agentNid;
228
- this.inputs = inputs;
229
- this.params = params;
230
- this.idempotencyKey = idempotencyKey;
231
- }
232
- taskId;
233
- subtaskId;
234
- action;
235
- agentNid;
236
- inputs;
237
- params;
238
- idempotencyKey;
239
- frameType = 65 /* DELEGATE */;
240
- preferredTier = 1 /* MSGPACK */;
241
- toDict() {
242
- return {
243
- task_id: this.taskId,
244
- subtask_id: this.subtaskId,
245
- action: this.action,
246
- agent_nid: this.agentNid,
247
- inputs: this.inputs ?? null,
248
- params: this.params ?? null,
249
- idempotency_key: this.idempotencyKey ?? null
250
- };
251
- }
252
- static fromDict(data) {
253
- return new _DelegateFrame(
254
- data["task_id"],
255
- data["subtask_id"],
256
- data["action"],
257
- data["agent_nid"],
258
- data["inputs"] ?? void 0,
259
- data["params"] ?? void 0,
260
- data["idempotency_key"] ?? void 0
261
- );
262
- }
263
- };
264
- var SyncFrame = class _SyncFrame {
265
- constructor(taskId, syncId, waitFor, minRequired = 0, aggregate = "merge", timeoutMs) {
266
- this.taskId = taskId;
267
- this.syncId = syncId;
268
- this.waitFor = waitFor;
269
- this.minRequired = minRequired;
270
- this.aggregate = aggregate;
271
- this.timeoutMs = timeoutMs;
272
- }
273
- taskId;
274
- syncId;
275
- waitFor;
276
- minRequired;
277
- aggregate;
278
- timeoutMs;
279
- frameType = 66 /* SYNC */;
280
- preferredTier = 1 /* MSGPACK */;
281
- toDict() {
282
- return {
283
- task_id: this.taskId,
284
- sync_id: this.syncId,
285
- wait_for: this.waitFor,
286
- min_required: this.minRequired,
287
- aggregate: this.aggregate,
288
- timeout_ms: this.timeoutMs ?? null
289
- };
290
- }
291
- static fromDict(data) {
292
- return new _SyncFrame(
293
- data["task_id"],
294
- data["sync_id"],
295
- data["wait_for"],
296
- data["min_required"] ?? 0,
297
- data["aggregate"] ?? "merge",
298
- data["timeout_ms"] ?? void 0
299
- );
300
- }
301
- };
302
- var AlignStreamFrame = class _AlignStreamFrame {
303
- constructor(streamId, taskId, subtaskId, seq, isFinal, senderNid, data, error, windowSize) {
304
- this.streamId = streamId;
305
- this.taskId = taskId;
306
- this.subtaskId = subtaskId;
307
- this.seq = seq;
308
- this.isFinal = isFinal;
309
- this.senderNid = senderNid;
310
- this.data = data;
311
- this.error = error;
312
- this.windowSize = windowSize;
313
- }
314
- streamId;
315
- taskId;
316
- subtaskId;
317
- seq;
318
- isFinal;
319
- senderNid;
320
- data;
321
- error;
322
- windowSize;
323
- frameType = 67 /* ALIGN_STREAM */;
324
- preferredTier = 1 /* MSGPACK */;
325
- toDict() {
326
- return {
327
- stream_id: this.streamId,
328
- task_id: this.taskId,
329
- subtask_id: this.subtaskId,
330
- seq: this.seq,
331
- is_final: this.isFinal,
332
- sender_nid: this.senderNid,
333
- data: this.data ?? null,
334
- error: this.error ? { error_code: this.error.errorCode, message: this.error.message ?? null } : null,
335
- window_size: this.windowSize ?? null
336
- };
337
- }
338
- static fromDict(data) {
339
- const rawError = data["error"];
340
- return new _AlignStreamFrame(
341
- data["stream_id"],
342
- data["task_id"],
343
- data["subtask_id"],
344
- data["seq"],
345
- data["is_final"],
346
- data["sender_nid"],
347
- data["data"] ?? void 0,
348
- rawError ? { errorCode: rawError.error_code, ...rawError.message != null ? { message: rawError.message } : {} } : void 0,
349
- data["window_size"] ?? void 0
350
- );
351
- }
352
- };
353
-
354
- // src/nop/registry.ts
355
- function registerNopFrames(registry) {
356
- registry.register(64 /* TASK */, TaskFrame);
357
- registry.register(65 /* DELEGATE */, DelegateFrame);
358
- registry.register(66 /* SYNC */, SyncFrame);
359
- registry.register(67 /* ALIGN_STREAM */, AlignStreamFrame);
360
- }
361
- var Tier1JsonCodec = class {
362
- encode(frame) {
363
- try {
364
- const json = JSON.stringify(frame.toDict());
365
- return new TextEncoder().encode(json);
366
- } catch (err) {
367
- throw new NpsCodecError(
368
- `Tier-1 JSON encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
369
- );
370
- }
371
- }
372
- decode(frameType, payload, registry) {
373
- const cls = registry.resolve(frameType);
374
- try {
375
- const text = new TextDecoder().decode(payload);
376
- const data = JSON.parse(text);
377
- return cls.fromDict(data);
378
- } catch (err) {
379
- throw new NpsCodecError(
380
- `Tier-1 JSON decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
381
- );
382
- }
383
- }
384
- };
385
- var Tier2MsgPackCodec = class {
386
- encode(frame) {
387
- try {
388
- return msgpack__namespace.encode(frame.toDict());
389
- } catch (err) {
390
- throw new NpsCodecError(
391
- `Tier-2 MsgPack encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
392
- );
393
- }
394
- }
395
- decode(frameType, payload, registry) {
396
- const cls = registry.resolve(frameType);
397
- try {
398
- const data = msgpack__namespace.decode(payload);
399
- return cls.fromDict(data);
400
- } catch (err) {
401
- throw new NpsCodecError(
402
- `Tier-2 MsgPack decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
403
- );
404
- }
405
- }
406
- };
407
- var NpsFrameCodec = class {
408
- _registry;
409
- _maxPayload;
410
- _json = new Tier1JsonCodec();
411
- _msgpack = new Tier2MsgPackCodec();
412
- constructor(registry, options = {}) {
413
- this._registry = registry;
414
- this._maxPayload = options.maxPayload ?? DEFAULT_MAX_PAYLOAD;
415
- }
416
- // ── Encode ────────────────────────────────────────────────────────────────
417
- encode(frame, options = {}) {
418
- const tier = options.overrideTier ?? frame.preferredTier;
419
- const tierCodec = this._selectCodec(tier);
420
- let payload;
421
- try {
422
- payload = tierCodec.encode(frame);
423
- } catch (err) {
424
- if (err instanceof NpsCodecError) throw err;
425
- throw new NpsCodecError(`Encode failed for 0x${frame.frameType.toString(16)}.`);
426
- }
427
- if (payload.length > this._maxPayload) {
428
- throw new NpsCodecError(
429
- `Encoded payload for 0x${frame.frameType.toString(16).padStart(2, "0")} exceeds max_frame_payload (${payload.length} bytes > ${this._maxPayload}). Use StreamFrame (0x03) for large payloads.`
430
- );
431
- }
432
- const useExt = payload.length > DEFAULT_MAX_PAYLOAD;
433
- let flags = this._buildFlags(frame, tier);
434
- if (useExt) flags |= FrameFlags.EXT;
435
- const header = new FrameHeader(frame.frameType, flags, payload.length);
436
- const headerBytes = header.toBytes();
437
- const wire = new Uint8Array(headerBytes.length + payload.length);
438
- wire.set(headerBytes, 0);
439
- wire.set(payload, headerBytes.length);
440
- return wire;
441
- }
442
- // ── Decode ────────────────────────────────────────────────────────────────
443
- decode(wire) {
444
- const header = FrameHeader.parse(wire);
445
- const payload = wire.slice(header.headerSize, header.headerSize + header.payloadLength);
446
- const codec = this._selectCodec(header.encodingTier);
447
- return codec.decode(header.frameType, payload, this._registry);
448
- }
449
- static peekHeader(wire) {
450
- return FrameHeader.parse(wire);
451
- }
452
- // ── Private ───────────────────────────────────────────────────────────────
453
- _buildFlags(frame, tier) {
454
- let flags = tier === 0 /* JSON */ ? FrameFlags.TIER1_JSON : FrameFlags.TIER2_MSGPACK;
455
- const isStreamFrame = "isLast" in frame;
456
- const isFinal = !isStreamFrame || frame.isLast;
457
- if (isFinal) flags |= FrameFlags.FINAL;
458
- return flags;
459
- }
460
- _selectCodec(tier) {
461
- if (tier === 0 /* JSON */) return this._json;
462
- if (tier === 1 /* MSGPACK */) return this._msgpack;
463
- throw new NpsCodecError(`Unsupported encoding tier: 0x${tier.toString(16).padStart(2, "0")}.`);
464
- }
465
- };
466
-
467
- // src/core/registry.ts
468
- var FrameRegistry = class {
469
- _map = /* @__PURE__ */ new Map();
470
- register(frameType, cls) {
471
- this._map.set(frameType, cls);
472
- }
473
- resolve(frameType) {
474
- const cls = this._map.get(frameType);
475
- if (cls === void 0) {
476
- throw new NpsFrameError(
477
- `No frame class registered for type 0x${frameType.toString(16).padStart(2, "0")}.`
478
- );
479
- }
480
- return cls;
481
- }
482
- };
483
-
484
- // src/ncp/frames.ts
485
- var AnchorFrame = class _AnchorFrame {
486
- constructor(anchorId, schema, ttl = 3600) {
487
- this.anchorId = anchorId;
488
- this.schema = schema;
489
- this.ttl = ttl;
490
- }
491
- anchorId;
492
- schema;
493
- ttl;
494
- frameType = 1 /* ANCHOR */;
495
- preferredTier = 1 /* MSGPACK */;
496
- toDict() {
497
- return {
498
- anchor_id: this.anchorId,
499
- schema: { fields: this.schema.fields.map((f) => ({ ...f })) },
500
- ttl: this.ttl
501
- };
502
- }
503
- static fromDict(data) {
504
- const schemaRaw = data["schema"];
505
- return new _AnchorFrame(
506
- data["anchor_id"],
507
- { fields: schemaRaw.fields },
508
- data["ttl"] ?? 3600
509
- );
510
- }
511
- };
512
- var DiffFrame = class _DiffFrame {
513
- constructor(anchorRef, baseSeq, patch, entityId) {
514
- this.anchorRef = anchorRef;
515
- this.baseSeq = baseSeq;
516
- this.patch = patch;
517
- this.entityId = entityId;
518
- }
519
- anchorRef;
520
- baseSeq;
521
- patch;
522
- entityId;
523
- frameType = 2 /* DIFF */;
524
- preferredTier = 1 /* MSGPACK */;
525
- toDict() {
526
- return {
527
- anchor_ref: this.anchorRef,
528
- base_seq: this.baseSeq,
529
- patch: this.patch.map((p) => ({ ...p })),
530
- entity_id: this.entityId ?? null
531
- };
532
- }
533
- static fromDict(data) {
534
- return new _DiffFrame(
535
- data["anchor_ref"],
536
- data["base_seq"],
537
- data["patch"],
538
- data["entity_id"] ?? void 0
539
- );
540
- }
541
- };
542
- var StreamFrame = class _StreamFrame {
543
- constructor(streamId, seq, isLast, data, anchorRef, windowSize) {
544
- this.streamId = streamId;
545
- this.seq = seq;
546
- this.isLast = isLast;
547
- this.data = data;
548
- this.anchorRef = anchorRef;
549
- this.windowSize = windowSize;
550
- }
551
- streamId;
552
- seq;
553
- isLast;
554
- data;
555
- anchorRef;
556
- windowSize;
557
- frameType = 3 /* STREAM */;
558
- preferredTier = 1 /* MSGPACK */;
559
- toDict() {
560
- return {
561
- stream_id: this.streamId,
562
- seq: this.seq,
563
- is_last: this.isLast,
564
- data: this.data,
565
- anchor_ref: this.anchorRef ?? null,
566
- window_size: this.windowSize ?? null
567
- };
568
- }
569
- static fromDict(data) {
570
- return new _StreamFrame(
571
- data["stream_id"],
572
- data["seq"],
573
- data["is_last"],
574
- data["data"],
575
- data["anchor_ref"] ?? void 0,
576
- data["window_size"] ?? void 0
577
- );
578
- }
579
- };
580
- var CapsFrame = class _CapsFrame {
581
- constructor(anchorRef, count, data, nextCursor, tokenEst, cached, tokenizerUsed) {
582
- this.anchorRef = anchorRef;
583
- this.count = count;
584
- this.data = data;
585
- this.nextCursor = nextCursor;
586
- this.tokenEst = tokenEst;
587
- this.cached = cached;
588
- this.tokenizerUsed = tokenizerUsed;
589
- }
590
- anchorRef;
591
- count;
592
- data;
593
- nextCursor;
594
- tokenEst;
595
- cached;
596
- tokenizerUsed;
597
- frameType = 4 /* CAPS */;
598
- preferredTier = 1 /* MSGPACK */;
599
- toDict() {
600
- return {
601
- anchor_ref: this.anchorRef,
602
- count: this.count,
603
- data: this.data,
604
- next_cursor: this.nextCursor ?? null,
605
- token_est: this.tokenEst ?? null,
606
- cached: this.cached ?? null,
607
- tokenizer_used: this.tokenizerUsed ?? null
608
- };
609
- }
610
- static fromDict(data) {
611
- return new _CapsFrame(
612
- data["anchor_ref"],
613
- data["count"],
614
- data["data"],
615
- data["next_cursor"] ?? void 0,
616
- data["token_est"] ?? void 0,
617
- data["cached"] ?? void 0,
618
- data["tokenizer_used"] ?? void 0
619
- );
620
- }
621
- };
622
- var ErrorFrame = class _ErrorFrame {
623
- constructor(status, error, message, details) {
624
- this.status = status;
625
- this.error = error;
626
- this.message = message;
627
- this.details = details;
628
- }
629
- status;
630
- error;
631
- message;
632
- details;
633
- frameType = 254 /* ERROR */;
634
- preferredTier = 1 /* MSGPACK */;
635
- toDict() {
636
- return {
637
- status: this.status,
638
- error: this.error,
639
- message: this.message ?? null,
640
- details: this.details ?? null
641
- };
642
- }
643
- static fromDict(data) {
644
- return new _ErrorFrame(
645
- data["status"],
646
- data["error"],
647
- data["message"] ?? void 0,
648
- data["details"] ?? void 0
649
- );
650
- }
651
- };
652
- var HelloFrame = class _HelloFrame {
653
- constructor(npsVersion, supportedEncodings, supportedProtocols, minVersion, agentId, maxFramePayload = _HelloFrame.DEFAULT_MAX_FRAME_PAYLOAD, extSupport = false, maxConcurrentStreams = _HelloFrame.DEFAULT_MAX_CONCURRENT_STREAMS, e2eEncAlgorithms) {
654
- this.npsVersion = npsVersion;
655
- this.supportedEncodings = supportedEncodings;
656
- this.supportedProtocols = supportedProtocols;
657
- this.minVersion = minVersion;
658
- this.agentId = agentId;
659
- this.maxFramePayload = maxFramePayload;
660
- this.extSupport = extSupport;
661
- this.maxConcurrentStreams = maxConcurrentStreams;
662
- this.e2eEncAlgorithms = e2eEncAlgorithms;
663
- }
664
- npsVersion;
665
- supportedEncodings;
666
- supportedProtocols;
667
- minVersion;
668
- agentId;
669
- maxFramePayload;
670
- extSupport;
671
- maxConcurrentStreams;
672
- e2eEncAlgorithms;
673
- frameType = 6 /* HELLO */;
674
- preferredTier = 0 /* JSON */;
675
- static DEFAULT_MAX_FRAME_PAYLOAD = 65535;
676
- static DEFAULT_MAX_CONCURRENT_STREAMS = 32;
677
- toDict() {
678
- return {
679
- nps_version: this.npsVersion,
680
- supported_encodings: [...this.supportedEncodings],
681
- supported_protocols: [...this.supportedProtocols],
682
- min_version: this.minVersion ?? null,
683
- agent_id: this.agentId ?? null,
684
- max_frame_payload: this.maxFramePayload,
685
- ext_support: this.extSupport,
686
- max_concurrent_streams: this.maxConcurrentStreams,
687
- e2e_enc_algorithms: this.e2eEncAlgorithms ? [...this.e2eEncAlgorithms] : null
688
- };
689
- }
690
- static fromDict(data) {
691
- return new _HelloFrame(
692
- data["nps_version"],
693
- data["supported_encodings"] ?? [],
694
- data["supported_protocols"] ?? [],
695
- data["min_version"] ?? void 0,
696
- data["agent_id"] ?? void 0,
697
- data["max_frame_payload"] ?? _HelloFrame.DEFAULT_MAX_FRAME_PAYLOAD,
698
- data["ext_support"] ?? false,
699
- data["max_concurrent_streams"] ?? _HelloFrame.DEFAULT_MAX_CONCURRENT_STREAMS,
700
- data["e2e_enc_algorithms"] ?? void 0
701
- );
702
- }
703
- };
704
-
705
- // src/ncp/registry.ts
706
- function registerNcpFrames(registry) {
707
- registry.register(1 /* ANCHOR */, AnchorFrame);
708
- registry.register(2 /* DIFF */, DiffFrame);
709
- registry.register(3 /* STREAM */, StreamFrame);
710
- registry.register(4 /* CAPS */, CapsFrame);
711
- registry.register(6 /* HELLO */, HelloFrame);
712
- registry.register(254 /* ERROR */, ErrorFrame);
713
- }
714
-
715
- // src/nop/client.ts
716
- var TERMINAL_STATES = /* @__PURE__ */ new Set([
717
- "completed" /* COMPLETED */,
718
- "failed" /* FAILED */,
719
- "cancelled" /* CANCELLED */
720
- ]);
721
- var NopTaskStatus = class {
722
- constructor(_raw) {
723
- this._raw = _raw;
724
- }
725
- _raw;
726
- get taskId() {
727
- return this._raw["task_id"];
728
- }
729
- get state() {
730
- return this._raw["state"];
731
- }
732
- get isTerminal() {
733
- return TERMINAL_STATES.has(this._raw["state"]);
734
- }
735
- get aggregatedResult() {
736
- return this._raw["aggregated_result"];
737
- }
738
- get errorCode() {
739
- return this._raw["error_code"] ?? void 0;
740
- }
741
- get errorMessage() {
742
- return this._raw["error_message"] ?? void 0;
743
- }
744
- get nodeResults() {
745
- return this._raw["node_results"] ?? {};
746
- }
747
- get raw() {
748
- return this._raw;
749
- }
750
- toString() {
751
- return `NopTaskStatus(taskId=${this.taskId}, state=${String(this._raw["state"])})`;
752
- }
753
- };
754
- var NopClient = class {
755
- _baseUrl;
756
- _codec;
757
- _tier;
758
- constructor(baseUrl, options = {}) {
759
- this._baseUrl = baseUrl.replace(/\/$/, "");
760
- this._tier = options.defaultTier ?? 1 /* MSGPACK */;
761
- const registry = options.registry ?? (() => {
762
- const r = new FrameRegistry();
763
- registerNcpFrames(r);
764
- registerNopFrames(r);
765
- return r;
766
- })();
767
- this._codec = new NpsFrameCodec(registry);
768
- }
769
- async submit(frame) {
770
- const wire = this._codec.encode(frame, { overrideTier: this._tier });
771
- const res = await fetch(`${this._baseUrl}/task`, {
772
- method: "POST",
773
- body: wire,
774
- headers: { "Content-Type": "application/x-nps-frame", "Accept": "application/json" }
775
- });
776
- if (!res.ok) throw new Error(`NOP /task failed: HTTP ${res.status}`);
777
- const data = await res.json();
778
- return data["task_id"];
779
- }
780
- async getStatus(taskId) {
781
- const res = await fetch(`${this._baseUrl}/task/${taskId}`, {
782
- headers: { "Accept": "application/json" }
783
- });
784
- if (!res.ok) throw new Error(`NOP /task/${taskId} failed: HTTP ${res.status}`);
785
- return new NopTaskStatus(await res.json());
786
- }
787
- async cancel(taskId) {
788
- const res = await fetch(`${this._baseUrl}/task/${taskId}/cancel`, {
789
- method: "POST",
790
- headers: { "Accept": "application/json" }
791
- });
792
- if (!res.ok) throw new Error(`NOP /task/${taskId}/cancel failed: HTTP ${res.status}`);
793
- }
794
- async wait(taskId, options = {}) {
795
- const pollIntervalMs = options.pollIntervalMs ?? 1e3;
796
- const timeoutMs = options.timeoutMs ?? 3e4;
797
- const deadline = Date.now() + timeoutMs;
798
- while (true) {
799
- const status = await this.getStatus(taskId);
800
- if (status.isTerminal) return status;
801
- const remaining = deadline - Date.now();
802
- if (remaining <= 0) {
803
- throw new Error(`Task '${taskId}' did not complete within ${timeoutMs}ms (state: ${String(status.raw["state"])}).`);
804
- }
805
- await new Promise((resolve) => setTimeout(resolve, Math.min(pollIntervalMs, remaining)));
806
- }
807
- }
808
- };
809
-
810
- exports.AggregateStrategy = AggregateStrategy;
811
- exports.AlignStreamFrame = AlignStreamFrame;
812
- exports.BackoffStrategy = BackoffStrategy;
813
- exports.DelegateFrame = DelegateFrame;
814
- exports.NopClient = NopClient;
815
- exports.NopTaskStatus = NopTaskStatus;
816
- exports.SyncFrame = SyncFrame;
817
- exports.TaskFrame = TaskFrame;
818
- exports.TaskPriority = TaskPriority;
819
- exports.TaskState = TaskState;
820
- exports.computeDelayMs = computeDelayMs;
821
- exports.registerNopFrames = registerNopFrames;
822
- //# sourceMappingURL=index.cjs.map
823
- //# sourceMappingURL=index.cjs.map