@augstash/sdk 0.2.0

package/dist/generated/src/apis/WhatsAppBusinessProfileApi.js

@@ -0,0 +1,187 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Augstash Public API
+ * Every /api/_** response is wrapped in {success, code, data, message, traceId, timestamp}; the schema shown for an operation is what arrives in `data`, and the SDKs unwrap it. Errors carry a stable `code` - branch on that, never on `message`. Authentication is an ask_live_* key on X-Api-Key, or a bearer token. Operations marked \'Not reachable with an ask_live_* API key\' need a user token.
+ *
+ * The version of the OpenAPI document: v1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppBusinessProfileApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class WhatsAppBusinessProfileApi extends runtime.BaseAPI {
+    /**
+     * Reads < 800ms — a live Meta round trip, not a local read. Every profile field is nullable and a null means Meta holds nothing for it, so an unfilled profile comes back as nulls rather than empty strings. `limits` carries the field lengths, website count and picture constraints this service enforces — validate against those rather than a copy in the client. `profilePictureUrl` is a Meta CDN URL that can expire; treat a broken image as a reason to re-read, not as proof there is no picture. Not reachable with an ask_live_* API key - needs a signed-in user\'s token.
+     * Get a phone number\'s WhatsApp business profile
+     */
+    async getWabaPhonenumbersProfileRaw(requestParameters, initOverrides) {
+        if (requestParameters['phoneId'] == null) {
+            throw new runtime.RequiredError('phoneId', 'Required parameter "phoneId" was null or undefined when calling getWabaPhonenumbersProfile().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-Api-Key"] = await this.configuration.apiKey("X-Api-Key"); // ApiKeyAuth authentication
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/waba/phone-numbers/{phoneId}/profile`;
+        urlPath = urlPath.replace(`{${"phoneId"}}`, encodeURIComponent(String(requestParameters['phoneId'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WhatsAppBusinessProfileResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Reads < 800ms — a live Meta round trip, not a local read. Every profile field is nullable and a null means Meta holds nothing for it, so an unfilled profile comes back as nulls rather than empty strings. `limits` carries the field lengths, website count and picture constraints this service enforces — validate against those rather than a copy in the client. `profilePictureUrl` is a Meta CDN URL that can expire; treat a broken image as a reason to re-read, not as proof there is no picture. Not reachable with an ask_live_* API key - needs a signed-in user\'s token.
+     * Get a phone number\'s WhatsApp business profile
+     */
+    async getWabaPhonenumbersProfile(requestParameters, initOverrides) {
+        const response = await this.getWabaPhonenumbersProfileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Writes < 800ms. A FULL REPLACE: every text field is written, and a null or blank one is CLEARED at Meta — send the whole profile, not a diff. Two things do not behave that way and both are Meta\'s doing: `vertical` cannot be cleared (the enum has no value meaning unset, and OTHER is a real category), so a null leaves it alone; and the picture is untouched here because it has its own endpoint. The response is a fresh read-back from Meta, not an echo of the request. Field lengths are judged against the `limits` served on the GET. Not reachable with an ask_live_* API key - needs a signed-in user\'s token.
+     * Replace a phone number\'s WhatsApp business profile
+     */
+    async updateWabaPhonenumbersRaw(requestParameters, initOverrides) {
+        if (requestParameters['phoneId'] == null) {
+            throw new runtime.RequiredError('phoneId', 'Required parameter "phoneId" was null or undefined when calling updateWabaPhonenumbers().');
+        }
+        if (requestParameters['updateWhatsAppBusinessProfileRequest'] == null) {
+            throw new runtime.RequiredError('updateWhatsAppBusinessProfileRequest', 'Required parameter "updateWhatsAppBusinessProfileRequest" was null or undefined when calling updateWabaPhonenumbers().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (requestParameters['xIdempotencyKey'] != null) {
+            headerParameters['X-Idempotency-Key'] = String(requestParameters['xIdempotencyKey']);
+        }
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-Api-Key"] = await this.configuration.apiKey("X-Api-Key"); // ApiKeyAuth authentication
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/waba/phone-numbers/{phoneId}/profile`;
+        urlPath = urlPath.replace(`{${"phoneId"}}`, encodeURIComponent(String(requestParameters['phoneId'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'PUT',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.UpdateWhatsAppBusinessProfileRequestToJSON)(requestParameters['updateWhatsAppBusinessProfileRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WhatsAppBusinessProfileResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Writes < 800ms. A FULL REPLACE: every text field is written, and a null or blank one is CLEARED at Meta — send the whole profile, not a diff. Two things do not behave that way and both are Meta\'s doing: `vertical` cannot be cleared (the enum has no value meaning unset, and OTHER is a real category), so a null leaves it alone; and the picture is untouched here because it has its own endpoint. The response is a fresh read-back from Meta, not an echo of the request. Field lengths are judged against the `limits` served on the GET. Not reachable with an ask_live_* API key - needs a signed-in user\'s token.
+     * Replace a phone number\'s WhatsApp business profile
+     */
+    async updateWabaPhonenumbers(requestParameters, initOverrides) {
+        const response = await this.updateWabaPhonenumbersRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Writes < 3s — four Meta calls, two of which move the image itself. Takes the same body as POST /api/v1/tenant/logo (`{content, contentType, filename}`, base64, a `data:` URL prefix tolerated): there is no multipart on this API and none is needed. Meta will not accept an image on the profile endpoint — it requires a handle from its Resumable Upload API — and that exchange happens server-side, so no Meta credential ever reaches the browser. ONLY the picture changes: the About line, address, description, email, websites and vertical are left exactly as they were. Size, MIME type and minimum dimensions are checked before anything is sent to Meta; the accepted values are on the GET response\'s `limits`. The response is the full profile, read back from Meta, so the new `profilePictureUrl` comes with it. Not reachable with an ask_live_* API key - needs a signed-in user\'s token.
+     * Set a phone number\'s WhatsApp profile picture
+     */
+    async uploadPictureRaw(requestParameters, initOverrides) {
+        if (requestParameters['phoneId'] == null) {
+            throw new runtime.RequiredError('phoneId', 'Required parameter "phoneId" was null or undefined when calling uploadPicture().');
+        }
+        if (requestParameters['uploadProfilePictureRequest'] == null) {
+            throw new runtime.RequiredError('uploadProfilePictureRequest', 'Required parameter "uploadProfilePictureRequest" was null or undefined when calling uploadPicture().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (requestParameters['xIdempotencyKey'] != null) {
+            headerParameters['X-Idempotency-Key'] = String(requestParameters['xIdempotencyKey']);
+        }
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-Api-Key"] = await this.configuration.apiKey("X-Api-Key"); // ApiKeyAuth authentication
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/waba/phone-numbers/{phoneId}/profile/picture`;
+        urlPath = urlPath.replace(`{${"phoneId"}}`, encodeURIComponent(String(requestParameters['phoneId'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.UploadProfilePictureRequestToJSON)(requestParameters['uploadProfilePictureRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WhatsAppBusinessProfileResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Writes < 3s — four Meta calls, two of which move the image itself. Takes the same body as POST /api/v1/tenant/logo (`{content, contentType, filename}`, base64, a `data:` URL prefix tolerated): there is no multipart on this API and none is needed. Meta will not accept an image on the profile endpoint — it requires a handle from its Resumable Upload API — and that exchange happens server-side, so no Meta credential ever reaches the browser. ONLY the picture changes: the About line, address, description, email, websites and vertical are left exactly as they were. Size, MIME type and minimum dimensions are checked before anything is sent to Meta; the accepted values are on the GET response\'s `limits`. The response is the full profile, read back from Meta, so the new `profilePictureUrl` comes with it. Not reachable with an ask_live_* API key - needs a signed-in user\'s token.
+     * Set a phone number\'s WhatsApp profile picture
+     */
+    async uploadPicture(requestParameters, initOverrides) {
+        const response = await this.uploadPictureRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.WhatsAppBusinessProfileApi = WhatsAppBusinessProfileApi;

package/dist/generated/src/apis/WhatsAppCallApi.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Augstash Public API
+ * Every /api/_** response is wrapped in {success, code, data, message, traceId, timestamp}; the schema shown for an operation is what arrives in `data`, and the SDKs unwrap it. Errors carry a stable `code` - branch on that, never on `message`. Authentication is an ask_live_* key on X-Api-Key, or a bearer token. Operations marked \'Not reachable with an ask_live_* API key\' need a user token.
+ *
+ * The version of the OpenAPI document: v1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime';
+import type { AcceptWaCallRequest, CursorPageWaCallResponse, InitiateWaCallRequest, RequestCallPermissionRequest, TerminateWaCallRequest, WaCallPermissionResponse, WaCallResponse } from '../models/index';
+export interface AcceptRequest {
+    callId: string;
+    acceptWaCallRequest: AcceptWaCallRequest;
+    xIdempotencyKey?: string;
+}
+export interface GetWhatsappCallsRequest {
+    callId: string;
+}
+export interface InitiateRequest {
+    initiateWaCallRequest: InitiateWaCallRequest;
+    xIdempotencyKey?: string;
+}
+export interface ListWhatsappRequest {
+    cursor?: string;
+    limit?: number;
+    contactWaId?: string;
+}
+export interface PermissionStatusRequest {
+    contactWaId: string;
+    phoneNumberId?: string;
+    wabaAccountId?: string;
+    refresh?: boolean;
+}
+export interface RejectWhatsappRequest {
+    callId: string;
+    xIdempotencyKey?: string;
+}
+export interface RequestPermissionRequest {
+    requestCallPermissionRequest: RequestCallPermissionRequest;
+    xIdempotencyKey?: string;
+}
+export interface RevokePermissionRequest {
+    permissionId: string;
+    xIdempotencyKey?: string;
+}
+export interface TerminateRequest {
+    callId: string;
+    xIdempotencyKey?: string;
+    terminateWaCallRequest?: TerminateWaCallRequest;
+}
+/**
+ * WhatsAppCallApi - interface
+ *
+ * @export
+ * @interface WhatsAppCallApiInterface
+ */
+export interface WhatsAppCallApiInterface {
+    /**
+     * Answers a customer-initiated call with the agent\'s WebRTC SDP. The caller\'s offer arrives as `sdpOffer` on the CALL_INCOMING realtime frame (and on GET /calls/{callId} while the call is still RINGING); feed it to setRemoteDescription(), createAnswer(), and post the result here. Meta is pre-accepted first so audio is already flowing when the answer lands — a failed pre-accept is logged and stepped over, never a reason to drop an answerable call. Only a RINGING inbound call can be answered: a second agent clicking Answer gets WA_CALL_INVALID_STATE, which means the call was taken, not that anything went wrong. Not billed. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * @summary Answer an inbound call
+     * @param {string} callId
+     * @param {AcceptWaCallRequest} acceptWaCallRequest
+     * @param {string} [xIdempotencyKey] Makes this call replayable instead of re-executed on retry (AS-TGT-001). The first 2xx response is cached per (tenant, key) for 24h and replayed verbatim, with &#x60;X-Idempotent-Replay&#x60; set. Reusing a key with a different body is refused with 409 IDEMPOTENCY_KEY_REUSED. The SDKs send one automatically on mutating calls.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    acceptRaw(requestParameters: AcceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Answers a customer-initiated call with the agent\'s WebRTC SDP. The caller\'s offer arrives as `sdpOffer` on the CALL_INCOMING realtime frame (and on GET /calls/{callId} while the call is still RINGING); feed it to setRemoteDescription(), createAnswer(), and post the result here. Meta is pre-accepted first so audio is already flowing when the answer lands — a failed pre-accept is logged and stepped over, never a reason to drop an answerable call. Only a RINGING inbound call can be answered: a second agent clicking Answer gets WA_CALL_INVALID_STATE, which means the call was taken, not that anything went wrong. Not billed. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Answer an inbound call
+     */
+    accept(requestParameters: AcceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * The current state of a single call — and the recovery path for a browser that missed a realtime frame, since CONNECTED and the end state both arrive asynchronously from Meta\'s webhook. Carries the SDP the client still needs: the caller\'s `sdpOffer` while an inbound call is RINGING, and the far side\'s `sdpAnswer` while an outbound call is CONNECTED. Both go null once the call is over. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * @summary One call
+     * @param {string} callId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    getWhatsappCallsRaw(requestParameters: GetWhatsappCallsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * The current state of a single call — and the recovery path for a browser that missed a realtime frame, since CONNECTED and the end state both arrive asynchronously from Meta\'s webhook. Carries the SDP the client still needs: the caller\'s `sdpOffer` while an inbound call is RINGING, and the far side\'s `sdpAnswer` while an outbound call is CONNECTED. Both go null once the call is over. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * One call
+     */
+    getWhatsappCalls(requestParameters: GetWhatsappCallsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * Relays the caller\'s WebRTC SDP offer to Meta. The browser owns the peer connection: create the offer with `createOffer()` and send it here. ⚠️ `sdpAnswer` is NOT in this response — Meta replies with a call id only, because the customer has not picked up yet. The answer arrives when they do, on the CALL_UPDATED frame reporting CONNECTED (and on GET /calls/{callId} for a browser that missed it); feed it into `setRemoteDescription()` then. For the same reason `mediaAvailable` is false here on a perfectly healthy call — it only means anything once there is an answer, and is FALSE on the local profile where the stub returns a marker rather than a session description. The call starts RINGING; CONNECTED only ever arrives via Meta\'s webhook, never in this response. Refused without a live calling permission, and refused outside the tenant\'s business hours. Not billed — a WhatsApp call carries no carrier cost and no wallet reservation is taken. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * @summary Place a WhatsApp call
+     * @param {InitiateWaCallRequest} initiateWaCallRequest
+     * @param {string} [xIdempotencyKey] Makes this call replayable instead of re-executed on retry (AS-TGT-001). The first 2xx response is cached per (tenant, key) for 24h and replayed verbatim, with &#x60;X-Idempotent-Replay&#x60; set. Reusing a key with a different body is refused with 409 IDEMPOTENCY_KEY_REUSED. The SDKs send one automatically on mutating calls.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    initiateRaw(requestParameters: InitiateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Relays the caller\'s WebRTC SDP offer to Meta. The browser owns the peer connection: create the offer with `createOffer()` and send it here. ⚠️ `sdpAnswer` is NOT in this response — Meta replies with a call id only, because the customer has not picked up yet. The answer arrives when they do, on the CALL_UPDATED frame reporting CONNECTED (and on GET /calls/{callId} for a browser that missed it); feed it into `setRemoteDescription()` then. For the same reason `mediaAvailable` is false here on a perfectly healthy call — it only means anything once there is an answer, and is FALSE on the local profile where the stub returns a marker rather than a session description. The call starts RINGING; CONNECTED only ever arrives via Meta\'s webhook, never in this response. Refused without a live calling permission, and refused outside the tenant\'s business hours. Not billed — a WhatsApp call carries no carrier cost and no wallet reservation is taken. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Place a WhatsApp call
+     */
+    initiate(requestParameters: InitiateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * Every call this tenant has placed or received, newest first, cursor-paginated: pass the previous page\'s `nextCursor` back as `cursor`. There is deliberately no total — counting the whole history on every page is the expensive half of offset paging. `sdpAnswer` is null on every row here; it is a one-shot handshake value with no meaning after the call. Optionally filtered to one customer. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * @summary The call log
+     * @param {string} [cursor]
+     * @param {number} [limit]
+     * @param {string} [contactWaId]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    listWhatsappRaw(requestParameters: ListWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CursorPageWaCallResponse>>;
+    /**
+     * Every call this tenant has placed or received, newest first, cursor-paginated: pass the previous page\'s `nextCursor` back as `cursor`. There is deliberately no total — counting the whole history on every page is the expensive half of offset paging. `sdpAnswer` is null on every row here; it is a one-shot handshake value with no meaning after the call. Optionally filtered to one customer. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * The call log
+     */
+    listWhatsapp(requestParameters: ListWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CursorPageWaCallResponse>;
+    /**
+     * The stored permission for one customer on one sending number. Gate the call button on `callable`, not on `status`: a grant that has just lapsed still reads as GRANTED until something touches the row, and `callable` accounts for the expiry. `refresh=true` additionally reports what Meta itself holds as `providerGranted`, and ADOPTS a grant Meta holds that we do not — which repairs a permission the customer accepted but whose webhook never reached us, and is the reason to reach for it when a call is refused as not-permitted. A denial is only reported, never applied: that direction would withdraw a real consent. A business-side revoke is never overridden. On the local profile the stub always reports false for it. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * @summary Read a customer\'s calling permission
+     * @param {string} contactWaId
+     * @param {string} [phoneNumberId]
+     * @param {string} [wabaAccountId]
+     * @param {boolean} [refresh]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    permissionStatusRaw(requestParameters: PermissionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallPermissionResponse>>;
+    /**
+     * The stored permission for one customer on one sending number. Gate the call button on `callable`, not on `status`: a grant that has just lapsed still reads as GRANTED until something touches the row, and `callable` accounts for the expiry. `refresh=true` additionally reports what Meta itself holds as `providerGranted`, and ADOPTS a grant Meta holds that we do not — which repairs a permission the customer accepted but whose webhook never reached us, and is the reason to reach for it when a call is refused as not-permitted. A denial is only reported, never applied: that direction would withdraw a real consent. A business-side revoke is never overridden. On the local profile the stub always reports false for it. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * Read a customer\'s calling permission
+     */
+    permissionStatus(requestParameters: PermissionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallPermissionResponse>;
+    /**
+     * Declines a customer-initiated call that was never answered — a different verb from terminate, which hangs up one that WAS answered, and a different row in the call log. The call becomes REJECTED with endReason BUSINESS_TERMINATED (not DECLINED, which means the customer declined). Declining an already-finished call returns it as it stands rather than erroring. If Meta refuses the decline the local row still ends. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * @summary Decline an inbound call
+     * @param {string} callId
+     * @param {string} [xIdempotencyKey] Makes this call replayable instead of re-executed on retry (AS-TGT-001). The first 2xx response is cached per (tenant, key) for 24h and replayed verbatim, with &#x60;X-Idempotent-Replay&#x60; set. Reusing a key with a different body is refused with 409 IDEMPOTENCY_KEY_REUSED. The SDKs send one automatically on mutating calls.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    rejectWhatsappRaw(requestParameters: RejectWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Declines a customer-initiated call that was never answered — a different verb from terminate, which hangs up one that WAS answered, and a different row in the call log. The call becomes REJECTED with endReason BUSINESS_TERMINATED (not DECLINED, which means the customer declined). Declining an already-finished call returns it as it stands rather than erroring. If Meta refuses the decline the local row still ends. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Decline an inbound call
+     */
+    rejectWhatsapp(requestParameters: RejectWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * Sends a call-permission prompt into the customer\'s WhatsApp thread. The answer comes back on Meta\'s webhook minutes or days later, so this ALWAYS returns status REQUESTED — do not poll it expecting GRANTED to appear synchronously, and do not enable a call button on the strength of a 200 here. Re-asking is refused while a live request or a live grant already covers the customer, and refused permanently once the customer has revoked: pestering someone who declined is exactly what the permission model exists to stop, and Meta rate-limits it. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * @summary Ask a customer for permission to call them
+     * @param {RequestCallPermissionRequest} requestCallPermissionRequest
+     * @param {string} [xIdempotencyKey] Makes this call replayable instead of re-executed on retry (AS-TGT-001). The first 2xx response is cached per (tenant, key) for 24h and replayed verbatim, with &#x60;X-Idempotent-Replay&#x60; set. Reusing a key with a different body is refused with 409 IDEMPOTENCY_KEY_REUSED. The SDKs send one automatically on mutating calls.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    requestPermissionRaw(requestParameters: RequestPermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallPermissionResponse>>;
+    /**
+     * Sends a call-permission prompt into the customer\'s WhatsApp thread. The answer comes back on Meta\'s webhook minutes or days later, so this ALWAYS returns status REQUESTED — do not poll it expecting GRANTED to appear synchronously, and do not enable a call button on the strength of a 200 here. Re-asking is refused while a live request or a live grant already covers the customer, and refused permanently once the customer has revoked: pestering someone who declined is exactly what the permission model exists to stop, and Meta rate-limits it. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Ask a customer for permission to call them
+     */
+    requestPermission(requestParameters: RequestPermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallPermissionResponse>;
+    /**
+     * The tenant\'s own do-not-call. LOCAL to Augstash: the Meta Calling API exposes no business-side revoke, so this stops Augstash placing calls and makes no claim about what Meta still holds. Distinct from a customer\'s own revoke — the response\'s `revokedSide` says which happened, and only a BUSINESS revoke can be undone by asking again. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * @summary Stop calling a customer (business-side revoke)
+     * @param {string} permissionId
+     * @param {string} [xIdempotencyKey] Makes this call replayable instead of re-executed on retry (AS-TGT-001). The first 2xx response is cached per (tenant, key) for 24h and replayed verbatim, with &#x60;X-Idempotent-Replay&#x60; set. Reusing a key with a different body is refused with 409 IDEMPOTENCY_KEY_REUSED. The SDKs send one automatically on mutating calls.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    revokePermissionRaw(requestParameters: RevokePermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallPermissionResponse>>;
+    /**
+     * The tenant\'s own do-not-call. LOCAL to Augstash: the Meta Calling API exposes no business-side revoke, so this stops Augstash placing calls and makes no claim about what Meta still holds. Distinct from a customer\'s own revoke — the response\'s `revokedSide` says which happened, and only a BUSINESS revoke can be undone by asking again. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Stop calling a customer (business-side revoke)
+     */
+    revokePermission(requestParameters: RevokePermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallPermissionResponse>;
+    /**
+     * Hangs up from the business side. Terminating a call that has already ended is a no-op returning the call as it stands, not an error — the user has already put the handset down. A call that was answered becomes COMPLETED; one that was not becomes MISSED. If Meta refuses the terminate the local row still ends, because leaving the tenant staring at a call they cannot end is the worse failure. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * @summary End a call
+     * @param {string} callId
+     * @param {string} [xIdempotencyKey] Makes this call replayable instead of re-executed on retry (AS-TGT-001). The first 2xx response is cached per (tenant, key) for 24h and replayed verbatim, with &#x60;X-Idempotent-Replay&#x60; set. Reusing a key with a different body is refused with 409 IDEMPOTENCY_KEY_REUSED. The SDKs send one automatically on mutating calls.
+     * @param {TerminateWaCallRequest} [terminateWaCallRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WhatsAppCallApiInterface
+     */
+    terminateRaw(requestParameters: TerminateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Hangs up from the business side. Terminating a call that has already ended is a no-op returning the call as it stands, not an error — the user has already put the handset down. A call that was answered becomes COMPLETED; one that was not becomes MISSED. If Meta refuses the terminate the local row still ends, because leaving the tenant staring at a call they cannot end is the worse failure. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * End a call
+     */
+    terminate(requestParameters: TerminateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+}
+/**
+ *
+ */
+export declare class WhatsAppCallApi extends runtime.BaseAPI implements WhatsAppCallApiInterface {
+    /**
+     * Answers a customer-initiated call with the agent\'s WebRTC SDP. The caller\'s offer arrives as `sdpOffer` on the CALL_INCOMING realtime frame (and on GET /calls/{callId} while the call is still RINGING); feed it to setRemoteDescription(), createAnswer(), and post the result here. Meta is pre-accepted first so audio is already flowing when the answer lands — a failed pre-accept is logged and stepped over, never a reason to drop an answerable call. Only a RINGING inbound call can be answered: a second agent clicking Answer gets WA_CALL_INVALID_STATE, which means the call was taken, not that anything went wrong. Not billed. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Answer an inbound call
+     */
+    acceptRaw(requestParameters: AcceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Answers a customer-initiated call with the agent\'s WebRTC SDP. The caller\'s offer arrives as `sdpOffer` on the CALL_INCOMING realtime frame (and on GET /calls/{callId} while the call is still RINGING); feed it to setRemoteDescription(), createAnswer(), and post the result here. Meta is pre-accepted first so audio is already flowing when the answer lands — a failed pre-accept is logged and stepped over, never a reason to drop an answerable call. Only a RINGING inbound call can be answered: a second agent clicking Answer gets WA_CALL_INVALID_STATE, which means the call was taken, not that anything went wrong. Not billed. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Answer an inbound call
+     */
+    accept(requestParameters: AcceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * The current state of a single call — and the recovery path for a browser that missed a realtime frame, since CONNECTED and the end state both arrive asynchronously from Meta\'s webhook. Carries the SDP the client still needs: the caller\'s `sdpOffer` while an inbound call is RINGING, and the far side\'s `sdpAnswer` while an outbound call is CONNECTED. Both go null once the call is over. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * One call
+     */
+    getWhatsappCallsRaw(requestParameters: GetWhatsappCallsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * The current state of a single call — and the recovery path for a browser that missed a realtime frame, since CONNECTED and the end state both arrive asynchronously from Meta\'s webhook. Carries the SDP the client still needs: the caller\'s `sdpOffer` while an inbound call is RINGING, and the far side\'s `sdpAnswer` while an outbound call is CONNECTED. Both go null once the call is over. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * One call
+     */
+    getWhatsappCalls(requestParameters: GetWhatsappCallsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * Relays the caller\'s WebRTC SDP offer to Meta. The browser owns the peer connection: create the offer with `createOffer()` and send it here. ⚠️ `sdpAnswer` is NOT in this response — Meta replies with a call id only, because the customer has not picked up yet. The answer arrives when they do, on the CALL_UPDATED frame reporting CONNECTED (and on GET /calls/{callId} for a browser that missed it); feed it into `setRemoteDescription()` then. For the same reason `mediaAvailable` is false here on a perfectly healthy call — it only means anything once there is an answer, and is FALSE on the local profile where the stub returns a marker rather than a session description. The call starts RINGING; CONNECTED only ever arrives via Meta\'s webhook, never in this response. Refused without a live calling permission, and refused outside the tenant\'s business hours. Not billed — a WhatsApp call carries no carrier cost and no wallet reservation is taken. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Place a WhatsApp call
+     */
+    initiateRaw(requestParameters: InitiateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Relays the caller\'s WebRTC SDP offer to Meta. The browser owns the peer connection: create the offer with `createOffer()` and send it here. ⚠️ `sdpAnswer` is NOT in this response — Meta replies with a call id only, because the customer has not picked up yet. The answer arrives when they do, on the CALL_UPDATED frame reporting CONNECTED (and on GET /calls/{callId} for a browser that missed it); feed it into `setRemoteDescription()` then. For the same reason `mediaAvailable` is false here on a perfectly healthy call — it only means anything once there is an answer, and is FALSE on the local profile where the stub returns a marker rather than a session description. The call starts RINGING; CONNECTED only ever arrives via Meta\'s webhook, never in this response. Refused without a live calling permission, and refused outside the tenant\'s business hours. Not billed — a WhatsApp call carries no carrier cost and no wallet reservation is taken. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Place a WhatsApp call
+     */
+    initiate(requestParameters: InitiateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * Every call this tenant has placed or received, newest first, cursor-paginated: pass the previous page\'s `nextCursor` back as `cursor`. There is deliberately no total — counting the whole history on every page is the expensive half of offset paging. `sdpAnswer` is null on every row here; it is a one-shot handshake value with no meaning after the call. Optionally filtered to one customer. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * The call log
+     */
+    listWhatsappRaw(requestParameters: ListWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CursorPageWaCallResponse>>;
+    /**
+     * Every call this tenant has placed or received, newest first, cursor-paginated: pass the previous page\'s `nextCursor` back as `cursor`. There is deliberately no total — counting the whole history on every page is the expensive half of offset paging. `sdpAnswer` is null on every row here; it is a one-shot handshake value with no meaning after the call. Optionally filtered to one customer. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * The call log
+     */
+    listWhatsapp(requestParameters?: ListWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CursorPageWaCallResponse>;
+    /**
+     * The stored permission for one customer on one sending number. Gate the call button on `callable`, not on `status`: a grant that has just lapsed still reads as GRANTED until something touches the row, and `callable` accounts for the expiry. `refresh=true` additionally reports what Meta itself holds as `providerGranted`, and ADOPTS a grant Meta holds that we do not — which repairs a permission the customer accepted but whose webhook never reached us, and is the reason to reach for it when a call is refused as not-permitted. A denial is only reported, never applied: that direction would withdraw a real consent. A business-side revoke is never overridden. On the local profile the stub always reports false for it. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * Read a customer\'s calling permission
+     */
+    permissionStatusRaw(requestParameters: PermissionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallPermissionResponse>>;
+    /**
+     * The stored permission for one customer on one sending number. Gate the call button on `callable`, not on `status`: a grant that has just lapsed still reads as GRANTED until something touches the row, and `callable` accounts for the expiry. `refresh=true` additionally reports what Meta itself holds as `providerGranted`, and ADOPTS a grant Meta holds that we do not — which repairs a permission the customer accepted but whose webhook never reached us, and is the reason to reach for it when a call is refused as not-permitted. A denial is only reported, never applied: that direction would withdraw a real consent. A business-side revoke is never overridden. On the local profile the stub always reports false for it. Reads < 300ms. Requires API-key scope: wacalling:read.
+     * Read a customer\'s calling permission
+     */
+    permissionStatus(requestParameters: PermissionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallPermissionResponse>;
+    /**
+     * Declines a customer-initiated call that was never answered — a different verb from terminate, which hangs up one that WAS answered, and a different row in the call log. The call becomes REJECTED with endReason BUSINESS_TERMINATED (not DECLINED, which means the customer declined). Declining an already-finished call returns it as it stands rather than erroring. If Meta refuses the decline the local row still ends. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Decline an inbound call
+     */
+    rejectWhatsappRaw(requestParameters: RejectWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Declines a customer-initiated call that was never answered — a different verb from terminate, which hangs up one that WAS answered, and a different row in the call log. The call becomes REJECTED with endReason BUSINESS_TERMINATED (not DECLINED, which means the customer declined). Declining an already-finished call returns it as it stands rather than erroring. If Meta refuses the decline the local row still ends. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Decline an inbound call
+     */
+    rejectWhatsapp(requestParameters: RejectWhatsappRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+    /**
+     * Sends a call-permission prompt into the customer\'s WhatsApp thread. The answer comes back on Meta\'s webhook minutes or days later, so this ALWAYS returns status REQUESTED — do not poll it expecting GRANTED to appear synchronously, and do not enable a call button on the strength of a 200 here. Re-asking is refused while a live request or a live grant already covers the customer, and refused permanently once the customer has revoked: pestering someone who declined is exactly what the permission model exists to stop, and Meta rate-limits it. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Ask a customer for permission to call them
+     */
+    requestPermissionRaw(requestParameters: RequestPermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallPermissionResponse>>;
+    /**
+     * Sends a call-permission prompt into the customer\'s WhatsApp thread. The answer comes back on Meta\'s webhook minutes or days later, so this ALWAYS returns status REQUESTED — do not poll it expecting GRANTED to appear synchronously, and do not enable a call button on the strength of a 200 here. Re-asking is refused while a live request or a live grant already covers the customer, and refused permanently once the customer has revoked: pestering someone who declined is exactly what the permission model exists to stop, and Meta rate-limits it. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Ask a customer for permission to call them
+     */
+    requestPermission(requestParameters: RequestPermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallPermissionResponse>;
+    /**
+     * The tenant\'s own do-not-call. LOCAL to Augstash: the Meta Calling API exposes no business-side revoke, so this stops Augstash placing calls and makes no claim about what Meta still holds. Distinct from a customer\'s own revoke — the response\'s `revokedSide` says which happened, and only a BUSINESS revoke can be undone by asking again. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Stop calling a customer (business-side revoke)
+     */
+    revokePermissionRaw(requestParameters: RevokePermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallPermissionResponse>>;
+    /**
+     * The tenant\'s own do-not-call. LOCAL to Augstash: the Meta Calling API exposes no business-side revoke, so this stops Augstash placing calls and makes no claim about what Meta still holds. Distinct from a customer\'s own revoke — the response\'s `revokedSide` says which happened, and only a BUSINESS revoke can be undone by asking again. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * Stop calling a customer (business-side revoke)
+     */
+    revokePermission(requestParameters: RevokePermissionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallPermissionResponse>;
+    /**
+     * Hangs up from the business side. Terminating a call that has already ended is a no-op returning the call as it stands, not an error — the user has already put the handset down. A call that was answered becomes COMPLETED; one that was not becomes MISSED. If Meta refuses the terminate the local row still ends, because leaving the tenant staring at a call they cannot end is the worse failure. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * End a call
+     */
+    terminateRaw(requestParameters: TerminateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WaCallResponse>>;
+    /**
+     * Hangs up from the business side. Terminating a call that has already ended is a no-op returning the call as it stands, not an error — the user has already put the handset down. A call that was answered becomes COMPLETED; one that was not becomes MISSED. If Meta refuses the terminate the local row still ends, because leaving the tenant staring at a call they cannot end is the worse failure. Writes < 800ms. Requires API-key scope: wacalling:write.
+     * End a call
+     */
+    terminate(requestParameters: TerminateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WaCallResponse>;
+}