@tagma/trigger-webhook 0.1.4 → 0.2.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 (5) hide show
  1. package/dist/index.d.ts.map +1 -1
  2. package/dist/index.js +11 -3
  3. package/dist/index.js.map +1 -1
  4. package/package.json +2 -2
  5. package/src/index.ts +288 -280
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,cAAc,CAAC;AAkIlE,QAAA,MAAM,cAAc,EAAE,aAwHrB,CAAC;AAGF,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAe,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,cAAc,CAAC;AA0IlE,QAAA,MAAM,cAAc,EAAE,aAwHrB,CAAC;AAGF,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAe,cAAc,CAAC"}
package/dist/index.js CHANGED
@@ -99,15 +99,23 @@ function ensureServer(port, path, secretEnv, hostname) {
99
99
  }
100
100
  }
101
101
  // Decode JSON if possible so downstream tasks get structured data.
102
- // Falls back to the raw string body otherwise.
102
+ //
103
+ // D22: when the sender explicitly declared `application/json`, a parse
104
+ // failure is a contract violation — silently falling through to the
105
+ // raw-string payload meant downstream tasks that did `payload.field`
106
+ // crashed later with "Cannot read properties of undefined", far away
107
+ // from the actual cause. Return 400 so the sender sees the problem
108
+ // up front. Bodies without a JSON content-type still pass through
109
+ // untouched, which preserves the "any POST body" escape hatch.
103
110
  let payload = rawBody;
104
111
  const contentType = req.headers.get('content-type') ?? '';
105
112
  if (contentType.includes('application/json')) {
106
113
  try {
107
114
  payload = JSON.parse(rawBody);
108
115
  }
109
- catch {
110
- /* keep raw body */
116
+ catch (err) {
117
+ const msg = err instanceof Error ? err.message : String(err);
118
+ return new Response(`invalid JSON body: ${msg}`, { status: 400 });
111
119
  }
112
120
  }
113
121
  const waiter = state.waiters.shift();
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tagma/trigger-webhook",
3
- "version": "0.1.4",
3
+ "version": "0.2.0",
4
4
  "description": "HTTP webhook trigger plugin for tagma-sdk pipelines",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -48,7 +48,7 @@
48
48
  "prepublishOnly": "bun run build"
49
49
  },
50
50
  "peerDependencies": {
51
- "@tagma/types": "0.2.7"
51
+ "@tagma/types": "0.4.0"
52
52
  },
53
53
  "devDependencies": {
54
54
  "bun-types": "^1.3.11",
package/src/index.ts CHANGED
@@ -1,280 +1,288 @@
1
- // ═══ Webhook Trigger Plugin ═══
2
- //
3
- // Spins up a Bun.serve HTTP listener and resolves the trigger when a POST
4
- // arrives on the configured path. Optional HMAC-SHA256 validation via the
5
- // `x-tagma-signature: sha256=<hex>` header protects against unauthenticated
6
- // callers when the secret env var is set.
7
- //
8
- // Multiple tasks sharing the same `(port, path)` pair hit the same listener
9
- // instance and are enqueued as waiters — the next inbound request wakes one
10
- // waiter (FIFO). This keeps the plugin lightweight even when a pipeline has
11
- // many webhook-triggered tasks.
12
- //
13
- // Usage in pipeline.yaml:
14
- // plugins: ["@tagma/trigger-webhook"]
15
- // tracks:
16
- // - tasks:
17
- // - id: deploy
18
- // trigger:
19
- // type: webhook
20
- // port: 8787
21
- // path: /hooks/deploy
22
- // secret_env: TAGMA_WEBHOOK_SECRET
23
- // timeout: 10m
24
-
25
- import type { TriggerPlugin, TriggerContext } from '@tagma/types';
26
- import { createHmac, timingSafeEqual } from 'node:crypto';
27
-
28
- type Resolver = (payload: unknown) => void;
29
-
30
- interface WebhookServerState {
31
- readonly port: number;
32
- readonly path: string;
33
- readonly secretEnv: string | undefined;
34
- readonly waiters: Resolver[];
35
- }
36
-
37
- // Module-level so concurrent tasks on the same (port, path) share one
38
- // listener. Bun.serve refuses to bind a port twice, so this sharing is
39
- // required — not just an optimization.
40
- const servers = new Map<string, WebhookServerState>();
41
-
42
- function serverKey(port: number, path: string, hostname: string): string {
43
- return `${hostname}::${port}::${path}`;
44
- }
45
-
46
- const DEFAULT_WEBHOOK_HOST = '127.0.0.1';
47
-
48
- function parseDurationSafe(raw: unknown, fallback: number): number {
49
- if (raw == null) return fallback;
50
- const str = String(raw).trim();
51
- const m = str.match(/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/);
52
- if (!m) return fallback;
53
- const n = Number(m[1]);
54
- switch (m[2]) {
55
- case 'ms':
56
- return n;
57
- case 'm':
58
- return n * 60_000;
59
- case 'h':
60
- return n * 3_600_000;
61
- case 's':
62
- default:
63
- return n * 1000;
64
- }
65
- }
66
-
67
- function verifySignature(rawBody: string, header: string, secret: string): boolean {
68
- const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
69
- const a = Buffer.from(header);
70
- const b = Buffer.from(expected);
71
- if (a.length !== b.length) return false;
72
- return timingSafeEqual(a, b);
73
- }
74
-
75
- function ensureServer(
76
- port: number,
77
- path: string,
78
- secretEnv: string | undefined,
79
- hostname: string,
80
- ): WebhookServerState {
81
- const key = serverKey(port, path, hostname);
82
- const existing = servers.get(key);
83
- if (existing) return existing;
84
-
85
- const state: WebhookServerState = {
86
- port,
87
- path,
88
- secretEnv,
89
- waiters: [],
90
- };
91
-
92
- Bun.serve({
93
- port,
94
- // Default to loopback so the webhook endpoint is not reachable from the
95
- // LAN unless the user explicitly sets `host` in their YAML (e.g. for
96
- // container/WSL scenarios). Without this, Bun.serve listens on all
97
- // interfaces and a secret-less webhook would accept traffic from any
98
- // network-adjacent caller.
99
- hostname,
100
- async fetch(req) {
101
- const url = new URL(req.url);
102
- if (url.pathname !== path) {
103
- return new Response('not found', { status: 404 });
104
- }
105
- if (req.method !== 'POST') {
106
- return new Response('method not allowed', { status: 405 });
107
- }
108
-
109
- const rawBody = await req.text();
110
-
111
- // HMAC gate — bypassed when no secret env is configured, which is
112
- // acceptable for loopback dev but should always be set in production.
113
- const secret = state.secretEnv ? process.env[state.secretEnv] : undefined;
114
- if (state.secretEnv) {
115
- if (!secret) {
116
- return new Response(`env var ${state.secretEnv} not set`, { status: 500 });
117
- }
118
- const sigHeader = req.headers.get('x-tagma-signature') ?? '';
119
- if (!verifySignature(rawBody, sigHeader, secret)) {
120
- return new Response('invalid signature', { status: 401 });
121
- }
122
- }
123
-
124
- // Decode JSON if possible so downstream tasks get structured data.
125
- // Falls back to the raw string body otherwise.
126
- let payload: unknown = rawBody;
127
- const contentType = req.headers.get('content-type') ?? '';
128
- if (contentType.includes('application/json')) {
129
- try {
130
- payload = JSON.parse(rawBody);
131
- } catch {
132
- /* keep raw body */
133
- }
134
- }
135
-
136
- const waiter = state.waiters.shift();
137
- if (waiter) {
138
- waiter(payload);
139
- return new Response('ok', { status: 202 });
140
- }
141
- // No task is currently waiting on this endpoint — reject loudly so
142
- // callers know the webhook wasn't actually consumed by a pipeline.
143
- return new Response('no waiting task', { status: 409 });
144
- },
145
- error(err) {
146
- console.error(`[webhook] server error on :${port}${path}:`, err);
147
- return new Response('internal error', { status: 500 });
148
- },
149
- });
150
-
151
- servers.set(key, state);
152
- return state;
153
- }
154
-
155
- const WebhookTrigger: TriggerPlugin = {
156
- name: 'webhook',
157
- schema: {
158
- description: 'Wait for an HTTP POST to arrive on a local listener before the task runs.',
159
- fields: {
160
- port: {
161
- type: 'number',
162
- required: true,
163
- default: 8787,
164
- min: 1,
165
- max: 65535,
166
- description: 'TCP port to listen on.',
167
- placeholder: '8787',
168
- },
169
- path: {
170
- type: 'string',
171
- required: true,
172
- default: '/webhook',
173
- description: 'URL path to match (e.g. /hooks/deploy).',
174
- placeholder: '/webhook',
175
- },
176
- secret_env: {
177
- type: 'string',
178
- description:
179
- 'Env var containing the HMAC-SHA256 secret. When set, POSTs must include an x-tagma-signature: sha256=<hex> header computed over the raw body.',
180
- placeholder: 'TAGMA_WEBHOOK_SECRET',
181
- },
182
- host: {
183
- type: 'string',
184
- default: DEFAULT_WEBHOOK_HOST,
185
- description:
186
- 'Interface to bind on. Defaults to 127.0.0.1 so the webhook is only reachable from the local machine. Set to 0.0.0.0 to accept LAN traffic (only do this when secret_env is also set).',
187
- placeholder: DEFAULT_WEBHOOK_HOST,
188
- },
189
- timeout: {
190
- type: 'duration',
191
- description: 'Maximum wait time (e.g. 10m). Omit or 0 to wait indefinitely.',
192
- placeholder: '10m',
193
- },
194
- },
195
- },
196
-
197
- watch(config: Record<string, unknown>, ctx: TriggerContext): Promise<unknown> {
198
- const rawPort = config.port;
199
- const port = typeof rawPort === 'number' ? rawPort : Number(rawPort);
200
- if (!Number.isFinite(port) || port < 1 || port > 65535) {
201
- throw new Error(`webhook trigger: "port" must be 1-65535, got ${String(rawPort)}`);
202
- }
203
-
204
- const path = (config.path as string | undefined) ?? '/webhook';
205
- if (!path.startsWith('/')) {
206
- throw new Error(`webhook trigger: "path" must start with "/", got ${path}`);
207
- }
208
-
209
- const secretEnv = config.secret_env as string | undefined;
210
- const rawHost = config.host;
211
- const hostname =
212
- typeof rawHost === 'string' && rawHost.trim().length > 0
213
- ? rawHost.trim()
214
- : DEFAULT_WEBHOOK_HOST;
215
- const timeoutMs = config.timeout != null ? parseDurationSafe(config.timeout, 0) : 0;
216
-
217
- if (hostname !== DEFAULT_WEBHOOK_HOST && hostname !== 'localhost' && !secretEnv) {
218
- // Loud warning — the user has opted into a non-loopback bind without
219
- // HMAC. Refuse by default rather than silently expose the endpoint to
220
- // the network.
221
- throw new Error(
222
- `webhook trigger: binding to "${hostname}" without secret_env is refused — set secret_env to enable HMAC authentication before exposing to non-loopback interfaces`,
223
- );
224
- }
225
-
226
- const state = ensureServer(port, path, secretEnv, hostname);
227
-
228
- return new Promise<unknown>((resolvePromise, rejectPromise) => {
229
- if (ctx.signal.aborted) {
230
- rejectPromise(new Error('Pipeline aborted'));
231
- return;
232
- }
233
-
234
- let settled = false;
235
- let timer: ReturnType<typeof setTimeout> | null = null;
236
-
237
- const onFire: Resolver = (payload) => {
238
- if (settled) return;
239
- settled = true;
240
- cleanup();
241
- resolvePromise(payload);
242
- };
243
-
244
- const onAbort = (): void => {
245
- if (settled) return;
246
- settled = true;
247
- cleanup();
248
- rejectPromise(new Error('Pipeline aborted'));
249
- };
250
-
251
- const cleanup = (): void => {
252
- if (timer) clearTimeout(timer);
253
- ctx.signal.removeEventListener('abort', onAbort);
254
- const idx = state.waiters.indexOf(onFire);
255
- if (idx !== -1) state.waiters.splice(idx, 1);
256
- };
257
-
258
- state.waiters.push(onFire);
259
- ctx.signal.addEventListener('abort', onAbort, { once: true });
260
-
261
- if (timeoutMs > 0) {
262
- timer = setTimeout(() => {
263
- if (settled) return;
264
- settled = true;
265
- cleanup();
266
- rejectPromise(
267
- new Error(
268
- `webhook trigger timeout: no POST on :${port}${path} within ${String(config.timeout)}`,
269
- ),
270
- );
271
- }, timeoutMs);
272
- }
273
- });
274
- },
275
- };
276
-
277
- // ═══ Plugin self-description exports ═══
278
- export const pluginCategory = 'triggers';
279
- export const pluginType = 'webhook';
280
- export default WebhookTrigger;
1
+ // ═══ Webhook Trigger Plugin ═══
2
+ //
3
+ // Spins up a Bun.serve HTTP listener and resolves the trigger when a POST
4
+ // arrives on the configured path. Optional HMAC-SHA256 validation via the
5
+ // `x-tagma-signature: sha256=<hex>` header protects against unauthenticated
6
+ // callers when the secret env var is set.
7
+ //
8
+ // Multiple tasks sharing the same `(port, path)` pair hit the same listener
9
+ // instance and are enqueued as waiters — the next inbound request wakes one
10
+ // waiter (FIFO). This keeps the plugin lightweight even when a pipeline has
11
+ // many webhook-triggered tasks.
12
+ //
13
+ // Usage in pipeline.yaml:
14
+ // plugins: ["@tagma/trigger-webhook"]
15
+ // tracks:
16
+ // - tasks:
17
+ // - id: deploy
18
+ // trigger:
19
+ // type: webhook
20
+ // port: 8787
21
+ // path: /hooks/deploy
22
+ // secret_env: TAGMA_WEBHOOK_SECRET
23
+ // timeout: 10m
24
+
25
+ import type { TriggerPlugin, TriggerContext } from '@tagma/types';
26
+ import { createHmac, timingSafeEqual } from 'node:crypto';
27
+
28
+ type Resolver = (payload: unknown) => void;
29
+
30
+ interface WebhookServerState {
31
+ readonly port: number;
32
+ readonly path: string;
33
+ readonly secretEnv: string | undefined;
34
+ readonly waiters: Resolver[];
35
+ }
36
+
37
+ // Module-level so concurrent tasks on the same (port, path) share one
38
+ // listener. Bun.serve refuses to bind a port twice, so this sharing is
39
+ // required — not just an optimization.
40
+ const servers = new Map<string, WebhookServerState>();
41
+
42
+ function serverKey(port: number, path: string, hostname: string): string {
43
+ return `${hostname}::${port}::${path}`;
44
+ }
45
+
46
+ const DEFAULT_WEBHOOK_HOST = '127.0.0.1';
47
+
48
+ function parseDurationSafe(raw: unknown, fallback: number): number {
49
+ if (raw == null) return fallback;
50
+ const str = String(raw).trim();
51
+ const m = str.match(/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/);
52
+ if (!m) return fallback;
53
+ const n = Number(m[1]);
54
+ switch (m[2]) {
55
+ case 'ms':
56
+ return n;
57
+ case 'm':
58
+ return n * 60_000;
59
+ case 'h':
60
+ return n * 3_600_000;
61
+ case 's':
62
+ default:
63
+ return n * 1000;
64
+ }
65
+ }
66
+
67
+ function verifySignature(rawBody: string, header: string, secret: string): boolean {
68
+ const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
69
+ const a = Buffer.from(header);
70
+ const b = Buffer.from(expected);
71
+ if (a.length !== b.length) return false;
72
+ return timingSafeEqual(a, b);
73
+ }
74
+
75
+ function ensureServer(
76
+ port: number,
77
+ path: string,
78
+ secretEnv: string | undefined,
79
+ hostname: string,
80
+ ): WebhookServerState {
81
+ const key = serverKey(port, path, hostname);
82
+ const existing = servers.get(key);
83
+ if (existing) return existing;
84
+
85
+ const state: WebhookServerState = {
86
+ port,
87
+ path,
88
+ secretEnv,
89
+ waiters: [],
90
+ };
91
+
92
+ Bun.serve({
93
+ port,
94
+ // Default to loopback so the webhook endpoint is not reachable from the
95
+ // LAN unless the user explicitly sets `host` in their YAML (e.g. for
96
+ // container/WSL scenarios). Without this, Bun.serve listens on all
97
+ // interfaces and a secret-less webhook would accept traffic from any
98
+ // network-adjacent caller.
99
+ hostname,
100
+ async fetch(req) {
101
+ const url = new URL(req.url);
102
+ if (url.pathname !== path) {
103
+ return new Response('not found', { status: 404 });
104
+ }
105
+ if (req.method !== 'POST') {
106
+ return new Response('method not allowed', { status: 405 });
107
+ }
108
+
109
+ const rawBody = await req.text();
110
+
111
+ // HMAC gate — bypassed when no secret env is configured, which is
112
+ // acceptable for loopback dev but should always be set in production.
113
+ const secret = state.secretEnv ? process.env[state.secretEnv] : undefined;
114
+ if (state.secretEnv) {
115
+ if (!secret) {
116
+ return new Response(`env var ${state.secretEnv} not set`, { status: 500 });
117
+ }
118
+ const sigHeader = req.headers.get('x-tagma-signature') ?? '';
119
+ if (!verifySignature(rawBody, sigHeader, secret)) {
120
+ return new Response('invalid signature', { status: 401 });
121
+ }
122
+ }
123
+
124
+ // Decode JSON if possible so downstream tasks get structured data.
125
+ //
126
+ // D22: when the sender explicitly declared `application/json`, a parse
127
+ // failure is a contract violation — silently falling through to the
128
+ // raw-string payload meant downstream tasks that did `payload.field`
129
+ // crashed later with "Cannot read properties of undefined", far away
130
+ // from the actual cause. Return 400 so the sender sees the problem
131
+ // up front. Bodies without a JSON content-type still pass through
132
+ // untouched, which preserves the "any POST body" escape hatch.
133
+ let payload: unknown = rawBody;
134
+ const contentType = req.headers.get('content-type') ?? '';
135
+ if (contentType.includes('application/json')) {
136
+ try {
137
+ payload = JSON.parse(rawBody);
138
+ } catch (err) {
139
+ const msg = err instanceof Error ? err.message : String(err);
140
+ return new Response(`invalid JSON body: ${msg}`, { status: 400 });
141
+ }
142
+ }
143
+
144
+ const waiter = state.waiters.shift();
145
+ if (waiter) {
146
+ waiter(payload);
147
+ return new Response('ok', { status: 202 });
148
+ }
149
+ // No task is currently waiting on this endpoint — reject loudly so
150
+ // callers know the webhook wasn't actually consumed by a pipeline.
151
+ return new Response('no waiting task', { status: 409 });
152
+ },
153
+ error(err) {
154
+ console.error(`[webhook] server error on :${port}${path}:`, err);
155
+ return new Response('internal error', { status: 500 });
156
+ },
157
+ });
158
+
159
+ servers.set(key, state);
160
+ return state;
161
+ }
162
+
163
+ const WebhookTrigger: TriggerPlugin = {
164
+ name: 'webhook',
165
+ schema: {
166
+ description: 'Wait for an HTTP POST to arrive on a local listener before the task runs.',
167
+ fields: {
168
+ port: {
169
+ type: 'number',
170
+ required: true,
171
+ default: 8787,
172
+ min: 1,
173
+ max: 65535,
174
+ description: 'TCP port to listen on.',
175
+ placeholder: '8787',
176
+ },
177
+ path: {
178
+ type: 'string',
179
+ required: true,
180
+ default: '/webhook',
181
+ description: 'URL path to match (e.g. /hooks/deploy).',
182
+ placeholder: '/webhook',
183
+ },
184
+ secret_env: {
185
+ type: 'string',
186
+ description:
187
+ 'Env var containing the HMAC-SHA256 secret. When set, POSTs must include an x-tagma-signature: sha256=<hex> header computed over the raw body.',
188
+ placeholder: 'TAGMA_WEBHOOK_SECRET',
189
+ },
190
+ host: {
191
+ type: 'string',
192
+ default: DEFAULT_WEBHOOK_HOST,
193
+ description:
194
+ 'Interface to bind on. Defaults to 127.0.0.1 so the webhook is only reachable from the local machine. Set to 0.0.0.0 to accept LAN traffic (only do this when secret_env is also set).',
195
+ placeholder: DEFAULT_WEBHOOK_HOST,
196
+ },
197
+ timeout: {
198
+ type: 'duration',
199
+ description: 'Maximum wait time (e.g. 10m). Omit or 0 to wait indefinitely.',
200
+ placeholder: '10m',
201
+ },
202
+ },
203
+ },
204
+
205
+ watch(config: Record<string, unknown>, ctx: TriggerContext): Promise<unknown> {
206
+ const rawPort = config.port;
207
+ const port = typeof rawPort === 'number' ? rawPort : Number(rawPort);
208
+ if (!Number.isFinite(port) || port < 1 || port > 65535) {
209
+ throw new Error(`webhook trigger: "port" must be 1-65535, got ${String(rawPort)}`);
210
+ }
211
+
212
+ const path = (config.path as string | undefined) ?? '/webhook';
213
+ if (!path.startsWith('/')) {
214
+ throw new Error(`webhook trigger: "path" must start with "/", got ${path}`);
215
+ }
216
+
217
+ const secretEnv = config.secret_env as string | undefined;
218
+ const rawHost = config.host;
219
+ const hostname =
220
+ typeof rawHost === 'string' && rawHost.trim().length > 0
221
+ ? rawHost.trim()
222
+ : DEFAULT_WEBHOOK_HOST;
223
+ const timeoutMs = config.timeout != null ? parseDurationSafe(config.timeout, 0) : 0;
224
+
225
+ if (hostname !== DEFAULT_WEBHOOK_HOST && hostname !== 'localhost' && !secretEnv) {
226
+ // Loud warning — the user has opted into a non-loopback bind without
227
+ // HMAC. Refuse by default rather than silently expose the endpoint to
228
+ // the network.
229
+ throw new Error(
230
+ `webhook trigger: binding to "${hostname}" without secret_env is refused — set secret_env to enable HMAC authentication before exposing to non-loopback interfaces`,
231
+ );
232
+ }
233
+
234
+ const state = ensureServer(port, path, secretEnv, hostname);
235
+
236
+ return new Promise<unknown>((resolvePromise, rejectPromise) => {
237
+ if (ctx.signal.aborted) {
238
+ rejectPromise(new Error('Pipeline aborted'));
239
+ return;
240
+ }
241
+
242
+ let settled = false;
243
+ let timer: ReturnType<typeof setTimeout> | null = null;
244
+
245
+ const onFire: Resolver = (payload) => {
246
+ if (settled) return;
247
+ settled = true;
248
+ cleanup();
249
+ resolvePromise(payload);
250
+ };
251
+
252
+ const onAbort = (): void => {
253
+ if (settled) return;
254
+ settled = true;
255
+ cleanup();
256
+ rejectPromise(new Error('Pipeline aborted'));
257
+ };
258
+
259
+ const cleanup = (): void => {
260
+ if (timer) clearTimeout(timer);
261
+ ctx.signal.removeEventListener('abort', onAbort);
262
+ const idx = state.waiters.indexOf(onFire);
263
+ if (idx !== -1) state.waiters.splice(idx, 1);
264
+ };
265
+
266
+ state.waiters.push(onFire);
267
+ ctx.signal.addEventListener('abort', onAbort, { once: true });
268
+
269
+ if (timeoutMs > 0) {
270
+ timer = setTimeout(() => {
271
+ if (settled) return;
272
+ settled = true;
273
+ cleanup();
274
+ rejectPromise(
275
+ new Error(
276
+ `webhook trigger timeout: no POST on :${port}${path} within ${String(config.timeout)}`,
277
+ ),
278
+ );
279
+ }, timeoutMs);
280
+ }
281
+ });
282
+ },
283
+ };
284
+
285
+ // ═══ Plugin self-description exports ═══
286
+ export const pluginCategory = 'triggers';
287
+ export const pluginType = 'webhook';
288
+ export default WebhookTrigger;