@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,149 @@
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
+ import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
11
+ /**
12
+ * Signature header name used for webhook deliveries
13
+ */
14
+ export const SIGNATURE_HEADER = 'X-Violet-Signature-256';
15
+ /**
16
+ * Signature algorithm prefix
17
+ */
18
+ export const SIGNATURE_PREFIX = 'sha256=';
19
+ /**
20
+ * Generates an HMAC-SHA256 signature for a webhook payload
21
+ *
22
+ * @param options - Signing options
23
+ * @returns The signature in format: sha256=<hex_digest>
24
+ *
25
+ * @example
26
+ * ```typescript
27
+ * const signature = sign({
28
+ * secret: "webhook-secret",
29
+ * payload: { event: "node.created", data: { id: "xbox" } }
30
+ * });
31
+ * // Returns: "sha256=abc123..."
32
+ * ```
33
+ */
34
+ export function sign(options) {
35
+ const { secret, payload } = options;
36
+ // Normalize payload to string
37
+ const payloadString = typeof payload === 'string' ? payload : JSON.stringify(payload);
38
+ // Create HMAC-SHA256 signature
39
+ const hmac = createHmac('sha256', secret);
40
+ hmac.update(payloadString, 'utf8');
41
+ const digest = hmac.digest('hex');
42
+ return `${SIGNATURE_PREFIX}${digest}`;
43
+ }
44
+ /**
45
+ * Verifies an HMAC-SHA256 signature for a webhook payload
46
+ *
47
+ * Uses timing-safe comparison to prevent timing attacks.
48
+ *
49
+ * @param options - Verification options
50
+ * @returns Verification result with validity and optional error
51
+ *
52
+ * @example
53
+ * ```typescript
54
+ * const result = verify({
55
+ * secret: "webhook-secret",
56
+ * payload: { event: "node.created", data: { id: "xbox" } },
57
+ * signature: "sha256=abc123..."
58
+ * });
59
+ *
60
+ * if (result.valid) {
61
+ * // Process the webhook
62
+ * } else {
63
+ * // Reject: result.error contains the reason
64
+ * }
65
+ * ```
66
+ */
67
+ export function verify(options) {
68
+ const { secret, payload, signature } = options;
69
+ // Validate inputs
70
+ if (!secret) {
71
+ return { valid: false, error: 'Missing secret' };
72
+ }
73
+ if (!payload) {
74
+ return { valid: false, error: 'Missing payload' };
75
+ }
76
+ if (!signature) {
77
+ return { valid: false, error: 'Missing signature' };
78
+ }
79
+ // Normalize signature (strip prefix if present)
80
+ const normalizedSignature = signature.startsWith(SIGNATURE_PREFIX)
81
+ ? signature
82
+ : `${SIGNATURE_PREFIX}${signature}`;
83
+ // Generate expected signature
84
+ const expectedSignature = sign({ secret, payload });
85
+ // Timing-safe comparison
86
+ try {
87
+ const sigBuffer = Buffer.from(normalizedSignature, 'utf8');
88
+ const expectedBuffer = Buffer.from(expectedSignature, 'utf8');
89
+ // Lengths must match for timingSafeEqual
90
+ if (sigBuffer.length !== expectedBuffer.length) {
91
+ return { valid: false, error: 'Invalid signature' };
92
+ }
93
+ const isValid = timingSafeEqual(sigBuffer, expectedBuffer);
94
+ if (!isValid) {
95
+ return { valid: false, error: 'Invalid signature' };
96
+ }
97
+ return { valid: true };
98
+ }
99
+ catch {
100
+ return { valid: false, error: 'Signature verification failed' };
101
+ }
102
+ }
103
+ /**
104
+ * Generates a cryptographically secure random secret
105
+ *
106
+ * @param length - Length of the secret in bytes (default: 32)
107
+ * @returns A hex-encoded random secret
108
+ *
109
+ * @example
110
+ * ```typescript
111
+ * const secret = generateSecret();
112
+ * // Returns: "a1b2c3d4..." (64 hex characters = 32 bytes)
113
+ * ```
114
+ */
115
+ export function generateSecret(length = 32) {
116
+ return randomBytes(length).toString('hex');
117
+ }
118
+ /**
119
+ * Creates webhook headers for a delivery
120
+ *
121
+ * @param secret - The webhook secret
122
+ * @param payload - The payload being sent
123
+ * @returns Headers object with signature and content type
124
+ *
125
+ * @example
126
+ * ```typescript
127
+ * const headers = createDeliveryHeaders("secret", payload);
128
+ * // Returns: {
129
+ * // "Content-Type": "application/json",
130
+ * // "X-Violet-Signature-256": "sha256=...",
131
+ * // "X-Violet-Event": "node.created",
132
+ * // "X-Violet-Delivery": "delivery-id"
133
+ * // }
134
+ * ```
135
+ */
136
+ export function createDeliveryHeaders(secret, payload, eventType, deliveryId) {
137
+ const headers = {
138
+ 'Content-Type': 'application/json',
139
+ [SIGNATURE_HEADER]: sign({ secret, payload }),
140
+ };
141
+ if (eventType) {
142
+ headers['X-Violet-Event'] = eventType;
143
+ }
144
+ if (deliveryId) {
145
+ headers['X-Violet-Delivery'] = deliveryId;
146
+ }
147
+ return headers;
148
+ }
149
+ //# sourceMappingURL=signer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signer.js","sourceRoot":"","sources":["../../src/webhooks/signer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Webhook URL policy (SSRF protection)
3
+ *
4
+ * One shared validator used at registration/update time (syntactic + literal-IP
5
+ * checks, no network) and by the dispatcher immediately before every delivery
6
+ * (DNS re-resolution, so DNS rebinding after registration is blocked).
7
+ *
8
+ * Rules:
9
+ * - https is required. Plain http is allowed ONLY for the explicit dev loopback
10
+ * hosts in {@link DEV_LOOPBACK_HOSTS} (localhost, 127.0.0.1, [::1]).
11
+ * - URLs carrying credentials (user:pass@host) are rejected.
12
+ * - Hosts that are, or resolve to, private / loopback / link-local / CGNAT /
13
+ * metadata / multicast / reserved addresses are rejected. The dev loopback
14
+ * hosts above are the only exception (matched by name, never by resolution:
15
+ * a public hostname that resolves to 127.0.0.1 is rejected).
16
+ *
17
+ * Opt-in for private networks (local development, self-hosted receivers on an
18
+ * internal network): set `VIOLET_WEBHOOK_ALLOW_PRIVATE=1`, or pass
19
+ * `allowPrivate: true` to the dispatcher / validator. This disables ONLY the
20
+ * address-range checks; protocol and credential checks still apply.
21
+ *
22
+ * @module webhooks/url-policy
23
+ */
24
+ /**
25
+ * Hostnames (as exposed by `URL.hostname`) that may be used for local
26
+ * development, over http or https, without any address-range check.
27
+ */
28
+ export declare const DEV_LOOPBACK_HOSTS: readonly string[];
29
+ /** Environment variable that opts in to private/internal destinations. */
30
+ export declare const ALLOW_PRIVATE_ENV = "VIOLET_WEBHOOK_ALLOW_PRIVATE";
31
+ /** Resolved address, shape-compatible with `dns.promises.lookup(..., { all: true })` */
32
+ export interface ResolvedAddress {
33
+ address: string;
34
+ family: number;
35
+ }
36
+ /** Injectable DNS resolver (returns ALL addresses for the host) */
37
+ export type LookupFn = (hostname: string) => Promise<ResolvedAddress[]>;
38
+ /** Default resolver: dns.lookup with all: true (honours /etc/hosts like fetch does) */
39
+ export declare const defaultLookup: LookupFn;
40
+ export interface UrlPolicyOptions {
41
+ /** Allow private/internal address ranges. Defaults to VIOLET_WEBHOOK_ALLOW_PRIVATE=1. */
42
+ allowPrivate?: boolean;
43
+ /** DNS resolver (injectable for tests). Defaults to dns.lookup. */
44
+ lookup?: LookupFn;
45
+ }
46
+ export type UrlPolicyResult = {
47
+ ok: true;
48
+ url: URL;
49
+ } | {
50
+ ok: false;
51
+ reason: string;
52
+ };
53
+ /** Whether the opt-in env var is set */
54
+ export declare function isPrivateAllowedByEnv(): boolean;
55
+ /** True for the explicit development loopback host names */
56
+ export declare function isDevLoopbackHost(hostname: string): boolean;
57
+ /**
58
+ * Returns a human-readable reason if `address` is a non-public address, or
59
+ * null if it is a routable public address. Unparseable input is blocked.
60
+ */
61
+ export declare function classifyBlockedAddress(address: string): string | null;
62
+ /**
63
+ * Synchronous validation: protocol, credentials, and literal-IP / obviously
64
+ * local hostnames. Performs no DNS lookups. Used at registration and update.
65
+ */
66
+ export declare function validateWebhookUrl(rawUrl: string, options?: UrlPolicyOptions): UrlPolicyResult;
67
+ /**
68
+ * Full validation including DNS: everything in {@link validateWebhookUrl}, plus
69
+ * every address the hostname currently resolves to must be public. Called by the
70
+ * dispatcher immediately before each delivery to defeat DNS rebinding.
71
+ */
72
+ export declare function assertWebhookUrlSafe(rawUrl: string, options?: UrlPolicyOptions): Promise<UrlPolicyResult>;
73
+ //# sourceMappingURL=url-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url-policy.d.ts","sourceRoot":"","sources":["../../src/webhooks/url-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAwC,CAAC;AAEzF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAEhE,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAExE,uFAAuF;AACvF,eAAO,MAAM,aAAa,EAAE,QACuB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAChC,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,wCAAwC;AACxC,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAkHD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYrE;AAUD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAsC9F;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAgC1B"}
@@ -0,0 +1,250 @@
1
+ /**
2
+ * Webhook URL policy (SSRF protection)
3
+ *
4
+ * One shared validator used at registration/update time (syntactic + literal-IP
5
+ * checks, no network) and by the dispatcher immediately before every delivery
6
+ * (DNS re-resolution, so DNS rebinding after registration is blocked).
7
+ *
8
+ * Rules:
9
+ * - https is required. Plain http is allowed ONLY for the explicit dev loopback
10
+ * hosts in {@link DEV_LOOPBACK_HOSTS} (localhost, 127.0.0.1, [::1]).
11
+ * - URLs carrying credentials (user:pass@host) are rejected.
12
+ * - Hosts that are, or resolve to, private / loopback / link-local / CGNAT /
13
+ * metadata / multicast / reserved addresses are rejected. The dev loopback
14
+ * hosts above are the only exception (matched by name, never by resolution:
15
+ * a public hostname that resolves to 127.0.0.1 is rejected).
16
+ *
17
+ * Opt-in for private networks (local development, self-hosted receivers on an
18
+ * internal network): set `VIOLET_WEBHOOK_ALLOW_PRIVATE=1`, or pass
19
+ * `allowPrivate: true` to the dispatcher / validator. This disables ONLY the
20
+ * address-range checks; protocol and credential checks still apply.
21
+ *
22
+ * @module webhooks/url-policy
23
+ */
24
+ import { lookup as dnsLookup } from 'node:dns/promises';
25
+ import { isIP } from 'node:net';
26
+ /**
27
+ * Hostnames (as exposed by `URL.hostname`) that may be used for local
28
+ * development, over http or https, without any address-range check.
29
+ */
30
+ export const DEV_LOOPBACK_HOSTS = ['localhost', '127.0.0.1', '[::1]'];
31
+ /** Environment variable that opts in to private/internal destinations. */
32
+ export const ALLOW_PRIVATE_ENV = 'VIOLET_WEBHOOK_ALLOW_PRIVATE';
33
+ /** Default resolver: dns.lookup with all: true (honours /etc/hosts like fetch does) */
34
+ export const defaultLookup = async (hostname) => dnsLookup(hostname, { all: true, verbatim: true });
35
+ /** Whether the opt-in env var is set */
36
+ export function isPrivateAllowedByEnv() {
37
+ return process.env[ALLOW_PRIVATE_ENV] === '1';
38
+ }
39
+ /** True for the explicit development loopback host names */
40
+ export function isDevLoopbackHost(hostname) {
41
+ return DEV_LOOPBACK_HOSTS.includes(hostname.toLowerCase());
42
+ }
43
+ // -----------------------------------------------------------------------------
44
+ // IP classification
45
+ // -----------------------------------------------------------------------------
46
+ function parseIPv4(address) {
47
+ const parts = address.split('.');
48
+ if (parts.length !== 4)
49
+ return null;
50
+ const octets = parts.map((p) => (/^\d{1,3}$/.test(p) ? Number(p) : Number.NaN));
51
+ if (octets.some((o) => Number.isNaN(o) || o > 255))
52
+ return null;
53
+ return octets;
54
+ }
55
+ /** Expands an IPv6 literal to eight 16-bit groups (supports embedded dotted quads). */
56
+ function parseIPv6(input) {
57
+ let address = input;
58
+ const zone = address.indexOf('%');
59
+ if (zone !== -1)
60
+ address = address.slice(0, zone);
61
+ // Convert trailing dotted quad into two hex groups
62
+ const lastColon = address.lastIndexOf(':');
63
+ const tail = address.slice(lastColon + 1);
64
+ if (tail.includes('.')) {
65
+ const v4 = parseIPv4(tail);
66
+ if (!v4)
67
+ return null;
68
+ const hi = ((v4[0] << 8) | v4[1]).toString(16);
69
+ const lo = ((v4[2] << 8) | v4[3]).toString(16);
70
+ address = `${address.slice(0, lastColon + 1)}${hi}:${lo}`;
71
+ }
72
+ const halves = address.split('::');
73
+ if (halves.length > 2)
74
+ return null;
75
+ const head = halves[0] ? halves[0].split(':') : [];
76
+ const rest = halves.length === 2 && halves[1] ? halves[1].split(':') : [];
77
+ let groups;
78
+ if (halves.length === 2) {
79
+ const missing = 8 - head.length - rest.length;
80
+ if (missing < 1)
81
+ return null;
82
+ groups = [...head, ...Array(missing).fill('0'), ...rest];
83
+ }
84
+ else {
85
+ groups = head;
86
+ }
87
+ if (groups.length !== 8)
88
+ return null;
89
+ const out = groups.map((g) => /^[0-9a-fA-F]{1,4}$/.test(g) ? Number.parseInt(g, 16) : Number.NaN);
90
+ return out.some(Number.isNaN) ? null : out;
91
+ }
92
+ /** Blocked IPv4 ranges as [network address, prefix length, description] */
93
+ const BLOCKED_IPV4 = [
94
+ ['0.0.0.0', 8, 'unspecified/"this network" address'],
95
+ ['10.0.0.0', 8, 'private network address (10.0.0.0/8)'],
96
+ ['100.64.0.0', 10, 'carrier-grade NAT address (100.64.0.0/10)'],
97
+ ['127.0.0.0', 8, 'loopback address'],
98
+ ['169.254.0.0', 16, 'link-local/metadata address (169.254.0.0/16)'],
99
+ ['172.16.0.0', 12, 'private network address (172.16.0.0/12)'],
100
+ ['192.0.0.0', 24, 'IETF protocol assignment address (192.0.0.0/24)'],
101
+ ['192.168.0.0', 16, 'private network address (192.168.0.0/16)'],
102
+ ['198.18.0.0', 15, 'benchmarking address (198.18.0.0/15)'],
103
+ ['224.0.0.0', 4, 'multicast address'],
104
+ ['240.0.0.0', 4, 'reserved address'],
105
+ ];
106
+ function ipv4ToInt(o) {
107
+ return ((o[0] << 24) | (o[1] << 16) | (o[2] << 8) | o[3]) >>> 0;
108
+ }
109
+ function blockedIPv4(o) {
110
+ const ip = ipv4ToInt(o);
111
+ for (const [network, bits, reason] of BLOCKED_IPV4) {
112
+ const mask = bits === 0 ? 0 : (0xffffffff << (32 - bits)) >>> 0;
113
+ const net = ipv4ToInt(parseIPv4(network));
114
+ if ((ip & mask) >>> 0 === (net & mask) >>> 0)
115
+ return reason;
116
+ }
117
+ return null;
118
+ }
119
+ function embeddedV4(hi, lo) {
120
+ return [hi >> 8, hi & 0xff, lo >> 8, lo & 0xff];
121
+ }
122
+ /** Blocked IPv6 prefixes on the first group: [mask, value, description] */
123
+ const BLOCKED_IPV6_FIRST_GROUP = [
124
+ [0xfe00, 0xfc00, 'unique-local address (fc00::/7)'],
125
+ [0xffc0, 0xfe80, 'link-local address (fe80::/10)'],
126
+ [0xffc0, 0xfec0, 'site-local address (fec0::/10)'],
127
+ [0xff00, 0xff00, 'multicast address'],
128
+ ];
129
+ function blockedIPv6(g) {
130
+ const zeroPrefix = (n) => g.slice(0, n).every((x) => x === 0);
131
+ if (zeroPrefix(7)) {
132
+ if (g[7] === 0)
133
+ return 'unspecified address';
134
+ if (g[7] === 1)
135
+ return 'loopback address';
136
+ }
137
+ // Addresses embedding an IPv4 address take that address's verdict:
138
+ // IPv4-mapped ::ffff:a.b.c.d, IPv4-compatible ::a.b.c.d (deprecated),
139
+ // NAT64 64:ff9b::/96, and 6to4 2002::/16 (IPv4 in groups 1-2).
140
+ if (zeroPrefix(5) && g[5] === 0xffff)
141
+ return blockedIPv4(embeddedV4(g[6], g[7]));
142
+ if (zeroPrefix(6))
143
+ return blockedIPv4(embeddedV4(g[6], g[7])) ?? 'IPv4-compatible address';
144
+ if (g[0] === 0x64 && g[1] === 0xff9b && g.slice(2, 6).every((x) => x === 0)) {
145
+ return blockedIPv4(embeddedV4(g[6], g[7]));
146
+ }
147
+ if (g[0] === 0x2002)
148
+ return blockedIPv4(embeddedV4(g[1], g[2]));
149
+ for (const [mask, value, reason] of BLOCKED_IPV6_FIRST_GROUP) {
150
+ if ((g[0] & mask) === value)
151
+ return reason;
152
+ }
153
+ return null;
154
+ }
155
+ /**
156
+ * Returns a human-readable reason if `address` is a non-public address, or
157
+ * null if it is a routable public address. Unparseable input is blocked.
158
+ */
159
+ export function classifyBlockedAddress(address) {
160
+ const bare = address.startsWith('[') && address.endsWith(']') ? address.slice(1, -1) : address;
161
+ const family = isIP(bare);
162
+ if (family === 4) {
163
+ const octets = parseIPv4(bare);
164
+ return octets ? blockedIPv4(octets) : 'invalid IPv4 address';
165
+ }
166
+ if (family === 6) {
167
+ const groups = parseIPv6(bare);
168
+ return groups ? blockedIPv6(groups) : 'invalid IPv6 address';
169
+ }
170
+ return 'invalid IP address';
171
+ }
172
+ // -----------------------------------------------------------------------------
173
+ // URL validation
174
+ // -----------------------------------------------------------------------------
175
+ function shouldAllowPrivate(options) {
176
+ return options?.allowPrivate ?? isPrivateAllowedByEnv();
177
+ }
178
+ /**
179
+ * Synchronous validation: protocol, credentials, and literal-IP / obviously
180
+ * local hostnames. Performs no DNS lookups. Used at registration and update.
181
+ */
182
+ export function validateWebhookUrl(rawUrl, options) {
183
+ let url;
184
+ try {
185
+ url = new URL(rawUrl);
186
+ }
187
+ catch {
188
+ return { ok: false, reason: 'Invalid URL format' };
189
+ }
190
+ const devHost = isDevLoopbackHost(url.hostname);
191
+ if (url.protocol !== 'https:' && !(url.protocol === 'http:' && devHost)) {
192
+ return {
193
+ ok: false,
194
+ reason: 'Webhook URL must use HTTPS (http is only allowed for localhost/127.0.0.1/[::1])',
195
+ };
196
+ }
197
+ if (url.username || url.password) {
198
+ return { ok: false, reason: 'Webhook URL must not contain credentials' };
199
+ }
200
+ if (devHost || shouldAllowPrivate(options)) {
201
+ return { ok: true, url };
202
+ }
203
+ const hostname = url.hostname.toLowerCase().replace(/\.$/, '');
204
+ if (hostname === 'localhost' || hostname.endsWith('.localhost')) {
205
+ return { ok: false, reason: 'Webhook URL host resolves to a loopback address' };
206
+ }
207
+ if (isIP(hostname.startsWith('[') ? hostname.slice(1, -1) : hostname) !== 0) {
208
+ const reason = classifyBlockedAddress(hostname);
209
+ if (reason) {
210
+ return { ok: false, reason: `Webhook URL host is a non-public address: ${reason}` };
211
+ }
212
+ }
213
+ return { ok: true, url };
214
+ }
215
+ /**
216
+ * Full validation including DNS: everything in {@link validateWebhookUrl}, plus
217
+ * every address the hostname currently resolves to must be public. Called by the
218
+ * dispatcher immediately before each delivery to defeat DNS rebinding.
219
+ */
220
+ export async function assertWebhookUrlSafe(rawUrl, options) {
221
+ const syntactic = validateWebhookUrl(rawUrl, options);
222
+ if (!syntactic.ok)
223
+ return syntactic;
224
+ const { url } = syntactic;
225
+ const hostname = url.hostname;
226
+ // Dev loopback hosts and the explicit private opt-in skip resolution checks.
227
+ if (isDevLoopbackHost(hostname) || shouldAllowPrivate(options))
228
+ return syntactic;
229
+ // Literal IPs were fully classified by validateWebhookUrl.
230
+ if (isIP(hostname.startsWith('[') ? hostname.slice(1, -1) : hostname) !== 0)
231
+ return syntactic;
232
+ let addresses;
233
+ try {
234
+ addresses = await (options?.lookup ?? defaultLookup)(hostname);
235
+ }
236
+ catch {
237
+ return { ok: false, reason: 'DNS lookup failed' };
238
+ }
239
+ if (addresses.length === 0) {
240
+ return { ok: false, reason: 'DNS lookup returned no addresses' };
241
+ }
242
+ for (const { address } of addresses) {
243
+ const reason = classifyBlockedAddress(address);
244
+ if (reason) {
245
+ return { ok: false, reason: `Webhook URL host resolves to a non-public address: ${reason}` };
246
+ }
247
+ }
248
+ return syntactic;
249
+ }
250
+ //# sourceMappingURL=url-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url-policy.js","sourceRoot":"","sources":["../../src/webhooks/url-policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Worker-safe Violet core entrypoint.
3
+ *
4
+ * Excludes Node-only storage and system command surfaces so Workers can bundle
5
+ * only the command/runtime pieces they actually use.
6
+ */
7
+ export * from '@lushly-dev/violet-core/worker';
8
+ export type { CommandContext, Database } from './commands/registry.js';
9
+ export { registry } from './commands/registry.js';
10
+ export declare function initializeWorkerCore(): void;
11
+ //# sourceMappingURL=worker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAalD,wBAAgB,oBAAoB,IAAI,IAAI,CAW3C"}
package/dist/worker.js ADDED
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Worker-safe Violet core entrypoint.
3
+ *
4
+ * Excludes Node-only storage and system command surfaces so Workers can bundle
5
+ * only the command/runtime pieces they actually use.
6
+ */
7
+ export * from '@lushly-dev/violet-core/worker';
8
+ export { registry } from './commands/registry.js';
9
+ import { initializeExport } from '@lushly-dev/violet-core/engine';
10
+ import { registerAnalyzeCommands } from './commands/analyze/index.js';
11
+ import { registerAuditCommands } from './commands/audit/index.js';
12
+ import { registerChangesCommands } from './commands/changes/index.js';
13
+ import { registerConstraintCommands } from './commands/constraints/index.js';
14
+ import { registerExportCommands } from './commands/export/index.js';
15
+ import { registerImportCommands } from './commands/import/index.js';
16
+ import { registerNodeCommands } from './commands/node/index.js';
17
+ import { registerSpecimenCommands } from './commands/specimen/index.js';
18
+ import { registerTokenCommands } from './commands/token/index.js';
19
+ export function initializeWorkerCore() {
20
+ registerNodeCommands();
21
+ registerTokenCommands();
22
+ registerExportCommands();
23
+ registerImportCommands();
24
+ registerConstraintCommands();
25
+ registerAnalyzeCommands();
26
+ registerChangesCommands();
27
+ registerAuditCommands();
28
+ registerSpecimenCommands();
29
+ initializeExport();
30
+ }
31
+ //# sourceMappingURL=worker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,UAAU,oBAAoB;IACnC,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;IACxB,sBAAsB,EAAE,CAAC;IACzB,sBAAsB,EAAE,CAAC;IACzB,0BAA0B,EAAE,CAAC;IAC7B,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,CAAC;IAC1B,qBAAqB,EAAE,CAAC;IACxB,wBAAwB,EAAE,CAAC;IAC3B,gBAAgB,EAAE,CAAC;AACpB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,87 @@
1
1
  {
2
2
  "name": "@lushly-dev/violet-afd",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.3.0-preview.0",
4
+ "license": "MIT",
5
+ "author": "Falkicon",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/lushly-dev/afd.git",
9
+ "directory": "integrations/violet-afd"
10
+ },
11
+ "publishConfig": {
12
+ "access": "public"
13
+ },
14
+ "keywords": [
15
+ "violet",
16
+ "design-tokens",
17
+ "afd",
18
+ "agent-first",
19
+ "commands"
20
+ ],
21
+ "engines": {
22
+ "node": ">=24"
23
+ },
24
+ "description": "AFD command bindings for the native Violet token engine; the pre-split violet-core command surface",
25
+ "type": "module",
26
+ "main": "./dist/index.js",
27
+ "types": "./dist/index.d.ts",
28
+ "exports": {
29
+ ".": {
30
+ "import": "./dist/index.js",
31
+ "types": "./dist/index.d.ts"
32
+ },
33
+ "./worker": {
34
+ "import": "./dist/worker.js",
35
+ "types": "./dist/worker.d.ts"
36
+ },
37
+ "./commands": {
38
+ "import": "./dist/commands/index.js",
39
+ "types": "./dist/commands/index.d.ts"
40
+ },
41
+ "./css": {
42
+ "import": "./dist/css.js",
43
+ "types": "./dist/css.d.ts"
44
+ },
45
+ "./types": {
46
+ "import": "./dist/types/index.js",
47
+ "types": "./dist/types/index.d.ts"
48
+ }
49
+ },
50
+ "dependencies": {
51
+ "@lushly-dev/afd-core": "^2.2.0",
52
+ "@neondatabase/serverless": "^1.1.0",
53
+ "nanoid": "^6.0.2",
54
+ "ws": "^8.22.0",
55
+ "zod": "^4.6.7"
56
+ },
57
+ "peerDependencies": {
58
+ "@lushly-dev/violet-core": "^0.3.0-preview.0"
59
+ },
60
+ "devDependencies": {
61
+ "@biomejs/biome": "^2.6.6",
62
+ "@types/better-sqlite3": "^9.6.0",
63
+ "@types/node": "^26.6.6",
64
+ "@types/pg": "^8.23.1",
65
+ "@types/ws": "^8.18.2",
66
+ "@vitest/coverage-v8": "^5.1.0",
67
+ "pg": "^8.23.1",
68
+ "typescript": "^7.0.2",
69
+ "vitest": "^5.1.0",
70
+ "@lushly-dev/violet-core": "^0.3.0-preview.0"
71
+ },
72
+ "files": [
73
+ "dist",
74
+ "README.md",
75
+ "LICENSE"
76
+ ],
77
+ "scripts": {
78
+ "build": "tsc",
79
+ "dev": "tsc --watch",
80
+ "lint": "biome check src/",
81
+ "test": "vitest run --config vitest.unit.config.ts",
82
+ "test:db": "vitest run",
83
+ "test:watch": "vitest",
84
+ "test:coverage": "vitest run --coverage",
85
+ "clean": "rm -rf dist *.tsbuildinfo"
86
+ }
6
87
  }