@jambonz/sdk 0.1.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 (39) hide show
  1. package/dist/client/index.cjs +119 -0
  2. package/dist/client/index.cjs.map +1 -0
  3. package/dist/client/index.d.cts +58 -0
  4. package/dist/client/index.d.ts +58 -0
  5. package/dist/client/index.js +115 -0
  6. package/dist/client/index.js.map +1 -0
  7. package/dist/common-Bsqv1Brz.d.cts +69 -0
  8. package/dist/common-Bsqv1Brz.d.ts +69 -0
  9. package/dist/index.cjs +1014 -0
  10. package/dist/index.cjs.map +1 -0
  11. package/dist/index.d.cts +10 -0
  12. package/dist/index.d.ts +10 -0
  13. package/dist/index.js +996 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/rest-BV_FsqnH.d.cts +97 -0
  16. package/dist/rest-CthGXHnw.d.ts +97 -0
  17. package/dist/types/index.cjs +4 -0
  18. package/dist/types/index.cjs.map +1 -0
  19. package/dist/types/index.d.cts +3 -0
  20. package/dist/types/index.d.ts +3 -0
  21. package/dist/types/index.js +3 -0
  22. package/dist/types/index.js.map +1 -0
  23. package/dist/verb-builder-But-DJle.d.cts +82 -0
  24. package/dist/verb-builder-CO_qoYxC.d.ts +82 -0
  25. package/dist/verbs-B_afNNUM.d.cts +770 -0
  26. package/dist/verbs-B_afNNUM.d.ts +770 -0
  27. package/dist/webhook/index.cjs +320 -0
  28. package/dist/webhook/index.cjs.map +1 -0
  29. package/dist/webhook/index.d.cts +26 -0
  30. package/dist/webhook/index.d.ts +26 -0
  31. package/dist/webhook/index.js +313 -0
  32. package/dist/webhook/index.js.map +1 -0
  33. package/dist/websocket/index.cjs +833 -0
  34. package/dist/websocket/index.cjs.map +1 -0
  35. package/dist/websocket/index.d.cts +179 -0
  36. package/dist/websocket/index.d.ts +179 -0
  37. package/dist/websocket/index.js +822 -0
  38. package/dist/websocket/index.js.map +1 -0
  39. package/package.json +96 -0
@@ -0,0 +1,313 @@
1
+ import { createHmac, timingSafeEqual } from 'crypto';
2
+ import Ajv from 'ajv';
3
+ import { readFileSync } from 'fs';
4
+ import { dirname, resolve } from 'path';
5
+ import { fileURLToPath } from 'url';
6
+
7
+ // src/webhook/response.ts
8
+ var COMPONENT_SCHEMAS = [
9
+ "auth",
10
+ "actionHook",
11
+ "synthesizer",
12
+ "recognizer",
13
+ "target",
14
+ "vad",
15
+ "bidirectionalAudio",
16
+ "fillerNoise",
17
+ "actionHookDelayAction"
18
+ ];
19
+ var VERB_SCHEMAS = [
20
+ "answer",
21
+ "alert",
22
+ "config",
23
+ "say",
24
+ "play",
25
+ "gather",
26
+ "dial",
27
+ "listen",
28
+ "stream",
29
+ "llm",
30
+ "pipeline",
31
+ "conference",
32
+ "transcribe",
33
+ "enqueue",
34
+ "dequeue",
35
+ "dtmf",
36
+ "dub",
37
+ "hangup",
38
+ "leave",
39
+ "message",
40
+ "pause",
41
+ "redirect",
42
+ "tag",
43
+ "sip-decline",
44
+ "sip-request",
45
+ "sip-refer"
46
+ ];
47
+ function loadSchema(schemaDir, relativePath) {
48
+ const fullPath = resolve(schemaDir, relativePath);
49
+ return JSON.parse(readFileSync(fullPath, "utf-8"));
50
+ }
51
+ function findSchemaDir() {
52
+ const currentDir = typeof __dirname !== "undefined" ? __dirname : dirname(fileURLToPath(import.meta.url));
53
+ const candidates = [
54
+ resolve(currentDir, "../../schema"),
55
+ // from src/
56
+ resolve(currentDir, "../../../schema")
57
+ // from dist/
58
+ ];
59
+ for (const candidate of candidates) {
60
+ try {
61
+ readFileSync(resolve(candidate, "jambonz-app.schema.json"), "utf-8");
62
+ return candidate;
63
+ } catch {
64
+ }
65
+ }
66
+ throw new Error(
67
+ "Could not find jambonz schema directory. Ensure the schema/ directory is present alongside the typescript/ directory."
68
+ );
69
+ }
70
+ var JambonzValidator = class {
71
+ validateApp;
72
+ ajv;
73
+ constructor(schemaDir) {
74
+ const dir = schemaDir ?? findSchemaDir();
75
+ this.ajv = new Ajv({
76
+ allErrors: true,
77
+ strict: false,
78
+ validateSchema: false,
79
+ logger: false
80
+ });
81
+ for (const name of COMPONENT_SCHEMAS) {
82
+ const schema = loadSchema(dir, `components/${name}.schema.json`);
83
+ this.ajv.addSchema(schema);
84
+ }
85
+ for (const name of VERB_SCHEMAS) {
86
+ const schema = loadSchema(dir, `verbs/${name}.schema.json`);
87
+ this.ajv.addSchema(schema);
88
+ }
89
+ const appSchema = loadSchema(dir, "jambonz-app.schema.json");
90
+ this.validateApp = this.ajv.compile(appSchema);
91
+ }
92
+ /** Validate a complete verb array (a jambonz application). */
93
+ validate(app) {
94
+ const valid = this.validateApp(app);
95
+ if (valid) {
96
+ return { valid: true, errors: [] };
97
+ }
98
+ return {
99
+ valid: false,
100
+ errors: formatErrors(this.validateApp.errors)
101
+ };
102
+ }
103
+ /** Validate a single verb object. */
104
+ validateVerb(verb) {
105
+ return this.validate([verb]);
106
+ }
107
+ };
108
+ function formatErrors(errors) {
109
+ if (!errors) return [];
110
+ return errors.map((err) => ({
111
+ path: err.instancePath || "/",
112
+ message: err.message || "Unknown validation error"
113
+ }));
114
+ }
115
+
116
+ // src/verb-builder.ts
117
+ var VerbBuilder = class {
118
+ verbs = [];
119
+ validator;
120
+ constructor(opts) {
121
+ if (opts?.validate === false) {
122
+ this.validator = null;
123
+ } else {
124
+ this.validator = new JambonzValidator(opts?.schemaDir);
125
+ }
126
+ }
127
+ // --- Audio & Speech ---
128
+ say(opts) {
129
+ return this.addVerb({ verb: "say", ...opts });
130
+ }
131
+ play(opts) {
132
+ return this.addVerb({ verb: "play", ...opts });
133
+ }
134
+ gather(opts) {
135
+ return this.addVerb({ verb: "gather", ...opts });
136
+ }
137
+ // --- AI & Real-time ---
138
+ llm(opts) {
139
+ return this.addVerb({ verb: "llm", ...opts });
140
+ }
141
+ pipeline(opts) {
142
+ return this.addVerb({ verb: "pipeline", ...opts });
143
+ }
144
+ listen(opts) {
145
+ return this.addVerb({ verb: "listen", ...opts });
146
+ }
147
+ stream(opts) {
148
+ return this.addVerb({ verb: "stream", ...opts });
149
+ }
150
+ transcribe(opts) {
151
+ return this.addVerb({ verb: "transcribe", ...opts });
152
+ }
153
+ // --- Call Control ---
154
+ dial(opts) {
155
+ return this.addVerb({ verb: "dial", ...opts });
156
+ }
157
+ conference(opts) {
158
+ return this.addVerb({ verb: "conference", ...opts });
159
+ }
160
+ enqueue(opts) {
161
+ return this.addVerb({ verb: "enqueue", ...opts });
162
+ }
163
+ dequeue(opts) {
164
+ return this.addVerb({ verb: "dequeue", ...opts });
165
+ }
166
+ hangup(opts) {
167
+ return this.addVerb({ verb: "hangup", ...opts });
168
+ }
169
+ redirect(opts) {
170
+ return this.addVerb({ verb: "redirect", ...opts });
171
+ }
172
+ pause(opts) {
173
+ return this.addVerb({ verb: "pause", ...opts });
174
+ }
175
+ leave(opts) {
176
+ return this.addVerb({ verb: "leave", ...opts });
177
+ }
178
+ // --- SIP ---
179
+ sipDecline(opts) {
180
+ return this.addVerb({ verb: "sip:decline", ...opts });
181
+ }
182
+ sipRequest(opts) {
183
+ return this.addVerb({ verb: "sip:request", ...opts });
184
+ }
185
+ sipRefer(opts) {
186
+ return this.addVerb({ verb: "sip:refer", ...opts });
187
+ }
188
+ // --- Utility ---
189
+ config(opts) {
190
+ return this.addVerb({ verb: "config", ...opts });
191
+ }
192
+ answer(opts) {
193
+ return this.addVerb({ verb: "answer", ...opts });
194
+ }
195
+ alert(opts) {
196
+ return this.addVerb({ verb: "alert", ...opts });
197
+ }
198
+ tag(opts) {
199
+ return this.addVerb({ verb: "tag", ...opts });
200
+ }
201
+ dtmf(opts) {
202
+ return this.addVerb({ verb: "dtmf", ...opts });
203
+ }
204
+ dub(opts) {
205
+ return this.addVerb({ verb: "dub", ...opts });
206
+ }
207
+ message(opts) {
208
+ return this.addVerb({ verb: "message", ...opts });
209
+ }
210
+ // --- Raw JSON input (primary AI agent path) ---
211
+ /**
212
+ * Add one or more verbs from raw JSON.
213
+ * Validates against the JSON schemas at runtime if validation is enabled.
214
+ */
215
+ addVerbs(verbs) {
216
+ if (this.validator) {
217
+ const result = this.validator.validate(verbs);
218
+ if (!result.valid) {
219
+ const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join("; ");
220
+ throw new Error(`Verb validation failed: ${messages}`);
221
+ }
222
+ }
223
+ this.verbs.push(...verbs);
224
+ return this;
225
+ }
226
+ // --- Internal ---
227
+ addVerb(verb) {
228
+ if (this.validator) {
229
+ const result = this.validator.validateVerb(verb);
230
+ if (!result.valid) {
231
+ const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join("; ");
232
+ throw new Error(`Verb '${verb.verb}' validation failed: ${messages}`);
233
+ }
234
+ }
235
+ this.verbs.push(verb);
236
+ return this;
237
+ }
238
+ /** Get the current verb count. */
239
+ get length() {
240
+ return this.verbs.length;
241
+ }
242
+ /** Clear all queued verbs. */
243
+ clear() {
244
+ this.verbs = [];
245
+ return this;
246
+ }
247
+ /** Returns a copy of the current verb array. */
248
+ toJSON() {
249
+ return [...this.verbs];
250
+ }
251
+ };
252
+
253
+ // src/webhook/response.ts
254
+ var WebhookResponse = class extends VerbBuilder {
255
+ constructor(opts) {
256
+ super(opts);
257
+ }
258
+ /** Returns the verb array for JSON serialization. */
259
+ toJSON() {
260
+ return [...this.verbs];
261
+ }
262
+ /**
263
+ * Express-compatible middleware for verifying jambonz webhook signatures.
264
+ * Uses HMAC-SHA256 with timing-safe comparison.
265
+ */
266
+ static verifySignature(secret, opts) {
267
+ const tolerance = opts?.tolerance ?? 300;
268
+ return (req, _res, next) => {
269
+ try {
270
+ const signature = req.headers["jambonz-signature"];
271
+ if (!signature) {
272
+ throw new Error("Missing Jambonz-Signature header");
273
+ }
274
+ const parts = signature.split(",");
275
+ let timestamp = "";
276
+ const signatures = [];
277
+ for (const part of parts) {
278
+ const [key, value] = part.split("=");
279
+ if (key === "t") timestamp = value;
280
+ else if (key === "v1") signatures.push(value);
281
+ }
282
+ if (!timestamp || signatures.length === 0) {
283
+ throw new Error("Invalid Jambonz-Signature format");
284
+ }
285
+ const ts = parseInt(timestamp, 10);
286
+ const now = Math.floor(Date.now() / 1e3);
287
+ if (Math.abs(now - ts) > tolerance) {
288
+ throw new Error("Webhook signature timestamp outside tolerance");
289
+ }
290
+ const payload = typeof req.body === "string" ? req.body : JSON.stringify(req.body);
291
+ const signedPayload = `${timestamp}.${payload}`;
292
+ const expected = createHmac("sha256", secret).update(signedPayload).digest("hex");
293
+ const matched = signatures.some((sig) => {
294
+ try {
295
+ return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
296
+ } catch {
297
+ return false;
298
+ }
299
+ });
300
+ if (!matched) {
301
+ throw new Error("Webhook signature verification failed");
302
+ }
303
+ next();
304
+ } catch (err) {
305
+ next(err instanceof Error ? err : new Error(String(err)));
306
+ }
307
+ };
308
+ }
309
+ };
310
+
311
+ export { WebhookResponse };
312
+ //# sourceMappingURL=index.js.map
313
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/validator.ts","../../src/verb-builder.ts","../../src/webhook/response.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all 36 JSON schemas from schema/ and validates verb arrays and individual verbs.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync } from 'fs';\nimport { resolve, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n// Schema $id to file path mapping\nconst COMPONENT_SCHEMAS = [\n 'auth',\n 'actionHook',\n 'synthesizer',\n 'recognizer',\n 'target',\n 'vad',\n 'bidirectionalAudio',\n 'fillerNoise',\n 'actionHookDelayAction',\n] as const;\n\nconst VERB_SCHEMAS = [\n 'answer',\n 'alert',\n 'config',\n 'say',\n 'play',\n 'gather',\n 'dial',\n 'listen',\n 'stream',\n 'llm',\n 'pipeline',\n 'conference',\n 'transcribe',\n 'enqueue',\n 'dequeue',\n 'dtmf',\n 'dub',\n 'hangup',\n 'leave',\n 'message',\n 'pause',\n 'redirect',\n 'tag',\n 'sip-decline',\n 'sip-request',\n 'sip-refer',\n] as const;\n\nfunction loadSchema(schemaDir: string, relativePath: string): Record<string, unknown> {\n const fullPath = resolve(schemaDir, relativePath);\n return JSON.parse(readFileSync(fullPath, 'utf-8')) as Record<string, unknown>;\n}\n\nfunction findSchemaDir(): string {\n // Walk up from this file to find the schema/ directory\n // In development: typescript/src/validator.ts -> ../../schema\n // In dist: typescript/dist/validator.js -> ../../schema\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n // Try relative paths from both src and dist locations\n const candidates = [\n resolve(currentDir, '../../schema'), // from src/\n resolve(currentDir, '../../../schema'), // from dist/\n ];\n\n for (const candidate of candidates) {\n try {\n readFileSync(resolve(candidate, 'jambonz-app.schema.json'), 'utf-8');\n return candidate;\n } catch {\n // try next\n }\n }\n\n throw new Error(\n 'Could not find jambonz schema directory. Ensure the schema/ directory is present alongside the typescript/ directory.'\n );\n}\n\nexport class JambonzValidator {\n private validateApp: ValidateFunction;\n private ajv: Ajv;\n\n constructor(schemaDir?: string) {\n const dir = schemaDir ?? findSchemaDir();\n this.ajv = new Ajv({\n allErrors: true,\n strict: false,\n validateSchema: false,\n logger: false,\n });\n\n // Register component schemas first (they are referenced by verb schemas)\n for (const name of COMPONENT_SCHEMAS) {\n const schema = loadSchema(dir, `components/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n for (const name of VERB_SCHEMAS) {\n const schema = loadSchema(dir, `verbs/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(dir, 'jambonz-app.schema.json');\n this.validateApp = this.ajv.compile(appSchema);\n }\n\n /** Validate a complete verb array (a jambonz application). */\n validate(app: unknown): ValidationResult {\n const valid = this.validateApp(app);\n if (valid) {\n return { valid: true, errors: [] };\n }\n return {\n valid: false,\n errors: formatErrors(this.validateApp.errors),\n };\n }\n\n /** Validate a single verb object. */\n validateVerb(verb: unknown): ValidationResult {\n // Wrap in an array and validate as an app\n return this.validate([verb]);\n }\n}\n\nfunction formatErrors(errors: ErrorObject[] | null | undefined): ValidationError[] {\n if (!errors) return [];\n return errors.map((err) => ({\n path: err.instancePath || '/',\n message: err.message || 'Unknown validation error',\n }));\n}\n\nlet _defaultValidator: JambonzValidator | null = null;\n\n/** Get a shared validator instance. */\nexport function getValidator(schemaDir?: string): JambonzValidator {\n if (!_defaultValidator) {\n _defaultValidator = new JambonzValidator(schemaDir);\n }\n return _defaultValidator;\n}\n","/**\n * Shared VerbBuilder base class.\n * Provides typed verb methods and raw JSON input for both WebhookResponse and WS Session.\n */\n\nimport type {\n AlertVerb,\n AnswerVerb,\n ConferenceVerb,\n ConfigVerb,\n DequeueVerb,\n DialVerb,\n DtmfVerb,\n DubVerb,\n EnqueueVerb,\n GatherVerb,\n HangupVerb,\n LeaveVerb,\n ListenVerb,\n LlmVerb,\n MessageVerb,\n PauseVerb,\n PipelineVerb,\n PlayVerb,\n RedirectVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n Verb,\n} from './types/verbs.js';\nimport { JambonzValidator } from './validator.js';\n\nexport interface VerbBuilderOptions {\n /** Enable runtime schema validation. Default: true. */\n validate?: boolean;\n /** Path to schema directory. Auto-detected if omitted. */\n schemaDir?: string;\n}\n\nexport class VerbBuilder {\n protected verbs: Verb[] = [];\n protected validator: JambonzValidator | null;\n\n constructor(opts?: VerbBuilderOptions) {\n if (opts?.validate === false) {\n this.validator = null;\n } else {\n this.validator = new JambonzValidator(opts?.schemaDir);\n }\n }\n\n // --- Audio & Speech ---\n\n say(opts: Omit<SayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'say', ...opts });\n }\n\n play(opts: Omit<PlayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'play', ...opts });\n }\n\n gather(opts: Omit<GatherVerb, 'verb'>): this {\n return this.addVerb({ verb: 'gather', ...opts });\n }\n\n // --- AI & Real-time ---\n\n llm(opts: Omit<LlmVerb, 'verb'>): this {\n return this.addVerb({ verb: 'llm', ...opts });\n }\n\n pipeline(opts: Omit<PipelineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pipeline', ...opts });\n }\n\n listen(opts: Omit<ListenVerb, 'verb'>): this {\n return this.addVerb({ verb: 'listen', ...opts });\n }\n\n stream(opts: Omit<StreamVerb, 'verb'>): this {\n return this.addVerb({ verb: 'stream', ...opts });\n }\n\n transcribe(opts: Omit<TranscribeVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transcribe', ...opts });\n }\n\n // --- Call Control ---\n\n dial(opts: Omit<DialVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dial', ...opts });\n }\n\n conference(opts: Omit<ConferenceVerb, 'verb'>): this {\n return this.addVerb({ verb: 'conference', ...opts });\n }\n\n enqueue(opts: Omit<EnqueueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'enqueue', ...opts });\n }\n\n dequeue(opts: Omit<DequeueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dequeue', ...opts });\n }\n\n hangup(opts?: Omit<HangupVerb, 'verb'>): this {\n return this.addVerb({ verb: 'hangup', ...opts });\n }\n\n redirect(opts: Omit<RedirectVerb, 'verb'>): this {\n return this.addVerb({ verb: 'redirect', ...opts });\n }\n\n pause(opts: Omit<PauseVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pause', ...opts });\n }\n\n leave(opts?: Omit<LeaveVerb, 'verb'>): this {\n return this.addVerb({ verb: 'leave', ...opts });\n }\n\n // --- SIP ---\n\n sipDecline(opts: Omit<SipDeclineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:decline', ...opts });\n }\n\n sipRequest(opts: Omit<SipRequestVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:request', ...opts });\n }\n\n sipRefer(opts: Omit<SipReferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:refer', ...opts });\n }\n\n // --- Utility ---\n\n config(opts: Omit<ConfigVerb, 'verb'>): this {\n return this.addVerb({ verb: 'config', ...opts });\n }\n\n answer(opts?: Omit<AnswerVerb, 'verb'>): this {\n return this.addVerb({ verb: 'answer', ...opts });\n }\n\n alert(opts: Omit<AlertVerb, 'verb'>): this {\n return this.addVerb({ verb: 'alert', ...opts });\n }\n\n tag(opts: Omit<TagVerb, 'verb'>): this {\n return this.addVerb({ verb: 'tag', ...opts });\n }\n\n dtmf(opts: Omit<DtmfVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dtmf', ...opts });\n }\n\n dub(opts: Omit<DubVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dub', ...opts });\n }\n\n message(opts: Omit<MessageVerb, 'verb'>): this {\n return this.addVerb({ verb: 'message', ...opts });\n }\n\n // --- Raw JSON input (primary AI agent path) ---\n\n /**\n * Add one or more verbs from raw JSON.\n * Validates against the JSON schemas at runtime if validation is enabled.\n */\n addVerbs(verbs: Verb[]): this {\n if (this.validator) {\n const result = this.validator.validate(verbs);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb validation failed: ${messages}`);\n }\n }\n this.verbs.push(...verbs);\n return this;\n }\n\n // --- Internal ---\n\n protected addVerb(verb: Verb): this {\n if (this.validator) {\n const result = this.validator.validateVerb(verb);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb '${verb.verb}' validation failed: ${messages}`);\n }\n }\n this.verbs.push(verb);\n return this;\n }\n\n /** Get the current verb count. */\n get length(): number {\n return this.verbs.length;\n }\n\n /** Clear all queued verbs. */\n clear(): this {\n this.verbs = [];\n return this;\n }\n\n /** Returns a copy of the current verb array. */\n toJSON(): Verb[] {\n return [...this.verbs];\n }\n}\n","/**\n * WebhookResponse — verb builder for HTTP webhook applications.\n * Extends VerbBuilder with toJSON() and signature verification.\n */\n\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { VerbBuilder, type VerbBuilderOptions } from '../verb-builder.js';\nimport type { JambonzApp } from '../types/verbs.js';\nimport type { IncomingMessage, ServerResponse } from 'http';\n\nexport class WebhookResponse extends VerbBuilder {\n constructor(opts?: VerbBuilderOptions) {\n super(opts);\n }\n\n /** Returns the verb array for JSON serialization. */\n toJSON(): JambonzApp {\n return [...this.verbs];\n }\n\n /**\n * Express-compatible middleware for verifying jambonz webhook signatures.\n * Uses HMAC-SHA256 with timing-safe comparison.\n */\n static verifySignature(secret: string, opts?: { tolerance?: number }) {\n const tolerance = opts?.tolerance ?? 300; // 5 minutes default\n\n return (\n req: IncomingMessage & { body?: unknown; rawBody?: Buffer },\n _res: ServerResponse,\n next: (err?: Error) => void\n ) => {\n try {\n const signature = (req.headers as Record<string, string | undefined>)['jambonz-signature'];\n if (!signature) {\n throw new Error('Missing Jambonz-Signature header');\n }\n\n const parts = signature.split(',');\n let timestamp = '';\n const signatures: string[] = [];\n\n for (const part of parts) {\n const [key, value] = part.split('=');\n if (key === 't') timestamp = value;\n else if (key === 'v1') signatures.push(value);\n }\n\n if (!timestamp || signatures.length === 0) {\n throw new Error('Invalid Jambonz-Signature format');\n }\n\n // Check timestamp tolerance\n const ts = parseInt(timestamp, 10);\n const now = Math.floor(Date.now() / 1000);\n if (Math.abs(now - ts) > tolerance) {\n throw new Error('Webhook signature timestamp outside tolerance');\n }\n\n // Compute expected signature\n const payload = typeof req.body === 'string'\n ? req.body\n : JSON.stringify(req.body);\n const signedPayload = `${timestamp}.${payload}`;\n const expected = createHmac('sha256', secret)\n .update(signedPayload)\n .digest('hex');\n\n // Timing-safe comparison\n const matched = signatures.some((sig) => {\n try {\n return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));\n } catch {\n return false;\n }\n });\n\n if (!matched) {\n throw new Error('Webhook signature verification failed');\n }\n\n next();\n } catch (err) {\n next(err instanceof Error ? err : new Error(String(err)));\n }\n };\n }\n}\n"]}