telnyx 7.17.0 → 7.19.0

package/src/resources/phone-numbers/jobs.ts

@@ -14,8 +14,10 @@ import { path } from '../../internal/utils/path';
  */
 export class Jobs extends APIResource {
   /**
-   * Returns background jobs that operate on phone numbers. Results can be filtered
-   * by job type and sorted by creation time, and include pagination metadata.
+   * Returns background jobs that operate on phone numbers. Filter by job type,
+   * target phone numbers, or job status, and sort by creation time. Multiple
+   * phone-number or status values use OR semantics within that filter; different
+   * filter categories use AND semantics. Results include pagination metadata.
    *
    * @example
    * ```ts
@@ -239,7 +241,8 @@ export interface JobUpdateEmergencySettingsBatchResponse {
 
 export interface JobListParams extends DefaultFlatPaginationParams {
   /**
-   * Consolidated filter parameter (deepObject style). Originally: filter[type]
+   * Consolidated filter parameter (deepObject style). Originally: filter[type],
+   * filter[phone_number], filter[phone_number][], filter[status][]
    */
   filter?: JobListParams.Filter;
 
@@ -252,9 +255,25 @@ export interface JobListParams extends DefaultFlatPaginationParams {
 
 export namespace JobListParams {
   /**
-   * Consolidated filter parameter (deepObject style). Originally: filter[type]
+   * Consolidated filter parameter (deepObject style). Originally: filter[type],
+   * filter[phone_number], filter[phone_number][], filter[status][]
    */
   export interface Filter {
+    /**
+     * Returns jobs that targeted any of the supplied account-owned phone numbers.
+     * Values beginning with `+` must contain 1 to 20 digits after the plus sign. The
+     * 10-value limit is enforced before duplicate values are removed. Unmatched or
+     * non-account-owned identifiers return an empty result. Phone-number filtering
+     * must be enabled for the account.
+     */
+    phone_number?: string | Array<string>;
+
+    /**
+     * Returns jobs with any of the supplied statuses. Use repeated `filter[status][]`
+     * parameters; scalar and comma-separated status values are not accepted.
+     */
+    status?: Array<'pending' | 'in_progress' | 'completed' | 'failed' | 'expired'>;
+
     /**
      * Identifies the type of the background job.
      */

package/src/resources/sim-card-groups/actions.ts

@@ -67,8 +67,9 @@ export class Actions extends APIResource {
   }
 
   /**
-   * This action will asynchronously remove an existing Wireless Blocklist to all the
-   * SIMs in the SIM card group.
+   * This action asynchronously removes the Wireless Blocklist assigned to a SIM Card
+   * Group. The request returns `404` when the SIM Card Group does not exist and
+   * `422` when no Wireless Blocklist is assigned.
    *
    * @example
    * ```ts
@@ -118,8 +119,9 @@ export class Actions extends APIResource {
   }
 
   /**
-   * This action will asynchronously assign a Wireless Blocklist to all the SIMs in
-   * the SIM card group.
+   * This action asynchronously assigns a Wireless Blocklist to all SIMs in the SIM
+   * Card Group. The request returns `404` when the SIM Card Group does not exist and
+   * `422` when the Wireless Blocklist does not exist.
    *
    * @example
    * ```ts
@@ -201,6 +203,11 @@ export namespace SimCardGroupAction {
      * The identification of the related Private Wireless Gateway resource.
      */
     private_wireless_gateway_id?: string;
+
+    /**
+     * The identification of the related Wireless Blocklist resource.
+     */
+    wireless_blocklist_id?: string;
   }
 }
 

package/src/resources/speech-to-text/speech-to-text.ts

@@ -43,13 +43,14 @@ export class SpeechToText extends APIResource {
    * `Authorization: Bearer <API_KEY>` header.
    *
    * Supported engines: `Azure`, `Deepgram`, `Google`, `Telnyx`, `xAI`,
-   * `Speechmatics`, `Soniox`, `Parakeet`, `Humain`, `Reson8`.
+   * `Speechmatics`, `Soniox`, `Parakeet`, `Humain`, `Reson8`, `Cohere`.
    *
    * **Connection flow:**
    *
    * 1. Open WebSocket with query parameters specifying engine, input format, and
    *    language.
-   * 2. Send binary audio frames (mp3/wav format).
+   * 2. Send binary audio frames (mp3, wav, linear16, or linear32 format, per
+   *    `input_format`).
    * 3. Receive JSON transcript frames with `transcript`, `is_final`, and
    *    `confidence` fields.
    * 4. Close connection when done.
@@ -76,7 +77,7 @@ export class SpeechToText extends APIResource {
 export type SttServiceType = 'streaming' | 'file_based' | 'in_call' | 'ai_assistant';
 
 /**
- * Binary audio data in mp3 or wav format.
+ * Binary audio data in mp3, wav, linear16, or linear32 format, per `input_format`.
  */
 export type TranscribeClientEvent = Uploadable;
 
@@ -103,9 +104,10 @@ export namespace TranscribeServerEvent {
     type: 'transcript';
 
     /**
-     * Confidence score of the transcription, ranging from 0 to 1.
+     * Confidence score of the transcription, ranging from 0 to 1. `cohere/ar-stt`
+     * frames return `null` here rather than omitting the field.
      */
-    confidence?: number;
+    confidence?: number | null;
 
     /**
      * Whether this is a final transcription result. When `false`, this is an interim
@@ -219,6 +221,7 @@ export interface SpeechToTextListProvidersParams {
     | 'parakeet'
     | 'humain'
     | 'reson8'
+    | 'cohere'
     | 'azure'
     | 'openai'
     | 'google'
@@ -239,7 +242,7 @@ export interface SpeechToTextRetrieveTranscriptionParams {
   /**
    * The format of input audio stream.
    */
-  input_format: 'mp3' | 'wav';
+  input_format: 'mp3' | 'wav' | 'linear16' | 'linear32';
 
   /**
    * The transcription engine to use for processing the audio stream.
@@ -254,7 +257,8 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'Soniox'
     | 'Parakeet'
     | 'Humain'
-    | 'Reson8';
+    | 'Reson8'
+    | 'Cohere';
 
   /**
    * Silence duration (in milliseconds) that triggers end-of-speech detection. When
@@ -283,7 +287,9 @@ export interface SpeechToTextRetrieveTranscriptionParams {
   keywords?: string;
 
   /**
-   * The language spoken in the audio stream.
+   * The language spoken in the audio stream. For `cohere/ar-stt`, this must be `ar`
+   * or `en` — unlike other engines, Cohere does not auto-detect the language, and
+   * rejects unsupported values including `auto`; omitting it defaults to `ar`.
    */
   language?: string;
 
@@ -309,13 +315,21 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'soniox/stt-rt-v4'
     | 'nvidia/parakeet-v3'
     | 'humain/realtime'
-    | 'reson8/turns';
+    | 'reson8/turns'
+    | 'cohere/ar-stt';
 
   /**
    * Enable redaction of sensitive information (e.g., PCI data, SSN) from
    * transcription results. Supported values depend on the transcription engine.
    */
   redact?: string;
+
+  /**
+   * Audio sample rate in Hz. Required when `input_format` is a raw encoding
+   * (`linear16`, `linear32`) — those formats carry no header metadata. Ignored for
+   * container formats (`mp3`, `wav`), which self-describe their rate.
+   */
+  sample_rate?: number;
 }
 
 export declare namespace SpeechToText {

package/src/resources/webhooks.ts

@@ -6,25 +6,19 @@ import * as NumberOrdersAPI from './number-orders';
 import * as CallsAPI from './calls/calls';
 import * as MessagesAPI from './messages/messages';
 import * as ThreadsAPI from './email-inboxes/threads/threads';
-import { Webhook } from 'standardwebhooks';
 import { EmailBracketCursorPagination } from '../core/pagination';
+import { unsafeUnwrapWebhook, unwrapWebhook } from '../lib/webhooks';
 
 export class Webhooks extends APIResource {
-  unwrap(
+  async unwrap(
     body: string,
     { headers, key }: { headers: Record<string, string>; key?: string },
-  ): UnwrapWebhookEvent {
-    if (headers !== undefined) {
-      const keyStr: string | null = key === undefined ? this._client.publicKey : key;
-      if (keyStr === null) throw new Error('Webhook key must not be null in order to unwrap');
-      const wh = new Webhook(keyStr);
-      wh.verify(body, headers);
-    }
-    return JSON.parse(body) as UnwrapWebhookEvent;
+  ): Promise<UnwrapWebhookEvent> {
+    return unwrapWebhook<UnwrapWebhookEvent>(body, { headers, key }, this._client.publicKey);
   }
 
   unsafeUnwrap(body: string): UnsafeUnwrapWebhookEvent {
-    return JSON.parse(body) as UnsafeUnwrapWebhookEvent;
+    return unsafeUnwrapWebhook<UnsafeUnwrapWebhookEvent>(body);
   }
 }
 
@@ -4482,9 +4476,10 @@ export namespace Transcription {
   export namespace Payload {
     export interface TranscriptionData {
       /**
-       * Speech recognition confidence level.
+       * Speech recognition confidence level. `cohere/ar-stt` returns `null` here rather
+       * than omitting the field.
        */
-      confidence?: number;
+      confidence?: number | null;
 
       /**
        * When false, it means that this is an interim result.

package/src/resources/wireless-blocklist-values.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as AuthenticationProvidersAPI from './authentication-providers';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
@@ -10,7 +9,8 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class WirelessBlocklistValues extends APIResource {
   /**
-   * Retrieve all wireless blocklist values for a given blocklist type.
+   * Retrieve all wireless blocklist values for a given blocklist type. The request
+   * returns `422` when `type` is missing or invalid.
    */
   list(
     query: WirelessBlocklistValueListParams,
@@ -21,12 +21,10 @@ export class WirelessBlocklistValues extends APIResource {
 }
 
 export interface WirelessBlocklistValueListResponse {
-  data?:
+  data:
     | Array<WirelessBlocklistValueListResponse.Country>
     | Array<WirelessBlocklistValueListResponse.Mcc>
     | Array<WirelessBlocklistValueListResponse.Plmn>;
-
-  meta?: AuthenticationProvidersAPI.PaginationMeta;
 }
 
 export namespace WirelessBlocklistValueListResponse {
@@ -34,36 +32,21 @@ export namespace WirelessBlocklistValueListResponse {
     /**
      * ISO 3166-1 Alpha-2 Country Code.
      */
-    code: string;
-
-    /**
-     * The name of the country.
-     */
-    name: string;
+    country_code: string;
   }
 
   export interface Mcc {
     /**
      * Mobile Country Code.
      */
-    code: string;
-
-    /**
-     * The name of the country.
-     */
-    name: string;
+    mcc: string;
   }
 
   export interface Plmn {
     /**
      * Public land mobile network code (MCC + MNC).
      */
-    code: string;
-
-    /**
-     * The name of the network.
-     */
-    name: string;
+    plmn: string;
   }
 }
 

package/src/resources/wireless-blocklists.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -16,7 +17,7 @@ export class WirelessBlocklists extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const wirelessBlocklist of client.wirelessBlocklists.list()) {
+   * for await (const wirelessWirelessBlocklist of client.wirelessBlocklists.list()) {
    *   // ...
    * }
    * ```
@@ -24,8 +25,8 @@ export class WirelessBlocklists extends APIResource {
   list(
     query: WirelessBlocklistListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<WirelessBlocklistsDefaultFlatPagination, WirelessBlocklist> {
-    return this._client.getAPIList('/wireless_blocklists', DefaultFlatPagination<WirelessBlocklist>, {
+  ): PagePromise<WirelessWirelessBlocklistsDefaultFlatPagination, WirelessWirelessBlocklist> {
+    return this._client.getAPIList('/wireless_blocklists', DefaultFlatPagination<WirelessWirelessBlocklist>, {
       query,
       ...options,
     });
@@ -72,18 +73,22 @@ export class WirelessBlocklists extends APIResource {
   }
 
   /**
-   * Permanently deletes the specified wireless blocklist from your account.
+   * Permanently deletes the specified wireless blocklist from your account. The
+   * request returns `422` when the wireless blocklist is assigned to a SIM Card
+   * Group.
    *
    * @example
    * ```ts
-   * const wirelessBlocklist =
-   *   await client.wirelessBlocklists.delete(
-   *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *   );
+   * await client.wirelessBlocklists.delete(
+   *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
+   * );
    * ```
    */
-  delete(id: string, options?: RequestOptions): APIPromise<WirelessBlocklistDeleteResponse> {
-    return this._client.delete(path`/wireless_blocklists/${id}`, options);
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/wireless_blocklists/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
   }
 
   /**
@@ -102,7 +107,8 @@ export class WirelessBlocklists extends APIResource {
   }
 }
 
-export type WirelessBlocklistsDefaultFlatPagination = DefaultFlatPagination<WirelessBlocklist>;
+export type WirelessWirelessBlocklistsDefaultFlatPagination =
+  DefaultFlatPagination<WirelessWirelessBlocklist>;
 
 export interface WirelessBlocklist {
   /**
@@ -138,20 +144,48 @@ export interface WirelessBlocklist {
   values?: Array<string>;
 }
 
+export interface WirelessWirelessBlocklist {
+  /**
+   * Identifies the resource.
+   */
+  id?: string;
+
+  /**
+   * ISO 8601 formatted date-time indicating when the resource was created.
+   */
+  created_at?: string;
+
+  /**
+   * The wireless blocklist name.
+   */
+  name?: string;
+
+  /**
+   * The type of the wireless blocklist.
+   */
+  type?: 'country' | 'mcc' | 'plmn';
+
+  /**
+   * ISO 8601 formatted date-time indicating when the resource was updated.
+   */
+  updated_at?: string;
+
+  /**
+   * Values to block. The values here depend on the `type` of Wireless Blocklist.
+   */
+  values?: Array<string>;
+}
+
 export interface WirelessBlocklistCreateResponse {
-  data?: WirelessBlocklist;
+  data?: WirelessWirelessBlocklist;
 }
 
 export interface WirelessBlocklistRetrieveResponse {
-  data?: WirelessBlocklist;
+  data?: WirelessWirelessBlocklist;
 }
 
 export interface WirelessBlocklistUpdateResponse {
-  data?: WirelessBlocklist;
-}
-
-export interface WirelessBlocklistDeleteResponse {
-  data?: WirelessBlocklist;
+  data?: WirelessWirelessBlocklist;
 }
 
 export interface WirelessBlocklistListParams extends DefaultFlatPaginationParams {
@@ -164,11 +198,6 @@ export interface WirelessBlocklistListParams extends DefaultFlatPaginationParams
    * When the Private Wireless Gateway was last updated.
    */
   'filter[type]'?: string;
-
-  /**
-   * Values to filter on (inclusive).
-   */
-  'filter[values]'?: string;
 }
 
 export interface WirelessBlocklistUpdateParams {
@@ -203,11 +232,11 @@ export interface WirelessBlocklistCreateParams {
 export declare namespace WirelessBlocklists {
   export {
     type WirelessBlocklist as WirelessBlocklist,
+    type WirelessWirelessBlocklist as WirelessWirelessBlocklist,
     type WirelessBlocklistCreateResponse as WirelessBlocklistCreateResponse,
     type WirelessBlocklistRetrieveResponse as WirelessBlocklistRetrieveResponse,
     type WirelessBlocklistUpdateResponse as WirelessBlocklistUpdateResponse,
-    type WirelessBlocklistDeleteResponse as WirelessBlocklistDeleteResponse,
-    type WirelessBlocklistsDefaultFlatPagination as WirelessBlocklistsDefaultFlatPagination,
+    type WirelessWirelessBlocklistsDefaultFlatPagination as WirelessWirelessBlocklistsDefaultFlatPagination,
     type WirelessBlocklistListParams as WirelessBlocklistListParams,
     type WirelessBlocklistUpdateParams as WirelessBlocklistUpdateParams,
     type WirelessBlocklistCreateParams as WirelessBlocklistCreateParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.17.0'; // x-release-please-version
+export const VERSION = '7.19.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.17.0";
+export declare const VERSION = "7.19.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.17.0";
+export declare const VERSION = "7.19.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.17.0'; // x-release-please-version
+exports.VERSION = '7.19.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '7.17.0'; // x-release-please-version
+export const VERSION = '7.19.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map