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

package/dist/angular/index.js

@@ -1414,6 +1414,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)) {
@@ -1423,6 +1480,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/client/index.js

@@ -807,6 +807,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)) {
@@ -816,6 +873,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/index.d.ts

@@ -16,8 +16,10 @@ export { assertVoiceRealtimeProviderContractEvidence, buildVoiceRealtimeProvider
 export type { VoiceRealtimeProviderContractAssertionInput, VoiceRealtimeProviderContractAssertionReport, VoiceRealtimeProviderContractCapability, VoiceRealtimeProviderContractCheck, VoiceRealtimeProviderContractDefinition, VoiceRealtimeProviderContractMatrixPresetOptions, VoiceRealtimeProviderContractMatrixInput, VoiceRealtimeProviderContractMatrixReport, VoiceRealtimeProviderContractRoutesOptions, VoiceRealtimeProviderContractRow, VoiceRealtimeProviderPresetProvider, VoiceRealtimeProviderContractStatus } from './realtimeProviderContracts';
 export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { assertVoiceMediaPipelineEvidence, buildVoiceMediaPipelineReport, createVoiceMediaPipelineRoutes, evaluateVoiceMediaPipelineEvidence, renderVoiceMediaPipelineHTML, renderVoiceMediaPipelineMarkdown } from './mediaPipelineRoutes';
+export { buildVoiceTelephonyMediaReport, createVoiceTelephonyMediaRoutes, renderVoiceTelephonyMediaHTML } from './telephonyMediaRoutes';
 export { createVoiceBrowserMediaRoutes, getLatestVoiceBrowserMediaReport, renderVoiceBrowserMediaHTML, summarizeVoiceBrowserMedia } from './browserMediaRoutes';
 export type { VoiceMediaPipelineAssertionInput, VoiceMediaPipelineAssertionReport, VoiceMediaPipelineReport, VoiceMediaPipelineReportOptions, VoiceMediaPipelineRoutesOptions } from './mediaPipelineRoutes';
+export type { VoiceTelephonyMediaCarrierInput, VoiceTelephonyMediaCarrierReport, VoiceTelephonyMediaReport, VoiceTelephonyMediaRoutesOptions, VoiceTelephonyMediaStatus } from './telephonyMediaRoutes';
 export type { VoiceBrowserMediaReport, VoiceBrowserMediaRoutesOptions, VoiceBrowserMediaSample, VoiceBrowserMediaStatus } from './browserMediaRoutes';
 export { buildVoiceDemoReadyReport, createVoiceDemoReadyRoutes, renderVoiceDemoReadyHTML } from './demoReadyRoutes';
 export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkDescriptor, createVoiceDeliverySinkPair, createVoiceDeliverySinkRoutes, createVoiceFileDeliverySink, createVoicePostgresDeliverySink, createVoiceS3DeliverySink, createVoiceSQLiteDeliverySink, createVoiceWebhookDeliverySink, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';