nixflex 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.4.0
+
+- New: `client.storage` - connect your own S3-compatible bucket for call recordings (data residency). `storage.set()` verifies with a probe write before saving, `storage.get()` never returns the secret, `storage.delete()` disconnects. Recordings then upload to your bucket and `recording_url` becomes a `byo:` path. See https://docs.nixflex.com/advanced/your-own-storage
+
+## 0.3.1 (2026-08-24)
+
+- Voicemail as a structured setting: `voicemail_leave_enabled` + `voicemail_message` on Agent (applies to dashboard-imported numbers) and on PhoneNumber / PhoneNumberUpdateParams (the only voicemail control for API-imported numbers - no inheritance across the two worlds)
+- Enabling without a message is rejected with `voicemail_message_required`
+- No breaking changes.
 ## 0.3.0 (2026-08-23)
 
 - Call type: `charged_minutes` (minutes actually billed - transfers stop the meter at handoff, so this can be less than the recording length)

package/dist/index.cjs

@@ -465,6 +465,28 @@ var UsageResource = class {
     return this.http.request("GET", "/usage", void 0, void 0, opts);
   }
 };
+var Storage = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Connect your own S3-compatible bucket for call recordings (data residency).
+   * The connection is verified with a probe write BEFORE saving - broken
+   * credentials are rejected, never stored. Recordings then upload to your
+   * bucket and Nixflex keeps no copy; recording_url becomes a byo: path. */
+  set(params, opts) {
+    return this.http.request("PUT", "/account/storage", params, void 0, opts);
+  }
+  /** Current storage configuration. The secret is never included. */
+  get(opts) {
+    return this.http.request("GET", "/account/storage", void 0, void 0, opts);
+  }
+  /** Disconnect and clear. Recordings return to Nixflex EU storage from the
+   * next call; files already in your bucket are untouched - they are yours. */
+  delete(opts) {
+    return this.http.request("DELETE", "/account/storage", void 0, void 0, opts);
+  }
+};
 var Webhooks = class {
   constructor(http) {
     this.http = http;
@@ -512,6 +534,8 @@ var Nixflex = class {
   usage;
   /** Per-number post-call webhook configuration. */
   webhooks;
+  /** Your own S3-compatible recording storage (data residency). */
+  storage;
   constructor(options) {
     const http = new HttpClient(options);
     this.agents = new Agents(http);
@@ -522,6 +546,7 @@ var Nixflex = class {
     this.keys = new Keys(http);
     this.usage = new UsageResource(http);
     this.webhooks = new Webhooks(http);
+    this.storage = new Storage(http);
   }
   /** Create a brand-new API key (unauthenticated signup endpoint - most
    * developers use the dashboard instead). The key_secret is shown ONCE.

package/dist/index.d.cts

@@ -66,6 +66,12 @@ interface AgentCreateParams {
     amd_enabled?: boolean;
     /** Keypad digits instead of speech. Three-state: true/false explicit, null = not set (a number's own setting decides). */
     dtmf_enabled?: boolean | null;
+    /** Leave a message on detected voicemails. Applies to DASHBOARD-imported numbers on
+     * this agent; API-imported numbers use their own per-number setting instead. Enabling
+     * without voicemail_message is rejected with voicemail_message_required. */
+    voicemail_leave_enabled?: boolean;
+    /** Spoken word for word on voicemail when enabled - the agent never rewrites it. */
+    voicemail_message?: string | null;
     /** Where to POST post-call data. */
     webhook_url?: string | null;
     /** Agent can end the call cleanly. Default true. */
@@ -124,6 +130,8 @@ interface Agent {
     fallback_message: string;
     post_call_sms_enabled?: boolean;
     post_call_sms_template?: string | null;
+    voicemail_leave_enabled?: boolean;
+    voicemail_message?: string | null;
     data_extraction_fields?: unknown[];
     is_active: boolean;
     created_at: string;
@@ -385,6 +393,12 @@ interface PhoneNumber {
     custom_prompt?: string | null;
     voice_id?: string | null;
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail setting - the ONLY one that applies to API-imported
+     * numbers (dashboard-imported numbers follow the agent). null = not set = silent
+     * hangup on voicemail. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on a detected voicemail when enabled. */
+    voicemail_message?: string | null;
     sms_prompt?: string | null;
     web_prompt?: string | null;
     speaking_rate?: number | null;
@@ -401,6 +415,12 @@ interface PhoneNumberUpdateParams {
     voice_id?: string | null;
     /** SMS agent auto-reply on/off. Default false. */
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail toggle - the only voicemail control for API-imported
+     * numbers. Enabling without a message (here or already saved) is rejected with
+     * voicemail_message_required. null clears. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on voicemail. Max 2000. null clears. */
+    voicemail_message?: string | null;
     /** SMS agent instructions (independent channel). Max 20000. null clears. */
     sms_prompt?: string | null;
     /** Web agent instructions (independent channel). Max 20000. null clears. */
@@ -556,6 +576,38 @@ interface WebhookConfigResponse {
     phone_number?: string;
     url?: string | null;
 }
+/** Your own S3-compatible recording storage (BYO storage). */
+interface StorageConfig {
+    storage_enabled: boolean;
+    endpoint: string | null;
+    region: string | null;
+    bucket: string | null;
+    access_key: string | null;
+}
+interface StorageSetParams {
+    /** The exact bucket name at your provider. */
+    bucket: string;
+    /** Access key ID with permission to write objects. */
+    access_key: string;
+    /** Secret access key. Write-only - stored encrypted, never returned. */
+    secret_key: string;
+    /** https:// endpoint of your provider. Leave empty for Amazon S3. */
+    endpoint?: string;
+    /** Your bucket's region. Defaults to auto. */
+    region?: string;
+}
+interface StorageSetResponse {
+    ok: boolean;
+    storage_enabled: boolean;
+    bucket: string;
+    endpoint: string | null;
+    region: string;
+    verified: boolean;
+}
+interface StorageDeleteResponse {
+    ok: boolean;
+    storage_enabled: boolean;
+}
 
 declare class PhoneNumbers {
     private readonly http;
@@ -643,6 +695,21 @@ declare class UsageResource {
     get(opts?: RequestOptions): Promise<Usage>;
 }
 
+declare class Storage {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Connect your own S3-compatible bucket for call recordings (data residency).
+     * The connection is verified with a probe write BEFORE saving - broken
+     * credentials are rejected, never stored. Recordings then upload to your
+     * bucket and Nixflex keeps no copy; recording_url becomes a byo: path. */
+    set(params: StorageSetParams, opts?: RequestOptions): Promise<StorageSetResponse>;
+    /** Current storage configuration. The secret is never included. */
+    get(opts?: RequestOptions): Promise<StorageConfig>;
+    /** Disconnect and clear. Recordings return to Nixflex EU storage from the
+     * next call; files already in your bucket are untouched - they are yours. */
+    delete(opts?: RequestOptions): Promise<StorageDeleteResponse>;
+}
+
 declare class Webhooks {
     private readonly http;
     constructor(http: HttpClient);
@@ -732,6 +799,8 @@ declare class Nixflex {
     readonly usage: UsageResource;
     /** Per-number post-call webhook configuration. */
     readonly webhooks: Webhooks;
+    /** Your own S3-compatible recording storage (data residency). */
+    readonly storage: Storage;
     constructor(options: NixflexClientOptions);
     /** Create a brand-new API key (unauthenticated signup endpoint - most
      * developers use the dashboard instead). The key_secret is shown ONCE.
@@ -742,4 +811,4 @@ declare class Nixflex {
     }, baseUrl?: string): Promise<KeyCreateResponse>;
 }
 
-export { type Agent, type AgentCreateParams, type AgentDeleteResponse, type AgentUpdateParams, type BatchCampaignParams, type BatchCreateResponse, type BatchInvalidEntry, type BatchLaunchResponse, type BatchRecipient, type Call, type CallDeleteAllResponse, type CallDeleteResponse, type CallDirection, type CallerSentiment, type KeyCreateResponse, type KeyRotateResponse, type ListParams, type MonitorToggleResponse, Nixflex, type NixflexAPIErrorBody, NixflexAuthenticationError, type NixflexClientOptions, NixflexConnectionError, NixflexError, NixflexInvalidRequestError, NixflexNotFoundError, NixflexPaymentRequiredError, NixflexRateLimitError, NixflexServerError, type OutboundCallParams, type OutboundCallResponse, type PhoneNumber, type PhoneNumberDeleteResponse, type PhoneNumberImportParams, type PhoneNumberListResponse, type PhoneNumberUpdateParams, type RequestOptions, type ResponseLength, type SmsCampaign, type SmsCampaignCreateParams, type SmsCampaignDeleteResponse, type SmsCampaignLaunchResponse, type SmsCampaignListResponse, type SmsCampaignRecipient, type SmsCampaignStatus, type SmsSendParams, type SmsSendResponse, type TransferType, type Usage, type VerifyOptions, type WebCallsToggleResponse, type WebhookConfigResponse, type Weekday, Nixflex as default, errorFromResponse, verifyWebhookSignature };
+export { type Agent, type AgentCreateParams, type AgentDeleteResponse, type AgentUpdateParams, type BatchCampaignParams, type BatchCreateResponse, type BatchInvalidEntry, type BatchLaunchResponse, type BatchRecipient, type Call, type CallDeleteAllResponse, type CallDeleteResponse, type CallDirection, type CallerSentiment, type KeyCreateResponse, type KeyRotateResponse, type ListParams, type MonitorToggleResponse, Nixflex, type NixflexAPIErrorBody, NixflexAuthenticationError, type NixflexClientOptions, NixflexConnectionError, NixflexError, NixflexInvalidRequestError, NixflexNotFoundError, NixflexPaymentRequiredError, NixflexRateLimitError, NixflexServerError, type OutboundCallParams, type OutboundCallResponse, type PhoneNumber, type PhoneNumberDeleteResponse, type PhoneNumberImportParams, type PhoneNumberListResponse, type PhoneNumberUpdateParams, type RequestOptions, type ResponseLength, type SmsCampaign, type SmsCampaignCreateParams, type SmsCampaignDeleteResponse, type SmsCampaignLaunchResponse, type SmsCampaignListResponse, type SmsCampaignRecipient, type SmsCampaignStatus, type SmsSendParams, type SmsSendResponse, type StorageConfig, type StorageDeleteResponse, type StorageSetParams, type StorageSetResponse, type TransferType, type Usage, type VerifyOptions, type WebCallsToggleResponse, type WebhookConfigResponse, type Weekday, Nixflex as default, errorFromResponse, verifyWebhookSignature };

package/dist/index.d.ts

@@ -66,6 +66,12 @@ interface AgentCreateParams {
     amd_enabled?: boolean;
     /** Keypad digits instead of speech. Three-state: true/false explicit, null = not set (a number's own setting decides). */
     dtmf_enabled?: boolean | null;
+    /** Leave a message on detected voicemails. Applies to DASHBOARD-imported numbers on
+     * this agent; API-imported numbers use their own per-number setting instead. Enabling
+     * without voicemail_message is rejected with voicemail_message_required. */
+    voicemail_leave_enabled?: boolean;
+    /** Spoken word for word on voicemail when enabled - the agent never rewrites it. */
+    voicemail_message?: string | null;
     /** Where to POST post-call data. */
     webhook_url?: string | null;
     /** Agent can end the call cleanly. Default true. */
@@ -124,6 +130,8 @@ interface Agent {
     fallback_message: string;
     post_call_sms_enabled?: boolean;
     post_call_sms_template?: string | null;
+    voicemail_leave_enabled?: boolean;
+    voicemail_message?: string | null;
     data_extraction_fields?: unknown[];
     is_active: boolean;
     created_at: string;
@@ -385,6 +393,12 @@ interface PhoneNumber {
     custom_prompt?: string | null;
     voice_id?: string | null;
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail setting - the ONLY one that applies to API-imported
+     * numbers (dashboard-imported numbers follow the agent). null = not set = silent
+     * hangup on voicemail. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on a detected voicemail when enabled. */
+    voicemail_message?: string | null;
     sms_prompt?: string | null;
     web_prompt?: string | null;
     speaking_rate?: number | null;
@@ -401,6 +415,12 @@ interface PhoneNumberUpdateParams {
     voice_id?: string | null;
     /** SMS agent auto-reply on/off. Default false. */
     sms_reply_enabled?: boolean;
+    /** This number's own voicemail toggle - the only voicemail control for API-imported
+     * numbers. Enabling without a message (here or already saved) is rejected with
+     * voicemail_message_required. null clears. */
+    voicemail_leave_enabled?: boolean | null;
+    /** Spoken word for word on voicemail. Max 2000. null clears. */
+    voicemail_message?: string | null;
     /** SMS agent instructions (independent channel). Max 20000. null clears. */
     sms_prompt?: string | null;
     /** Web agent instructions (independent channel). Max 20000. null clears. */
@@ -556,6 +576,38 @@ interface WebhookConfigResponse {
     phone_number?: string;
     url?: string | null;
 }
+/** Your own S3-compatible recording storage (BYO storage). */
+interface StorageConfig {
+    storage_enabled: boolean;
+    endpoint: string | null;
+    region: string | null;
+    bucket: string | null;
+    access_key: string | null;
+}
+interface StorageSetParams {
+    /** The exact bucket name at your provider. */
+    bucket: string;
+    /** Access key ID with permission to write objects. */
+    access_key: string;
+    /** Secret access key. Write-only - stored encrypted, never returned. */
+    secret_key: string;
+    /** https:// endpoint of your provider. Leave empty for Amazon S3. */
+    endpoint?: string;
+    /** Your bucket's region. Defaults to auto. */
+    region?: string;
+}
+interface StorageSetResponse {
+    ok: boolean;
+    storage_enabled: boolean;
+    bucket: string;
+    endpoint: string | null;
+    region: string;
+    verified: boolean;
+}
+interface StorageDeleteResponse {
+    ok: boolean;
+    storage_enabled: boolean;
+}
 
 declare class PhoneNumbers {
     private readonly http;
@@ -643,6 +695,21 @@ declare class UsageResource {
     get(opts?: RequestOptions): Promise<Usage>;
 }
 
+declare class Storage {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Connect your own S3-compatible bucket for call recordings (data residency).
+     * The connection is verified with a probe write BEFORE saving - broken
+     * credentials are rejected, never stored. Recordings then upload to your
+     * bucket and Nixflex keeps no copy; recording_url becomes a byo: path. */
+    set(params: StorageSetParams, opts?: RequestOptions): Promise<StorageSetResponse>;
+    /** Current storage configuration. The secret is never included. */
+    get(opts?: RequestOptions): Promise<StorageConfig>;
+    /** Disconnect and clear. Recordings return to Nixflex EU storage from the
+     * next call; files already in your bucket are untouched - they are yours. */
+    delete(opts?: RequestOptions): Promise<StorageDeleteResponse>;
+}
+
 declare class Webhooks {
     private readonly http;
     constructor(http: HttpClient);
@@ -732,6 +799,8 @@ declare class Nixflex {
     readonly usage: UsageResource;
     /** Per-number post-call webhook configuration. */
     readonly webhooks: Webhooks;
+    /** Your own S3-compatible recording storage (data residency). */
+    readonly storage: Storage;
     constructor(options: NixflexClientOptions);
     /** Create a brand-new API key (unauthenticated signup endpoint - most
      * developers use the dashboard instead). The key_secret is shown ONCE.
@@ -742,4 +811,4 @@ declare class Nixflex {
     }, baseUrl?: string): Promise<KeyCreateResponse>;
 }
 
-export { type Agent, type AgentCreateParams, type AgentDeleteResponse, type AgentUpdateParams, type BatchCampaignParams, type BatchCreateResponse, type BatchInvalidEntry, type BatchLaunchResponse, type BatchRecipient, type Call, type CallDeleteAllResponse, type CallDeleteResponse, type CallDirection, type CallerSentiment, type KeyCreateResponse, type KeyRotateResponse, type ListParams, type MonitorToggleResponse, Nixflex, type NixflexAPIErrorBody, NixflexAuthenticationError, type NixflexClientOptions, NixflexConnectionError, NixflexError, NixflexInvalidRequestError, NixflexNotFoundError, NixflexPaymentRequiredError, NixflexRateLimitError, NixflexServerError, type OutboundCallParams, type OutboundCallResponse, type PhoneNumber, type PhoneNumberDeleteResponse, type PhoneNumberImportParams, type PhoneNumberListResponse, type PhoneNumberUpdateParams, type RequestOptions, type ResponseLength, type SmsCampaign, type SmsCampaignCreateParams, type SmsCampaignDeleteResponse, type SmsCampaignLaunchResponse, type SmsCampaignListResponse, type SmsCampaignRecipient, type SmsCampaignStatus, type SmsSendParams, type SmsSendResponse, type TransferType, type Usage, type VerifyOptions, type WebCallsToggleResponse, type WebhookConfigResponse, type Weekday, Nixflex as default, errorFromResponse, verifyWebhookSignature };
+export { type Agent, type AgentCreateParams, type AgentDeleteResponse, type AgentUpdateParams, type BatchCampaignParams, type BatchCreateResponse, type BatchInvalidEntry, type BatchLaunchResponse, type BatchRecipient, type Call, type CallDeleteAllResponse, type CallDeleteResponse, type CallDirection, type CallerSentiment, type KeyCreateResponse, type KeyRotateResponse, type ListParams, type MonitorToggleResponse, Nixflex, type NixflexAPIErrorBody, NixflexAuthenticationError, type NixflexClientOptions, NixflexConnectionError, NixflexError, NixflexInvalidRequestError, NixflexNotFoundError, NixflexPaymentRequiredError, NixflexRateLimitError, NixflexServerError, type OutboundCallParams, type OutboundCallResponse, type PhoneNumber, type PhoneNumberDeleteResponse, type PhoneNumberImportParams, type PhoneNumberListResponse, type PhoneNumberUpdateParams, type RequestOptions, type ResponseLength, type SmsCampaign, type SmsCampaignCreateParams, type SmsCampaignDeleteResponse, type SmsCampaignLaunchResponse, type SmsCampaignListResponse, type SmsCampaignRecipient, type SmsCampaignStatus, type SmsSendParams, type SmsSendResponse, type StorageConfig, type StorageDeleteResponse, type StorageSetParams, type StorageSetResponse, type TransferType, type Usage, type VerifyOptions, type WebCallsToggleResponse, type WebhookConfigResponse, type Weekday, Nixflex as default, errorFromResponse, verifyWebhookSignature };

package/dist/index.js

@@ -429,6 +429,28 @@ var UsageResource = class {
     return this.http.request("GET", "/usage", void 0, void 0, opts);
   }
 };
+var Storage = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Connect your own S3-compatible bucket for call recordings (data residency).
+   * The connection is verified with a probe write BEFORE saving - broken
+   * credentials are rejected, never stored. Recordings then upload to your
+   * bucket and Nixflex keeps no copy; recording_url becomes a byo: path. */
+  set(params, opts) {
+    return this.http.request("PUT", "/account/storage", params, void 0, opts);
+  }
+  /** Current storage configuration. The secret is never included. */
+  get(opts) {
+    return this.http.request("GET", "/account/storage", void 0, void 0, opts);
+  }
+  /** Disconnect and clear. Recordings return to Nixflex EU storage from the
+   * next call; files already in your bucket are untouched - they are yours. */
+  delete(opts) {
+    return this.http.request("DELETE", "/account/storage", void 0, void 0, opts);
+  }
+};
 var Webhooks = class {
   constructor(http) {
     this.http = http;
@@ -476,6 +498,8 @@ var Nixflex = class {
   usage;
   /** Per-number post-call webhook configuration. */
   webhooks;
+  /** Your own S3-compatible recording storage (data residency). */
+  storage;
   constructor(options) {
     const http = new HttpClient(options);
     this.agents = new Agents(http);
@@ -486,6 +510,7 @@ var Nixflex = class {
     this.keys = new Keys(http);
     this.usage = new UsageResource(http);
     this.webhooks = new Webhooks(http);
+    this.storage = new Storage(http);
   }
   /** Create a brand-new API key (unauthenticated signup endpoint - most
    * developers use the dashboard instead). The key_secret is shown ONCE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nixflex",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official Node.js SDK for the Nixflex voice AI platform - AI phone agents, outbound campaigns, and SMS.",
   "keywords": [
     "nixflex",