@absolutejs/voice 0.0.22-beta.74 → 0.0.22-beta.76

package/dist/client/opsStatusWidget.d.ts

@@ -29,7 +29,7 @@ export type VoiceOpsStatusWidgetOptions = VoiceAppKitStatusClientOptions & {
     includeLinks?: boolean;
     title?: string;
 };
-export declare const getVoiceOpsStatusLabel: (report?: VoiceAppKitStatusReport | null, error?: string | null) => "Passing" | "Unavailable" | "Checking" | "Needs attention";
+export declare const getVoiceOpsStatusLabel: (report?: VoiceAppKitStatusReport | null, error?: string | null) => "Passing" | "Needs attention" | "Unavailable" | "Checking";
 export declare const createVoiceOpsStatusViewModel: (snapshot: VoiceAppKitStatusSnapshot, options?: VoiceOpsStatusWidgetOptions) => VoiceOpsStatusViewModel;
 export declare const renderVoiceOpsStatusHTML: (snapshot: VoiceAppKitStatusSnapshot, options?: VoiceOpsStatusWidgetOptions) => string;
 export declare const getVoiceOpsStatusCSS: () => string;

package/dist/index.d.ts

@@ -81,7 +81,7 @@ export type { VoiceS3ReviewStoreClient, VoiceS3ReviewStoreFile, VoiceS3ReviewSto
 export type { VoiceSQLiteRuntimeStorage, VoiceSQLiteStoreOptions } from './sqliteStore';
 export type { StoredVoiceIntegrationEvent, StoredVoiceExternalObjectMap, StoredVoiceOpsTask, VoiceExternalObjectMap, VoiceExternalObjectMapStore, VoiceOpsTaskAgeBucket, VoiceOpsTaskAnalyticsOptions, VoiceOpsTaskAnalyticsSummary, VoiceOpsTaskAssignmentRule, VoiceOpsTaskAssignmentRuleCondition, VoiceOpsTaskAssignmentRules, VoiceOpsTaskAssigneeAnalytics, VoiceOpsDispositionTaskPolicies, VoiceOpsSLABreachPolicy, VoiceIntegrationDeliveryStatus, VoiceIntegrationEvent, VoiceIntegrationEventStore, VoiceIntegrationSinkDelivery, VoiceIntegrationEventType, VoiceIntegrationWebhookConfig, VoiceOpsTask, VoiceOpsTaskHistoryEntry, VoiceOpsTaskKind, VoiceOpsTaskPolicy, VoiceOpsTaskPriority, VoiceOpsTaskStatus, VoiceOpsTaskStore, VoiceOpsTaskSummary, VoiceOpsTaskWorkerAnalytics } from './ops';
 export { createTwilioMediaStreamBridge, createTwilioVoiceRoutes, createTwilioVoiceResponse, decodeTwilioMulawBase64, encodeTwilioMulawBase64, transcodePCMToTwilioOutboundPayload, transcodeTwilioInboundPayloadToPCM16 } from './telephony/twilio';
-export type { TwilioInboundMessage, TwilioMediaStreamBridge, TwilioMediaStreamBridgeOptions, TwilioMediaStreamSocket, TwilioOutboundClearMessage, TwilioOutboundMarkMessage, TwilioOutboundMediaMessage, TwilioOutboundMessage, TwilioVoiceRouteParameters, TwilioVoiceResponseOptions, TwilioVoiceRoutesOptions } from './telephony/twilio';
+export type { TwilioInboundMessage, TwilioMediaStreamBridge, TwilioMediaStreamBridgeOptions, TwilioMediaStreamSocket, TwilioOutboundClearMessage, TwilioOutboundMarkMessage, TwilioOutboundMediaMessage, TwilioOutboundMessage, TwilioVoiceRouteParameters, TwilioVoiceResponseOptions, TwilioVoiceSmokeCheck, TwilioVoiceSmokeOptions, TwilioVoiceSmokeReport, TwilioVoiceSetupOptions, TwilioVoiceSetupStatus, TwilioVoiceRoutesOptions } from './telephony/twilio';
 export { shapeTelephonyAssistantText } from './telephony/response';
 export type { TelephonyResponseShapeMode, TelephonyResponseShapeOptions } from './telephony/response';
 export * from './types';

package/dist/index.js

@@ -15226,6 +15226,166 @@ var resolveTwilioStreamParameters = async (parameters, input) => {
   }
   return parameters;
 };
+var joinUrlPath = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+var escapeHtml17 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var getWebhookVerificationUrl = (webhook, input) => {
+  if (!webhook?.verificationUrl) {
+    return;
+  }
+  if (typeof webhook.verificationUrl === "function") {
+    return webhook.verificationUrl(input);
+  }
+  return webhook.verificationUrl;
+};
+var buildTwilioVoiceSetupStatus = async (options, input) => {
+  const origin = resolveRequestOrigin(input.request);
+  const stream = await resolveTwilioStreamUrl(options, input);
+  const twiml = joinUrlPath(origin, input.twimlPath);
+  const webhook = joinUrlPath(origin, input.webhookPath);
+  const verificationUrl = getWebhookVerificationUrl(options.webhook, input);
+  const missing = Object.entries(options.setup?.requiredEnv ?? {}).filter((entry) => !entry[1]).map(([name]) => name);
+  const signingConfigured = Boolean(options.webhook?.signingSecret || options.webhook?.verify);
+  const warnings = [
+    ...stream.startsWith("wss://") ? [] : ["Twilio media streams should use wss:// in production."],
+    ...signingConfigured ? [] : ["Webhook signature verification is not configured."],
+    ...verificationUrl || !signingConfigured ? [] : ["Webhook signing is configured without an explicit verification URL."]
+  ];
+  return {
+    generatedAt: Date.now(),
+    missing,
+    provider: "twilio",
+    ready: missing.length === 0 && signingConfigured && warnings.length === 0,
+    signing: {
+      configured: signingConfigured,
+      mode: options.webhook?.verify ? "custom" : options.webhook?.signingSecret ? "twilio-signature" : "none",
+      verificationUrl
+    },
+    urls: {
+      stream,
+      twiml,
+      webhook
+    },
+    warnings
+  };
+};
+var renderTwilioVoiceSetupHTML = (status, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
+<p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Twilio setup</p>
+<h1>${escapeHtml17(title)}</h1>
+<p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
+<section>
+<h2>URLs</h2>
+<ul>
+<li><strong>TwiML:</strong> <code>${escapeHtml17(status.urls.twiml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml17(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml17(status.urls.webhook)}</code></li>
+</ul>
+</section>
+<section>
+<h2>Signing</h2>
+<p>Mode: <code>${status.signing.mode}</code></p>
+${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml17(status.signing.verificationUrl)}</code></p>` : ""}
+</section>
+${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml17(name)}</code></li>`).join("")}</ul></section>` : ""}
+${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml17(warning)}</li>`).join("")}</ul></section>` : ""}
+</main>`;
+var extractTwilioStreamUrl = (twiml) => twiml.match(/<Stream\b[^>]*\surl="([^"]+)"/i)?.[1]?.replaceAll("&amp;", "&");
+var createSmokeCheck = (name, status, message, details) => ({
+  details,
+  message,
+  name,
+  status
+});
+var renderTwilioVoiceSmokeHTML = (report, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
+<p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Twilio smoke test</p>
+<h1>${escapeHtml17(title)}</h1>
+<p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
+<section>
+<h2>Checks</h2>
+<ul>
+${report.checks.map((check) => `<li><strong>${escapeHtml17(check.name)}</strong>: ${escapeHtml17(check.status)}${check.message ? ` - ${escapeHtml17(check.message)}` : ""}</li>`).join("")}
+</ul>
+</section>
+<section>
+<h2>Observed URLs</h2>
+<ul>
+<li><strong>TwiML:</strong> <code>${escapeHtml17(report.setup.urls.twiml)}</code></li>
+<li><strong>Stream:</strong> <code>${escapeHtml17(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
+<li><strong>Webhook:</strong> <code>${escapeHtml17(report.setup.urls.webhook)}</code></li>
+</ul>
+</section>
+</main>`;
+var runTwilioVoiceSmokeTest = async (input) => {
+  const setup = await buildTwilioVoiceSetupStatus(input.options, input);
+  const checks = [];
+  const twimlUrl = new URL(setup.urls.twiml);
+  twimlUrl.searchParams.set("scenarioId", input.options.smoke?.scenarioId ?? "smoke");
+  twimlUrl.searchParams.set("sessionId", input.options.smoke?.sessionId ?? "smoke-session");
+  const twimlResponse = await input.app.handle(new Request(twimlUrl, {
+    headers: input.request.headers
+  }));
+  const twiml = await twimlResponse.text();
+  const streamUrl = extractTwilioStreamUrl(twiml);
+  checks.push(createSmokeCheck("twiml", twimlResponse.ok && Boolean(streamUrl) ? "pass" : "fail", streamUrl ? "TwiML includes a media stream URL." : 'TwiML is missing <Stream url="...">.', {
+    status: twimlResponse.status,
+    streamUrl
+  }));
+  checks.push(createSmokeCheck("stream-url", streamUrl?.startsWith("wss://") ? "pass" : "fail", streamUrl?.startsWith("wss://") ? "Media stream URL uses wss://." : "Media stream URL should use wss:// for Twilio.", {
+    streamUrl
+  }));
+  const webhookBody = {
+    CallSid: input.options.smoke?.callSid ?? "CA_SMOKE_TEST",
+    CallStatus: input.options.smoke?.status ?? "busy",
+    SipResponseCode: String(input.options.smoke?.sipCode ?? 486)
+  };
+  const webhookHeaders = new Headers({
+    "content-type": "application/x-www-form-urlencoded"
+  });
+  const verificationUrl = setup.signing.verificationUrl ?? setup.urls.webhook;
+  if (input.options.webhook?.signingSecret) {
+    webhookHeaders.set("x-twilio-signature", await signVoiceTwilioWebhook({
+      authToken: input.options.webhook.signingSecret,
+      body: webhookBody,
+      url: verificationUrl
+    }));
+  }
+  const webhookResponse = await input.app.handle(new Request(setup.urls.webhook, {
+    body: new URLSearchParams(webhookBody),
+    headers: webhookHeaders,
+    method: "POST"
+  }));
+  const webhookText = await webhookResponse.text();
+  const webhookPayload = (() => {
+    try {
+      return JSON.parse(webhookText);
+    } catch {
+      return webhookText;
+    }
+  })();
+  checks.push(createSmokeCheck("webhook", webhookResponse.ok ? "pass" : "fail", webhookResponse.ok ? "Synthetic Twilio status callback was accepted." : "Synthetic Twilio status callback failed.", {
+    status: webhookResponse.status
+  }));
+  for (const warning of setup.warnings) {
+    checks.push(createSmokeCheck("setup-warning", "warn", warning));
+  }
+  for (const name of setup.missing) {
+    checks.push(createSmokeCheck("missing-env", "fail", `${name} is missing.`));
+  }
+  return {
+    checks,
+    generatedAt: Date.now(),
+    pass: checks.every((check) => check.status !== "fail"),
+    provider: "twilio",
+    setup,
+    twiml: {
+      status: twimlResponse.status,
+      streamUrl
+    },
+    webhook: {
+      body: webhookPayload,
+      status: webhookResponse.status
+    }
+  };
+};
 var normalizeOnTurn2 = (handler) => {
   if (handler.length > 1) {
     const directHandler = handler;
@@ -15606,9 +15766,11 @@ var createTwilioVoiceRoutes = (options) => {
   const streamPath = options.streamPath ?? "/api/voice/twilio/stream";
   const twimlPath = options.twiml?.path ?? "/api/voice/twilio";
   const webhookPath = options.webhook?.path ?? "/api/voice/twilio/webhook";
+  const setupPath = options.setup?.path === false ? false : options.setup?.path ?? "/api/voice/twilio/setup";
+  const smokePath = options.smoke?.path === false ? false : options.smoke?.path ?? "/api/voice/twilio/smoke";
   const bridges = new WeakMap;
   const webhookPolicy = options.webhook?.policy ?? options.outcomePolicy ?? createVoiceTelephonyOutcomePolicy();
-  return new Elysia18({
+  const app = new Elysia18({
     name: options.name ?? "absolutejs-voice-twilio"
   }).get(twimlPath, async ({ query, request }) => {
     const streamUrl = await resolveTwilioStreamUrl(options, {
@@ -15678,6 +15840,69 @@ var createTwilioVoiceRoutes = (options) => {
     policy: webhookPolicy,
     provider: "twilio"
   }));
+  if (!setupPath) {
+    if (!smokePath) {
+      return app;
+    }
+    return app.get(smokePath, async ({ query, request }) => {
+      const report = await runTwilioVoiceSmokeTest({
+        app,
+        options,
+        query,
+        request,
+        streamPath,
+        twimlPath,
+        webhookPath
+      });
+      if (query.format === "html") {
+        return new Response(renderTwilioVoiceSmokeHTML(report, options.smoke?.title ?? "AbsoluteJS Twilio Voice Smoke Test"), {
+          headers: {
+            "content-type": "text/html; charset=utf-8"
+          }
+        });
+      }
+      return report;
+    });
+  }
+  const withSetup = app.get(setupPath, async ({ query, request }) => {
+    const status = await buildTwilioVoiceSetupStatus(options, {
+      query,
+      request,
+      streamPath,
+      twimlPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderTwilioVoiceSetupHTML(status, options.setup?.title ?? "AbsoluteJS Twilio Voice Setup"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return status;
+  });
+  if (!smokePath) {
+    return withSetup;
+  }
+  return withSetup.get(smokePath, async ({ query, request }) => {
+    const report = await runTwilioVoiceSmokeTest({
+      app,
+      options,
+      query,
+      request,
+      streamPath,
+      twimlPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderTwilioVoiceSmokeHTML(report, options.smoke?.title ?? "AbsoluteJS Twilio Voice Smoke Test"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return report;
+  });
 };
 // src/telephony/response.ts
 var normalizeWhitespace = (value) => value.replace(/\s+/g, " ").trim();

package/dist/telephony/twilio.d.ts

@@ -113,9 +113,63 @@ export type TwilioVoiceRouteParameters = Record<string, string | number | boolea
     query: Record<string, unknown>;
     request: Request;
 }) => Promise<Record<string, string | number | boolean | undefined>> | Record<string, string | number | boolean | undefined>);
+export type TwilioVoiceSetupStatus = {
+    generatedAt: number;
+    missing: string[];
+    provider: 'twilio';
+    ready: boolean;
+    signing: {
+        configured: boolean;
+        mode: 'custom' | 'none' | 'twilio-signature';
+        verificationUrl?: string;
+    };
+    urls: {
+        stream: string;
+        twiml: string;
+        webhook: string;
+    };
+    warnings: string[];
+};
+export type TwilioVoiceSetupOptions = {
+    path?: false | string;
+    requiredEnv?: Record<string, string | undefined>;
+    title?: string;
+};
+export type TwilioVoiceSmokeCheck = {
+    details?: Record<string, unknown>;
+    message?: string;
+    name: string;
+    status: 'fail' | 'pass' | 'warn';
+};
+export type TwilioVoiceSmokeReport = {
+    checks: TwilioVoiceSmokeCheck[];
+    generatedAt: number;
+    pass: boolean;
+    provider: 'twilio';
+    setup: TwilioVoiceSetupStatus;
+    twiml?: {
+        status: number;
+        streamUrl?: string;
+    };
+    webhook?: {
+        body?: unknown;
+        status: number;
+    };
+};
+export type TwilioVoiceSmokeOptions = {
+    callSid?: string;
+    path?: false | string;
+    scenarioId?: string;
+    sessionId?: string;
+    sipCode?: number;
+    status?: string;
+    title?: string;
+};
 export type TwilioVoiceRoutesOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = TwilioMediaStreamBridgeOptions<TContext, TSession, TResult> & {
     name?: string;
     outcomePolicy?: VoiceTelephonyOutcomePolicy;
+    smoke?: TwilioVoiceSmokeOptions;
+    setup?: TwilioVoiceSetupOptions;
     streamPath?: string;
     twiml?: {
         parameters?: TwilioVoiceRouteParameters;

package/dist/testing/index.js

@@ -8565,6 +8565,166 @@ var resolveTwilioStreamParameters = async (parameters, input) => {
   }
   return parameters;
 };
+var joinUrlPath = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+var escapeHtml2 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var getWebhookVerificationUrl = (webhook, input) => {
+  if (!webhook?.verificationUrl) {
+    return;
+  }
+  if (typeof webhook.verificationUrl === "function") {
+    return webhook.verificationUrl(input);
+  }
+  return webhook.verificationUrl;
+};
+var buildTwilioVoiceSetupStatus = async (options, input) => {
+  const origin = resolveRequestOrigin(input.request);
+  const stream = await resolveTwilioStreamUrl(options, input);
+  const twiml = joinUrlPath(origin, input.twimlPath);
+  const webhook = joinUrlPath(origin, input.webhookPath);
+  const verificationUrl = getWebhookVerificationUrl(options.webhook, input);
+  const missing = Object.entries(options.setup?.requiredEnv ?? {}).filter((entry) => !entry[1]).map(([name]) => name);
+  const signingConfigured = Boolean(options.webhook?.signingSecret || options.webhook?.verify);
+  const warnings = [
+    ...stream.startsWith("wss://") ? [] : ["Twilio media streams should use wss:// in production."],
+    ...signingConfigured ? [] : ["Webhook signature verification is not configured."],
+    ...verificationUrl || !signingConfigured ? [] : ["Webhook signing is configured without an explicit verification URL."]
+  ];
+  return {
+    generatedAt: Date.now(),
+    missing,
+    provider: "twilio",
+    ready: missing.length === 0 && signingConfigured && warnings.length === 0,
+    signing: {
+      configured: signingConfigured,
+      mode: options.webhook?.verify ? "custom" : options.webhook?.signingSecret ? "twilio-signature" : "none",
+      verificationUrl
+    },
+    urls: {
+      stream,
+      twiml,
+      webhook
+    },
+    warnings
+  };
+};
+var renderTwilioVoiceSetupHTML = (status, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
+<p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Twilio setup</p>
+<h1>${escapeHtml2(title)}</h1>
+<p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
+<section>
+<h2>URLs</h2>
+<ul>
+<li><strong>TwiML:</strong> <code>${escapeHtml2(status.urls.twiml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml2(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml2(status.urls.webhook)}</code></li>
+</ul>
+</section>
+<section>
+<h2>Signing</h2>
+<p>Mode: <code>${status.signing.mode}</code></p>
+${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml2(status.signing.verificationUrl)}</code></p>` : ""}
+</section>
+${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml2(name)}</code></li>`).join("")}</ul></section>` : ""}
+${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml2(warning)}</li>`).join("")}</ul></section>` : ""}
+</main>`;
+var extractTwilioStreamUrl = (twiml) => twiml.match(/<Stream\b[^>]*\surl="([^"]+)"/i)?.[1]?.replaceAll("&amp;", "&");
+var createSmokeCheck = (name, status, message, details) => ({
+  details,
+  message,
+  name,
+  status
+});
+var renderTwilioVoiceSmokeHTML = (report, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
+<p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Twilio smoke test</p>
+<h1>${escapeHtml2(title)}</h1>
+<p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
+<section>
+<h2>Checks</h2>
+<ul>
+${report.checks.map((check) => `<li><strong>${escapeHtml2(check.name)}</strong>: ${escapeHtml2(check.status)}${check.message ? ` - ${escapeHtml2(check.message)}` : ""}</li>`).join("")}
+</ul>
+</section>
+<section>
+<h2>Observed URLs</h2>
+<ul>
+<li><strong>TwiML:</strong> <code>${escapeHtml2(report.setup.urls.twiml)}</code></li>
+<li><strong>Stream:</strong> <code>${escapeHtml2(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
+<li><strong>Webhook:</strong> <code>${escapeHtml2(report.setup.urls.webhook)}</code></li>
+</ul>
+</section>
+</main>`;
+var runTwilioVoiceSmokeTest = async (input) => {
+  const setup = await buildTwilioVoiceSetupStatus(input.options, input);
+  const checks = [];
+  const twimlUrl = new URL(setup.urls.twiml);
+  twimlUrl.searchParams.set("scenarioId", input.options.smoke?.scenarioId ?? "smoke");
+  twimlUrl.searchParams.set("sessionId", input.options.smoke?.sessionId ?? "smoke-session");
+  const twimlResponse = await input.app.handle(new Request(twimlUrl, {
+    headers: input.request.headers
+  }));
+  const twiml = await twimlResponse.text();
+  const streamUrl = extractTwilioStreamUrl(twiml);
+  checks.push(createSmokeCheck("twiml", twimlResponse.ok && Boolean(streamUrl) ? "pass" : "fail", streamUrl ? "TwiML includes a media stream URL." : 'TwiML is missing <Stream url="...">.', {
+    status: twimlResponse.status,
+    streamUrl
+  }));
+  checks.push(createSmokeCheck("stream-url", streamUrl?.startsWith("wss://") ? "pass" : "fail", streamUrl?.startsWith("wss://") ? "Media stream URL uses wss://." : "Media stream URL should use wss:// for Twilio.", {
+    streamUrl
+  }));
+  const webhookBody = {
+    CallSid: input.options.smoke?.callSid ?? "CA_SMOKE_TEST",
+    CallStatus: input.options.smoke?.status ?? "busy",
+    SipResponseCode: String(input.options.smoke?.sipCode ?? 486)
+  };
+  const webhookHeaders = new Headers({
+    "content-type": "application/x-www-form-urlencoded"
+  });
+  const verificationUrl = setup.signing.verificationUrl ?? setup.urls.webhook;
+  if (input.options.webhook?.signingSecret) {
+    webhookHeaders.set("x-twilio-signature", await signVoiceTwilioWebhook({
+      authToken: input.options.webhook.signingSecret,
+      body: webhookBody,
+      url: verificationUrl
+    }));
+  }
+  const webhookResponse = await input.app.handle(new Request(setup.urls.webhook, {
+    body: new URLSearchParams(webhookBody),
+    headers: webhookHeaders,
+    method: "POST"
+  }));
+  const webhookText = await webhookResponse.text();
+  const webhookPayload = (() => {
+    try {
+      return JSON.parse(webhookText);
+    } catch {
+      return webhookText;
+    }
+  })();
+  checks.push(createSmokeCheck("webhook", webhookResponse.ok ? "pass" : "fail", webhookResponse.ok ? "Synthetic Twilio status callback was accepted." : "Synthetic Twilio status callback failed.", {
+    status: webhookResponse.status
+  }));
+  for (const warning of setup.warnings) {
+    checks.push(createSmokeCheck("setup-warning", "warn", warning));
+  }
+  for (const name of setup.missing) {
+    checks.push(createSmokeCheck("missing-env", "fail", `${name} is missing.`));
+  }
+  return {
+    checks,
+    generatedAt: Date.now(),
+    pass: checks.every((check) => check.status !== "fail"),
+    provider: "twilio",
+    setup,
+    twiml: {
+      status: twimlResponse.status,
+      streamUrl
+    },
+    webhook: {
+      body: webhookPayload,
+      status: webhookResponse.status
+    }
+  };
+};
 var normalizeOnTurn = (handler) => {
   if (handler.length > 1) {
     const directHandler = handler;
@@ -8945,9 +9105,11 @@ var createTwilioVoiceRoutes = (options) => {
   const streamPath = options.streamPath ?? "/api/voice/twilio/stream";
   const twimlPath = options.twiml?.path ?? "/api/voice/twilio";
   const webhookPath = options.webhook?.path ?? "/api/voice/twilio/webhook";
+  const setupPath = options.setup?.path === false ? false : options.setup?.path ?? "/api/voice/twilio/setup";
+  const smokePath = options.smoke?.path === false ? false : options.smoke?.path ?? "/api/voice/twilio/smoke";
   const bridges = new WeakMap;
   const webhookPolicy = options.webhook?.policy ?? options.outcomePolicy ?? createVoiceTelephonyOutcomePolicy();
-  return new Elysia2({
+  const app = new Elysia2({
     name: options.name ?? "absolutejs-voice-twilio"
   }).get(twimlPath, async ({ query, request }) => {
     const streamUrl = await resolveTwilioStreamUrl(options, {
@@ -9017,6 +9179,69 @@ var createTwilioVoiceRoutes = (options) => {
     policy: webhookPolicy,
     provider: "twilio"
   }));
+  if (!setupPath) {
+    if (!smokePath) {
+      return app;
+    }
+    return app.get(smokePath, async ({ query, request }) => {
+      const report = await runTwilioVoiceSmokeTest({
+        app,
+        options,
+        query,
+        request,
+        streamPath,
+        twimlPath,
+        webhookPath
+      });
+      if (query.format === "html") {
+        return new Response(renderTwilioVoiceSmokeHTML(report, options.smoke?.title ?? "AbsoluteJS Twilio Voice Smoke Test"), {
+          headers: {
+            "content-type": "text/html; charset=utf-8"
+          }
+        });
+      }
+      return report;
+    });
+  }
+  const withSetup = app.get(setupPath, async ({ query, request }) => {
+    const status = await buildTwilioVoiceSetupStatus(options, {
+      query,
+      request,
+      streamPath,
+      twimlPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderTwilioVoiceSetupHTML(status, options.setup?.title ?? "AbsoluteJS Twilio Voice Setup"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return status;
+  });
+  if (!smokePath) {
+    return withSetup;
+  }
+  return withSetup.get(smokePath, async ({ query, request }) => {
+    const report = await runTwilioVoiceSmokeTest({
+      app,
+      options,
+      query,
+      request,
+      streamPath,
+      twimlPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderTwilioVoiceSmokeHTML(report, options.smoke?.title ?? "AbsoluteJS Twilio Voice Smoke Test"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return report;
+  });
 };
 
 // src/testing/telephony.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.74",
+	"version": "0.0.22-beta.76",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",