Repository navigation
Expand file tree
/
Copy pathwebhook.html
More file actions
1709 lines (1599 loc) · 83 KB
/
Copy pathwebhook.html
File metadata and controls
1709 lines (1599 loc) · 83 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<!-- @su:responder-script
// =============================================================================
// RESPONDER SCRIPT - paired with webhook.html, auto-deployed to the responder's
// `script` setting by dev/tools/deploy.ts. This HTML comment is stripped from
// the served body by html-minifier-terser (`removeComments: true`).
// See dev/tools/guides/platform.md -> "Responder Script (`@su:responder-script`)".
//
// The responder is mounted as a PREFIX responder and plays three roles, keyed
// off the request shape so a third-party caller (the thing being inspected) and
// the inspector UI never collide:
//
// 1. CAPTURE ANY <mount>/<token> (a path segment after the mount)
// Seals the incoming request against the token's registered public key
// and appends it to the per-token KV log. The server only ever stores
// ciphertext - it cannot read what it captured (end-to-end encrypted).
// 2. MANAGEMENT GET/PUT/DELETE <mount>?t=<token> (bare mount + ?t=)
// GET -> list (or, with &live=1, long-poll watch) sealed records.
// PUT -> register the recipient public key (first-writer-wins).
// DELETE -> purge the token's records (and, once drained, its key).
// 3. CONFIGURATOR GET <mount> (no token anywhere)
// Returns null so the static inspector HTML body is served.
//
// KV + crypto primitives come from the sandbox-injected `globalThis.secutils`
// (see src/js_runtime/op_responder_kv.rs and op_crypto_seal.rs). Binary values
// cross the boundary as base64url strings.
//
// -----------------------------------------------------------------------------
// TESTING THE EXPIRED TAKE-OVER (handy reference)
// -----------------------------------------------------------------------------
// The inspector loads its session entirely from the URL `#fragment`, which is
// `uint32-LE(jsonByteLen) | rawDEFLATE(JSON)` then base64url (unpadded). The
// bootstrap only needs truthy `t`, `k`, `p` plus an `exp` (unix seconds) in the
// PAST to immediately render the "This webhook has expired" card - it returns
// before any crypto/network, so placeholder `k`/`p` are fine. Note: opening such
// a link writes the demo entry into localStorage (`webhook.sessions`); the
// "Remove from list" button on the expired card evicts it again.
//
// Re-generate (the 4-byte length prefix is written but ignored on decode):
// python3 - <<'PY'
// import json, zlib, struct, base64, time
// exp = int(time.time()) - 86400 # 24h in the past -> always expired
// s = {"t":"ExpiredDemo01","k":{"kty":"EC","crv":"P-256","d":"demo","x":"demo",
// "y":"demo","key_ops":["deriveBits"],"ext":True},
// "p":"BDemoPublicKeyPlaceholderxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
// "l":"Expired webhook demo","d":"Demo of the expired-webhook take-over screen.",
// "createdAt":(exp-7*86400)*1000,"exp":exp,
// "m":{"s":200,"h":[["Content-Type","application/json; charset=utf-8"]],"b":"{\"ok\":true}"}}
// raw = json.dumps(s, separators=(",",":")).encode()
// co = zlib.compressobj(9, zlib.DEFLATED, -zlib.MAX_WBITS)
// out = struct.pack("<I", len(raw)) + co.compress(raw) + co.flush()
// print("https://tools.secutils.dev/webhook#" + base64.urlsafe_b64encode(out).decode().rstrip("="))
// PY
//
// Example link (static `exp` in the past, so it renders expired forever):
// https://tools.secutils.dev/webhook#pgEAAJ1Qy07DMBD8FWvPCTgV5IU40MKJSw7c2grlsVWC09hyNiFRlH9nDUW916fZ3fHOzC5AkMLbZBqL1SuetQzAAwXpAopmN9pxXdqRYeZvHkOuKsYVUxlOVzhfocL5U5se0j13bDPitqEejh7gxGpkB1w9MMzfOsVsKNqmfMc5a_MSa93yn-nGx-LtNY_4xqLWWomLL2fcKQp9ElSjwD-a_0-jXKGvR7SiLy1id_cbHXPC6oWNB1GUPCRhnERSShfGuF4sAxmESeTB2V2NU2_ctOb0e9jpjrAj_2M2yMtyYzhqTo3u7r963T2Jss5tj_Q80MmP4cg3KtjkcgCtDpdTwbr-AA
// =============================================================================
(() => {
// The webhook's default absolute lifetime. The key is written with this TTL, so its
// birth-anchored deadline is owned by the responder script and the whole webhook (key,
// config, requests) disappears together after this window - even when the server-side
// `responder_kv_max_lifespan_sec` backstop is disabled (its default). When that backstop
// *is* enabled it only clamps the deadline shorter; it can never extend it.
const LIFESPAN_FALLBACK_SEC = 604800; // 7 days.
const PAGE_LIMIT = 200;
// Long-poll window. Kept short so a watch that ever outlives its client (e.g. an abrupt
// kill the client can't intercept) parks a server-side V8 isolate for at most this long
// before the worker is reclaimed. The client also aborts proactively on hide/close.
const WATCH_TIMEOUT_MS = 15000;
// Remaining seconds until the webhook's absolute deadline (`exp`, unix seconds),
// so dependent writes never outlive the key. Floors at 1s so a near-deadline
// write still lands rather than being rejected as a zero/negative TTL.
const ttlForDeadline = (exp) => (exp ? Math.max(1, exp - Math.floor(Date.now() / 1000)) : LIFESPAN_FALLBACK_SEC);
const TOKEN_RE = /^[A-Za-z0-9_-]{8,64}$/;
const PUBKEY_RE = /^[A-Za-z0-9_-]{80,200}$/;
const MOCK_MAX_HEADERS = 20;
const MOCK_MAX_BODY = 64 * 1024; // 64 KiB plaintext response body.
// Normalise + clamp a user-authored mock-response config to the on-disk shape
// `{ s, h, b }` (status, header pairs, body). Mirrors echo.html's wire format so
// a config built there is interchangeable here.
const normalizeMock = (m) => {
const s = Number.isInteger(m && m.s) && m.s >= 100 && m.s <= 599 ? m.s : 200;
const h = [];
if (m && Array.isArray(m.h)) {
for (const pair of m.h.slice(0, MOCK_MAX_HEADERS)) {
if (Array.isArray(pair) && pair[0]) {
h.push([String(pair[0]).slice(0, 256), String(pair[1] ?? '').slice(0, 1024)]);
}
}
}
let b = m && typeof m.b === 'string' ? m.b : '';
if (b.length > MOCK_MAX_BODY) b = b.slice(0, MOCK_MAX_BODY);
return { s, h, b };
};
const method = (context.method || 'GET').toUpperCase();
const path = context.path || '';
const query = context.query || {};
const parts = path.split('/').filter(Boolean);
const cors = {
'Access-Control-Allow-Origin': '*',
'Access-Control-Allow-Methods': 'GET, PUT, DELETE, POST, OPTIONS',
'Access-Control-Allow-Headers': '*',
};
// Every non-null response sets `skipRequest: true` so the responder's request history never
// records captures (plaintext headers, body, client IP) or inspector polls, even if the
// responder's `requestsToTrack` setting drifts above 0.
const json = (statusCode, obj) => ({
statusCode,
headers: Object.assign({ 'Content-Type': 'application/json; charset=utf-8' }, cors),
body: JSON.stringify(obj),
skipRequest: true,
});
const notFound = () => ({
statusCode: 404,
headers: { 'Content-Type': 'text/plain; charset=utf-8' },
body: 'Not found',
skipRequest: true,
});
if (method === 'OPTIONS') {
return { statusCode: 204, headers: cors, body: '', skipRequest: true };
}
// base64url encoder for raw bytes (the Deno sandbox has no btoa).
const B = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
const b64url = (bytes) => {
let out = '';
const len = bytes.length;
for (let i = 0; i < len; i += 3) {
const a = bytes[i];
const b = i + 1 < len ? bytes[i + 1] : undefined;
const c = i + 2 < len ? bytes[i + 2] : undefined;
out += B[a >> 2];
out += B[((a & 3) << 4) | ((b ?? 0) >> 4)];
if (b === undefined) break;
out += B[((b & 15) << 2) | ((c ?? 0) >> 6)];
if (c === undefined) break;
out += B[c & 63];
}
return out;
};
// Inverse of `b64url`: decode an unpadded base64url string back to bytes.
const fromB64url = (str) => {
const out = [];
for (let i = 0; i < str.length; i += 4) {
const a = B.indexOf(str[i]);
const b = B.indexOf(str[i + 1]);
const c = B.indexOf(str[i + 2]);
const d = B.indexOf(str[i + 3]);
out.push((a << 2) | (b >> 4));
if (c >= 0) out.push(((b & 15) << 4) | (c >> 2));
if (d >= 0) out.push(((c & 3) << 6) | d);
}
return new Uint8Array(out);
};
// -------------------------------------------------------------------------
// 1. CAPTURE: a path segment after the mount means "inspect this request".
// -------------------------------------------------------------------------
if (parts.length >= 2) {
const token = parts[parts.length - 1];
if (!TOKEN_RE.test(token)) return notFound();
return (async () => {
// Read the key together with its expiry so the captured request inherits the
// webhook's birth-anchored deadline (everything expires together).
const pkEntry = await secutils.kv.getEntry('pk/' + token);
const pub = pkEntry && pkEntry.value;
// No registered (live) key => the token was never initialised, or the webhook
// already expired and was swept; indistinguishable from an unknown one by design.
if (!pub) return notFound();
const exp = pkEntry.expiresAt;
const record = {
at: Date.now(),
method,
path,
query: context.rawQuery || '',
headers: context.headers || {},
clientAddress: context.clientAddress || null,
bodyB64: b64url(context.body),
};
let sealed;
try {
sealed = await secutils.crypto.seal(pub, JSON.stringify(record));
} catch (_e) {
return json(500, { ok: false, reason: 'seal-failed' });
}
// Time-ordered key: zero-padded epoch ms + random tiebreak. The KV `key`
// column is COLLATE "C", so lexicographic order == chronological order.
const ts = String(record.at).padStart(15, '0');
const rnd = Math.random().toString(36).slice(2, 10).padEnd(8, '0');
const key = 'req/' + token + '/' + ts + '-' + rnd;
try {
await secutils.kv.set(key, sealed, { ttlSec: ttlForDeadline(exp) });
} catch (_e) {
// Quota exhausted (per-tier entry/byte cap). Keep the caller happy; the
// inspector simply won't see this record until TTL frees capacity.
return json(200, { ok: false, reason: 'full' });
}
// Reply with the visitor's configured mock response when present; otherwise
// a friendly default 200. The config is plaintext (the server has no private
// key) - only the captured request itself is sealed above.
const cfgRaw = await secutils.kv.get('cfg/' + token);
if (cfgRaw) {
try {
// KV values are stored as base64url bytes; cfg is base64url(JSON).
const cfg = normalizeMock(JSON.parse(Deno.core.decode(fromB64url(cfgRaw))));
const headers = {};
for (const pair of cfg.h) headers[pair[0]] = pair[1];
if (!Object.keys(headers).some((h) => h.toLowerCase() === 'content-type')) {
headers['Content-Type'] = 'text/plain; charset=utf-8';
}
return { statusCode: cfg.s, headers, body: cfg.b, skipRequest: true };
} catch (_e) {
// Corrupt config - fall back to the default OK below.
}
}
return json(200, { ok: true });
})();
}
// -------------------------------------------------------------------------
// 2. MANAGEMENT: bare mount + ?t=<token>. Token is a bearer capability for
// the (still encrypted) log; only the private-key holder can read it.
// -------------------------------------------------------------------------
const token = query.t;
if (token) {
if (!TOKEN_RE.test(token)) return json(400, { error: 'invalid token' });
const reqPrefix = 'req/' + token + '/';
if (method === 'PUT' || method === 'POST') {
let pub = '';
// `mock`: undefined = leave config unchanged, null = delete it, object = set it.
let mock;
const body = context.body;
if (body.length) {
const raw = Deno.core.decode(body).trim();
if (raw.startsWith('{')) {
try {
const parsed = JSON.parse(raw);
pub = String(parsed.pk || '');
if (Object.prototype.hasOwnProperty.call(parsed, 'mock')) {
mock = parsed.mock === null ? null : (parsed.mock && typeof parsed.mock === 'object' ? parsed.mock : undefined);
}
} catch (_e) { pub = ''; }
} else {
pub = raw;
}
}
const havePub = PUBKEY_RE.test(pub);
if (!havePub && mock === undefined) return json(400, { error: 'invalid public key' });
return (async () => {
// First-writer-wins: a later visitor cannot hijack an existing token's key.
// The key is written with the webhook's absolute birth-anchored deadline so it
// can never become eternal: `ttlForDeadline()` resolves to `LIFESPAN_FALLBACK_SEC`
// (the default lifetime), and the server's `responder_kv_max_lifespan_sec` backstop,
// when enabled, only clamps it *shorter*. `ifAbsent` makes this a no-op on a live
// row, so re-registration never refreshes the TTL and the deadline stays anchored
// to creation. Config and requests inherit this exact deadline via `expiresAt` below.
if (havePub) await secutils.kv.set('pk/' + token, pub, { ifAbsent: true, ttlSec: ttlForDeadline() });
// Read back the (possibly pre-existing) key + its server-assigned deadline so
// the config inherits exactly the webhook's lifetime and the client learns it.
const pkEntry = await secutils.kv.getEntry('pk/' + token);
const storedPub = pkEntry && pkEntry.value;
const exp = pkEntry && pkEntry.expiresAt;
if (mock === null) {
await secutils.kv.delete('cfg/' + token);
} else if (mock !== undefined && storedPub) {
// KV only accepts base64url values, so store base64url(JSON-bytes). Clamp
// the config to the webhook deadline so it never outlives (or under-lives) it.
const encoded = b64url(Deno.core.encode(JSON.stringify(normalizeMock(mock))));
await secutils.kv.set('cfg/' + token, encoded, { ttlSec: ttlForDeadline(exp) });
}
const fingerprint = storedPub ? await secutils.crypto.sha256(storedPub) : null;
return json(200, { ok: true, fingerprint, mine: storedPub === pub, exp: exp || null });
})();
}
if (method === 'DELETE') {
return (async () => {
const page = await secutils.kv.list({ prefix: reqPrefix, limit: PAGE_LIMIT, valuesIncluded: false });
for (const entry of page.entries) await secutils.kv.delete(entry.key);
const remaining = page.entries.length >= PAGE_LIMIT;
// Once the log is drained, drop the key registration too (full delete).
if (!remaining && query.keep !== '1') await secutils.kv.delete('pk/' + token);
return json(200, { ok: true, removed: page.entries.length, remaining });
})();
}
// GET -> list, or long-poll watch when &live=1.
return (async () => {
const after = query.after || undefined;
const result = query.live === '1'
? await secutils.kv.watch({ prefix: reqPrefix, after, limit: PAGE_LIMIT, timeoutMs: WATCH_TIMEOUT_MS })
: await secutils.kv.list({ prefix: reqPrefix, after, limit: PAGE_LIMIT });
return json(200, result);
})();
}
// -------------------------------------------------------------------------
// 3. CONFIGURATOR: nothing token-shaped -> serve the static inspector HTML.
// -------------------------------------------------------------------------
return null;
})();
-->
<html lang="en" data-theme="dark">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Webhook Inspector | Secutils.dev</title>
<meta name="description" content="Free ephemeral webhook & HTTP request inspector. Get a unique URL, point any service at it, and watch requests arrive live. End-to-end encrypted, no signup.">
<meta name="robots" content="index, follow, max-image-preview:large">
<link rel="canonical" href="https://{{TOOLS_HOST}}/webhook">
<meta name="su-tool-path" content="/webhook">
<meta name="su-tool-name" content="Webhook Inspector">
<meta name="su-tool-description" content="Get a unique, ephemeral webhook URL and watch incoming HTTP requests arrive live in a grid. End-to-end encrypted, browser-only, no signup.">
<meta name="su-tool-promote" content="true">
<meta property="og:type" content="website">
<meta property="og:site_name" content="Secutils.dev">
<meta property="og:title" content="Webhook Inspector">
<meta property="og:description" content="Free ephemeral webhook & HTTP request inspector. Unique URL, live request grid, end-to-end encrypted. No signup.">
<meta property="og:url" content="https://{{TOOLS_HOST}}/webhook">
<meta property="og:image" content="https://secutils.dev/docs/img/og/og-webhook.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Webhook Inspector on Secutils.dev.">
<meta property="og:locale" content="en_US">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Webhook Inspector">
<meta name="twitter:description" content="Free ephemeral webhook inspector. Unique URL, live request grid, end-to-end encrypted. No signup.">
<meta name="twitter:image" content="https://secutils.dev/docs/img/og/og-webhook.png">
<script type="application/ld+json">{"@context":"https://schema.org","@type":"WebApplication","name":"Webhook Inspector","url":"https://{{TOOLS_HOST}}/webhook","applicationCategory":"DeveloperApplication","operatingSystem":"Any","browserRequirements":"Requires JavaScript","isAccessibleForFree":true,"offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"publisher":{"@type":"Organization","name":"Secutils.dev","url":"https://secutils.dev"},"sameAs":"https://github.com/secutils-dev/secutils/blob/main/dev/tools/webhook.html","description":"Free ephemeral webhook & HTTP request inspector. Unique URL, live request grid, end-to-end encrypted, no signup."}</script>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300..700&family=Roboto+Mono:wght@400..700&display=swap" rel="stylesheet">
<!-- Privacy-friendly analytics by Plausible -->
<script defer src="https://tools.secutils.dev/js/script.js" fetchpriority="low"></script>
<script>
window.plausible = window.plausible || function () { (plausible.q = plausible.q || []).push(arguments) };
plausible.init = plausible.init || function (i) { plausible.o = i || {} };
plausible.init();
</script>
<script>
try {
const saved = localStorage.getItem('su-tool-theme');
document.documentElement.dataset.theme = saved === 'light' || saved === 'dark'
? saved : (matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
} catch {}
</script>
<link rel="stylesheet" href="./shared/tokens.css" data-su-style="tokens">
<link rel="stylesheet" href="./shared/components.css" data-su-style="components">
<style>
/* Webhook workflow and request views. Shared chrome lives in shared/. */
body { min-height: 100vh; }
.su-header { position: sticky; top: 0; padding-inline: 16px; }
main { flex: 1; padding: 32px 16px 48px; max-width: 980px; margin: 0 auto; width: 100%; }
.page-title { margin-bottom: 6px; }
.page-subtitle { color: var(--text-muted); margin-bottom: 24px; text-wrap: pretty; }
.page-subtitle code { font-family: var(--mono); font-size: 0.85em; padding: 1px 6px; border-radius: var(--radius-s); background: var(--surface); border: 1px solid var(--border); color: var(--text); }
.card { margin-bottom: 16px; }
.label-hint { font-size: 12px; font-weight: 400; color: var(--text-muted); margin-left: 6px; }
.url-label { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
.session-bar { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
.session-bar .select { flex: 1; min-width: 180px; }
.url-row { display: flex; gap: 8px; align-items: center; margin-top: 8px; }
.url-row .input-mono { flex: 1; min-width: 0; }
.fp { margin-top: 10px; font: 12px var(--mono); color: var(--text-muted); display: flex; align-items: center; gap: 8px; overflow-wrap: anywhere; }
.fp .dot { width: 8px; height: 8px; border-radius: 50%; background: var(--text-muted); flex-shrink: 0; }
.fp.ok .dot { background: var(--success); }
.fp.warn .dot { background: var(--danger); }
.actions { display: flex; gap: 8px; flex-wrap: wrap; margin-top: 12px; align-items: center; }
.actions .spacer { flex: 1; }
/* Single control: the blinking "Live" pill *is* the on/off switch. */
.live-btn { display: inline-flex; align-items: center; gap: 7px; height: 28px; padding: 0 10px; border-radius: var(--radius); border: 1px solid var(--eui-border-plain); background: var(--surface); color: var(--text-muted); font: 12px/1 var(--font); cursor: pointer; white-space: nowrap; }
.live-btn:hover { color: var(--text); background: var(--eui-hover); }
.live-btn .ring { display: block; width: 8px; height: 8px; border-radius: 50%; background: var(--text-muted); flex: none; transition: background .15s; }
.live-btn[aria-checked="true"] { color: var(--success); border-color: color-mix(in srgb, var(--success) 50%, transparent); }
.live-btn[aria-checked="true"] .ring { background: var(--success); }
@media (prefers-reduced-motion: no-preference) {
.live-btn[aria-checked="true"] .ring { animation: su-live-pulse 2s ease-in-out infinite; }
}
@keyframes su-live-pulse { 0%, 100% { opacity: 1; } 50% { opacity: .65; } }
.grid-head { display: flex; align-items: center; justify-content: space-between; margin-bottom: 12px; gap: 8px; flex-wrap: wrap; }
.grid-head h2 { font-size: 1.05rem; font-weight: 600; }
.grid-head .count { color: var(--text-muted); font-size: 13px; font-weight: 400; margin-left: 6px; }
.card-hint { color: var(--text-muted); font-size: 12px; margin-bottom: 12px; text-wrap: pretty; }
.card-hint a { color: var(--primary); font-weight: 600; text-decoration: none; }
.card-hint a:hover { text-decoration: underline; }
.ephemeral-note { display: flex; gap: 10px; align-items: center; padding: 10px 12px; margin-bottom: 14px; border: 1px solid var(--eui-border); border-radius: var(--radius); background: var(--bg); color: var(--text-muted); font-size: 12px; line-height: 1.5; text-wrap: pretty; }
.ephemeral-note > [data-icon] { color: var(--text-muted); }
.ephemeral-text { flex: 1; min-width: 0; text-align: center; }
.ephemeral-text p { margin: 0; }
.ephemeral-cta { margin-top: 4px; }
.ephemeral-note strong { color: var(--text); font-weight: 600; }
#ephemeralWhen { color: var(--text); font-weight: 700; background: var(--surface-hover); border-radius: var(--radius-s); padding: 1px 6px; }
.ephemeral-note a { color: var(--primary); font-weight: 600; text-decoration: none; }
.ephemeral-note a:hover { text-decoration: underline; }
.textarea { min-height: 120px; }
.textarea-sm { min-height: 60px; font-family: var(--font); }
.input-status { width: 120px; font-family: var(--mono); }
.row-head { display: flex; justify-content: space-between; align-items: center; margin-bottom: 10px; }
.row-head .field-label { margin: 0; }
.hdr-table { width: 100%; table-layout: fixed; border-collapse: separate; border-spacing: 0 6px; }
.hdr-table td { padding: 0 8px 0 0; vertical-align: middle; }
.hdr-table td:first-child { width: 36%; padding-left: 0; }
.hdr-table td:last-child { width: 28px; padding-right: 0; }
.hdr-empty { color: var(--text-muted); font-size: 13px; padding: 6px 0 2px; }
.hdr-empty code { font-family: var(--mono); font-size: 0.85em; padding: 1px 6px; border-radius: var(--radius-s); background: var(--bg); border: 1px solid var(--border); color: var(--text); }
.resp-card > summary { cursor: pointer; list-style: none; display: flex; align-items: center; justify-content: space-between; gap: 8px; }
.resp-card > summary::-webkit-details-marker { display: none; }
.resp-card[open] > summary { margin-bottom: 14px; }
.resp-summary-title { display: inline-flex; align-items: center; gap: 8px; font-size: 1.05rem; font-weight: 600; }
.resp-chevron, .request-chevron { color: var(--text-muted); transform: rotate(-90deg); }
.resp-card[open] .resp-chevron, .req[open] .request-chevron { transform: none; }
.resp-summary-hint { color: var(--text-muted); font-size: 12px; font-weight: 400; }
.resp-field { margin-top: 14px; }
.req-list { display: flex; flex-direction: column; gap: 8px; }
.req { border: 1px solid var(--border); border-radius: var(--radius); background: var(--bg); overflow: hidden; }
.req-summary { display: flex; align-items: center; gap: 8px; padding: 10px 12px; cursor: pointer; list-style: none; flex-wrap: wrap; }
.req-summary::-webkit-details-marker { display: none; }
.req-summary:hover { background: var(--surface-hover); }
.method { font: 600 11px var(--mono); padding: 3px 7px; border-radius: var(--radius-s); background: var(--badge-bg); color: var(--badge-text); flex-shrink: 0; min-width: 56px; text-align: center; }
.method.GET { background: #20384f; color: #6cb6ff; }
.method.POST { background: #1f3d2b; color: #6fd99f; }
.method.PUT { background: #3d3520; color: #e3c14a; }
.method.DELETE { background: #3d2222; color: #ff8a84; }
.method.PATCH { background: #33243d; color: #d09bff; }
.req-path { font: 13px var(--mono); color: var(--text); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; flex: 1; min-width: 60px; }
.req-time { font-size: 12px; color: var(--text-muted); flex-shrink: 0; }
.req-body { padding: 0 12px 12px; border-top: 1px solid var(--border); }
.req-section { margin-top: 12px; }
.req-section h4 { font-size: 11px; text-transform: uppercase; letter-spacing: 0.06em; color: var(--text-muted); margin-bottom: 6px; }
.kv-table { width: 100%; border-collapse: collapse; font: 12px var(--mono); }
.kv-table td { padding: 3px 8px 3px 0; vertical-align: top; word-break: break-all; }
.kv-table td:first-child { color: var(--text-muted); white-space: nowrap; width: 1%; padding-right: 14px; }
pre.body-pre { background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius); padding: 10px 12px; font: 12px/1.5 var(--mono); white-space: pre-wrap; word-break: break-all; max-height: 320px; overflow: auto; margin: 0; }
.empty-state { text-align: center; padding: 40px 20px; color: var(--text-muted); }
.es-icon { display: flex; justify-content: center; margin-bottom: 10px; color: var(--text-muted); }
.es-icon .eui-icon { width: 32px; height: 32px; }
.empty-state p { font-size: 14px; margin-bottom: 4px; }
.empty-state .es-sub { font-size: 12px; }
/* Webhook lifetime badge sitting next to the URL label. Colour escalates as the
absolute deadline approaches (neutral -> amber under 24h -> red under 1h). */
.life-chip { display: inline-flex; align-items: center; gap: 5px; padding: 2px 9px; border-radius: var(--radius-s); border: 1px solid var(--border); background: var(--surface); color: var(--text-muted); font: 600 11px/1.4 var(--font); text-transform: none; letter-spacing: 0; vertical-align: middle; cursor: help; }
.life-chip::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: currentColor; opacity: 0.7; }
.life-chip.warn { color: #1d2a3e; border-color: transparent; background: var(--eui-warning); }
.life-chip.danger { color: var(--eui-danger); border-color: var(--eui-danger); background: var(--eui-danger-bg); }
/* Expired webhook take-over card with the clone / sign-up lead-magnet CTAs. */
.expired-card { text-align: center; }
.expired-title { font-size: 16px; font-weight: 700; margin-bottom: 6px; }
.expired-sub { font-size: 13px; color: var(--text-muted); max-width: 540px; margin: 0 auto 8px; line-height: 1.5; }
.expired-actions { display: flex; gap: 10px; justify-content: center; flex-wrap: wrap; margin: 16px 0; }
/* Secondary, utility action (local-only "Remove from list") sits below the lead-magnet
copy, separated by a hairline so it reads as a lesser action than clone / sign-up. */
.expired-actions-secondary { margin: 16px 0 0; padding-top: 14px; border-top: 1px solid var(--border); }
.spinner { width: 16px; height: 16px; border: 2px solid var(--border); border-top-color: var(--primary); border-radius: 50%; animation: spin .7s linear infinite; flex-shrink: 0; }
@keyframes spin { to { transform: rotate(360deg); } }
.reg-overlay { display: flex; align-items: center; gap: 10px; padding: 12px 14px; border: 1px dashed var(--border); border-radius: var(--radius); color: var(--text-muted); font-size: 13px; }
.empty-state p { text-wrap: pretty; }
@media (max-width: 640px) {
.su-header { padding-inline: 12px; }
.skill-link span:last-child { display: none; }
.skill-link { padding: 0 10px; }
.session-bar .select { flex-basis: 100%; }
main { padding: 20px 12px 32px; }
.label-hint { display: block; margin-left: 0; }
}
</style>
</head>
<body>
<noscript>
<p class="su-noscript"><strong>Webhook Inspector</strong>. Get a unique webhook URL, point any service at it, and watch incoming HTTP requests arrive live. Captured requests are end-to-end encrypted with a key that never leaves your browser. Requires JavaScript; please enable it. Source on <a href="https://github.com/secutils-dev/secutils/blob/main/dev/tools/webhook.html">GitHub</a>.</p>
</noscript>
<header class="su-header">
<a class="su-app-brand" href="https://secutils.dev" target="_blank" rel="noopener" aria-label="WEBHOOKS by Secutils.dev (opens in new tab)">
<img class="su-app-icon" src="./webhook/assets/webhook-app-icon.svg" data-su-app-icon="webhook" width="32" height="32" alt="">
<span class="su-app-brand-copy">
<span class="su-app-name">WEBHOOKS</span>
<span class="su-app-publisher">Secutils.dev</span>
</span>
</a>
<div class="su-header-section">
<a id="skillLink" class="skill-link" href="#" target="_blank" rel="noopener"
title="View AI agent skill (skill.md, opens in new tab)"
aria-label="View AI agent skill (opens in new tab)">
<span data-icon="sparkles"></span>
<span>Skill</span>
</a>
<button class="su-header-btn theme-toggle" id="themeToggle" type="button" aria-label="Toggle theme">
<span class="icon-sun" data-icon="sun"></span>
<span class="icon-moon" data-icon="moon"></span>
</button>
</div>
</header>
<main>
<h1 class="page-title">Webhook inspector</h1>
<p class="page-subtitle">Get a unique URL, point any service at it, and watch requests arrive live.</p>
<section class="su-panel card">
<label class="field-label" for="sessionSelect">Your webhooks</label>
<div class="session-bar">
<select id="sessionSelect" class="select"></select>
<button id="newBtn" type="button" class="btn btn-primary" title="Create a fresh webhook">New</button>
<button id="cloneBtn" type="button" class="btn" title="Copy this webhook's response settings into a brand-new webhook URL">Clone</button>
<button id="renameBtn" type="button" class="btn" title="Rename this webhook">Rename</button>
</div>
<div id="regOverlay" class="reg-overlay" style="margin-top:12px" hidden>
<span class="spinner"></span>
<span id="regOverlayMsg">Generating encryption keys and registering your webhook…</span>
</div>
<div id="urlBlock" hidden>
<label class="field-label url-label" for="webhookUrl" style="margin-top:16px">Webhook URL <span id="lifeChip" class="life-chip" hidden></span></label>
<div class="url-row">
<input id="webhookUrl" class="input-mono" readonly>
<button id="copyUrl" type="button" class="btn" title="Copy webhook URL">
<span data-icon="copy"></span>
<span>Copy</span>
</button>
</div>
<div id="fingerprint" class="fp"><span class="dot"></span><span id="fpText">Setting up encryption…</span></div>
<label class="field-label" for="webhookDesc" style="margin-top:16px">Description <span class="label-hint">(a private note kept in this browser & the share link, never sent to the server)</span></label>
<textarea id="webhookDesc" class="textarea textarea-sm" placeholder="What is this webhook for? Notes for whoever opens the share link."></textarea>
</div>
</section>
<section class="su-panel card expired-card" id="expiredState" hidden>
<div class="es-icon"><span data-icon="clock"></span></div>
<p class="expired-title">This webhook has expired.</p>
<p class="expired-sub">Its URL, response settings, and every captured request have been permanently deleted. Ephemeral webhooks live for a limited time and cannot be revived.</p>
<div class="expired-actions">
<button id="expiredCloneBtn" type="button" class="btn btn-primary">Clone to a new webhook</button>
<a class="btn" href="https://secutils.dev/signup" target="_blank" rel="noopener noreferrer">Create a free account →</a>
</div>
<p class="expired-sub">A free Secutils.dev account gives you <strong>permanent</strong> webhooks that never expire, plus scheduled checks, notifications, and more.</p>
<div class="expired-actions expired-actions-secondary">
<button id="expiredDeleteBtn" type="button" class="btn btn-danger">Remove from list</button>
</div>
</section>
<details class="su-panel card resp-card" id="respCard">
<summary>
<span class="resp-summary-title"><span class="resp-chevron" data-icon="chevronDown"></span>Response</span>
<span id="respSummaryHint" class="resp-summary-hint">Returns 200 OK</span>
</summary>
<p class="card-hint">What every caller receives. Stored unencrypted so the server can reply without your key; captured requests stay end-to-end encrypted.</p>
<div class="resp-field">
<label class="field-label" for="respStatus">Status code</label>
<input id="respStatus" class="input input-status" type="number" min="100" max="599" value="200">
</div>
<div class="resp-field">
<div class="row-head">
<h3 class="field-label">Headers</h3>
<button id="respAddHeader" type="button" class="btn btn-sm"><span data-icon="plus"></span>Add header</button>
</div>
<table id="respHeaders" class="hdr-table"><tbody></tbody></table>
<div id="respHeadersEmpty" class="hdr-empty" hidden>No headers. <code>Content-Type: text/plain; charset=utf-8</code> is added automatically.</div>
</div>
<div class="resp-field">
<label class="field-label" for="respBody">Body</label>
<textarea id="respBody" class="textarea" placeholder="Response body (text)"></textarea>
</div>
<div class="actions">
<button id="respSave" type="button" class="btn btn-primary"><span data-icon="save"></span>Save response</button>
<span id="respSaveMsg" class="resp-summary-hint" role="status"></span>
<span class="spacer"></span>
<button id="respReset" type="button" class="btn btn-empty"><span data-icon="refresh"></span>Reset to default</button>
</div>
</details>
<section class="su-panel card" id="requestsCard">
<div class="grid-head">
<h2>Requests <span id="reqCount" class="count"></span></h2>
<button id="liveToggle" type="button" class="live-btn" role="switch" aria-checked="false" title="Stream new requests as they arrive">
<span class="ring"></span> Live
</button>
</div>
<div class="ephemeral-note">
<span data-icon="clock"></span>
<div class="ephemeral-text">
<p>This webhook is <strong>ephemeral</strong> - its URL, settings, and every captured request are deleted automatically <span id="ephemeralWhen">when it expires</span>.</p>
<p class="ephemeral-cta">Need it to stick around? <a href="https://secutils.dev/signup" target="_blank" rel="noopener noreferrer">Create a free account</a> for permanent, more feature-rich webhooks.</p>
</div>
</div>
<div id="reqList" class="req-list"></div>
<div id="emptyState" class="empty-state">
<div class="es-icon"><span data-icon="documents"></span></div>
<p>No requests captured yet.</p>
<p class="es-sub">Send an HTTP request to your webhook URL above and it will show up here.</p>
</div>
<div class="actions">
<button id="refreshBtn" type="button" class="btn" title="Fetch the latest requests"><span data-icon="refresh"></span>Refresh</button>
<span class="spacer"></span>
<button id="clearBtn" type="button" class="btn" title="Delete all captured requests for this webhook"><span data-icon="trash"></span>Clear history</button>
<button id="deleteBtn" type="button" class="btn btn-danger" title="Delete this webhook and all its data"><span data-icon="trash"></span>Delete webhook</button>
</div>
</section>
<aside class="su-more-tools" aria-label="More free tools">
<p>Other free, no-signup Secutils.dev tools for HTTP mocking, JWT, SAML, certificates, and more - <a href="https://{{TOOLS_HOST}}/">Browse all tools →</a></p>
</aside>
</main>
<footer class="su-footer">
<p>Get a unique webhook URL and watch incoming requests arrive live. End-to-end encrypted, no signup.</p>
<p class="su-footer-fineprint"><button type="button" class="su-footer-link" id="privacyOpen">Privacy</button></p>
</footer>
<dialog id="privacyDialog" class="su-dialog" closedby="any" aria-labelledby="privacyDialogTitle">
<header class="su-dialog-header">
<h2 id="privacyDialogTitle">Privacy</h2>
<button type="button" class="su-dialog-close" id="privacyClose" aria-label="Close">
<span data-icon="cross"></span>
</button>
</header>
<div class="su-dialog-body">
<p><strong>Captured requests are end-to-end encrypted.</strong> When you create a webhook, this page generates an elliptic-curve key pair (ECDH P-256) directly in your browser. Only the <em>public</em> key is registered with the server. Every request that hits your webhook URL is sealed on the server against that public key (ECDH → HKDF-SHA256 → AES-256-GCM, libsodium-style sealed box) and stored as <strong>ciphertext only</strong>. The matching <em>private</em> key never leaves your browser, so the server (and anyone who can read the database) cannot decrypt what was captured.</p>
<p><strong>Your response template is not encrypted.</strong> The status code, headers, and body you configure as the reply are stored in plaintext on the server, because the server has to answer callers without your key. Avoid putting secrets in the response template.</p>
<p><strong>Your webhook lives in this browser.</strong> The private key, token, label, and description are kept in <code>localStorage</code> and encoded into the page’s URL fragment (<code>#…</code>), which browsers never transmit to the server. Share that full URL, including the fragment, to open the same webhook (and the ability to decrypt it) on another device. Lose the fragment and the captured data is unrecoverable by design.</p>
<p><strong>Ephemeral by default.</strong> Captured requests expire automatically after 7 days and a background job reaps them. There is no account and no long-term storage.</p>
<p><strong>Anonymous usage analytics.</strong> We use <a href="https://plausible.io/" target="_blank" rel="noopener noreferrer">Plausible Analytics</a>, a privacy-first, GDPR-compliant tool, to collect aggregate usage data. No cookies, no personal data, no individual tracking.</p>
<p class="su-dialog-fineprint">See the full <a href="https://secutils.dev/privacy" target="_blank" rel="noopener noreferrer">Secutils.dev privacy policy</a> for details on the wider service.</p>
</div>
</dialog>
<dialog id="renameDialog" class="su-dialog" closedby="any" aria-labelledby="renameDialogTitle">
<header class="su-dialog-header">
<h2 id="renameDialogTitle">Rename webhook</h2>
<button type="button" class="su-dialog-close" id="renameClose" aria-label="Close">
<span data-icon="cross"></span>
</button>
</header>
<form id="renameForm" method="dialog">
<div class="su-dialog-body">
<label class="field-label" for="renameInput">Label</label>
<input id="renameInput" class="input" type="text" maxlength="80" placeholder="My webhook" autocomplete="off" spellcheck="false">
</div>
<div class="su-dialog-footer">
<button type="button" class="btn" id="renameCancel">Cancel</button>
<button type="submit" class="btn btn-primary">Save</button>
</div>
</form>
</dialog>
<dialog id="confirmDialog" class="su-dialog" closedby="any" aria-labelledby="confirmDialogTitle">
<header class="su-dialog-header">
<h2 id="confirmDialogTitle">Confirm</h2>
<button type="button" class="su-dialog-close" id="confirmClose" aria-label="Close">
<span data-icon="cross"></span>
</button>
</header>
<div class="su-dialog-body">
<p id="confirmDialogMsg"></p>
</div>
<div class="su-dialog-footer">
<button type="button" class="btn" id="confirmCancel">Cancel</button>
<button type="button" class="btn btn-danger" id="confirmOk">Delete</button>
</div>
</dialog>
<div id="toast" class="toast" role="status" aria-live="polite" style="display:none">
<span id="toastMsg"></span>
</div>
<script type="module">
import { icon, hydrateIcons } from './shared/icons.js';
hydrateIcons();
const $ = (id) => document.getElementById(id);
const els = Object.freeze({
sessionSelect: $('sessionSelect'),
newBtn: $('newBtn'),
cloneBtn: $('cloneBtn'),
renameBtn: $('renameBtn'),
regOverlay: $('regOverlay'),
regOverlayMsg: $('regOverlayMsg'),
urlBlock: $('urlBlock'),
webhookDesc: $('webhookDesc'),
lifeChip: $('lifeChip'),
expiredState: $('expiredState'),
expiredCloneBtn: $('expiredCloneBtn'),
expiredDeleteBtn: $('expiredDeleteBtn'),
requestsCard: $('requestsCard'),
ephemeralWhen: $('ephemeralWhen'),
webhookUrl: $('webhookUrl'),
copyUrl: $('copyUrl'),
fingerprint: $('fingerprint'),
fpText: $('fpText'),
reqList: $('reqList'),
emptyState: $('emptyState'),
reqCount: $('reqCount'),
liveToggle: $('liveToggle'),
refreshBtn: $('refreshBtn'),
clearBtn: $('clearBtn'),
deleteBtn: $('deleteBtn'),
themeToggle: $('themeToggle'),
toast: $('toast'),
toastMsg: $('toastMsg'),
respCard: $('respCard'),
respSummaryHint: $('respSummaryHint'),
respStatus: $('respStatus'),
respHeaders: $('respHeaders').querySelector('tbody'),
respHeadersEmpty: $('respHeadersEmpty'),
respBody: $('respBody'),
respAddHeader: $('respAddHeader'),
respSave: $('respSave'),
respSaveMsg: $('respSaveMsg'),
respReset: $('respReset'),
});
// The effective default response when a webhook has no custom mock configured.
const DEFAULT_MOCK = { s: 200, h: [['Content-Type', 'application/json; charset=utf-8']], b: '{"ok":true}' };
function normalizeMock(m) {
const s = Number.isInteger(m && m.s) && m.s >= 100 && m.s <= 599 ? m.s : 200;
const h = [];
if (m && Array.isArray(m.h)) {
for (const pair of m.h) {
if (Array.isArray(pair) && String(pair[0] || '').trim()) {
h.push([String(pair[0]).slice(0, 256), String(pair[1] ?? '').slice(0, 1024)]);
}
}
}
let b = m && typeof m.b === 'string' ? m.b : '';
if (b.length > 64 * 1024) b = b.slice(0, 64 * 1024);
return { s, h, b };
}
// Curated response-header suggestions surfaced via native <datalist> dropdowns
// (mirrors echo.html). Names shown verbatim; values looked up case-insensitively
// (key = lowercased name). Names without an entry in HEADER_PRESETS still
// autocomplete the name, but offer no value suggestions - same for any custom
// (non-listed) header typed by the user.
const HEADER_NAMES = [
'Access-Control-Allow-Credentials', 'Access-Control-Allow-Headers',
'Access-Control-Allow-Methods', 'Access-Control-Allow-Origin',
'Cache-Control', 'Content-Disposition', 'Content-Encoding', 'Content-Length',
'Content-Security-Policy', 'Content-Type', 'Date', 'ETag', 'Last-Modified',
'Location', 'Server', 'Set-Cookie', 'Strict-Transport-Security', 'Vary',
'WWW-Authenticate', 'X-Content-Type-Options', 'X-Frame-Options',
];
const HEADER_PRESETS = Object.freeze({
'content-type': ['application/json; charset=utf-8', 'text/html; charset=utf-8', 'text/plain', 'application/xml', 'text/css', 'application/javascript', 'image/png', 'image/jpeg', 'application/octet-stream'],
'cache-control': ['no-cache', 'no-store', 'max-age=0', 'max-age=3600', 'public, max-age=86400', 'private', 'must-revalidate'],
'content-encoding': ['gzip', 'br', 'deflate', 'identity'],
'server': ['nginx', 'Apache', 'cloudflare', 'Microsoft-IIS/10.0'],
'access-control-allow-origin': ['*', 'https://example.com', 'null'],
'access-control-allow-methods': ['GET, POST, PUT, DELETE, OPTIONS', 'GET, HEAD, OPTIONS'],
'access-control-allow-headers': ['Content-Type, Authorization', '*'],
'access-control-allow-credentials': ['true', 'false'],
'vary': ['Accept-Encoding', 'Origin', 'Accept, Accept-Encoding', 'User-Agent'],
'content-disposition': ['inline', 'attachment', 'attachment; filename="file.pdf"'],
'strict-transport-security': ['max-age=31536000', 'max-age=31536000; includeSubDomains', 'max-age=63072000; includeSubDomains; preload'],
'x-frame-options': ['DENY', 'SAMEORIGIN'],
'x-content-type-options': ['nosniff'],
'www-authenticate': ['Bearer', 'Bearer realm="api"', 'Bearer error="invalid_token"', 'Basic realm="api"'],
'content-security-policy': [`default-src 'self'`, `default-src 'self'; script-src 'self' 'unsafe-inline'`, `frame-ancestors 'none'`],
});
// Shared <datalist> of response-header names - created once and reused across all
// name inputs (every row links to the same `list="resp-hdr-names"` target).
const respNamesDatalist = document.createElement('datalist');
respNamesDatalist.id = 'resp-hdr-names';
for (const name of HEADER_NAMES) {
const opt = document.createElement('option');
opt.value = name;
respNamesDatalist.appendChild(opt);
}
document.body.appendChild(respNamesDatalist);
// Populate a per-row value <datalist> from HEADER_PRESETS keyed by the lowercased
// header name, and toggle the value input's `list` attribute so rows without
// presets don't render an empty dropdown indicator.
const applyValuePresets = (valueInput, valueDatalist, headerName) => {
const presets = HEADER_PRESETS[headerName.trim().toLowerCase()];
valueDatalist.replaceChildren();
if (presets) {
for (const v of presets) {
const opt = document.createElement('option');
opt.value = v;
valueDatalist.appendChild(opt);
}
valueInput.setAttribute('list', valueDatalist.id);
} else {
valueInput.removeAttribute('list');
}
};
const MOUNT = location.pathname.replace(/\/$/, '') || '/webhook';
const CATALOG_KEY = 'webhook.sessions';
const ACTIVE_KEY = 'webhook.active';
const enc = new TextEncoder();
const dec = new TextDecoder();
// ---- base64url helpers (browser side; atob/btoa available here) ----
const bytesToB64url = (bytes) => {
let s = '';
for (const b of bytes) s += String.fromCharCode(b);
return btoa(s).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
};
const b64urlToBytes = (str) => {
const b64 = str.replace(/-/g, '+').replace(/_/g, '/');
const padded = b64 + '==='.slice(0, (4 - (b64.length % 4)) % 4);
const bin = atob(padded);
const out = new Uint8Array(bin.length);
for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
return out;
};
// ---- session catalog (localStorage) ----
// Each session: { t: token, k: privateKeyJwk, p: publicKeyRawB64url, l: label,
// d?: free-text description (local-only), createdAt,
// exp?: absolute deadline (unix s, from server), m?: mock config }
function loadCatalog() {
try { return JSON.parse(localStorage.getItem(CATALOG_KEY)) || []; } catch { return []; }
}
function saveCatalog(catalog) {
try { localStorage.setItem(CATALOG_KEY, JSON.stringify(catalog)); } catch {}
}
function upsertSession(session) {
const catalog = loadCatalog();
const idx = catalog.findIndex((s) => s.t === session.t);
if (idx >= 0) catalog[idx] = session; else catalog.push(session);
saveCatalog(catalog);
}
function getSession(token) {
return loadCatalog().find((s) => s.t === token) || null;
}
function setActive(token) {
try { localStorage.setItem(ACTIVE_KEY, token); } catch {}
}
function getActive() {
try { return localStorage.getItem(ACTIVE_KEY); } catch { return null; }
}
// ---- session fragment encode/decode (4-byte LE ulen + raw-deflate JSON) ----
const encodeSession = async (session) => {
const text = JSON.stringify(session);
const bytes = enc.encode(text);
const stream = new Blob([bytes]).stream().pipeThrough(new CompressionStream('deflate-raw'));
const deflated = new Uint8Array(await new Response(stream).arrayBuffer());
const out = new Uint8Array(4 + deflated.length);
new DataView(out.buffer).setUint32(0, bytes.length, true);
out.set(deflated, 4);
return bytesToB64url(out);
};
const decodeSession = async (str) => {
try {
const bytes = b64urlToBytes(str);
if (bytes.length < 4) return null;
const stream = new Blob([bytes.subarray(4)]).stream().pipeThrough(new DecompressionStream('deflate-raw'));
const inflated = new Uint8Array(await new Response(stream).arrayBuffer());
return JSON.parse(dec.decode(inflated));
} catch { return null; }
};
// ---- crypto: keygen + decrypt sealed boxes (mirrors src/js_runtime/op_crypto_seal.rs) ----
async function generateKeyPair() {
const pair = await crypto.subtle.generateKey({ name: 'ECDH', namedCurve: 'P-256' }, true, ['deriveBits']);
const jwk = await crypto.subtle.exportKey('jwk', pair.privateKey);
const raw = new Uint8Array(await crypto.subtle.exportKey('raw', pair.publicKey));
return { jwk, pubRaw: bytesToB64url(raw) };
}
async function decryptSealed(privJwk, myPubRawB64, sealedB64) {
const sealed = b64urlToBytes(sealedB64);
if (sealed.length < 65 + 12 + 16) throw new Error('sealed blob too short');
const ephPubRaw = sealed.subarray(0, 65);
const iv = sealed.subarray(65, 77);
const ct = sealed.subarray(77);
const myPubRaw = b64urlToBytes(myPubRawB64);
const privKey = await crypto.subtle.importKey('jwk', privJwk, { name: 'ECDH', namedCurve: 'P-256' }, false, ['deriveBits']);
const ephPub = await crypto.subtle.importKey('raw', ephPubRaw, { name: 'ECDH', namedCurve: 'P-256' }, false, []);
const shared = await crypto.subtle.deriveBits({ name: 'ECDH', public: ephPub }, privKey, 256);
const hkdfKey = await crypto.subtle.importKey('raw', shared, 'HKDF', false, ['deriveBits']);
const aesBits = await crypto.subtle.deriveBits(
{ name: 'HKDF', hash: 'SHA-256', salt: myPubRaw, info: ephPubRaw },
hkdfKey, 256,
);
const aesKey = await crypto.subtle.importKey('raw', aesBits, { name: 'AES-GCM' }, false, ['decrypt']);
const plain = await crypto.subtle.decrypt({ name: 'AES-GCM', iv }, aesKey, ct);
return JSON.parse(dec.decode(new Uint8Array(plain)));
}
async function sha256Hex(b64url) {
const digest = await crypto.subtle.digest('SHA-256', b64urlToBytes(b64url));
return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, '0')).join('');
}
// ---- token generation ----
function randomToken() {
const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
const bytes = new Uint8Array(16);
crypto.getRandomValues(bytes);
let out = '';
for (const b of bytes) out += alphabet[b % alphabet.length];
return out;
}
// ---- toast ----
let toastTimer;
function toast(msg) {
els.toastMsg.textContent = msg;
els.toast.style.display = 'flex';
clearTimeout(toastTimer);
toastTimer = setTimeout(() => { els.toast.style.display = 'none'; }, 2200);
}
// ---- cross-tab sync ----
let channel = null;
try { channel = new BroadcastChannel('webhook'); } catch {}
function broadcast(type) { try { channel && channel.postMessage({ type }); } catch {} }
// ---- application state ----
let current = null; // active session object
let watchAbort = null; // AbortController for the live watch loop
let liveRunning = false;
let liveEnabled = false; // user intent: keep streaming across session switches
const seenKeys = new Set();
let cursor = undefined;
function setRegistering(on, msg) {
els.regOverlay.hidden = !on;
if (msg) els.regOverlayMsg.textContent = msg;
els.newBtn.disabled = on;
els.cloneBtn.disabled = on;
els.deleteBtn.disabled = on;
els.clearBtn.disabled = on;
}
function renderSessionSelect() {
const catalog = loadCatalog();
els.sessionSelect.replaceChildren();
if (!catalog.length) {
const opt = document.createElement('option');
opt.textContent = 'No webhooks yet';
opt.value = '';
els.sessionSelect.appendChild(opt);
return;
}
for (const s of catalog) {
const opt = document.createElement('option');
opt.value = s.t;
opt.textContent = s.l || `webhook ${s.t.slice(0, 6)}`;
if (current && s.t === current.t) opt.selected = true;
els.sessionSelect.appendChild(opt);
}
}
function webhookUrlFor(token) {
return `${location.origin}${MOUNT}/${token}`;
}
async function updateFragment() {
if (!current) return;
const fragment = await encodeSession(current);
history.replaceState(null, '', `#${fragment}`);
}
// PUT to the management endpoint. `mock` is omitted to leave the response config
// untouched, an object to set it, or null to delete it. A hard timeout guarantees
// the UI can never hang forever on a stalled connection.
async function putManagement(session, mock) {
const payload = { pk: session.p };
if (mock !== undefined) payload.mock = mock;
const ctrl = new AbortController();
const timer = setTimeout(() => ctrl.abort(), 12000);
try {
const res = await fetch(`${MOUNT}?t=${encodeURIComponent(session.t)}`, {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload),
signal: ctrl.signal,
});
if (!res.ok) throw new Error(`register failed: ${res.status}`);
return await res.json();
} catch (e) {
throw e.name === 'AbortError' ? new Error('timed out') : e;
} finally {