@lushly-dev/violet-afd 0.0.0-stage → 0.3.0-preview.0

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 (335) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +29 -2
  3. package/dist/commands/analyze/compare.d.ts +34 -0
  4. package/dist/commands/analyze/compare.d.ts.map +1 -0
  5. package/dist/commands/analyze/compare.js +180 -0
  6. package/dist/commands/analyze/compare.js.map +1 -0
  7. package/dist/commands/analyze/compliance.d.ts +41 -0
  8. package/dist/commands/analyze/compliance.d.ts.map +1 -0
  9. package/dist/commands/analyze/compliance.js +166 -0
  10. package/dist/commands/analyze/compliance.js.map +1 -0
  11. package/dist/commands/analyze/deviations.d.ts +30 -0
  12. package/dist/commands/analyze/deviations.d.ts.map +1 -0
  13. package/dist/commands/analyze/deviations.js +201 -0
  14. package/dist/commands/analyze/deviations.js.map +1 -0
  15. package/dist/commands/analyze/health.d.ts +211 -0
  16. package/dist/commands/analyze/health.d.ts.map +1 -0
  17. package/dist/commands/analyze/health.js +697 -0
  18. package/dist/commands/analyze/health.js.map +1 -0
  19. package/dist/commands/analyze/index.d.ts +15 -0
  20. package/dist/commands/analyze/index.d.ts.map +1 -0
  21. package/dist/commands/analyze/index.js +31 -0
  22. package/dist/commands/analyze/index.js.map +1 -0
  23. package/dist/commands/analyze/snapshot.d.ts +64 -0
  24. package/dist/commands/analyze/snapshot.d.ts.map +1 -0
  25. package/dist/commands/analyze/snapshot.js +126 -0
  26. package/dist/commands/analyze/snapshot.js.map +1 -0
  27. package/dist/commands/analyze/trends.d.ts +82 -0
  28. package/dist/commands/analyze/trends.d.ts.map +1 -0
  29. package/dist/commands/analyze/trends.js +312 -0
  30. package/dist/commands/analyze/trends.js.map +1 -0
  31. package/dist/commands/analyze/violations.d.ts +84 -0
  32. package/dist/commands/analyze/violations.d.ts.map +1 -0
  33. package/dist/commands/analyze/violations.js +158 -0
  34. package/dist/commands/analyze/violations.js.map +1 -0
  35. package/dist/commands/apikeys/check.d.ts +39 -0
  36. package/dist/commands/apikeys/check.d.ts.map +1 -0
  37. package/dist/commands/apikeys/check.js +61 -0
  38. package/dist/commands/apikeys/check.js.map +1 -0
  39. package/dist/commands/apikeys/create.d.ts +36 -0
  40. package/dist/commands/apikeys/create.d.ts.map +1 -0
  41. package/dist/commands/apikeys/create.js +116 -0
  42. package/dist/commands/apikeys/create.js.map +1 -0
  43. package/dist/commands/apikeys/index.d.ts +15 -0
  44. package/dist/commands/apikeys/index.d.ts.map +1 -0
  45. package/dist/commands/apikeys/index.js +21 -0
  46. package/dist/commands/apikeys/index.js.map +1 -0
  47. package/dist/commands/apikeys/keys.d.ts +79 -0
  48. package/dist/commands/apikeys/keys.d.ts.map +1 -0
  49. package/dist/commands/apikeys/keys.js +239 -0
  50. package/dist/commands/apikeys/keys.js.map +1 -0
  51. package/dist/commands/audit/index.d.ts +11 -0
  52. package/dist/commands/audit/index.d.ts.map +1 -0
  53. package/dist/commands/audit/index.js +15 -0
  54. package/dist/commands/audit/index.js.map +1 -0
  55. package/dist/commands/audit/list.d.ts +101 -0
  56. package/dist/commands/audit/list.d.ts.map +1 -0
  57. package/dist/commands/audit/list.js +230 -0
  58. package/dist/commands/audit/list.js.map +1 -0
  59. package/dist/commands/changes/impact.d.ts +477 -0
  60. package/dist/commands/changes/impact.d.ts.map +1 -0
  61. package/dist/commands/changes/impact.js +541 -0
  62. package/dist/commands/changes/impact.js.map +1 -0
  63. package/dist/commands/changes/index.d.ts +11 -0
  64. package/dist/commands/changes/index.d.ts.map +1 -0
  65. package/dist/commands/changes/index.js +15 -0
  66. package/dist/commands/changes/index.js.map +1 -0
  67. package/dist/commands/constraints/index.d.ts +11 -0
  68. package/dist/commands/constraints/index.d.ts.map +1 -0
  69. package/dist/commands/constraints/index.js +19 -0
  70. package/dist/commands/constraints/index.js.map +1 -0
  71. package/dist/commands/constraints/list.d.ts +52 -0
  72. package/dist/commands/constraints/list.d.ts.map +1 -0
  73. package/dist/commands/constraints/list.js +103 -0
  74. package/dist/commands/constraints/list.js.map +1 -0
  75. package/dist/commands/constraints/set.d.ts +50 -0
  76. package/dist/commands/constraints/set.d.ts.map +1 -0
  77. package/dist/commands/constraints/set.js +137 -0
  78. package/dist/commands/constraints/set.js.map +1 -0
  79. package/dist/commands/constraints/validate.d.ts +38 -0
  80. package/dist/commands/constraints/validate.d.ts.map +1 -0
  81. package/dist/commands/constraints/validate.js +164 -0
  82. package/dist/commands/constraints/validate.js.map +1 -0
  83. package/dist/commands/docs/generator.d.ts +77 -0
  84. package/dist/commands/docs/generator.d.ts.map +1 -0
  85. package/dist/commands/docs/generator.js +256 -0
  86. package/dist/commands/docs/generator.js.map +1 -0
  87. package/dist/commands/docs/index.d.ts +6 -0
  88. package/dist/commands/docs/index.d.ts.map +1 -0
  89. package/dist/commands/docs/index.js +6 -0
  90. package/dist/commands/docs/index.js.map +1 -0
  91. package/dist/commands/export/export.d.ts +64 -0
  92. package/dist/commands/export/export.d.ts.map +1 -0
  93. package/dist/commands/export/export.js +193 -0
  94. package/dist/commands/export/export.js.map +1 -0
  95. package/dist/commands/export/index.d.ts +9 -0
  96. package/dist/commands/export/index.d.ts.map +1 -0
  97. package/dist/commands/export/index.js +13 -0
  98. package/dist/commands/export/index.js.map +1 -0
  99. package/dist/commands/import/flatten.d.ts +30 -0
  100. package/dist/commands/import/flatten.d.ts.map +1 -0
  101. package/dist/commands/import/flatten.js +121 -0
  102. package/dist/commands/import/flatten.js.map +1 -0
  103. package/dist/commands/import/index.d.ts +11 -0
  104. package/dist/commands/import/index.d.ts.map +1 -0
  105. package/dist/commands/import/index.js +19 -0
  106. package/dist/commands/import/index.js.map +1 -0
  107. package/dist/commands/import/json.d.ts +40 -0
  108. package/dist/commands/import/json.d.ts.map +1 -0
  109. package/dist/commands/import/json.js +209 -0
  110. package/dist/commands/import/json.js.map +1 -0
  111. package/dist/commands/import/tree.d.ts +39 -0
  112. package/dist/commands/import/tree.d.ts.map +1 -0
  113. package/dist/commands/import/tree.js +247 -0
  114. package/dist/commands/import/tree.js.map +1 -0
  115. package/dist/commands/import/validate.d.ts +53 -0
  116. package/dist/commands/import/validate.d.ts.map +1 -0
  117. package/dist/commands/import/validate.js +201 -0
  118. package/dist/commands/import/validate.js.map +1 -0
  119. package/dist/commands/index.d.ts +21 -0
  120. package/dist/commands/index.d.ts.map +1 -0
  121. package/dist/commands/index.js +21 -0
  122. package/dist/commands/index.js.map +1 -0
  123. package/dist/commands/json-schema.d.ts +21 -0
  124. package/dist/commands/json-schema.d.ts.map +1 -0
  125. package/dist/commands/json-schema.js +41 -0
  126. package/dist/commands/json-schema.js.map +1 -0
  127. package/dist/commands/node/create.d.ts +80 -0
  128. package/dist/commands/node/create.d.ts.map +1 -0
  129. package/dist/commands/node/create.js +174 -0
  130. package/dist/commands/node/create.js.map +1 -0
  131. package/dist/commands/node/delete.d.ts +28 -0
  132. package/dist/commands/node/delete.d.ts.map +1 -0
  133. package/dist/commands/node/delete.js +134 -0
  134. package/dist/commands/node/delete.js.map +1 -0
  135. package/dist/commands/node/deprecation.d.ts +23 -0
  136. package/dist/commands/node/deprecation.d.ts.map +1 -0
  137. package/dist/commands/node/deprecation.js +59 -0
  138. package/dist/commands/node/deprecation.js.map +1 -0
  139. package/dist/commands/node/get.d.ts +79 -0
  140. package/dist/commands/node/get.d.ts.map +1 -0
  141. package/dist/commands/node/get.js +106 -0
  142. package/dist/commands/node/get.js.map +1 -0
  143. package/dist/commands/node/graph.d.ts +138 -0
  144. package/dist/commands/node/graph.d.ts.map +1 -0
  145. package/dist/commands/node/graph.js +285 -0
  146. package/dist/commands/node/graph.js.map +1 -0
  147. package/dist/commands/node/index.d.ts +17 -0
  148. package/dist/commands/node/index.d.ts.map +1 -0
  149. package/dist/commands/node/index.js +31 -0
  150. package/dist/commands/node/index.js.map +1 -0
  151. package/dist/commands/node/list.d.ts +74 -0
  152. package/dist/commands/node/list.d.ts.map +1 -0
  153. package/dist/commands/node/list.js +130 -0
  154. package/dist/commands/node/list.js.map +1 -0
  155. package/dist/commands/node/operations.d.ts +35 -0
  156. package/dist/commands/node/operations.d.ts.map +1 -0
  157. package/dist/commands/node/operations.js +66 -0
  158. package/dist/commands/node/operations.js.map +1 -0
  159. package/dist/commands/node/scope.d.ts +14 -0
  160. package/dist/commands/node/scope.d.ts.map +1 -0
  161. package/dist/commands/node/scope.js +49 -0
  162. package/dist/commands/node/scope.js.map +1 -0
  163. package/dist/commands/node/update.d.ts +84 -0
  164. package/dist/commands/node/update.d.ts.map +1 -0
  165. package/dist/commands/node/update.js +229 -0
  166. package/dist/commands/node/update.js.map +1 -0
  167. package/dist/commands/registry.d.ts +114 -0
  168. package/dist/commands/registry.d.ts.map +1 -0
  169. package/dist/commands/registry.js +141 -0
  170. package/dist/commands/registry.js.map +1 -0
  171. package/dist/commands/specimen/get.d.ts +46 -0
  172. package/dist/commands/specimen/get.d.ts.map +1 -0
  173. package/dist/commands/specimen/get.js +121 -0
  174. package/dist/commands/specimen/get.js.map +1 -0
  175. package/dist/commands/specimen/index.d.ts +10 -0
  176. package/dist/commands/specimen/index.d.ts.map +1 -0
  177. package/dist/commands/specimen/index.js +16 -0
  178. package/dist/commands/specimen/index.js.map +1 -0
  179. package/dist/commands/specimen/set.d.ts +31 -0
  180. package/dist/commands/specimen/set.d.ts.map +1 -0
  181. package/dist/commands/specimen/set.js +188 -0
  182. package/dist/commands/specimen/set.js.map +1 -0
  183. package/dist/commands/specimen/shared.d.ts +16 -0
  184. package/dist/commands/specimen/shared.d.ts.map +1 -0
  185. package/dist/commands/specimen/shared.js +27 -0
  186. package/dist/commands/specimen/shared.js.map +1 -0
  187. package/dist/commands/system/doctor.d.ts +48 -0
  188. package/dist/commands/system/doctor.d.ts.map +1 -0
  189. package/dist/commands/system/doctor.js +224 -0
  190. package/dist/commands/system/doctor.js.map +1 -0
  191. package/dist/commands/system/index.d.ts +12 -0
  192. package/dist/commands/system/index.d.ts.map +1 -0
  193. package/dist/commands/system/index.js +17 -0
  194. package/dist/commands/system/index.js.map +1 -0
  195. package/dist/commands/system/validate.d.ts +47 -0
  196. package/dist/commands/system/validate.d.ts.map +1 -0
  197. package/dist/commands/system/validate.js +245 -0
  198. package/dist/commands/system/validate.js.map +1 -0
  199. package/dist/commands/token/add.d.ts +94 -0
  200. package/dist/commands/token/add.d.ts.map +1 -0
  201. package/dist/commands/token/add.js +162 -0
  202. package/dist/commands/token/add.js.map +1 -0
  203. package/dist/commands/token/catalog.d.ts +69 -0
  204. package/dist/commands/token/catalog.d.ts.map +1 -0
  205. package/dist/commands/token/catalog.js +175 -0
  206. package/dist/commands/token/catalog.js.map +1 -0
  207. package/dist/commands/token/compare.d.ts +140 -0
  208. package/dist/commands/token/compare.d.ts.map +1 -0
  209. package/dist/commands/token/compare.js +207 -0
  210. package/dist/commands/token/compare.js.map +1 -0
  211. package/dist/commands/token/copy.d.ts +31 -0
  212. package/dist/commands/token/copy.d.ts.map +1 -0
  213. package/dist/commands/token/copy.js +179 -0
  214. package/dist/commands/token/copy.js.map +1 -0
  215. package/dist/commands/token/definitions.d.ts +29 -0
  216. package/dist/commands/token/definitions.d.ts.map +1 -0
  217. package/dist/commands/token/definitions.js +63 -0
  218. package/dist/commands/token/definitions.js.map +1 -0
  219. package/dist/commands/token/index.d.ts +22 -0
  220. package/dist/commands/token/index.d.ts.map +1 -0
  221. package/dist/commands/token/index.js +44 -0
  222. package/dist/commands/token/index.js.map +1 -0
  223. package/dist/commands/token/lineage.d.ts +43 -0
  224. package/dist/commands/token/lineage.d.ts.map +1 -0
  225. package/dist/commands/token/lineage.js +187 -0
  226. package/dist/commands/token/lineage.js.map +1 -0
  227. package/dist/commands/token/matrix.d.ts +249 -0
  228. package/dist/commands/token/matrix.d.ts.map +1 -0
  229. package/dist/commands/token/matrix.js +658 -0
  230. package/dist/commands/token/matrix.js.map +1 -0
  231. package/dist/commands/token/override.d.ts +51 -0
  232. package/dist/commands/token/override.d.ts.map +1 -0
  233. package/dist/commands/token/override.js +158 -0
  234. package/dist/commands/token/override.js.map +1 -0
  235. package/dist/commands/token/previous-value.d.ts +23 -0
  236. package/dist/commands/token/previous-value.d.ts.map +1 -0
  237. package/dist/commands/token/previous-value.js +26 -0
  238. package/dist/commands/token/previous-value.js.map +1 -0
  239. package/dist/commands/token/reset.d.ts +29 -0
  240. package/dist/commands/token/reset.d.ts.map +1 -0
  241. package/dist/commands/token/reset.js +143 -0
  242. package/dist/commands/token/reset.js.map +1 -0
  243. package/dist/commands/token/resolve.d.ts +43 -0
  244. package/dist/commands/token/resolve.d.ts.map +1 -0
  245. package/dist/commands/token/resolve.js +136 -0
  246. package/dist/commands/token/resolve.js.map +1 -0
  247. package/dist/commands/token/subtract.d.ts +27 -0
  248. package/dist/commands/token/subtract.d.ts.map +1 -0
  249. package/dist/commands/token/subtract.js +129 -0
  250. package/dist/commands/token/subtract.js.map +1 -0
  251. package/dist/commands/webhooks/delete.d.ts +31 -0
  252. package/dist/commands/webhooks/delete.d.ts.map +1 -0
  253. package/dist/commands/webhooks/delete.js +94 -0
  254. package/dist/commands/webhooks/delete.js.map +1 -0
  255. package/dist/commands/webhooks/get.d.ts +50 -0
  256. package/dist/commands/webhooks/get.d.ts.map +1 -0
  257. package/dist/commands/webhooks/get.js +122 -0
  258. package/dist/commands/webhooks/get.js.map +1 -0
  259. package/dist/commands/webhooks/index.d.ts +24 -0
  260. package/dist/commands/webhooks/index.d.ts.map +1 -0
  261. package/dist/commands/webhooks/index.js +41 -0
  262. package/dist/commands/webhooks/index.js.map +1 -0
  263. package/dist/commands/webhooks/list.d.ts +72 -0
  264. package/dist/commands/webhooks/list.d.ts.map +1 -0
  265. package/dist/commands/webhooks/list.js +116 -0
  266. package/dist/commands/webhooks/list.js.map +1 -0
  267. package/dist/commands/webhooks/logs.d.ts +65 -0
  268. package/dist/commands/webhooks/logs.d.ts.map +1 -0
  269. package/dist/commands/webhooks/logs.js +138 -0
  270. package/dist/commands/webhooks/logs.js.map +1 -0
  271. package/dist/commands/webhooks/redact.d.ts +18 -0
  272. package/dist/commands/webhooks/redact.d.ts.map +1 -0
  273. package/dist/commands/webhooks/redact.js +24 -0
  274. package/dist/commands/webhooks/redact.js.map +1 -0
  275. package/dist/commands/webhooks/register.d.ts +78 -0
  276. package/dist/commands/webhooks/register.d.ts.map +1 -0
  277. package/dist/commands/webhooks/register.js +175 -0
  278. package/dist/commands/webhooks/register.js.map +1 -0
  279. package/dist/commands/webhooks/test.d.ts +32 -0
  280. package/dist/commands/webhooks/test.d.ts.map +1 -0
  281. package/dist/commands/webhooks/test.js +101 -0
  282. package/dist/commands/webhooks/test.js.map +1 -0
  283. package/dist/commands/webhooks/update.d.ts +77 -0
  284. package/dist/commands/webhooks/update.d.ts.map +1 -0
  285. package/dist/commands/webhooks/update.js +198 -0
  286. package/dist/commands/webhooks/update.js.map +1 -0
  287. package/dist/css.d.ts +3 -0
  288. package/dist/css.d.ts.map +1 -0
  289. package/dist/css.js +3 -0
  290. package/dist/css.js.map +1 -0
  291. package/dist/demo/index.d.ts +8 -0
  292. package/dist/demo/index.d.ts.map +1 -0
  293. package/dist/demo/index.js +8 -0
  294. package/dist/demo/index.js.map +1 -0
  295. package/dist/demo/realistic-system.d.ts +54 -0
  296. package/dist/demo/realistic-system.d.ts.map +1 -0
  297. package/dist/demo/realistic-system.js +919 -0
  298. package/dist/demo/realistic-system.js.map +1 -0
  299. package/dist/index.d.ts +21 -0
  300. package/dist/index.d.ts.map +1 -0
  301. package/dist/index.js +60 -0
  302. package/dist/index.js.map +1 -0
  303. package/dist/types/command-result.d.ts +10 -0
  304. package/dist/types/command-result.d.ts.map +1 -0
  305. package/dist/types/command-result.js +11 -0
  306. package/dist/types/command-result.js.map +1 -0
  307. package/dist/types/index.d.ts +8 -0
  308. package/dist/types/index.d.ts.map +1 -0
  309. package/dist/types/index.js +10 -0
  310. package/dist/types/index.js.map +1 -0
  311. package/dist/version.d.ts +3 -0
  312. package/dist/version.d.ts.map +1 -0
  313. package/dist/version.js +4 -0
  314. package/dist/version.js.map +1 -0
  315. package/dist/webhooks/dispatcher.d.ts +147 -0
  316. package/dist/webhooks/dispatcher.d.ts.map +1 -0
  317. package/dist/webhooks/dispatcher.js +420 -0
  318. package/dist/webhooks/dispatcher.js.map +1 -0
  319. package/dist/webhooks/index.d.ts +9 -0
  320. package/dist/webhooks/index.d.ts.map +1 -0
  321. package/dist/webhooks/index.js +9 -0
  322. package/dist/webhooks/index.js.map +1 -0
  323. package/dist/webhooks/signer.d.ts +119 -0
  324. package/dist/webhooks/signer.d.ts.map +1 -0
  325. package/dist/webhooks/signer.js +149 -0
  326. package/dist/webhooks/signer.js.map +1 -0
  327. package/dist/webhooks/url-policy.d.ts +73 -0
  328. package/dist/webhooks/url-policy.d.ts.map +1 -0
  329. package/dist/webhooks/url-policy.js +250 -0
  330. package/dist/webhooks/url-policy.js.map +1 -0
  331. package/dist/worker.d.ts +11 -0
  332. package/dist/worker.d.ts.map +1 -0
  333. package/dist/worker.js +31 -0
  334. package/dist/worker.js.map +1 -0
  335. package/package.json +84 -3
@@ -0,0 +1,420 @@
1
+ /**
2
+ * Webhook Dispatcher - Event matching, delivery, and retry logic
3
+ *
4
+ * Handles:
5
+ * - Matching events to subscribed webhooks
6
+ * - Queuing deliveries with immediate first attempt
7
+ * - Retry logic with exponential backoff
8
+ * - SSRF protection: the destination is re-validated (including a fresh DNS
9
+ * resolution) immediately before every attempt, and redirects are never followed
10
+ *
11
+ * @module webhooks/dispatcher
12
+ */
13
+ import { createDeliveryHeaders } from './signer.js';
14
+ import { assertWebhookUrlSafe } from './url-policy.js';
15
+ /**
16
+ * Retry schedule: delays between retry attempts (in milliseconds)
17
+ * Pattern: 1m, 5m, 30m, 2h, 12h
18
+ */
19
+ const RETRY_DELAYS = [
20
+ 60_000, // 1 minute
21
+ 300_000, // 5 minutes
22
+ 1_800_000, // 30 minutes
23
+ 7_200_000, // 2 hours
24
+ 43_200_000, // 12 hours
25
+ ];
26
+ /**
27
+ * Maximum number of delivery attempts: the initial attempt plus one retry per
28
+ * entry in RETRY_DELAYS (so every delay in the schedule is actually used).
29
+ */
30
+ const MAX_ATTEMPTS = RETRY_DELAYS.length + 1;
31
+ /**
32
+ * Request timeout in milliseconds
33
+ */
34
+ const REQUEST_TIMEOUT = 30_000;
35
+ /**
36
+ * Maximum number of deliveries in flight at once during fan-out / retry sweeps
37
+ */
38
+ const DEFAULT_CONCURRENCY = 5;
39
+ /**
40
+ * WebhookDispatcher - Handles event delivery to registered webhooks
41
+ *
42
+ * @example
43
+ * ```typescript
44
+ * const dispatcher = new WebhookDispatcher({ db });
45
+ *
46
+ * // Dispatch an event
47
+ * await dispatcher.dispatch({
48
+ * id: "evt_123",
49
+ * type: "node.created",
50
+ * timestamp: new Date().toISOString(),
51
+ * data: { node: { id: "xbox", name: "Xbox", type: "product" } }
52
+ * });
53
+ *
54
+ * // Process pending retries
55
+ * await dispatcher.processRetries();
56
+ * ```
57
+ */
58
+ export class WebhookDispatcher {
59
+ db;
60
+ fetch;
61
+ retryTimer;
62
+ requestTimeout;
63
+ concurrency;
64
+ allowPrivate;
65
+ lookup;
66
+ /** Delivery IDs claimed by a retry sweep (prevents overlapping sweeps double-delivering) */
67
+ inFlight = new Set();
68
+ constructor(options) {
69
+ this.db = options.db;
70
+ this.fetch = options.fetch ?? globalThis.fetch;
71
+ this.requestTimeout = options.requestTimeout ?? REQUEST_TIMEOUT;
72
+ this.concurrency = Math.max(1, Math.floor(options.concurrency ?? DEFAULT_CONCURRENCY));
73
+ this.allowPrivate = options.allowPrivate;
74
+ this.lookup = options.lookup;
75
+ // Start auto-retry if enabled
76
+ if (options.autoRetry) {
77
+ const interval = options.retryInterval ?? 60_000;
78
+ this.retryTimer = setInterval(() => {
79
+ // Never let a failed sweep become an unhandled rejection. Overlap is
80
+ // prevented per delivery by the in-flight set in processRetries().
81
+ this.processRetries().catch(() => { });
82
+ }, interval);
83
+ // Do not keep the process alive just for retries
84
+ this.retryTimer.unref?.();
85
+ }
86
+ }
87
+ /**
88
+ * Stops the auto-retry timer
89
+ */
90
+ stop() {
91
+ if (this.retryTimer) {
92
+ clearInterval(this.retryTimer);
93
+ this.retryTimer = undefined;
94
+ }
95
+ }
96
+ /**
97
+ * Dispatches an event to all matching webhooks
98
+ *
99
+ * @param event - The event to dispatch
100
+ * @returns Array of delivery IDs created
101
+ */
102
+ async dispatch(event) {
103
+ // Find matching webhooks
104
+ const webhooks = await this.findMatchingWebhooks(event);
105
+ if (webhooks.length === 0) {
106
+ return [];
107
+ }
108
+ // Create deliveries and attempt immediate delivery, a few at a time
109
+ return mapWithConcurrency(webhooks, this.concurrency, (webhook) => this.createAndDeliver(webhook, event));
110
+ }
111
+ /**
112
+ * Finds webhooks that should receive this event
113
+ */
114
+ async findMatchingWebhooks(event) {
115
+ // Get all active webhooks
116
+ const webhooks = await this.db.listWebhooks({ active: true });
117
+ return webhooks.filter((webhook) => {
118
+ // Check if webhook subscribes to this event type
119
+ if (!webhook.events.includes(event.type)) {
120
+ return false;
121
+ }
122
+ // Check node filter if present
123
+ if (webhook.nodeFilter) {
124
+ const eventNodeId = this.extractNodeId(event);
125
+ if (eventNodeId && !this.matchesNodeFilter(eventNodeId, webhook.nodeFilter)) {
126
+ return false;
127
+ }
128
+ }
129
+ return true;
130
+ });
131
+ }
132
+ /**
133
+ * Extracts the node ID from an event (if applicable)
134
+ */
135
+ extractNodeId(event) {
136
+ const data = event.data;
137
+ // Try common patterns
138
+ if ('nodeId' in data)
139
+ return data.nodeId;
140
+ if ('node' in data && typeof data.node === 'object' && data.node !== null) {
141
+ return data.node.id;
142
+ }
143
+ return undefined;
144
+ }
145
+ /**
146
+ * Checks if an event node matches the webhook's node filter
147
+ * Filter matches if event node is the filter node or a descendant
148
+ */
149
+ matchesNodeFilter(eventNodeId, filterNodeId) {
150
+ // Exact match
151
+ if (eventNodeId === filterNodeId)
152
+ return true;
153
+ // Descendant match (node IDs typically use hierarchical naming)
154
+ // e.g., filter="xbox" matches "xbox", "xbox-ios", "xbox-web"
155
+ if (eventNodeId.startsWith(`${filterNodeId}-`))
156
+ return true;
157
+ return false;
158
+ }
159
+ /**
160
+ * Creates a delivery record and attempts immediate delivery
161
+ */
162
+ async createAndDeliver(webhook, event) {
163
+ const deliveryId = `del_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
164
+ const payload = JSON.stringify(event);
165
+ // Create delivery record
166
+ await this.db.createDelivery({
167
+ id: deliveryId,
168
+ webhookId: webhook.id,
169
+ eventType: event.type,
170
+ payload,
171
+ status: null,
172
+ attempts: 0,
173
+ createdAt: new Date().toISOString(),
174
+ });
175
+ // Attempt immediate delivery
176
+ await this.attemptDelivery(deliveryId, webhook, payload);
177
+ return deliveryId;
178
+ }
179
+ /**
180
+ * Attempts to deliver a payload to a webhook
181
+ */
182
+ async attemptDelivery(deliveryId, webhook, payload) {
183
+ const delivery = await this.db.getDelivery(deliveryId);
184
+ if (!delivery) {
185
+ return {
186
+ success: false,
187
+ status: null,
188
+ response: 'Delivery not found',
189
+ duration: 0,
190
+ };
191
+ }
192
+ const result = await this.send(deliveryId, webhook, payload, delivery.eventType);
193
+ // Update delivery record. `null` explicitly clears a column; `undefined` would
194
+ // leave the previous value in place.
195
+ const attempts = delivery.attempts + 1;
196
+ const update = {
197
+ status: result.status,
198
+ response: result.success ? null : (result.response ?? null),
199
+ attempts,
200
+ };
201
+ if (result.success) {
202
+ update.deliveredAt = new Date().toISOString();
203
+ update.nextRetryAt = null;
204
+ }
205
+ else if (attempts < MAX_ATTEMPTS) {
206
+ // Schedule retry
207
+ const delay = RETRY_DELAYS[attempts - 1] ?? RETRY_DELAYS[RETRY_DELAYS.length - 1];
208
+ update.nextRetryAt = new Date(Date.now() + delay).toISOString();
209
+ }
210
+ else {
211
+ // Max attempts reached: stop retrying
212
+ update.nextRetryAt = null;
213
+ }
214
+ await this.db.updateDelivery(deliveryId, update);
215
+ return result;
216
+ }
217
+ /**
218
+ * Performs one HTTP attempt. Never throws; failures are reported in the result.
219
+ *
220
+ * Security notes:
221
+ * - The destination is validated, and its DNS re-resolved, right before the request
222
+ * so a hostname that was public at registration but now points at an internal
223
+ * address (DNS rebinding) is refused.
224
+ * - Redirects are not followed (a 3xx is a failed delivery), otherwise a public
225
+ * endpoint could bounce the request to an internal one.
226
+ * - The response body is never read (it is cancelled), so nothing the target
227
+ * returns is buffered, stored or surfaced.
228
+ */
229
+ async send(deliveryId, webhook, payload, eventType) {
230
+ const startTime = Date.now();
231
+ const controller = new AbortController();
232
+ const timer = setTimeout(() => controller.abort(), this.requestTimeout);
233
+ timer.unref?.();
234
+ try {
235
+ const policy = await assertWebhookUrlSafe(webhook.url, {
236
+ allowPrivate: this.allowPrivate,
237
+ lookup: this.lookup,
238
+ });
239
+ if (!policy.ok) {
240
+ return {
241
+ success: false,
242
+ status: null,
243
+ response: `Blocked: ${policy.reason}`,
244
+ duration: Date.now() - startTime,
245
+ };
246
+ }
247
+ const headers = createDeliveryHeaders(webhook.secret, JSON.parse(payload), eventType, deliveryId);
248
+ const response = await this.fetch(webhook.url, {
249
+ method: 'POST',
250
+ headers,
251
+ body: payload,
252
+ signal: controller.signal,
253
+ redirect: 'manual',
254
+ });
255
+ // Discard the body without reading it
256
+ try {
257
+ await response.body?.cancel();
258
+ }
259
+ catch {
260
+ // ignore
261
+ }
262
+ const duration = Date.now() - startTime;
263
+ if (response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) {
264
+ return {
265
+ success: false,
266
+ status: response.status || null,
267
+ response: `Redirect not followed${response.status ? ` (HTTP ${response.status})` : ''}`,
268
+ duration,
269
+ };
270
+ }
271
+ const success = response.status >= 200 && response.status < 300;
272
+ return {
273
+ success,
274
+ status: response.status,
275
+ response: success ? undefined : `HTTP ${response.status}`,
276
+ duration,
277
+ };
278
+ }
279
+ catch (error) {
280
+ return {
281
+ success: false,
282
+ status: null,
283
+ response: describeFetchError(error),
284
+ duration: Date.now() - startTime,
285
+ };
286
+ }
287
+ finally {
288
+ clearTimeout(timer);
289
+ }
290
+ }
291
+ /**
292
+ * Processes all pending retries that are due
293
+ */
294
+ async processRetries() {
295
+ const pending = await this.db.getPendingDeliveries();
296
+ const due = pending.filter((delivery) => {
297
+ // Skip attempts already in progress (e.g. a slow sweep still running)
298
+ if (this.inFlight.has(delivery.id))
299
+ return false;
300
+ if (delivery.nextRetryAt) {
301
+ return new Date(delivery.nextRetryAt).getTime() <= Date.now();
302
+ }
303
+ return true;
304
+ });
305
+ // Claim synchronously (before any await) so an overlapping sweep skips these
306
+ for (const delivery of due)
307
+ this.inFlight.add(delivery.id);
308
+ const results = await mapWithConcurrency(due, this.concurrency, async (delivery) => {
309
+ try {
310
+ // Get webhook
311
+ const webhook = await this.db.getWebhook(delivery.webhookId);
312
+ if (!webhook?.active) {
313
+ // Webhook deleted or disabled: stop retrying
314
+ await this.db.updateDelivery(delivery.id, {
315
+ nextRetryAt: null,
316
+ response: 'Webhook disabled or deleted',
317
+ });
318
+ return false;
319
+ }
320
+ // Attempt retry
321
+ await this.attemptDelivery(delivery.id, webhook, delivery.payload);
322
+ return true;
323
+ }
324
+ finally {
325
+ this.inFlight.delete(delivery.id);
326
+ }
327
+ });
328
+ return results.filter(Boolean).length;
329
+ }
330
+ /**
331
+ * Manually retry a specific delivery
332
+ */
333
+ async retryDelivery(deliveryId) {
334
+ const delivery = await this.db.getDelivery(deliveryId);
335
+ if (!delivery) {
336
+ return {
337
+ success: false,
338
+ status: null,
339
+ response: 'Delivery not found',
340
+ duration: 0,
341
+ };
342
+ }
343
+ const webhook = await this.db.getWebhook(delivery.webhookId);
344
+ if (!webhook) {
345
+ return {
346
+ success: false,
347
+ status: null,
348
+ response: 'Webhook not found',
349
+ duration: 0,
350
+ };
351
+ }
352
+ return this.attemptDelivery(deliveryId, webhook, delivery.payload);
353
+ }
354
+ /**
355
+ * Sends a test ping to a webhook
356
+ */
357
+ async sendTestPing(webhookId) {
358
+ const webhook = await this.db.getWebhook(webhookId);
359
+ if (!webhook) {
360
+ return {
361
+ success: false,
362
+ status: null,
363
+ response: 'Webhook not found',
364
+ duration: 0,
365
+ };
366
+ }
367
+ const event = {
368
+ id: `evt_test_${Date.now()}`,
369
+ type: 'test.ping',
370
+ timestamp: new Date().toISOString(),
371
+ data: {
372
+ test: true,
373
+ message: 'This is a test ping from Violet',
374
+ webhookId,
375
+ },
376
+ };
377
+ const deliveryId = await this.createAndDeliver(webhook, event);
378
+ const delivery = await this.db.getDelivery(deliveryId);
379
+ const status = delivery?.status ?? null;
380
+ return {
381
+ success: status !== null && status >= 200 && status < 300,
382
+ status,
383
+ response: delivery?.response,
384
+ duration: 0, // Already completed
385
+ deliveryId,
386
+ };
387
+ }
388
+ }
389
+ /**
390
+ * Maps `items` through `fn` with at most `limit` calls in flight, preserving order.
391
+ */
392
+ async function mapWithConcurrency(items, limit, fn) {
393
+ const results = new Array(items.length);
394
+ let next = 0;
395
+ const worker = async () => {
396
+ while (next < items.length) {
397
+ const index = next++;
398
+ results[index] = await fn(items[index]);
399
+ }
400
+ };
401
+ await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
402
+ return results;
403
+ }
404
+ /**
405
+ * Short, non-sensitive description of a failed request. Deliberately excludes the
406
+ * raw error message, which can include resolved addresses and other internals.
407
+ */
408
+ function describeFetchError(error) {
409
+ if (error instanceof Error) {
410
+ if (error.name === 'AbortError' || error.name === 'TimeoutError') {
411
+ return 'Request timed out';
412
+ }
413
+ const code = error.cause?.code;
414
+ if (typeof code === 'string' && /^[A-Z0-9_]{3,40}$/.test(code)) {
415
+ return `Network error (${code})`;
416
+ }
417
+ }
418
+ return 'Network error';
419
+ }
420
+ //# sourceMappingURL=dispatcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/webhooks/dispatcher.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Webhooks module - Event delivery system for Violet Design
3
+ *
4
+ * @module webhooks
5
+ */
6
+ export { sign, verify, generateSecret, createDeliveryHeaders, SIGNATURE_HEADER, SIGNATURE_PREFIX, type SignOptions, type VerifyOptions, type VerifyResult, } from './signer.js';
7
+ export { ALLOW_PRIVATE_ENV, DEV_LOOPBACK_HOSTS, assertWebhookUrlSafe, classifyBlockedAddress, validateWebhookUrl, type LookupFn, type UrlPolicyOptions, type UrlPolicyResult, } from './url-policy.js';
8
+ export { WebhookDispatcher, type DispatcherOptions, type DeliveryResult, } from './dispatcher.js';
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webhooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,IAAI,EACJ,MAAM,EACN,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACnB,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Webhooks module - Event delivery system for Violet Design
3
+ *
4
+ * @module webhooks
5
+ */
6
+ export { sign, verify, generateSecret, createDeliveryHeaders, SIGNATURE_HEADER, SIGNATURE_PREFIX, } from './signer.js';
7
+ export { ALLOW_PRIVATE_ENV, DEV_LOOPBACK_HOSTS, assertWebhookUrlSafe, classifyBlockedAddress, validateWebhookUrl, } from './url-policy.js';
8
+ export { WebhookDispatcher, } from './dispatcher.js';
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/webhooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,IAAI,EACJ,MAAM,EACN,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,GAIhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GAIlB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,iBAAiB,GAGjB,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,119 @@
1
+ /**
2
+ * Webhook Signer - HMAC-SHA256 signing and verification
3
+ *
4
+ * Follows GitHub webhook signature pattern:
5
+ * - Header: X-Violet-Signature-256
6
+ * - Format: sha256=<hex_digest>
7
+ *
8
+ * @module webhooks/signer
9
+ */
10
+ /**
11
+ * Signature header name used for webhook deliveries
12
+ */
13
+ export declare const SIGNATURE_HEADER = "X-Violet-Signature-256";
14
+ /**
15
+ * Signature algorithm prefix
16
+ */
17
+ export declare const SIGNATURE_PREFIX = "sha256=";
18
+ /**
19
+ * Options for signature generation
20
+ */
21
+ export interface SignOptions {
22
+ /** The webhook secret key */
23
+ secret: string;
24
+ /** The payload to sign (will be JSON stringified if object) */
25
+ payload: string | object;
26
+ }
27
+ /**
28
+ * Options for signature verification
29
+ */
30
+ export interface VerifyOptions {
31
+ /** The webhook secret key */
32
+ secret: string;
33
+ /** The payload that was signed */
34
+ payload: string | object;
35
+ /** The signature to verify (with or without sha256= prefix) */
36
+ signature: string;
37
+ }
38
+ /**
39
+ * Result of signature verification
40
+ */
41
+ export interface VerifyResult {
42
+ /** Whether the signature is valid */
43
+ valid: boolean;
44
+ /** Error message if verification failed */
45
+ error?: string;
46
+ }
47
+ /**
48
+ * Generates an HMAC-SHA256 signature for a webhook payload
49
+ *
50
+ * @param options - Signing options
51
+ * @returns The signature in format: sha256=<hex_digest>
52
+ *
53
+ * @example
54
+ * ```typescript
55
+ * const signature = sign({
56
+ * secret: "webhook-secret",
57
+ * payload: { event: "node.created", data: { id: "xbox" } }
58
+ * });
59
+ * // Returns: "sha256=abc123..."
60
+ * ```
61
+ */
62
+ export declare function sign(options: SignOptions): string;
63
+ /**
64
+ * Verifies an HMAC-SHA256 signature for a webhook payload
65
+ *
66
+ * Uses timing-safe comparison to prevent timing attacks.
67
+ *
68
+ * @param options - Verification options
69
+ * @returns Verification result with validity and optional error
70
+ *
71
+ * @example
72
+ * ```typescript
73
+ * const result = verify({
74
+ * secret: "webhook-secret",
75
+ * payload: { event: "node.created", data: { id: "xbox" } },
76
+ * signature: "sha256=abc123..."
77
+ * });
78
+ *
79
+ * if (result.valid) {
80
+ * // Process the webhook
81
+ * } else {
82
+ * // Reject: result.error contains the reason
83
+ * }
84
+ * ```
85
+ */
86
+ export declare function verify(options: VerifyOptions): VerifyResult;
87
+ /**
88
+ * Generates a cryptographically secure random secret
89
+ *
90
+ * @param length - Length of the secret in bytes (default: 32)
91
+ * @returns A hex-encoded random secret
92
+ *
93
+ * @example
94
+ * ```typescript
95
+ * const secret = generateSecret();
96
+ * // Returns: "a1b2c3d4..." (64 hex characters = 32 bytes)
97
+ * ```
98
+ */
99
+ export declare function generateSecret(length?: number): string;
100
+ /**
101
+ * Creates webhook headers for a delivery
102
+ *
103
+ * @param secret - The webhook secret
104
+ * @param payload - The payload being sent
105
+ * @returns Headers object with signature and content type
106
+ *
107
+ * @example
108
+ * ```typescript
109
+ * const headers = createDeliveryHeaders("secret", payload);
110
+ * // Returns: {
111
+ * // "Content-Type": "application/json",
112
+ * // "X-Violet-Signature-256": "sha256=...",
113
+ * // "X-Violet-Event": "node.created",
114
+ * // "X-Violet-Delivery": "delivery-id"
115
+ * // }
116
+ * ```
117
+ */
118
+ export declare function createDeliveryHeaders(secret: string, payload: object, eventType?: string, deliveryId?: string): Record<string, string>;
119
+ //# sourceMappingURL=signer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/webhooks/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAYjD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CA4C3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAK,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB"}