@augstash/sdk 0.2.0

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

@@ -0,0 +1,134 @@
+/**
+ * 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 { ConnectMessengerAccountRequest, MessengerAccountResponse, MessengerSubscriptionResponse } from '../models/index';
+export interface ConnectMessengerRequest {
+    connectMessengerAccountRequest: ConnectMessengerAccountRequest;
+    xIdempotencyKey?: string;
+}
+export interface DisconnectMessengerRequest {
+    id: string;
+    xIdempotencyKey?: string;
+}
+export interface SubscriptionMessengerRequest {
+    id: string;
+}
+/**
+ * MessengerAccountApi - interface
+ *
+ * @export
+ * @interface MessengerAccountApiInterface
+ */
+export interface MessengerAccountApiInterface {
+    /**
+     * Takes AT MOST ONE credential. Supply authCode to exchange a fresh Meta OAuth code — the only way to replace a credential Meta has rejected. Supply sessionId instead after POST /api/v1/messenger/pages, which already spent the code listing the Pages. Supply NEITHER to reuse a Page permission this tenant already granted (typically by connecting the same Page for Instagram Direct), which needs no Facebook login at all; the response\'s credentialSource says which happened. Reconnecting a Page this tenant already holds refreshes its credential rather than failing. Writes < 800ms. Requires API-key scope: messenger:write.
+     * @summary Connect a Facebook Page for Messenger
+     * @param {ConnectMessengerAccountRequest} connectMessengerAccountRequest
+     * @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 MessengerAccountApiInterface
+     */
+    connectMessengerRaw(requestParameters: ConnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerAccountResponse>>;
+    /**
+     * Takes AT MOST ONE credential. Supply authCode to exchange a fresh Meta OAuth code — the only way to replace a credential Meta has rejected. Supply sessionId instead after POST /api/v1/messenger/pages, which already spent the code listing the Pages. Supply NEITHER to reuse a Page permission this tenant already granted (typically by connecting the same Page for Instagram Direct), which needs no Facebook login at all; the response\'s credentialSource says which happened. Reconnecting a Page this tenant already holds refreshes its credential rather than failing. Writes < 800ms. Requires API-key scope: messenger:write.
+     * Connect a Facebook Page for Messenger
+     */
+    connectMessenger(requestParameters: ConnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerAccountResponse>;
+    /**
+     * Drops the stored credential so the Page can no longer send. The Meta webhook subscription is only removed if no other channel still uses that Page — Instagram Direct shares it, and dropping it would silently stop that channel\'s inbound messages. The Page row survives so historical messages keep their link. Writes < 300ms. Requires API-key scope: messenger:write.
+     * @summary Disconnect a Facebook Page
+     * @param {string} id
+     * @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 MessengerAccountApiInterface
+     */
+    disconnectMessengerRaw(requestParameters: DisconnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerAccountResponse>>;
+    /**
+     * Drops the stored credential so the Page can no longer send. The Meta webhook subscription is only removed if no other channel still uses that Page — Instagram Direct shares it, and dropping it would silently stop that channel\'s inbound messages. The Page row survives so historical messages keep their link. Writes < 300ms. Requires API-key scope: messenger:write.
+     * Disconnect a Facebook Page
+     */
+    disconnectMessenger(requestParameters: DisconnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerAccountResponse>;
+    /**
+     * Every Page this tenant has connected for Messenger, newest first, including disconnected ones so their history stays explainable. Reads < 300ms. Requires API-key scope: messenger:read.
+     * @summary List connected Facebook Pages
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MessengerAccountApiInterface
+     */
+    listMessengerRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<MessengerAccountResponse>>>;
+    /**
+     * Every Page this tenant has connected for Messenger, newest first, including disconnected ones so their history stays explainable. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List connected Facebook Pages
+     */
+    listMessenger(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<MessengerAccountResponse>>;
+    /**
+     * Reads GET /{page-id}/subscribed_apps from Meta LIVE on every call and reports whether this app is currently subscribed — the pages_manage_metadata surface, and the only honest source for a \"Receiving messages: on\" indicator. Never cached and never derived from a stored flag: a tenant can remove the app in Business Settings at any time, after which the token, the status and the Page name all still look healthy while no customer message ever arrives. A disconnected Page reports subscribed=false without calling Meta. Reads < 800ms — this one talks to Meta, so it does not meet the 300ms read budget and is not on the list path for that reason. Requires API-key scope: messenger:read.
+     * @summary Is Meta delivering this Page\'s messages to us?
+     * @param {string} id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MessengerAccountApiInterface
+     */
+    subscriptionMessengerRaw(requestParameters: SubscriptionMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerSubscriptionResponse>>;
+    /**
+     * Reads GET /{page-id}/subscribed_apps from Meta LIVE on every call and reports whether this app is currently subscribed — the pages_manage_metadata surface, and the only honest source for a \"Receiving messages: on\" indicator. Never cached and never derived from a stored flag: a tenant can remove the app in Business Settings at any time, after which the token, the status and the Page name all still look healthy while no customer message ever arrives. A disconnected Page reports subscribed=false without calling Meta. Reads < 800ms — this one talks to Meta, so it does not meet the 300ms read budget and is not on the list path for that reason. Requires API-key scope: messenger:read.
+     * Is Meta delivering this Page\'s messages to us?
+     */
+    subscriptionMessenger(requestParameters: SubscriptionMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerSubscriptionResponse>;
+}
+/**
+ *
+ */
+export declare class MessengerAccountApi extends runtime.BaseAPI implements MessengerAccountApiInterface {
+    /**
+     * Takes AT MOST ONE credential. Supply authCode to exchange a fresh Meta OAuth code — the only way to replace a credential Meta has rejected. Supply sessionId instead after POST /api/v1/messenger/pages, which already spent the code listing the Pages. Supply NEITHER to reuse a Page permission this tenant already granted (typically by connecting the same Page for Instagram Direct), which needs no Facebook login at all; the response\'s credentialSource says which happened. Reconnecting a Page this tenant already holds refreshes its credential rather than failing. Writes < 800ms. Requires API-key scope: messenger:write.
+     * Connect a Facebook Page for Messenger
+     */
+    connectMessengerRaw(requestParameters: ConnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerAccountResponse>>;
+    /**
+     * Takes AT MOST ONE credential. Supply authCode to exchange a fresh Meta OAuth code — the only way to replace a credential Meta has rejected. Supply sessionId instead after POST /api/v1/messenger/pages, which already spent the code listing the Pages. Supply NEITHER to reuse a Page permission this tenant already granted (typically by connecting the same Page for Instagram Direct), which needs no Facebook login at all; the response\'s credentialSource says which happened. Reconnecting a Page this tenant already holds refreshes its credential rather than failing. Writes < 800ms. Requires API-key scope: messenger:write.
+     * Connect a Facebook Page for Messenger
+     */
+    connectMessenger(requestParameters: ConnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerAccountResponse>;
+    /**
+     * Drops the stored credential so the Page can no longer send. The Meta webhook subscription is only removed if no other channel still uses that Page — Instagram Direct shares it, and dropping it would silently stop that channel\'s inbound messages. The Page row survives so historical messages keep their link. Writes < 300ms. Requires API-key scope: messenger:write.
+     * Disconnect a Facebook Page
+     */
+    disconnectMessengerRaw(requestParameters: DisconnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerAccountResponse>>;
+    /**
+     * Drops the stored credential so the Page can no longer send. The Meta webhook subscription is only removed if no other channel still uses that Page — Instagram Direct shares it, and dropping it would silently stop that channel\'s inbound messages. The Page row survives so historical messages keep their link. Writes < 300ms. Requires API-key scope: messenger:write.
+     * Disconnect a Facebook Page
+     */
+    disconnectMessenger(requestParameters: DisconnectMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerAccountResponse>;
+    /**
+     * Every Page this tenant has connected for Messenger, newest first, including disconnected ones so their history stays explainable. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List connected Facebook Pages
+     */
+    listMessengerRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<MessengerAccountResponse>>>;
+    /**
+     * Every Page this tenant has connected for Messenger, newest first, including disconnected ones so their history stays explainable. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List connected Facebook Pages
+     */
+    listMessenger(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<MessengerAccountResponse>>;
+    /**
+     * Reads GET /{page-id}/subscribed_apps from Meta LIVE on every call and reports whether this app is currently subscribed — the pages_manage_metadata surface, and the only honest source for a \"Receiving messages: on\" indicator. Never cached and never derived from a stored flag: a tenant can remove the app in Business Settings at any time, after which the token, the status and the Page name all still look healthy while no customer message ever arrives. A disconnected Page reports subscribed=false without calling Meta. Reads < 800ms — this one talks to Meta, so it does not meet the 300ms read budget and is not on the list path for that reason. Requires API-key scope: messenger:read.
+     * Is Meta delivering this Page\'s messages to us?
+     */
+    subscriptionMessengerRaw(requestParameters: SubscriptionMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerSubscriptionResponse>>;
+    /**
+     * Reads GET /{page-id}/subscribed_apps from Meta LIVE on every call and reports whether this app is currently subscribed — the pages_manage_metadata surface, and the only honest source for a \"Receiving messages: on\" indicator. Never cached and never derived from a stored flag: a tenant can remove the app in Business Settings at any time, after which the token, the status and the Page name all still look healthy while no customer message ever arrives. A disconnected Page reports subscribed=false without calling Meta. Reads < 800ms — this one talks to Meta, so it does not meet the 300ms read budget and is not on the list path for that reason. Requires API-key scope: messenger:read.
+     * Is Meta delivering this Page\'s messages to us?
+     */
+    subscriptionMessenger(requestParameters: SubscriptionMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerSubscriptionResponse>;
+}

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

@@ -0,0 +1,212 @@
+"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.MessengerAccountApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class MessengerAccountApi extends runtime.BaseAPI {
+    /**
+     * Takes AT MOST ONE credential. Supply authCode to exchange a fresh Meta OAuth code — the only way to replace a credential Meta has rejected. Supply sessionId instead after POST /api/v1/messenger/pages, which already spent the code listing the Pages. Supply NEITHER to reuse a Page permission this tenant already granted (typically by connecting the same Page for Instagram Direct), which needs no Facebook login at all; the response\'s credentialSource says which happened. Reconnecting a Page this tenant already holds refreshes its credential rather than failing. Writes < 800ms. Requires API-key scope: messenger:write.
+     * Connect a Facebook Page for Messenger
+     */
+    async connectMessengerRaw(requestParameters, initOverrides) {
+        if (requestParameters['connectMessengerAccountRequest'] == null) {
+            throw new runtime.RequiredError('connectMessengerAccountRequest', 'Required parameter "connectMessengerAccountRequest" was null or undefined when calling connectMessenger().');
+        }
+        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/messenger/accounts/connect`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.ConnectMessengerAccountRequestToJSON)(requestParameters['connectMessengerAccountRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.MessengerAccountResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Takes AT MOST ONE credential. Supply authCode to exchange a fresh Meta OAuth code — the only way to replace a credential Meta has rejected. Supply sessionId instead after POST /api/v1/messenger/pages, which already spent the code listing the Pages. Supply NEITHER to reuse a Page permission this tenant already granted (typically by connecting the same Page for Instagram Direct), which needs no Facebook login at all; the response\'s credentialSource says which happened. Reconnecting a Page this tenant already holds refreshes its credential rather than failing. Writes < 800ms. Requires API-key scope: messenger:write.
+     * Connect a Facebook Page for Messenger
+     */
+    async connectMessenger(requestParameters, initOverrides) {
+        const response = await this.connectMessengerRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Drops the stored credential so the Page can no longer send. The Meta webhook subscription is only removed if no other channel still uses that Page — Instagram Direct shares it, and dropping it would silently stop that channel\'s inbound messages. The Page row survives so historical messages keep their link. Writes < 300ms. Requires API-key scope: messenger:write.
+     * Disconnect a Facebook Page
+     */
+    async disconnectMessengerRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling disconnectMessenger().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        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/messenger/accounts/{id}`;
+        urlPath = urlPath.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.MessengerAccountResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Drops the stored credential so the Page can no longer send. The Meta webhook subscription is only removed if no other channel still uses that Page — Instagram Direct shares it, and dropping it would silently stop that channel\'s inbound messages. The Page row survives so historical messages keep their link. Writes < 300ms. Requires API-key scope: messenger:write.
+     * Disconnect a Facebook Page
+     */
+    async disconnectMessenger(requestParameters, initOverrides) {
+        const response = await this.disconnectMessengerRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Every Page this tenant has connected for Messenger, newest first, including disconnected ones so their history stays explainable. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List connected Facebook Pages
+     */
+    async listMessengerRaw(initOverrides) {
+        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/messenger/accounts`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.MessengerAccountResponseFromJSON));
+    }
+    /**
+     * Every Page this tenant has connected for Messenger, newest first, including disconnected ones so their history stays explainable. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List connected Facebook Pages
+     */
+    async listMessenger(initOverrides) {
+        const response = await this.listMessengerRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * Reads GET /{page-id}/subscribed_apps from Meta LIVE on every call and reports whether this app is currently subscribed — the pages_manage_metadata surface, and the only honest source for a \"Receiving messages: on\" indicator. Never cached and never derived from a stored flag: a tenant can remove the app in Business Settings at any time, after which the token, the status and the Page name all still look healthy while no customer message ever arrives. A disconnected Page reports subscribed=false without calling Meta. Reads < 800ms — this one talks to Meta, so it does not meet the 300ms read budget and is not on the list path for that reason. Requires API-key scope: messenger:read.
+     * Is Meta delivering this Page\'s messages to us?
+     */
+    async subscriptionMessengerRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling subscriptionMessenger().');
+        }
+        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/messenger/accounts/{id}/subscription`;
+        urlPath = urlPath.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.MessengerSubscriptionResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Reads GET /{page-id}/subscribed_apps from Meta LIVE on every call and reports whether this app is currently subscribed — the pages_manage_metadata surface, and the only honest source for a \"Receiving messages: on\" indicator. Never cached and never derived from a stored flag: a tenant can remove the app in Business Settings at any time, after which the token, the status and the Page name all still look healthy while no customer message ever arrives. A disconnected Page reports subscribed=false without calling Meta. Reads < 800ms — this one talks to Meta, so it does not meet the 300ms read budget and is not on the list path for that reason. Requires API-key scope: messenger:read.
+     * Is Meta delivering this Page\'s messages to us?
+     */
+    async subscriptionMessenger(requestParameters, initOverrides) {
+        const response = await this.subscriptionMessengerRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.MessengerAccountApi = MessengerAccountApi;

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

@@ -0,0 +1,86 @@
+/**
+ * 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 { CursorPageMessengerMessageResponse, MessengerMessageResponse, SendMessengerMessageRequest } from '../models/index';
+export interface ListMessengerMessagesRequest {
+    accountId?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface SendMessengerRequest {
+    sendMessengerMessageRequest: SendMessengerMessageRequest;
+    xIdempotencyKey?: string;
+}
+/**
+ * MessengerMessageApi - interface
+ *
+ * @export
+ * @interface MessengerMessageApiInterface
+ */
+export interface MessengerMessageApiInterface {
+    /**
+     * Cursor-paginated send/receive log, newest first. Pass the previous response\'s nextCursor as ?cursor= to page; there is no page number and no total. Each row carries conversationId — the unified inbox thread it belongs to, and the id to pass to PUT /api/v1/omnichannel/conversations/{id}/assignment to assign the conversation to an agent. It is null only until the unified projection catches up (written after this module\'s own commit); render that as not-yet-assignable, not as an error. Reads < 300ms. Requires API-key scope: messenger:read.
+     * @summary List Messenger messages
+     * @param {string} [accountId]
+     * @param {string} [cursor]
+     * @param {number} [limit]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MessengerMessageApiInterface
+     */
+    listMessengerMessagesRaw(requestParameters: ListMessengerMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CursorPageMessengerMessageResponse>>;
+    /**
+     * Cursor-paginated send/receive log, newest first. Pass the previous response\'s nextCursor as ?cursor= to page; there is no page number and no total. Each row carries conversationId — the unified inbox thread it belongs to, and the id to pass to PUT /api/v1/omnichannel/conversations/{id}/assignment to assign the conversation to an agent. It is null only until the unified projection catches up (written after this module\'s own commit); render that as not-yet-assignable, not as an error. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List Messenger messages
+     */
+    listMessengerMessages(requestParameters: ListMessengerMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CursorPageMessengerMessageResponse>;
+    /**
+     * Three modes, exactly one per request. Inside the 24-hour reply window, supply text, OR attachmentType + attachmentUrl for a media reply (image/video/audio/file; Meta fetches the URL server-side, so it must be publicly reachable over HTTPS). Outside the window, supply templateName (+ templateLanguage, templateParameters) naming an APPROVED utility template — the only out-of-window route since Meta retired message tags on 27 Apr 2026, and note media has NO out-of-window route at all. Utility templates are ONLY for genuine transactional updates the customer expects; Meta revokes messaging permission app-wide for misuse. The deprecated messageTag field is always rejected with 410. An X-Idempotency-Key replays a prior send. Sends < 800ms. Requires API-key scope: messenger:write.
+     * @summary Send one Messenger message
+     * @param {SendMessengerMessageRequest} sendMessengerMessageRequest
+     * @param {string} [xIdempotencyKey]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MessengerMessageApiInterface
+     */
+    sendMessengerRaw(requestParameters: SendMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerMessageResponse>>;
+    /**
+     * Three modes, exactly one per request. Inside the 24-hour reply window, supply text, OR attachmentType + attachmentUrl for a media reply (image/video/audio/file; Meta fetches the URL server-side, so it must be publicly reachable over HTTPS). Outside the window, supply templateName (+ templateLanguage, templateParameters) naming an APPROVED utility template — the only out-of-window route since Meta retired message tags on 27 Apr 2026, and note media has NO out-of-window route at all. Utility templates are ONLY for genuine transactional updates the customer expects; Meta revokes messaging permission app-wide for misuse. The deprecated messageTag field is always rejected with 410. An X-Idempotency-Key replays a prior send. Sends < 800ms. Requires API-key scope: messenger:write.
+     * Send one Messenger message
+     */
+    sendMessenger(requestParameters: SendMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerMessageResponse>;
+}
+/**
+ *
+ */
+export declare class MessengerMessageApi extends runtime.BaseAPI implements MessengerMessageApiInterface {
+    /**
+     * Cursor-paginated send/receive log, newest first. Pass the previous response\'s nextCursor as ?cursor= to page; there is no page number and no total. Each row carries conversationId — the unified inbox thread it belongs to, and the id to pass to PUT /api/v1/omnichannel/conversations/{id}/assignment to assign the conversation to an agent. It is null only until the unified projection catches up (written after this module\'s own commit); render that as not-yet-assignable, not as an error. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List Messenger messages
+     */
+    listMessengerMessagesRaw(requestParameters: ListMessengerMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CursorPageMessengerMessageResponse>>;
+    /**
+     * Cursor-paginated send/receive log, newest first. Pass the previous response\'s nextCursor as ?cursor= to page; there is no page number and no total. Each row carries conversationId — the unified inbox thread it belongs to, and the id to pass to PUT /api/v1/omnichannel/conversations/{id}/assignment to assign the conversation to an agent. It is null only until the unified projection catches up (written after this module\'s own commit); render that as not-yet-assignable, not as an error. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List Messenger messages
+     */
+    listMessengerMessages(requestParameters?: ListMessengerMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CursorPageMessengerMessageResponse>;
+    /**
+     * Three modes, exactly one per request. Inside the 24-hour reply window, supply text, OR attachmentType + attachmentUrl for a media reply (image/video/audio/file; Meta fetches the URL server-side, so it must be publicly reachable over HTTPS). Outside the window, supply templateName (+ templateLanguage, templateParameters) naming an APPROVED utility template — the only out-of-window route since Meta retired message tags on 27 Apr 2026, and note media has NO out-of-window route at all. Utility templates are ONLY for genuine transactional updates the customer expects; Meta revokes messaging permission app-wide for misuse. The deprecated messageTag field is always rejected with 410. An X-Idempotency-Key replays a prior send. Sends < 800ms. Requires API-key scope: messenger:write.
+     * Send one Messenger message
+     */
+    sendMessengerRaw(requestParameters: SendMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessengerMessageResponse>>;
+    /**
+     * Three modes, exactly one per request. Inside the 24-hour reply window, supply text, OR attachmentType + attachmentUrl for a media reply (image/video/audio/file; Meta fetches the URL server-side, so it must be publicly reachable over HTTPS). Outside the window, supply templateName (+ templateLanguage, templateParameters) naming an APPROVED utility template — the only out-of-window route since Meta retired message tags on 27 Apr 2026, and note media has NO out-of-window route at all. Utility templates are ONLY for genuine transactional updates the customer expects; Meta revokes messaging permission app-wide for misuse. The deprecated messageTag field is always rejected with 410. An X-Idempotency-Key replays a prior send. Sends < 800ms. Requires API-key scope: messenger:write.
+     * Send one Messenger message
+     */
+    sendMessenger(requestParameters: SendMessengerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessengerMessageResponse>;
+}

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

@@ -0,0 +1,142 @@
+"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.MessengerMessageApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class MessengerMessageApi extends runtime.BaseAPI {
+    /**
+     * Cursor-paginated send/receive log, newest first. Pass the previous response\'s nextCursor as ?cursor= to page; there is no page number and no total. Each row carries conversationId — the unified inbox thread it belongs to, and the id to pass to PUT /api/v1/omnichannel/conversations/{id}/assignment to assign the conversation to an agent. It is null only until the unified projection catches up (written after this module\'s own commit); render that as not-yet-assignable, not as an error. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List Messenger messages
+     */
+    async listMessengerMessagesRaw(requestParameters, initOverrides) {
+        const queryParameters = {};
+        if (requestParameters['accountId'] != null) {
+            queryParameters['accountId'] = requestParameters['accountId'];
+        }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        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/messenger/messages`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.CursorPageMessengerMessageResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Cursor-paginated send/receive log, newest first. Pass the previous response\'s nextCursor as ?cursor= to page; there is no page number and no total. Each row carries conversationId — the unified inbox thread it belongs to, and the id to pass to PUT /api/v1/omnichannel/conversations/{id}/assignment to assign the conversation to an agent. It is null only until the unified projection catches up (written after this module\'s own commit); render that as not-yet-assignable, not as an error. Reads < 300ms. Requires API-key scope: messenger:read.
+     * List Messenger messages
+     */
+    async listMessengerMessages(requestParameters = {}, initOverrides) {
+        const response = await this.listMessengerMessagesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Three modes, exactly one per request. Inside the 24-hour reply window, supply text, OR attachmentType + attachmentUrl for a media reply (image/video/audio/file; Meta fetches the URL server-side, so it must be publicly reachable over HTTPS). Outside the window, supply templateName (+ templateLanguage, templateParameters) naming an APPROVED utility template — the only out-of-window route since Meta retired message tags on 27 Apr 2026, and note media has NO out-of-window route at all. Utility templates are ONLY for genuine transactional updates the customer expects; Meta revokes messaging permission app-wide for misuse. The deprecated messageTag field is always rejected with 410. An X-Idempotency-Key replays a prior send. Sends < 800ms. Requires API-key scope: messenger:write.
+     * Send one Messenger message
+     */
+    async sendMessengerRaw(requestParameters, initOverrides) {
+        if (requestParameters['sendMessengerMessageRequest'] == null) {
+            throw new runtime.RequiredError('sendMessengerMessageRequest', 'Required parameter "sendMessengerMessageRequest" was null or undefined when calling sendMessenger().');
+        }
+        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/messenger/messages`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.SendMessengerMessageRequestToJSON)(requestParameters['sendMessengerMessageRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.MessengerMessageResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Three modes, exactly one per request. Inside the 24-hour reply window, supply text, OR attachmentType + attachmentUrl for a media reply (image/video/audio/file; Meta fetches the URL server-side, so it must be publicly reachable over HTTPS). Outside the window, supply templateName (+ templateLanguage, templateParameters) naming an APPROVED utility template — the only out-of-window route since Meta retired message tags on 27 Apr 2026, and note media has NO out-of-window route at all. Utility templates are ONLY for genuine transactional updates the customer expects; Meta revokes messaging permission app-wide for misuse. The deprecated messageTag field is always rejected with 410. An X-Idempotency-Key replays a prior send. Sends < 800ms. Requires API-key scope: messenger:write.
+     * Send one Messenger message
+     */
+    async sendMessenger(requestParameters, initOverrides) {
+        const response = await this.sendMessengerRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.MessengerMessageApi = MessengerMessageApi;