@lushly-dev/violet-afd 0.0.0-stage → 0.3.0-preview.1
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.
- package/LICENSE +21 -0
- package/README.md +29 -2
- package/dist/commands/analyze/compare.d.ts +36 -0
- package/dist/commands/analyze/compare.d.ts.map +1 -0
- package/dist/commands/analyze/compare.js +196 -0
- package/dist/commands/analyze/compare.js.map +1 -0
- package/dist/commands/analyze/compliance.d.ts +41 -0
- package/dist/commands/analyze/compliance.d.ts.map +1 -0
- package/dist/commands/analyze/compliance.js +166 -0
- package/dist/commands/analyze/compliance.js.map +1 -0
- package/dist/commands/analyze/deviations.d.ts +30 -0
- package/dist/commands/analyze/deviations.d.ts.map +1 -0
- package/dist/commands/analyze/deviations.js +201 -0
- package/dist/commands/analyze/deviations.js.map +1 -0
- package/dist/commands/analyze/health.d.ts +211 -0
- package/dist/commands/analyze/health.d.ts.map +1 -0
- package/dist/commands/analyze/health.js +697 -0
- package/dist/commands/analyze/health.js.map +1 -0
- package/dist/commands/analyze/index.d.ts +15 -0
- package/dist/commands/analyze/index.d.ts.map +1 -0
- package/dist/commands/analyze/index.js +31 -0
- package/dist/commands/analyze/index.js.map +1 -0
- package/dist/commands/analyze/snapshot.d.ts +64 -0
- package/dist/commands/analyze/snapshot.d.ts.map +1 -0
- package/dist/commands/analyze/snapshot.js +126 -0
- package/dist/commands/analyze/snapshot.js.map +1 -0
- package/dist/commands/analyze/trends.d.ts +82 -0
- package/dist/commands/analyze/trends.d.ts.map +1 -0
- package/dist/commands/analyze/trends.js +312 -0
- package/dist/commands/analyze/trends.js.map +1 -0
- package/dist/commands/analyze/violations.d.ts +84 -0
- package/dist/commands/analyze/violations.d.ts.map +1 -0
- package/dist/commands/analyze/violations.js +158 -0
- package/dist/commands/analyze/violations.js.map +1 -0
- package/dist/commands/apikeys/check.d.ts +39 -0
- package/dist/commands/apikeys/check.d.ts.map +1 -0
- package/dist/commands/apikeys/check.js +61 -0
- package/dist/commands/apikeys/check.js.map +1 -0
- package/dist/commands/apikeys/create.d.ts +36 -0
- package/dist/commands/apikeys/create.d.ts.map +1 -0
- package/dist/commands/apikeys/create.js +116 -0
- package/dist/commands/apikeys/create.js.map +1 -0
- package/dist/commands/apikeys/index.d.ts +15 -0
- package/dist/commands/apikeys/index.d.ts.map +1 -0
- package/dist/commands/apikeys/index.js +21 -0
- package/dist/commands/apikeys/index.js.map +1 -0
- package/dist/commands/apikeys/keys.d.ts +79 -0
- package/dist/commands/apikeys/keys.d.ts.map +1 -0
- package/dist/commands/apikeys/keys.js +239 -0
- package/dist/commands/apikeys/keys.js.map +1 -0
- package/dist/commands/audit/index.d.ts +11 -0
- package/dist/commands/audit/index.d.ts.map +1 -0
- package/dist/commands/audit/index.js +15 -0
- package/dist/commands/audit/index.js.map +1 -0
- package/dist/commands/audit/list.d.ts +101 -0
- package/dist/commands/audit/list.d.ts.map +1 -0
- package/dist/commands/audit/list.js +230 -0
- package/dist/commands/audit/list.js.map +1 -0
- package/dist/commands/changes/impact.d.ts +477 -0
- package/dist/commands/changes/impact.d.ts.map +1 -0
- package/dist/commands/changes/impact.js +541 -0
- package/dist/commands/changes/impact.js.map +1 -0
- package/dist/commands/changes/index.d.ts +11 -0
- package/dist/commands/changes/index.d.ts.map +1 -0
- package/dist/commands/changes/index.js +15 -0
- package/dist/commands/changes/index.js.map +1 -0
- package/dist/commands/constraints/index.d.ts +11 -0
- package/dist/commands/constraints/index.d.ts.map +1 -0
- package/dist/commands/constraints/index.js +19 -0
- package/dist/commands/constraints/index.js.map +1 -0
- package/dist/commands/constraints/list.d.ts +52 -0
- package/dist/commands/constraints/list.d.ts.map +1 -0
- package/dist/commands/constraints/list.js +103 -0
- package/dist/commands/constraints/list.js.map +1 -0
- package/dist/commands/constraints/set.d.ts +50 -0
- package/dist/commands/constraints/set.d.ts.map +1 -0
- package/dist/commands/constraints/set.js +137 -0
- package/dist/commands/constraints/set.js.map +1 -0
- package/dist/commands/constraints/validate.d.ts +38 -0
- package/dist/commands/constraints/validate.d.ts.map +1 -0
- package/dist/commands/constraints/validate.js +164 -0
- package/dist/commands/constraints/validate.js.map +1 -0
- package/dist/commands/docs/generator.d.ts +77 -0
- package/dist/commands/docs/generator.d.ts.map +1 -0
- package/dist/commands/docs/generator.js +256 -0
- package/dist/commands/docs/generator.js.map +1 -0
- package/dist/commands/docs/index.d.ts +6 -0
- package/dist/commands/docs/index.d.ts.map +1 -0
- package/dist/commands/docs/index.js +6 -0
- package/dist/commands/docs/index.js.map +1 -0
- package/dist/commands/export/export.d.ts +64 -0
- package/dist/commands/export/export.d.ts.map +1 -0
- package/dist/commands/export/export.js +193 -0
- package/dist/commands/export/export.js.map +1 -0
- package/dist/commands/export/index.d.ts +9 -0
- package/dist/commands/export/index.d.ts.map +1 -0
- package/dist/commands/export/index.js +13 -0
- package/dist/commands/export/index.js.map +1 -0
- package/dist/commands/import/flatten.d.ts +30 -0
- package/dist/commands/import/flatten.d.ts.map +1 -0
- package/dist/commands/import/flatten.js +121 -0
- package/dist/commands/import/flatten.js.map +1 -0
- package/dist/commands/import/index.d.ts +11 -0
- package/dist/commands/import/index.d.ts.map +1 -0
- package/dist/commands/import/index.js +19 -0
- package/dist/commands/import/index.js.map +1 -0
- package/dist/commands/import/json.d.ts +40 -0
- package/dist/commands/import/json.d.ts.map +1 -0
- package/dist/commands/import/json.js +209 -0
- package/dist/commands/import/json.js.map +1 -0
- package/dist/commands/import/tree.d.ts +39 -0
- package/dist/commands/import/tree.d.ts.map +1 -0
- package/dist/commands/import/tree.js +247 -0
- package/dist/commands/import/tree.js.map +1 -0
- package/dist/commands/import/validate.d.ts +53 -0
- package/dist/commands/import/validate.d.ts.map +1 -0
- package/dist/commands/import/validate.js +201 -0
- package/dist/commands/import/validate.js.map +1 -0
- package/dist/commands/index.d.ts +21 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +21 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/commands/json-schema.d.ts +21 -0
- package/dist/commands/json-schema.d.ts.map +1 -0
- package/dist/commands/json-schema.js +41 -0
- package/dist/commands/json-schema.js.map +1 -0
- package/dist/commands/node/create.d.ts +80 -0
- package/dist/commands/node/create.d.ts.map +1 -0
- package/dist/commands/node/create.js +174 -0
- package/dist/commands/node/create.js.map +1 -0
- package/dist/commands/node/delete.d.ts +28 -0
- package/dist/commands/node/delete.d.ts.map +1 -0
- package/dist/commands/node/delete.js +134 -0
- package/dist/commands/node/delete.js.map +1 -0
- package/dist/commands/node/deprecation.d.ts +23 -0
- package/dist/commands/node/deprecation.d.ts.map +1 -0
- package/dist/commands/node/deprecation.js +59 -0
- package/dist/commands/node/deprecation.js.map +1 -0
- package/dist/commands/node/get.d.ts +79 -0
- package/dist/commands/node/get.d.ts.map +1 -0
- package/dist/commands/node/get.js +106 -0
- package/dist/commands/node/get.js.map +1 -0
- package/dist/commands/node/graph.d.ts +138 -0
- package/dist/commands/node/graph.d.ts.map +1 -0
- package/dist/commands/node/graph.js +285 -0
- package/dist/commands/node/graph.js.map +1 -0
- package/dist/commands/node/index.d.ts +17 -0
- package/dist/commands/node/index.d.ts.map +1 -0
- package/dist/commands/node/index.js +31 -0
- package/dist/commands/node/index.js.map +1 -0
- package/dist/commands/node/list.d.ts +74 -0
- package/dist/commands/node/list.d.ts.map +1 -0
- package/dist/commands/node/list.js +130 -0
- package/dist/commands/node/list.js.map +1 -0
- package/dist/commands/node/operations.d.ts +35 -0
- package/dist/commands/node/operations.d.ts.map +1 -0
- package/dist/commands/node/operations.js +66 -0
- package/dist/commands/node/operations.js.map +1 -0
- package/dist/commands/node/scope.d.ts +14 -0
- package/dist/commands/node/scope.d.ts.map +1 -0
- package/dist/commands/node/scope.js +49 -0
- package/dist/commands/node/scope.js.map +1 -0
- package/dist/commands/node/update.d.ts +84 -0
- package/dist/commands/node/update.d.ts.map +1 -0
- package/dist/commands/node/update.js +229 -0
- package/dist/commands/node/update.js.map +1 -0
- package/dist/commands/registry.d.ts +126 -0
- package/dist/commands/registry.d.ts.map +1 -0
- package/dist/commands/registry.js +141 -0
- package/dist/commands/registry.js.map +1 -0
- package/dist/commands/specimen/get.d.ts +47 -0
- package/dist/commands/specimen/get.d.ts.map +1 -0
- package/dist/commands/specimen/get.js +124 -0
- package/dist/commands/specimen/get.js.map +1 -0
- package/dist/commands/specimen/index.d.ts +10 -0
- package/dist/commands/specimen/index.d.ts.map +1 -0
- package/dist/commands/specimen/index.js +16 -0
- package/dist/commands/specimen/index.js.map +1 -0
- package/dist/commands/specimen/set.d.ts +31 -0
- package/dist/commands/specimen/set.d.ts.map +1 -0
- package/dist/commands/specimen/set.js +198 -0
- package/dist/commands/specimen/set.js.map +1 -0
- package/dist/commands/specimen/shared.d.ts +15 -0
- package/dist/commands/specimen/shared.d.ts.map +1 -0
- package/dist/commands/specimen/shared.js +26 -0
- package/dist/commands/specimen/shared.js.map +1 -0
- package/dist/commands/system/doctor.d.ts +48 -0
- package/dist/commands/system/doctor.d.ts.map +1 -0
- package/dist/commands/system/doctor.js +224 -0
- package/dist/commands/system/doctor.js.map +1 -0
- package/dist/commands/system/index.d.ts +12 -0
- package/dist/commands/system/index.d.ts.map +1 -0
- package/dist/commands/system/index.js +17 -0
- package/dist/commands/system/index.js.map +1 -0
- package/dist/commands/system/validate.d.ts +47 -0
- package/dist/commands/system/validate.d.ts.map +1 -0
- package/dist/commands/system/validate.js +245 -0
- package/dist/commands/system/validate.js.map +1 -0
- package/dist/commands/token/add.d.ts +94 -0
- package/dist/commands/token/add.d.ts.map +1 -0
- package/dist/commands/token/add.js +162 -0
- package/dist/commands/token/add.js.map +1 -0
- package/dist/commands/token/catalog.d.ts +69 -0
- package/dist/commands/token/catalog.d.ts.map +1 -0
- package/dist/commands/token/catalog.js +175 -0
- package/dist/commands/token/catalog.js.map +1 -0
- package/dist/commands/token/compare.d.ts +140 -0
- package/dist/commands/token/compare.d.ts.map +1 -0
- package/dist/commands/token/compare.js +207 -0
- package/dist/commands/token/compare.js.map +1 -0
- package/dist/commands/token/copy.d.ts +31 -0
- package/dist/commands/token/copy.d.ts.map +1 -0
- package/dist/commands/token/copy.js +179 -0
- package/dist/commands/token/copy.js.map +1 -0
- package/dist/commands/token/definitions.d.ts +29 -0
- package/dist/commands/token/definitions.d.ts.map +1 -0
- package/dist/commands/token/definitions.js +63 -0
- package/dist/commands/token/definitions.js.map +1 -0
- package/dist/commands/token/index.d.ts +22 -0
- package/dist/commands/token/index.d.ts.map +1 -0
- package/dist/commands/token/index.js +44 -0
- package/dist/commands/token/index.js.map +1 -0
- package/dist/commands/token/lineage.d.ts +43 -0
- package/dist/commands/token/lineage.d.ts.map +1 -0
- package/dist/commands/token/lineage.js +187 -0
- package/dist/commands/token/lineage.js.map +1 -0
- package/dist/commands/token/matrix.d.ts +249 -0
- package/dist/commands/token/matrix.d.ts.map +1 -0
- package/dist/commands/token/matrix.js +658 -0
- package/dist/commands/token/matrix.js.map +1 -0
- package/dist/commands/token/override.d.ts +51 -0
- package/dist/commands/token/override.d.ts.map +1 -0
- package/dist/commands/token/override.js +158 -0
- package/dist/commands/token/override.js.map +1 -0
- package/dist/commands/token/previous-value.d.ts +23 -0
- package/dist/commands/token/previous-value.d.ts.map +1 -0
- package/dist/commands/token/previous-value.js +26 -0
- package/dist/commands/token/previous-value.js.map +1 -0
- package/dist/commands/token/reset.d.ts +29 -0
- package/dist/commands/token/reset.d.ts.map +1 -0
- package/dist/commands/token/reset.js +143 -0
- package/dist/commands/token/reset.js.map +1 -0
- package/dist/commands/token/resolve.d.ts +43 -0
- package/dist/commands/token/resolve.d.ts.map +1 -0
- package/dist/commands/token/resolve.js +136 -0
- package/dist/commands/token/resolve.js.map +1 -0
- package/dist/commands/token/subtract.d.ts +27 -0
- package/dist/commands/token/subtract.d.ts.map +1 -0
- package/dist/commands/token/subtract.js +129 -0
- package/dist/commands/token/subtract.js.map +1 -0
- package/dist/commands/webhooks/delete.d.ts +31 -0
- package/dist/commands/webhooks/delete.d.ts.map +1 -0
- package/dist/commands/webhooks/delete.js +94 -0
- package/dist/commands/webhooks/delete.js.map +1 -0
- package/dist/commands/webhooks/get.d.ts +50 -0
- package/dist/commands/webhooks/get.d.ts.map +1 -0
- package/dist/commands/webhooks/get.js +122 -0
- package/dist/commands/webhooks/get.js.map +1 -0
- package/dist/commands/webhooks/index.d.ts +24 -0
- package/dist/commands/webhooks/index.d.ts.map +1 -0
- package/dist/commands/webhooks/index.js +41 -0
- package/dist/commands/webhooks/index.js.map +1 -0
- package/dist/commands/webhooks/list.d.ts +72 -0
- package/dist/commands/webhooks/list.d.ts.map +1 -0
- package/dist/commands/webhooks/list.js +116 -0
- package/dist/commands/webhooks/list.js.map +1 -0
- package/dist/commands/webhooks/logs.d.ts +65 -0
- package/dist/commands/webhooks/logs.d.ts.map +1 -0
- package/dist/commands/webhooks/logs.js +138 -0
- package/dist/commands/webhooks/logs.js.map +1 -0
- package/dist/commands/webhooks/redact.d.ts +18 -0
- package/dist/commands/webhooks/redact.d.ts.map +1 -0
- package/dist/commands/webhooks/redact.js +24 -0
- package/dist/commands/webhooks/redact.js.map +1 -0
- package/dist/commands/webhooks/register.d.ts +78 -0
- package/dist/commands/webhooks/register.d.ts.map +1 -0
- package/dist/commands/webhooks/register.js +175 -0
- package/dist/commands/webhooks/register.js.map +1 -0
- package/dist/commands/webhooks/test.d.ts +32 -0
- package/dist/commands/webhooks/test.d.ts.map +1 -0
- package/dist/commands/webhooks/test.js +101 -0
- package/dist/commands/webhooks/test.js.map +1 -0
- package/dist/commands/webhooks/update.d.ts +77 -0
- package/dist/commands/webhooks/update.d.ts.map +1 -0
- package/dist/commands/webhooks/update.js +198 -0
- package/dist/commands/webhooks/update.js.map +1 -0
- package/dist/css.d.ts +3 -0
- package/dist/css.d.ts.map +1 -0
- package/dist/css.js +3 -0
- package/dist/css.js.map +1 -0
- package/dist/demo/index.d.ts +8 -0
- package/dist/demo/index.d.ts.map +1 -0
- package/dist/demo/index.js +8 -0
- package/dist/demo/index.js.map +1 -0
- package/dist/demo/realistic-system.d.ts +54 -0
- package/dist/demo/realistic-system.d.ts.map +1 -0
- package/dist/demo/realistic-system.js +919 -0
- package/dist/demo/realistic-system.js.map +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +60 -0
- package/dist/index.js.map +1 -0
- package/dist/types/command-result.d.ts +10 -0
- package/dist/types/command-result.d.ts.map +1 -0
- package/dist/types/command-result.js +11 -0
- package/dist/types/command-result.js.map +1 -0
- package/dist/types/index.d.ts +8 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +10 -0
- package/dist/types/index.js.map +1 -0
- package/dist/version.d.ts +3 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +4 -0
- package/dist/version.js.map +1 -0
- package/dist/webhooks/dispatcher.d.ts +147 -0
- package/dist/webhooks/dispatcher.d.ts.map +1 -0
- package/dist/webhooks/dispatcher.js +420 -0
- package/dist/webhooks/dispatcher.js.map +1 -0
- package/dist/webhooks/index.d.ts +9 -0
- package/dist/webhooks/index.d.ts.map +1 -0
- package/dist/webhooks/index.js +9 -0
- package/dist/webhooks/index.js.map +1 -0
- package/dist/webhooks/signer.d.ts +119 -0
- package/dist/webhooks/signer.d.ts.map +1 -0
- package/dist/webhooks/signer.js +149 -0
- package/dist/webhooks/signer.js.map +1 -0
- package/dist/webhooks/url-policy.d.ts +73 -0
- package/dist/webhooks/url-policy.d.ts.map +1 -0
- package/dist/webhooks/url-policy.js +250 -0
- package/dist/webhooks/url-policy.js.map +1 -0
- package/dist/worker.d.ts +11 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/worker.js +31 -0
- package/dist/worker.js.map +1 -0
- 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"}
|