@absolutejs/voice 0.0.22-beta.322 → 0.0.22-beta.324

package/dist/productionReadiness.d.ts

@@ -20,6 +20,7 @@ import type { VoiceCampaignReadinessProofReport } from './campaign';
 import { type VoiceOpsRecoveryReport } from './opsRecovery';
 import { type VoiceObservabilityExportDeliveryHistory, type VoiceObservabilityExportDeliveryReceiptStore, type VoiceObservabilityExportReplayReport, type VoiceObservabilityExportReplaySource, type VoiceObservabilityExportReport } from './observabilityExport';
 import type { VoiceMediaPipelineReport } from './mediaPipelineRoutes';
+import type { VoiceTelephonyMediaReport } from './telephonyMediaRoutes';
 import type { MediaWebRTCStatsReport } from '@absolutejs/media';
 export type VoiceProductionReadinessObservabilityExportDeliveryHistoryOptions = {
     failOnMissing?: boolean;
@@ -140,6 +141,7 @@ export type VoiceProductionReadinessReport = {
         opsRecovery?: string;
         phoneAgentSmoke?: string;
         telephonyWebhookSecurity?: string;
+        telephonyMedia?: string;
         providerContracts?: string;
         providerOrchestration?: string;
         providerRoutingContracts?: string;
@@ -294,6 +296,14 @@ export type VoiceProductionReadinessReport = {
             status: VoiceProductionReadinessStatus;
             warned: number;
         };
+        telephonyMedia?: {
+            audioBytes: number;
+            carriers: number;
+            failed: number;
+            issues: number;
+            passed: number;
+            status: VoiceProductionReadinessStatus;
+        };
         providerRoutingContracts?: {
             failed: number;
             passed: number;
@@ -481,6 +491,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<MediaWebRTCStatsReport> | MediaWebRTCStatsReport);
+    telephonyMedia?: false | VoiceTelephonyMediaReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceTelephonyMediaReport> | VoiceTelephonyMediaReport);
     opsActionHistory?: false | VoiceProductionReadinessOpsActionHistoryOptions;
     opsRecovery?: false | VoiceOpsRecoveryReport | ((input: {
         query: Record<string, unknown>;

package/dist/react/index.js

@@ -5050,6 +5050,63 @@ var stringStat = (stat, key) => {
 };
 var statKey = (stat) => String(stat.id ?? stringStat(stat, "ssrc") ?? numericStat(stat, "ssrc") ?? stringStat(stat, "trackIdentifier") ?? stringStat(stat, "mid") ?? "unknown");
 var secondsToMs = (value) => value === undefined ? undefined : value * 1000;
+var DEFAULT_TELEPHONY_FORMAT = {
+  channels: 1,
+  container: "raw",
+  encoding: "mulaw",
+  sampleRateHz: 8000
+};
+var bytesToBase64 = (audio) => {
+  const bytes = audio instanceof ArrayBuffer ? new Uint8Array(audio) : new Uint8Array(audio.buffer, audio.byteOffset, audio.byteLength);
+  return Buffer.from(bytes).toString("base64");
+};
+var base64ToBytes = (value) => new Uint8Array(Buffer.from(value, "base64"));
+var unknownRecord = (value) => value && typeof value === "object" ? value : {};
+var firstString = (records, keys) => {
+  for (const record of records) {
+    for (const key of keys) {
+      const value = record[key];
+      if (typeof value === "string" && value.length > 0) {
+        return value;
+      }
+      if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+      }
+    }
+  }
+  return;
+};
+var firstNumber = (records, keys) => {
+  for (const record of records) {
+    for (const key of keys) {
+      const value = record[key];
+      if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+      }
+      if (typeof value === "string") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+          return parsed;
+        }
+      }
+    }
+  }
+  return;
+};
+var telephonyDirection = (track) => {
+  const normalized = track?.toLowerCase();
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("inbound") || normalized.includes("caller") || normalized.includes("in")) {
+    return "inbound";
+  }
+  if (normalized.includes("outbound") || normalized.includes("assistant") || normalized.includes("out")) {
+    return "outbound";
+  }
+  return "unknown";
+};
+var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -5059,6 +5116,113 @@ var normalizeWebRTCStat = (stat) => {
   }
   return sample;
 };
+var parseTelephonyMediaFrame = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const payload = firstString([media, envelope], ["payload", "audio", "data"]) ?? firstString([unknownRecord(envelope.message)], ["payload"]);
+  if (!payload) {
+    return;
+  }
+  const carrier = input.carrier ?? firstString([envelope], ["provider"]) ?? "telephony";
+  const streamId = firstString([media, envelope], ["streamSid", "stream_id", "streamId", "streamId", "callSid", "call_id"]);
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  const direction = telephonyDirection(track);
+  const timestamp = firstNumber([media, envelope], ["timestamp", "time", "startedAt"]);
+  return {
+    at: timestamp,
+    audio: base64ToBytes(payload),
+    format: input.format ?? DEFAULT_TELEPHONY_FORMAT,
+    id: [
+      carrier,
+      streamId ?? input.sessionId ?? "stream",
+      sequenceNumber ?? timestamp ?? Date.now()
+    ].join(":"),
+    kind: telephonyFrameKind(direction),
+    metadata: {
+      carrier,
+      direction,
+      event: firstString([envelope], ["event", "type"]),
+      sequenceNumber,
+      streamId,
+      track
+    },
+    sessionId: input.sessionId ?? streamId,
+    source: "telephony"
+  };
+};
+var serializeTelephonyMediaFrame = (input) => {
+  const carrier = input.carrier ?? input.frame.metadata?.carrier ?? "telephony";
+  const streamId = input.streamId ?? (typeof input.frame.metadata?.streamId === "string" ? input.frame.metadata.streamId : input.frame.sessionId);
+  const sequenceNumber = input.sequenceNumber ?? (typeof input.frame.metadata?.sequenceNumber === "string" || typeof input.frame.metadata?.sequenceNumber === "number" ? input.frame.metadata.sequenceNumber : undefined);
+  const direction = input.frame.kind === "assistant-audio" ? "outbound" : "inbound";
+  const payload = input.frame.audio ? bytesToBase64(input.frame.audio) : "";
+  if (carrier === "twilio") {
+    return {
+      event: "media",
+      sequenceNumber,
+      streamSid: streamId,
+      media: {
+        payload,
+        timestamp: input.frame.at,
+        track: direction
+      }
+    };
+  }
+  if (carrier === "telnyx") {
+    return {
+      event: "media",
+      stream_id: streamId,
+      sequence_number: sequenceNumber,
+      media: {
+        payload,
+        timestamp: input.frame.at,
+        track: direction
+      }
+    };
+  }
+  if (carrier === "plivo") {
+    return {
+      event: "media",
+      streamId,
+      sequenceNumber,
+      media: {
+        payload,
+        timestamp: input.frame.at,
+        track: direction
+      }
+    };
+  }
+  return {
+    event: "media",
+    provider: carrier,
+    sequenceNumber,
+    streamId,
+    media: {
+      payload,
+      timestamp: input.frame.at,
+      track: direction
+    }
+  };
+};
+var createTelephonyMediaSerializer = (input) => {
+  const format = input.format ?? DEFAULT_TELEPHONY_FORMAT;
+  return {
+    carrier: input.carrier,
+    format,
+    parse: (envelope) => parseTelephonyMediaFrame({
+      carrier: input.carrier,
+      envelope,
+      format,
+      sessionId: input.sessionId ?? input.streamId
+    }),
+    serialize: (frame) => serializeTelephonyMediaFrame({
+      carrier: input.carrier,
+      frame,
+      streamId: input.streamId
+    })
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/svelte/index.js

@@ -3384,6 +3384,63 @@ var stringStat = (stat, key) => {
 };
 var statKey = (stat) => String(stat.id ?? stringStat(stat, "ssrc") ?? numericStat(stat, "ssrc") ?? stringStat(stat, "trackIdentifier") ?? stringStat(stat, "mid") ?? "unknown");
 var secondsToMs = (value) => value === undefined ? undefined : value * 1000;
+var DEFAULT_TELEPHONY_FORMAT = {
+  channels: 1,
+  container: "raw",
+  encoding: "mulaw",
+  sampleRateHz: 8000
+};
+var bytesToBase64 = (audio) => {
+  const bytes = audio instanceof ArrayBuffer ? new Uint8Array(audio) : new Uint8Array(audio.buffer, audio.byteOffset, audio.byteLength);
+  return Buffer.from(bytes).toString("base64");
+};
+var base64ToBytes = (value) => new Uint8Array(Buffer.from(value, "base64"));
+var unknownRecord = (value) => value && typeof value === "object" ? value : {};
+var firstString = (records, keys) => {
+  for (const record of records) {
+    for (const key of keys) {
+      const value = record[key];
+      if (typeof value === "string" && value.length > 0) {
+        return value;
+      }
+      if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+      }
+    }
+  }
+  return;
+};
+var firstNumber = (records, keys) => {
+  for (const record of records) {
+    for (const key of keys) {
+      const value = record[key];
+      if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+      }
+      if (typeof value === "string") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+          return parsed;
+        }
+      }
+    }
+  }
+  return;
+};
+var telephonyDirection = (track) => {
+  const normalized = track?.toLowerCase();
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("inbound") || normalized.includes("caller") || normalized.includes("in")) {
+    return "inbound";
+  }
+  if (normalized.includes("outbound") || normalized.includes("assistant") || normalized.includes("out")) {
+    return "outbound";
+  }
+  return "unknown";
+};
+var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -3393,6 +3450,113 @@ var normalizeWebRTCStat = (stat) => {
   }
   return sample;
 };
+var parseTelephonyMediaFrame = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const payload = firstString([media, envelope], ["payload", "audio", "data"]) ?? firstString([unknownRecord(envelope.message)], ["payload"]);
+  if (!payload) {
+    return;
+  }
+  const carrier = input.carrier ?? firstString([envelope], ["provider"]) ?? "telephony";
+  const streamId = firstString([media, envelope], ["streamSid", "stream_id", "streamId", "streamId", "callSid", "call_id"]);
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  const direction = telephonyDirection(track);
+  const timestamp = firstNumber([media, envelope], ["timestamp", "time", "startedAt"]);
+  return {
+    at: timestamp,
+    audio: base64ToBytes(payload),
+    format: input.format ?? DEFAULT_TELEPHONY_FORMAT,
+    id: [
+      carrier,
+      streamId ?? input.sessionId ?? "stream",
+      sequenceNumber ?? timestamp ?? Date.now()
+    ].join(":"),
+    kind: telephonyFrameKind(direction),
+    metadata: {
+      carrier,
+      direction,
+      event: firstString([envelope], ["event", "type"]),
+      sequenceNumber,
+      streamId,
+      track
+    },
+    sessionId: input.sessionId ?? streamId,
+    source: "telephony"
+  };
+};
+var serializeTelephonyMediaFrame = (input) => {
+  const carrier = input.carrier ?? input.frame.metadata?.carrier ?? "telephony";
+  const streamId = input.streamId ?? (typeof input.frame.metadata?.streamId === "string" ? input.frame.metadata.streamId : input.frame.sessionId);
+  const sequenceNumber = input.sequenceNumber ?? (typeof input.frame.metadata?.sequenceNumber === "string" || typeof input.frame.metadata?.sequenceNumber === "number" ? input.frame.metadata.sequenceNumber : undefined);
+  const direction = input.frame.kind === "assistant-audio" ? "outbound" : "inbound";
+  const payload = input.frame.audio ? bytesToBase64(input.frame.audio) : "";
+  if (carrier === "twilio") {
+    return {
+      event: "media",
+      sequenceNumber,
+      streamSid: streamId,
+      media: {
+        payload,
+        timestamp: input.frame.at,
+        track: direction
+      }
+    };
+  }
+  if (carrier === "telnyx") {
+    return {
+      event: "media",
+      stream_id: streamId,
+      sequence_number: sequenceNumber,
+      media: {
+        payload,
+        timestamp: input.frame.at,
+        track: direction
+      }
+    };
+  }
+  if (carrier === "plivo") {
+    return {
+      event: "media",
+      streamId,
+      sequenceNumber,
+      media: {
+        payload,
+        timestamp: input.frame.at,
+        track: direction
+      }
+    };
+  }
+  return {
+    event: "media",
+    provider: carrier,
+    sequenceNumber,
+    streamId,
+    media: {
+      payload,
+      timestamp: input.frame.at,
+      track: direction
+    }
+  };
+};
+var createTelephonyMediaSerializer = (input) => {
+  const format = input.format ?? DEFAULT_TELEPHONY_FORMAT;
+  return {
+    carrier: input.carrier,
+    format,
+    parse: (envelope) => parseTelephonyMediaFrame({
+      carrier: input.carrier,
+      envelope,
+      format,
+      sessionId: input.sessionId ?? input.streamId
+    }),
+    serialize: (frame) => serializeTelephonyMediaFrame({
+      carrier: input.carrier,
+      frame,
+      streamId: input.streamId
+    })
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/telephonyMediaRoutes.d.ts

@@ -0,0 +1,63 @@
+import { Elysia } from 'elysia';
+import type { MediaFrame, MediaTelephonyCarrier, MediaTelephonyEnvelope } from '@absolutejs/media';
+export type VoiceTelephonyMediaStatus = 'fail' | 'pass';
+export type VoiceTelephonyMediaCarrierInput = {
+    carrier: MediaTelephonyCarrier;
+    envelope?: MediaTelephonyEnvelope;
+};
+export type VoiceTelephonyMediaCarrierReport = {
+    audioBytes: number;
+    carrier: MediaTelephonyCarrier;
+    frame?: MediaFrame;
+    issues: string[];
+    serialized?: MediaTelephonyEnvelope;
+    status: VoiceTelephonyMediaStatus;
+};
+export type VoiceTelephonyMediaReport = {
+    carriers: readonly VoiceTelephonyMediaCarrierReport[];
+    checkedAt: number;
+    issues: string[];
+    status: VoiceTelephonyMediaStatus;
+};
+export type VoiceTelephonyMediaRoutesOptions = {
+    carriers?: readonly VoiceTelephonyMediaCarrierInput[];
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+    title?: string;
+};
+export declare const buildVoiceTelephonyMediaReport: (input?: {
+    carriers?: readonly VoiceTelephonyMediaCarrierInput[];
+}) => VoiceTelephonyMediaReport;
+export declare const renderVoiceTelephonyMediaHTML: (report: VoiceTelephonyMediaReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceTelephonyMediaRoutes: (options?: VoiceTelephonyMediaRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;