@absolutejs/voice 0.0.22-beta.77 → 0.0.22-beta.79

package/dist/index.d.ts

@@ -82,8 +82,12 @@ export type { VoiceSQLiteRuntimeStorage, VoiceSQLiteStoreOptions } from './sqlit
 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 { evaluateVoiceTelephonyContract } from './telephony/contract';
+export { createTelnyxVoiceResponse, createTelnyxVoiceRoutes, verifyVoiceTelnyxWebhookSignature } from './telephony/telnyx';
+export { createPlivoVoiceResponse, createPlivoVoiceRoutes, signVoicePlivoWebhook, verifyVoicePlivoWebhookSignature } from './telephony/plivo';
 export type { TwilioInboundMessage, TwilioMediaStreamBridge, TwilioMediaStreamBridgeOptions, TwilioMediaStreamSocket, TwilioOutboundClearMessage, TwilioOutboundMarkMessage, TwilioOutboundMediaMessage, TwilioOutboundMessage, TwilioVoiceRouteParameters, TwilioVoiceResponseOptions, TwilioVoiceSmokeCheck, TwilioVoiceSmokeOptions, TwilioVoiceSmokeReport, TwilioVoiceSetupOptions, TwilioVoiceSetupStatus, TwilioVoiceRoutesOptions } from './telephony/twilio';
 export type { VoiceTelephonyContractIssue, VoiceTelephonyContractOptions, VoiceTelephonyContractReport, VoiceTelephonyContractRequirement, VoiceTelephonyProvider, VoiceTelephonySetupStatus, VoiceTelephonySmokeCheck, VoiceTelephonySmokeReport } from './telephony/contract';
+export type { TelnyxVoiceResponseOptions, TelnyxVoiceRoutesOptions, TelnyxVoiceSetupOptions, TelnyxVoiceSetupStatus, TelnyxVoiceSmokeCheck, TelnyxVoiceSmokeOptions, TelnyxVoiceSmokeReport } from './telephony/telnyx';
+export type { PlivoVoiceResponseOptions, PlivoVoiceRoutesOptions, PlivoVoiceSetupOptions, PlivoVoiceSetupStatus, PlivoVoiceSmokeCheck, PlivoVoiceSmokeOptions, PlivoVoiceSmokeReport } from './telephony/plivo';
 export { shapeTelephonyAssistantText } from './telephony/response';
 export type { TelephonyResponseShapeMode, TelephonyResponseShapeOptions } from './telephony/response';
 export * from './types';

package/dist/index.js

@@ -15983,6 +15983,622 @@ var evaluateVoiceTelephonyContract = (input) => {
     smoke: input.smoke
   };
 };
+// src/telephony/telnyx.ts
+import { Buffer as Buffer4 } from "buffer";
+import { Elysia as Elysia19 } from "elysia";
+var escapeXml3 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml18 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var joinUrlPath2 = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+var resolveRequestOrigin2 = (request) => {
+  const url = new URL(request.url);
+  const forwardedHost = request.headers.get("x-forwarded-host");
+  const forwardedProto = request.headers.get("x-forwarded-proto");
+  const host = forwardedHost ?? request.headers.get("host") ?? url.host;
+  const protocol = forwardedProto ?? url.protocol.replace(":", "");
+  return `${protocol}://${host}`;
+};
+var extractTelnyxStreamUrl = (texml) => texml.match(/<Stream\b[^>]*\surl="([^"]+)"/i)?.[1]?.replaceAll("&amp;", "&");
+var createSmokeCheck2 = (name, status, message, details) => ({
+  details,
+  message,
+  name,
+  status
+});
+var resolveTelnyxStreamUrl = async (options, input) => {
+  if (typeof options.texml?.streamUrl === "function") {
+    return options.texml.streamUrl(input);
+  }
+  if (typeof options.texml?.streamUrl === "string") {
+    return options.texml.streamUrl;
+  }
+  const origin = resolveRequestOrigin2(input.request);
+  const wsOrigin = origin.replace(/^http:/, "ws:").replace(/^https:/, "wss:");
+  return `${wsOrigin}${input.streamPath}`;
+};
+var createTelnyxVoiceResponse = (options) => {
+  const attributes = [
+    `url="${escapeXml3(options.streamUrl)}"`,
+    options.streamName ? `name="${escapeXml3(options.streamName)}"` : undefined,
+    options.track ? `track="${escapeXml3(options.track)}"` : undefined,
+    options.codec ? `codec="${escapeXml3(options.codec)}"` : undefined,
+    options.bidirectionalMode ? `bidirectionalMode="${escapeXml3(options.bidirectionalMode)}"` : undefined,
+    options.bidirectionalCodec ? `bidirectionalCodec="${escapeXml3(options.bidirectionalCodec)}"` : undefined
+  ].filter((value) => Boolean(value)).join(" ");
+  return `<?xml version="1.0" encoding="UTF-8"?><Response><Start><Stream ${attributes} /></Start></Response>`;
+};
+var decodeBase64 = (value) => Uint8Array.from(Buffer4.from(value, "base64"));
+var verifyVoiceTelnyxWebhookSignature = async (input) => {
+  if (!input.publicKey) {
+    return { ok: false, reason: "missing-secret" };
+  }
+  const signature = input.headers.get("telnyx-signature-ed25519");
+  const timestamp = input.headers.get("telnyx-timestamp");
+  if (!signature || !timestamp) {
+    return { ok: false, reason: "missing-signature" };
+  }
+  const toleranceSeconds = input.toleranceSeconds ?? 300;
+  const timestampNumber = Number(timestamp);
+  if (Number.isFinite(timestampNumber) && Math.abs(Date.now() / 1000 - timestampNumber) > toleranceSeconds) {
+    return { ok: false, reason: "invalid-signature" };
+  }
+  try {
+    const key = await crypto.subtle.importKey("raw", decodeBase64(input.publicKey), "Ed25519", false, ["verify"]);
+    const ok = await crypto.subtle.verify("Ed25519", key, decodeBase64(signature), new TextEncoder().encode(`${timestamp}|${input.body}`));
+    return ok ? { ok: true } : { ok: false, reason: "invalid-signature" };
+  } catch {
+    return { ok: false, reason: "invalid-signature" };
+  }
+};
+var buildTelnyxVoiceSetupStatus = async (options, input) => {
+  const origin = resolveRequestOrigin2(input.request);
+  const stream = await resolveTelnyxStreamUrl(options, input);
+  const texml = joinUrlPath2(origin, input.texmlPath);
+  const webhook = joinUrlPath2(origin, input.webhookPath);
+  const missing = Object.entries(options.setup?.requiredEnv ?? {}).filter((entry) => !entry[1]).map(([name]) => name);
+  const signingConfigured = Boolean(options.webhook?.publicKey || options.webhook?.verify);
+  const warnings = [
+    ...stream.startsWith("wss://") ? [] : ["Telnyx media streams should use wss:// in production."],
+    ...signingConfigured ? [] : ["Webhook signature verification is not configured."]
+  ];
+  return {
+    generatedAt: Date.now(),
+    missing,
+    provider: "telnyx",
+    ready: missing.length === 0 && signingConfigured && warnings.length === 0,
+    signing: {
+      configured: signingConfigured,
+      mode: options.webhook?.verify ? "custom" : options.webhook?.publicKey ? "provider-signature" : "none",
+      verificationUrl: webhook
+    },
+    urls: {
+      stream,
+      texml,
+      webhook
+    },
+    warnings
+  };
+};
+var renderTelnyxSetupHTML = (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;">Telnyx setup</p>
+<h1>${escapeHtml18(title)}</h1>
+<p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
+<ul>
+<li><strong>TeXML:</strong> <code>${escapeHtml18(status.urls.texml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml18(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml18(status.urls.webhook)}</code></li>
+</ul>
+${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml18(name)}</code></li>`).join("")}</ul>` : ""}
+${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml18(warning)}</li>`).join("")}</ul>` : ""}
+</main>`;
+var renderTelnyxSmokeHTML = (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;">Telnyx smoke test</p>
+<h1>${escapeHtml18(title)}</h1>
+<p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml18(check.name)}</strong>: ${escapeHtml18(check.status)}${check.message ? ` - ${escapeHtml18(check.message)}` : ""}</li>`).join("")}</ul>
+</main>`;
+var runTelnyxSmokeTest = async (input) => {
+  const setup = await buildTelnyxVoiceSetupStatus(input.options, input);
+  const checks = [];
+  const texmlResponse = await input.app.handle(new Request(setup.urls.texml));
+  const texml = await texmlResponse.text();
+  const streamUrl = extractTelnyxStreamUrl(texml);
+  checks.push(createSmokeCheck2("texml", texmlResponse.ok && Boolean(streamUrl) ? "pass" : "fail", streamUrl ? "TeXML includes a media stream URL." : 'TeXML is missing <Stream url="...">.', {
+    status: texmlResponse.status,
+    streamUrl
+  }));
+  checks.push(createSmokeCheck2("stream-url", streamUrl?.startsWith("wss://") ? "pass" : "fail", streamUrl?.startsWith("wss://") ? "Media stream URL uses wss://." : "Media stream URL should use wss:// for Telnyx.", {
+    streamUrl
+  }));
+  const webhookBody = {
+    data: {
+      event_type: input.options.smoke?.eventType ?? "call.hangup",
+      id: "telnyx-smoke-event",
+      payload: {
+        call_control_id: input.options.smoke?.callControlId ?? "telnyx-smoke-call",
+        call_leg_id: input.options.smoke?.callLegId ?? "telnyx-smoke-leg",
+        call_session_id: input.options.smoke?.sessionId ?? "telnyx-smoke-session",
+        hangup_cause: "busy",
+        sip_hangup_cause: 486
+      },
+      record_type: "event"
+    }
+  };
+  const webhookResponse = await input.app.handle(new Request(setup.urls.webhook, {
+    body: JSON.stringify(webhookBody),
+    headers: {
+      "content-type": "application/json"
+    },
+    method: "POST"
+  }));
+  const webhookText = await webhookResponse.text();
+  const webhookPayload = (() => {
+    try {
+      return JSON.parse(webhookText);
+    } catch {
+      return webhookText;
+    }
+  })();
+  checks.push(createSmokeCheck2("webhook", webhookResponse.ok ? "pass" : "fail", webhookResponse.ok ? "Synthetic Telnyx event was accepted." : "Synthetic Telnyx event failed.", {
+    status: webhookResponse.status
+  }));
+  for (const warning of setup.warnings) {
+    checks.push(createSmokeCheck2("setup-warning", "warn", warning));
+  }
+  for (const name of setup.missing) {
+    checks.push(createSmokeCheck2("missing-env", "fail", `${name} is missing.`));
+  }
+  const baseReport = {
+    checks,
+    generatedAt: Date.now(),
+    pass: checks.every((check) => check.status !== "fail"),
+    provider: "telnyx",
+    setup,
+    texml: {
+      status: texmlResponse.status,
+      streamUrl
+    },
+    twiml: {
+      status: texmlResponse.status,
+      streamUrl
+    },
+    webhook: {
+      body: webhookPayload,
+      status: webhookResponse.status
+    }
+  };
+  return {
+    ...baseReport,
+    contract: evaluateVoiceTelephonyContract({
+      setup,
+      smoke: baseReport
+    })
+  };
+};
+var createTelnyxVoiceRoutes = (options = {}) => {
+  const streamPath = options.streamPath ?? "/api/voice/telnyx/stream";
+  const texmlPath = options.texml?.path ?? "/api/voice/telnyx";
+  const webhookPath = options.webhook?.path ?? "/api/voice/telnyx/webhook";
+  const setupPath = options.setup?.path === false ? false : options.setup?.path ?? "/api/voice/telnyx/setup";
+  const smokePath = options.smoke?.path === false ? false : options.smoke?.path ?? "/api/voice/telnyx/smoke";
+  const webhookPolicy = options.webhook?.policy ?? options.outcomePolicy ?? createVoiceTelephonyOutcomePolicy();
+  const verify = options.webhook?.verify ?? (options.webhook?.publicKey ? (input) => verifyVoiceTelnyxWebhookSignature({
+    body: input.rawBody,
+    headers: input.headers,
+    publicKey: options.webhook?.publicKey,
+    toleranceSeconds: options.webhook?.toleranceSeconds
+  }) : undefined);
+  const app = new Elysia19({
+    name: options.name ?? "absolutejs-voice-telnyx"
+  }).get(texmlPath, async ({ query, request }) => {
+    const streamUrl = await resolveTelnyxStreamUrl(options, {
+      query,
+      request,
+      streamPath
+    });
+    return new Response(createTelnyxVoiceResponse({
+      ...options.texml?.response,
+      streamUrl
+    }), {
+      headers: {
+        "content-type": "text/xml; charset=utf-8"
+      }
+    });
+  }).post(texmlPath, async ({ query, request }) => {
+    const streamUrl = await resolveTelnyxStreamUrl(options, {
+      query,
+      request,
+      streamPath
+    });
+    return new Response(createTelnyxVoiceResponse({
+      ...options.texml?.response,
+      streamUrl
+    }), {
+      headers: {
+        "content-type": "text/xml; charset=utf-8"
+      }
+    });
+  }).use(createVoiceTelephonyWebhookRoutes({
+    ...options.webhook ?? {},
+    context: options.context,
+    path: webhookPath,
+    policy: webhookPolicy,
+    provider: "telnyx",
+    requireVerification: Boolean(options.webhook?.publicKey),
+    resolveSessionId: options.webhook?.resolveSessionId ?? (({ event }) => {
+      const metadata = event.metadata;
+      return typeof metadata?.call_session_id === "string" ? metadata.call_session_id : typeof metadata?.callSessionId === "string" ? metadata.callSessionId : typeof metadata?.call_control_id === "string" ? metadata.call_control_id : undefined;
+    }),
+    verify
+  }));
+  const withSetup = setupPath ? app.get(setupPath, async ({ query, request }) => {
+    const status = await buildTelnyxVoiceSetupStatus(options, {
+      query,
+      request,
+      streamPath,
+      texmlPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderTelnyxSetupHTML(status, options.setup?.title ?? "AbsoluteJS Telnyx Voice Setup"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return status;
+  }) : app;
+  if (!smokePath) {
+    return withSetup;
+  }
+  return withSetup.get(smokePath, async ({ query, request }) => {
+    const report = await runTelnyxSmokeTest({
+      app,
+      options,
+      query,
+      request,
+      streamPath,
+      texmlPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderTelnyxSmokeHTML(report, options.smoke?.title ?? "AbsoluteJS Telnyx Voice Smoke Test"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return report;
+  });
+};
+// src/telephony/plivo.ts
+import { Buffer as Buffer5 } from "buffer";
+import { Elysia as Elysia20 } from "elysia";
+var escapeXml4 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml19 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var joinUrlPath3 = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+var resolveRequestOrigin3 = (request) => {
+  const url = new URL(request.url);
+  const forwardedHost = request.headers.get("x-forwarded-host");
+  const forwardedProto = request.headers.get("x-forwarded-proto");
+  const host = forwardedHost ?? request.headers.get("host") ?? url.host;
+  const protocol = forwardedProto ?? url.protocol.replace(":", "");
+  return `${protocol}://${host}`;
+};
+var boolAttr = (value) => typeof value === "boolean" ? String(value) : undefined;
+var extraHeadersAttr = (headers) => {
+  if (!headers || typeof headers === "string") {
+    return headers;
+  }
+  return Object.entries(headers).filter((entry) => entry[1] !== undefined).map(([key, value]) => `${key}=${String(value)}`).join(",");
+};
+var extractPlivoStreamUrl = (xml) => xml.match(/<Stream\b[^>]*>([^<]+)<\/Stream>/i)?.[1]?.trim();
+var createSmokeCheck3 = (name, status, message, details) => ({
+  details,
+  message,
+  name,
+  status
+});
+var resolvePlivoStreamUrl = async (options, input) => {
+  if (typeof options.answer?.streamUrl === "function") {
+    return options.answer.streamUrl(input);
+  }
+  if (typeof options.answer?.streamUrl === "string") {
+    return options.answer.streamUrl;
+  }
+  const origin = resolveRequestOrigin3(input.request);
+  const wsOrigin = origin.replace(/^http:/, "ws:").replace(/^https:/, "wss:");
+  return `${wsOrigin}${input.streamPath}`;
+};
+var createPlivoVoiceResponse = (options) => {
+  const attributes = [
+    options.bidirectional !== undefined ? `bidirectional="${escapeXml4(String(options.bidirectional))}"` : undefined,
+    options.audioTrack ? `audioTrack="${escapeXml4(options.audioTrack)}"` : undefined,
+    options.streamTimeout ? `streamTimeout="${escapeXml4(String(options.streamTimeout))}"` : undefined,
+    options.contentType ? `contentType="${escapeXml4(options.contentType)}"` : undefined,
+    options.keepCallAlive !== undefined ? `keepCallAlive="${escapeXml4(String(options.keepCallAlive))}"` : undefined,
+    extraHeadersAttr(options.extraHeaders) ? `extraHeaders="${escapeXml4(extraHeadersAttr(options.extraHeaders))}"` : undefined,
+    options.statusCallbackUrl ? `statusCallbackUrl="${escapeXml4(options.statusCallbackUrl)}"` : undefined,
+    options.statusCallbackMethod ? `statusCallbackMethod="${escapeXml4(options.statusCallbackMethod)}"` : undefined,
+    boolAttr(options.noiseCancellation) ? `noiseCancellation="${escapeXml4(boolAttr(options.noiseCancellation))}"` : undefined,
+    options.noiseCancellationLevel ? `noiseCancellationLevel="${escapeXml4(String(options.noiseCancellationLevel))}"` : undefined
+  ].filter((value) => Boolean(value)).join(" ");
+  const openTag = attributes ? `<Stream ${attributes}>` : "<Stream>";
+  return `<?xml version="1.0" encoding="UTF-8"?><Response>${openTag}${escapeXml4(options.streamUrl)}</Stream></Response>`;
+};
+var toBase642 = (bytes) => Buffer5.from(new Uint8Array(bytes)).toString("base64");
+var timingSafeEqual3 = (left, right) => {
+  const encoder = new TextEncoder;
+  const leftBytes = encoder.encode(left);
+  const rightBytes = encoder.encode(right);
+  if (leftBytes.length !== rightBytes.length) {
+    return false;
+  }
+  let diff = 0;
+  for (let index = 0;index < leftBytes.length; index += 1) {
+    diff |= leftBytes[index] ^ rightBytes[index];
+  }
+  return diff === 0;
+};
+var signHmacSHA256Base64 = async (secret, payload) => {
+  const encoder = new TextEncoder;
+  const key = await crypto.subtle.importKey("raw", encoder.encode(secret), {
+    hash: "SHA-256",
+    name: "HMAC"
+  }, false, ["sign"]);
+  const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(payload));
+  return toBase642(signature);
+};
+var sortedParamsForSignature2 = (body) => {
+  if (!body || typeof body !== "object" || Array.isArray(body)) {
+    return "";
+  }
+  return Object.entries(body).filter(([, value]) => value !== undefined && value !== null).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}${String(value)}`).join("");
+};
+var signVoicePlivoWebhook = async (input) => signHmacSHA256Base64(input.authToken, `${input.url}${sortedParamsForSignature2(input.body)}.${input.nonce}`);
+var headerList = (value) => value?.split(",").map((signature) => signature.trim()).filter(Boolean) ?? [];
+var verifyVoicePlivoWebhookSignature = async (input) => {
+  if (!input.authToken) {
+    return { ok: false, reason: "missing-secret" };
+  }
+  const nonce = input.headers.get("x-plivo-signature-v3-nonce");
+  const signatures = [
+    ...headerList(input.headers.get("x-plivo-signature-v3")),
+    ...headerList(input.headers.get("x-plivo-signature-ma-v3"))
+  ];
+  if (!nonce || signatures.length === 0) {
+    return { ok: false, reason: "missing-signature" };
+  }
+  const expected = await signVoicePlivoWebhook({
+    authToken: input.authToken,
+    body: input.body,
+    nonce,
+    url: input.url
+  });
+  return signatures.some((signature) => timingSafeEqual3(signature, expected)) ? { ok: true } : { ok: false, reason: "invalid-signature" };
+};
+var buildPlivoVoiceSetupStatus = async (options, input) => {
+  const origin = resolveRequestOrigin3(input.request);
+  const stream = await resolvePlivoStreamUrl(options, input);
+  const answer = joinUrlPath3(origin, input.answerPath);
+  const webhook = joinUrlPath3(origin, input.webhookPath);
+  const missing = Object.entries(options.setup?.requiredEnv ?? {}).filter((entry) => !entry[1]).map(([name]) => name);
+  const signingConfigured = Boolean(options.webhook?.authToken || options.webhook?.verify);
+  const warnings = [
+    ...stream.startsWith("wss://") ? [] : ["Plivo audio streams should use wss:// in production."],
+    ...signingConfigured ? [] : ["Webhook signature verification is not configured."]
+  ];
+  return {
+    generatedAt: Date.now(),
+    missing,
+    provider: "plivo",
+    ready: missing.length === 0 && signingConfigured && warnings.length === 0,
+    signing: {
+      configured: signingConfigured,
+      mode: options.webhook?.verify ? "custom" : options.webhook?.authToken ? "provider-signature" : "none",
+      verificationUrl: webhook
+    },
+    urls: {
+      answer,
+      stream,
+      twiml: answer,
+      webhook
+    },
+    warnings
+  };
+};
+var renderPlivoSetupHTML = (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;">Plivo setup</p>
+<h1>${escapeHtml19(title)}</h1>
+<p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
+<ul>
+<li><strong>Answer XML:</strong> <code>${escapeHtml19(status.urls.answer)}</code></li>
+<li><strong>Audio stream:</strong> <code>${escapeHtml19(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml19(status.urls.webhook)}</code></li>
+</ul>
+${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml19(name)}</code></li>`).join("")}</ul>` : ""}
+${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml19(warning)}</li>`).join("")}</ul>` : ""}
+</main>`;
+var renderPlivoSmokeHTML = (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;">Plivo smoke test</p>
+<h1>${escapeHtml19(title)}</h1>
+<p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml19(check.name)}</strong>: ${escapeHtml19(check.status)}${check.message ? ` - ${escapeHtml19(check.message)}` : ""}</li>`).join("")}</ul>
+</main>`;
+var runPlivoSmokeTest = async (input) => {
+  const setup = await buildPlivoVoiceSetupStatus(input.options, input);
+  const checks = [];
+  const answerResponse = await input.app.handle(new Request(setup.urls.answer));
+  const answerXml = await answerResponse.text();
+  const streamUrl = extractPlivoStreamUrl(answerXml);
+  checks.push(createSmokeCheck3("answer-xml", answerResponse.ok && Boolean(streamUrl) ? "pass" : "fail", streamUrl ? "Answer XML includes a Stream URL." : "Answer XML is missing <Stream>...</Stream>.", {
+    status: answerResponse.status,
+    streamUrl
+  }));
+  checks.push(createSmokeCheck3("stream-url", streamUrl?.startsWith("wss://") ? "pass" : "fail", streamUrl?.startsWith("wss://") ? "Audio stream URL uses wss://." : "Audio stream URL should use wss:// for Plivo.", {
+    streamUrl
+  }));
+  const webhookBody = new URLSearchParams({
+    CallUUID: input.options.smoke?.callUuid ?? "plivo-smoke-call",
+    Duration: "0",
+    Event: input.options.smoke?.eventType ?? "Hangup",
+    From: "+15555550100",
+    HangupCause: "busy",
+    SessionId: input.options.smoke?.sessionId ?? "plivo-smoke-session",
+    SipResponseCode: String(input.options.smoke?.sipCode ?? 486),
+    To: "+15555550101",
+    status: input.options.smoke?.status ?? "busy"
+  });
+  const webhookResponse = await input.app.handle(new Request(setup.urls.webhook, {
+    body: webhookBody,
+    headers: {
+      "content-type": "application/x-www-form-urlencoded"
+    },
+    method: "POST"
+  }));
+  const webhookText = await webhookResponse.text();
+  const webhookPayload = (() => {
+    try {
+      return JSON.parse(webhookText);
+    } catch {
+      return webhookText;
+    }
+  })();
+  checks.push(createSmokeCheck3("webhook", webhookResponse.ok ? "pass" : "fail", webhookResponse.ok ? "Synthetic Plivo event was accepted." : "Synthetic Plivo event failed.", {
+    status: webhookResponse.status
+  }));
+  for (const warning of setup.warnings) {
+    checks.push(createSmokeCheck3("setup-warning", "warn", warning));
+  }
+  for (const name of setup.missing) {
+    checks.push(createSmokeCheck3("missing-env", "fail", `${name} is missing.`));
+  }
+  const baseReport = {
+    answer: {
+      status: answerResponse.status,
+      streamUrl
+    },
+    checks,
+    generatedAt: Date.now(),
+    pass: checks.every((check) => check.status !== "fail"),
+    provider: "plivo",
+    setup,
+    twiml: {
+      status: answerResponse.status,
+      streamUrl
+    },
+    webhook: {
+      body: webhookPayload,
+      status: webhookResponse.status
+    }
+  };
+  return {
+    ...baseReport,
+    contract: evaluateVoiceTelephonyContract({
+      setup,
+      smoke: baseReport
+    })
+  };
+};
+var createPlivoVoiceRoutes = (options = {}) => {
+  const streamPath = options.streamPath ?? "/api/voice/plivo/stream";
+  const answerPath = options.answer?.path ?? "/api/voice/plivo";
+  const webhookPath = options.webhook?.path ?? "/api/voice/plivo/webhook";
+  const setupPath = options.setup?.path === false ? false : options.setup?.path ?? "/api/voice/plivo/setup";
+  const smokePath = options.smoke?.path === false ? false : options.smoke?.path ?? "/api/voice/plivo/smoke";
+  const webhookPolicy = options.webhook?.policy ?? options.outcomePolicy ?? createVoiceTelephonyOutcomePolicy();
+  const verificationUrl = options.webhook?.verificationUrl;
+  const verify = options.webhook?.verify ?? (options.webhook?.authToken ? (input) => verifyVoicePlivoWebhookSignature({
+    authToken: options.webhook?.authToken,
+    body: input.body,
+    headers: input.request.headers,
+    url: typeof verificationUrl === "function" ? verificationUrl({
+      query: input.query,
+      request: input.request
+    }) : verificationUrl ?? input.request.url
+  }) : undefined);
+  const app = new Elysia20({
+    name: options.name ?? "absolutejs-voice-plivo"
+  }).get(answerPath, async ({ query, request }) => {
+    const streamUrl = await resolvePlivoStreamUrl(options, {
+      query,
+      request,
+      streamPath
+    });
+    return new Response(createPlivoVoiceResponse({
+      ...options.answer?.response,
+      streamUrl
+    }), {
+      headers: {
+        "content-type": "text/xml; charset=utf-8"
+      }
+    });
+  }).post(answerPath, async ({ query, request }) => {
+    const streamUrl = await resolvePlivoStreamUrl(options, {
+      query,
+      request,
+      streamPath
+    });
+    return new Response(createPlivoVoiceResponse({
+      ...options.answer?.response,
+      streamUrl
+    }), {
+      headers: {
+        "content-type": "text/xml; charset=utf-8"
+      }
+    });
+  }).use(createVoiceTelephonyWebhookRoutes({
+    ...options.webhook ?? {},
+    context: options.context,
+    path: webhookPath,
+    policy: webhookPolicy,
+    provider: "plivo",
+    requireVerification: Boolean(options.webhook?.authToken),
+    resolveSessionId: options.webhook?.resolveSessionId ?? (({ event }) => {
+      const metadata = event.metadata;
+      return typeof metadata?.SessionId === "string" ? metadata.SessionId : typeof metadata?.sessionId === "string" ? metadata.sessionId : typeof metadata?.CallUUID === "string" ? metadata.CallUUID : typeof metadata?.call_uuid === "string" ? metadata.call_uuid : undefined;
+    }),
+    verify
+  }));
+  const withSetup = setupPath ? app.get(setupPath, async ({ query, request }) => {
+    const status = await buildPlivoVoiceSetupStatus(options, {
+      answerPath,
+      query,
+      request,
+      streamPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderPlivoSetupHTML(status, options.setup?.title ?? "AbsoluteJS Plivo Voice Setup"), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return status;
+  }) : app;
+  if (!smokePath) {
+    return withSetup;
+  }
+  return withSetup.get(smokePath, async ({ query, request }) => {
+    const report = await runPlivoSmokeTest({
+      answerPath,
+      app,
+      options,
+      query,
+      request,
+      streamPath,
+      webhookPath
+    });
+    if (query.format === "html") {
+      return new Response(renderPlivoSmokeHTML(report, options.smoke?.title ?? "AbsoluteJS Plivo 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();
 var DEFAULT_MAX_WORDS = 12;
@@ -16041,6 +16657,8 @@ export {
   voiceTelephonyOutcomeToRouteResult,
   voice,
   verifyVoiceTwilioWebhookSignature,
+  verifyVoiceTelnyxWebhookSignature,
+  verifyVoicePlivoWebhookSignature,
   verifyVoiceOpsWebhookSignature,
   validateVoiceWorkflowRouteResult,
   transcodeTwilioInboundPayloadToPCM16,
@@ -16064,6 +16682,7 @@ export {
   summarizeVoiceAppKitStatus,
   startVoiceOpsTask,
   signVoiceTwilioWebhook,
+  signVoicePlivoWebhook,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,
   runVoiceToolContractSuite,
@@ -16282,11 +16901,15 @@ export {
   createTwilioVoiceRoutes,
   createTwilioVoiceResponse,
   createTwilioMediaStreamBridge,
+  createTelnyxVoiceRoutes,
+  createTelnyxVoiceResponse,
   createStoredVoiceOpsTask,
   createStoredVoiceIntegrationEvent,
   createStoredVoiceExternalObjectMap,
   createStoredVoiceCallReviewArtifact,
   createRiskyTurnCorrectionHandler,
+  createPlivoVoiceRoutes,
+  createPlivoVoiceResponse,
   createPhraseHintCorrectionHandler,
   createOpenAIVoiceAssistantModel,
   createMemoryVoiceTelephonyWebhookIdempotencyStore,

package/dist/telephony/plivo.d.ts

@@ -0,0 +1,154 @@
+import { Elysia } from 'elysia';
+import { type VoiceTelephonyContractReport, type VoiceTelephonySetupStatus, type VoiceTelephonySmokeCheck, type VoiceTelephonySmokeReport } from './contract';
+import { type VoiceTelephonyOutcomePolicy, type VoiceTelephonyWebhookRoutesOptions, type VoiceTelephonyWebhookVerificationResult } from '../telephonyOutcome';
+import type { VoiceSessionRecord } from '../types';
+export type PlivoVoiceResponseOptions = {
+    audioTrack?: 'both' | 'inbound' | 'outbound';
+    bidirectional?: boolean;
+    contentType?: 'audio/x-l16;rate=8000' | 'audio/x-l16;rate=16000' | 'audio/x-mulaw;rate=8000';
+    extraHeaders?: Record<string, string | number | boolean | undefined> | string;
+    keepCallAlive?: boolean;
+    noiseCancellation?: boolean;
+    noiseCancellationLevel?: number;
+    statusCallbackMethod?: 'GET' | 'POST';
+    statusCallbackUrl?: string;
+    streamTimeout?: number;
+    streamUrl: string;
+};
+export type PlivoVoiceSetupStatus = VoiceTelephonySetupStatus<'plivo'> & {
+    urls: VoiceTelephonySetupStatus<'plivo'>['urls'] & {
+        answer: string;
+    };
+};
+export type PlivoVoiceSetupOptions = {
+    path?: false | string;
+    requiredEnv?: Record<string, string | undefined>;
+    title?: string;
+};
+export type PlivoVoiceSmokeCheck = VoiceTelephonySmokeCheck;
+export type PlivoVoiceSmokeReport = VoiceTelephonySmokeReport<'plivo'> & {
+    answer?: {
+        status: number;
+        streamUrl?: string;
+    };
+    contract: VoiceTelephonyContractReport<'plivo'>;
+    setup: PlivoVoiceSetupStatus;
+};
+export type PlivoVoiceSmokeOptions = {
+    callUuid?: string;
+    eventType?: string;
+    path?: false | string;
+    sessionId?: string;
+    sipCode?: number;
+    status?: string;
+    title?: string;
+};
+export type PlivoVoiceRoutesOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    answer?: {
+        path?: string;
+        response?: Omit<PlivoVoiceResponseOptions, 'streamUrl'>;
+        streamUrl?: string | ((input: {
+            query: Record<string, unknown>;
+            request: Request;
+            streamPath: string;
+        }) => Promise<string> | string);
+    };
+    context?: TContext;
+    name?: string;
+    outcomePolicy?: VoiceTelephonyOutcomePolicy;
+    setup?: PlivoVoiceSetupOptions;
+    smoke?: PlivoVoiceSmokeOptions;
+    streamPath?: string;
+    webhook?: Omit<VoiceTelephonyWebhookRoutesOptions<TContext, TSession, TResult>, 'context' | 'path' | 'policy' | 'provider'> & {
+        authToken?: string;
+        path?: string;
+        policy?: VoiceTelephonyOutcomePolicy;
+        verificationUrl?: string | ((input: {
+            query: Record<string, unknown>;
+            request: Request;
+        }) => string);
+    };
+};
+export declare const createPlivoVoiceResponse: (options: PlivoVoiceResponseOptions) => string;
+export declare const signVoicePlivoWebhook: (input: {
+    authToken: string;
+    body?: unknown;
+    nonce: string;
+    url: string;
+}) => Promise<string>;
+export declare const verifyVoicePlivoWebhookSignature: (input: {
+    authToken?: string;
+    body?: unknown;
+    headers: Headers;
+    url: string;
+}) => Promise<VoiceTelephonyWebhookVerificationResult>;
+export declare const createPlivoVoiceRoutes: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options?: PlivoVoiceRoutesOptions<TContext, TSession, TResult>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response | import("..").VoiceTelephonyWebhookDecision<TResult>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+} & {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/telephony/telnyx.d.ts

@@ -0,0 +1,139 @@
+import { Elysia } from 'elysia';
+import { type VoiceTelephonyContractReport, type VoiceTelephonySetupStatus, type VoiceTelephonySmokeCheck, type VoiceTelephonySmokeReport } from './contract';
+import { type VoiceTelephonyOutcomePolicy, type VoiceTelephonyWebhookRoutesOptions, type VoiceTelephonyWebhookVerificationResult } from '../telephonyOutcome';
+import type { VoiceSessionRecord } from '../types';
+export type TelnyxVoiceResponseOptions = {
+    bidirectionalCodec?: 'AMR-WB' | 'G722' | 'OPUS' | 'PCMA' | 'PCMU';
+    bidirectionalMode?: 'mp3' | 'rtp';
+    codec?: 'AMR-WB' | 'G722' | 'OPUS' | 'PCMA' | 'PCMU' | 'default';
+    streamName?: string;
+    streamUrl: string;
+    track?: 'both_tracks' | 'inbound_track' | 'outbound_track';
+};
+export type TelnyxVoiceSetupStatus = VoiceTelephonySetupStatus<'telnyx'> & {
+    urls: VoiceTelephonySetupStatus<'telnyx'>['urls'] & {
+        texml: string;
+    };
+};
+export type TelnyxVoiceSetupOptions = {
+    path?: false | string;
+    requiredEnv?: Record<string, string | undefined>;
+    title?: string;
+};
+export type TelnyxVoiceSmokeCheck = VoiceTelephonySmokeCheck;
+export type TelnyxVoiceSmokeReport = VoiceTelephonySmokeReport<'telnyx'> & {
+    contract: VoiceTelephonyContractReport<'telnyx'>;
+    setup: TelnyxVoiceSetupStatus;
+    texml?: {
+        status: number;
+        streamUrl?: string;
+    };
+};
+export type TelnyxVoiceSmokeOptions = {
+    callControlId?: string;
+    callLegId?: string;
+    eventType?: string;
+    path?: false | string;
+    sessionId?: string;
+    title?: string;
+};
+export type TelnyxVoiceRoutesOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    context?: TContext;
+    name?: string;
+    outcomePolicy?: VoiceTelephonyOutcomePolicy;
+    setup?: TelnyxVoiceSetupOptions;
+    smoke?: TelnyxVoiceSmokeOptions;
+    streamPath?: string;
+    texml?: {
+        path?: string;
+        response?: Omit<TelnyxVoiceResponseOptions, 'streamUrl'>;
+        streamUrl?: string | ((input: {
+            query: Record<string, unknown>;
+            request: Request;
+            streamPath: string;
+        }) => Promise<string> | string);
+    };
+    webhook?: Omit<VoiceTelephonyWebhookRoutesOptions<TContext, TSession, TResult>, 'context' | 'path' | 'policy' | 'provider'> & {
+        path?: string;
+        policy?: VoiceTelephonyOutcomePolicy;
+        publicKey?: string;
+        toleranceSeconds?: number;
+    };
+};
+export declare const createTelnyxVoiceResponse: (options: TelnyxVoiceResponseOptions) => string;
+export declare const verifyVoiceTelnyxWebhookSignature: (input: {
+    body: string;
+    headers: Headers;
+    publicKey?: string;
+    toleranceSeconds?: number;
+}) => Promise<VoiceTelephonyWebhookVerificationResult>;
+export declare const createTelnyxVoiceRoutes: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(options?: TelnyxVoiceRoutesOptions<TContext, TSession, TResult>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response | import("..").VoiceTelephonyWebhookDecision<TResult>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+} & {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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