getpatter 0.6.3 → 0.6.4

package/README.md

@@ -74,6 +74,7 @@ Every provider reads its credentials from the environment by default. Pass `apiK
 |---|---|
 | `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN` | `new Twilio()` carrier |
 | `TELNYX_API_KEY`, `TELNYX_CONNECTION_ID`, `TELNYX_PUBLIC_KEY` (optional) | `new Telnyx()` carrier |
+| `PLIVO_AUTH_ID`, `PLIVO_AUTH_TOKEN` | `new Plivo()` carrier — Auth Token doubles as the V3 webhook signature key |
 | `OPENAI_API_KEY` | `OpenAIRealtime`, `WhisperSTT`, `OpenAITTS` |
 | `ELEVENLABS_API_KEY`, `ELEVENLABS_AGENT_ID` | `ElevenLabsConvAI`, `ElevenLabsTTS` |
 | `DEEPGRAM_API_KEY` | `DeepgramSTT` |
@@ -92,7 +93,7 @@ cp .env.example .env
 # Edit .env with your API keys
 ```
 
-> **Telnyx:** Telnyx is a fully supported telephony provider alternative to Twilio. Both carriers receive equal support for DTMF, transfer, and metrics. Recording parity is supported via Telnyx Call Control; consult the Telnyx portal for configuration details.
+> **Other carriers:** **Telnyx** and **Plivo** are both fully supported alternatives to Twilio. All three carriers receive equal support for inbound DTMF, transfer, AMD, status callbacks, recording, voicemail drop, and metrics. **Plivo** additionally supports native DTMF *send* over the media WebSocket — a capability Twilio Media Streams lacks. Plivo's Auth Token doubles as the V3 webhook signature key (no separate public key, unlike Telnyx Ed25519).
 
 ## Voice Modes
 
@@ -108,7 +109,7 @@ cp .env.example .env
 
 ```typescript
 new Patter({
-  carrier: Twilio | Telnyx;
+  carrier: Twilio | Telnyx | Plivo;
   phoneNumber: string;
   webhookUrl?: string;                              // Public hostname. Mutually exclusive with tunnel.
   tunnel?: CloudflareTunnel | StaticTunnel | boolean;  // `true` is shorthand for new CloudflareTunnel().
@@ -117,7 +118,7 @@ new Patter({
 
 | Parameter | Type | Description |
 |---|---|---|
-| `carrier` | `Twilio` / `Telnyx` | Carrier instance. Reads env vars by default. |
+| `carrier` | `Twilio` / `Telnyx` / `Plivo` | Carrier instance. Reads env vars by default. |
 | `phoneNumber` | `string` | Your phone number in E.164 format. |
 | `webhookUrl` | `string` | Public hostname your local server is reachable on. |
 | `tunnel` | `CloudflareTunnel \| StaticTunnel \| boolean` | `new CloudflareTunnel()`, `new StaticTunnel({ hostname: ... })`, or `true` (shorthand for `new CloudflareTunnel()`). |
@@ -179,7 +180,7 @@ await phone.call({
 ```typescript
 import {
   // Carriers
-  Twilio, Telnyx,
+  Twilio, Telnyx, Plivo,
   // Engines
   OpenAIRealtime, ElevenLabsConvAI,
   // STT

package/dist/{carrier-config-3WDQXP5J.mjs → carrier-config-7YGNRBPO.mjs}

@@ -7,6 +7,9 @@ import {
 
 // src/carrier-config.ts
 init_esm_shims();
+function redactPhone(n) {
+  return n.slice(0, 3) + "***" + n.slice(-4);
+}
 var TWILIO_API_BASE = "https://api.twilio.com/2010-04-01";
 var TELNYX_API_BASE = "https://api.telnyx.com/v2";
 var PLIVO_API_BASE = "https://api.plivo.com/v1";
@@ -25,7 +28,7 @@ async function configureTwilioNumber(accountSid, authToken, phoneNumber, voiceUr
   const body = await listResp.json();
   const match = body.incoming_phone_numbers?.[0];
   if (!match) {
-    throw new Error(`Twilio number ${phoneNumber} not found on account ${accountSid}`);
+    throw new Error(`Twilio number ${redactPhone(phoneNumber)} not found on account ${accountSid}`);
   }
   const updateUrl = `${TWILIO_API_BASE}/Accounts/${accountSid}/IncomingPhoneNumbers/${match.sid}.json`;
   const form = new URLSearchParams({ VoiceUrl: voiceUrl, VoiceMethod: "POST" });
@@ -44,17 +47,20 @@ async function configureTwilioNumber(accountSid, authToken, phoneNumber, voiceUr
   }
 }
 async function configureTelnyxNumber(apiKey, connectionId, phoneNumber) {
-  const resp = await fetch(`${TELNYX_API_BASE}/phone_numbers/${encodeURIComponent(phoneNumber)}`, {
-    method: "PATCH",
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({ connection_id: connectionId })
-  });
+  const resp = await fetch(
+    `${TELNYX_API_BASE}/phone_numbers/${encodeURIComponent(phoneNumber)}/voice`,
+    {
+      method: "PATCH",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ connection_id: connectionId, tech_prefix_enabled: false })
+    }
+  );
   if (!resp.ok) {
     throw new Error(
-      `Telnyx PATCH /phone_numbers/${phoneNumber} failed: ${resp.status} ${await resp.text()}`
+      `Telnyx PATCH /phone_numbers/${redactPhone(phoneNumber)}/voice failed: ${resp.status} ${await resp.text()}`
     );
   }
 }
@@ -104,7 +110,7 @@ async function autoConfigureCarrier(params) {
   if (provider === "telnyx" && params.telnyxKey && params.telnyxConnectionId) {
     try {
       await configureTelnyxNumber(params.telnyxKey, params.telnyxConnectionId, params.phoneNumber);
-      log.info("Telnyx number %s associated with connection %s", params.phoneNumber, params.telnyxConnectionId);
+      log.info("Telnyx number ***%s associated with connection %s", params.phoneNumber.slice(-4), params.telnyxConnectionId);
     } catch (err) {
       log.warn("Could not auto-configure Telnyx number: %s", err instanceof Error ? err.message : String(err));
     }

package/dist/{chunk-R2T4JABZ.mjs → chunk-3VVATR6A.mjs}

@@ -193,6 +193,8 @@ var SileroVAD = class _SileroVAD {
   speechThresholdDuration = 0;
   silenceThresholdDuration = 0;
   closed = false;
+  /** Transitions produced in the current processFrame call but not yet returned. */
+  eventQueue = [];
   /**
    * Load the Silero VAD model.
    * Throws if `onnxruntime-node` is not installed.
@@ -318,22 +320,21 @@ var SileroVAD = class _SileroVAD {
       );
     }
     if (pcmChunk.length === 0) {
-      return null;
+      return this.eventQueue.shift() ?? null;
     }
     const numSamples = Math.floor(pcmChunk.length / 2);
     if (numSamples === 0) {
-      return null;
+      return this.eventQueue.shift() ?? null;
     }
     const samples = new Float32Array(numSamples);
     for (let i = 0; i < numSamples; i++) {
-      samples[i] = pcmChunk.readInt16LE(i * 2) / 32767;
+      samples[i] = pcmChunk.readInt16LE(i * 2) / 32768;
     }
     const merged = new Float32Array(this.pending.length + samples.length);
     merged.set(this.pending, 0);
     merged.set(samples, this.pending.length);
     this.pending = merged;
     const windowSize = this.model.windowSizeSamples;
-    let event = null;
     while (this.pending.length >= windowSize) {
       const window = this.pending.slice(0, windowSize);
       this.pending = this.pending.slice(windowSize);
@@ -342,10 +343,10 @@ var SileroVAD = class _SileroVAD {
       const windowDuration = windowSize / this.opts.sampleRate;
       const transition = this.advanceState(p, windowDuration);
       if (transition !== null) {
-        event = transition;
+        this.eventQueue.push(transition);
       }
     }
-    return event;
+    return this.eventQueue.shift() ?? null;
   }
   advanceState(p, windowDuration) {
     const opts = this.opts;
@@ -400,6 +401,7 @@ var SileroVAD = class _SileroVAD {
     this.pubSpeaking = false;
     this.speechThresholdDuration = 0;
     this.silenceThresholdDuration = 0;
+    this.eventQueue = [];
     this.expFilter.reset();
     this.model.reset();
   }