@augstash/sdk 0.2.0 → 0.3.0

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

@@ -0,0 +1,259 @@
+"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.StoreApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class StoreApi extends runtime.BaseAPI {
+    /**
+     * Verifies the credentials against the store before saving, so a wrong token fails here rather than silently at the first sync. The credential keys each vendor wants are published as credentialFields on GET /api/v1/catalog/stores. For a cart with an inbound webhook (WooCommerce today) the webhook URL and secret are returned ONCE and are never rotated by a re-save — webhookMinted says whether this call created them. Writes < 2s (one live call to the merchant\'s own store). Requires API-key scope: catalog:write.
+     * Connect or update one of the tenant\'s e-commerce stores
+     */
+    async connectCatalogStoresRaw(requestParameters, initOverrides) {
+        if (requestParameters['vendor'] == null) {
+            throw new runtime.RequiredError('vendor', 'Required parameter "vendor" was null or undefined when calling connectCatalogStores().');
+        }
+        if (requestParameters['connectStoreRequest'] == null) {
+            throw new runtime.RequiredError('connectStoreRequest', 'Required parameter "connectStoreRequest" was null or undefined when calling connectCatalogStores().');
+        }
+        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/catalog/stores/{vendor}/connect`;
+        urlPath = urlPath.replace(`{${"vendor"}}`, encodeURIComponent(String(requestParameters['vendor'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.ConnectStoreRequestToJSON)(requestParameters['connectStoreRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.StoreConnectionResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Verifies the credentials against the store before saving, so a wrong token fails here rather than silently at the first sync. The credential keys each vendor wants are published as credentialFields on GET /api/v1/catalog/stores. For a cart with an inbound webhook (WooCommerce today) the webhook URL and secret are returned ONCE and are never rotated by a re-save — webhookMinted says whether this call created them. Writes < 2s (one live call to the merchant\'s own store). Requires API-key scope: catalog:write.
+     * Connect or update one of the tenant\'s e-commerce stores
+     */
+    async connectCatalogStores(requestParameters, initOverrides) {
+        const response = await this.connectCatalogStoresRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Idempotent. Products and orders already imported are kept — they are the merchant\'s history, not the connector\'s. The stored credentials are forgotten. Writes < 500ms. Requires API-key scope: catalog:write.
+     * Disconnect one of the tenant\'s e-commerce stores
+     */
+    async disconnectCatalogStoresRaw(requestParameters, initOverrides) {
+        if (requestParameters['vendor'] == null) {
+            throw new runtime.RequiredError('vendor', 'Required parameter "vendor" was null or undefined when calling disconnectCatalogStores().');
+        }
+        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/catalog/stores/{vendor}`;
+        urlPath = urlPath.replace(`{${"vendor"}}`, encodeURIComponent(String(requestParameters['vendor'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * Idempotent. Products and orders already imported are kept — they are the merchant\'s history, not the connector\'s. The stored credentials are forgotten. Writes < 500ms. Requires API-key scope: catalog:write.
+     * Disconnect one of the tenant\'s e-commerce stores
+     */
+    async disconnectCatalogStores(requestParameters, initOverrides) {
+        await this.disconnectCatalogStoresRaw(requestParameters, initOverrides);
+    }
+    /**
+     * Never returns credentials; webhookUrl/webhookSecret are null here and are returned only once, from POST /connect. Reads < 300ms. Requires API-key scope: catalog:read.
+     * Get the tenant\'s connection to one store
+     */
+    async getCatalogStoresRaw(requestParameters, initOverrides) {
+        if (requestParameters['vendor'] == null) {
+            throw new runtime.RequiredError('vendor', 'Required parameter "vendor" was null or undefined when calling getCatalogStores().');
+        }
+        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/catalog/stores/{vendor}`;
+        urlPath = urlPath.replace(`{${"vendor"}}`, encodeURIComponent(String(requestParameters['vendor'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.StoreConnectionResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Never returns credentials; webhookUrl/webhookSecret are null here and are returned only once, from POST /connect. Reads < 300ms. Requires API-key scope: catalog:read.
+     * Get the tenant\'s connection to one store
+     */
+    async getCatalogStores(requestParameters, initOverrides) {
+        const response = await this.getCatalogStoresRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Serves all five carts whatever the tenant has connected — a cart missing from this list is one the FE cannot render a connect prompt for. credentialFields comes from the vendor\'s own adapter, so a connect form built from it cannot drift out of step with what the backend validates. Never returns a credential. Reads < 300ms. Requires API-key scope: catalog:read.
+     * List every e-commerce store Augstash can connect
+     */
+    async listCatalogStoresRaw(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/catalog/stores`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.StoreVendorResponseFromJSON));
+    }
+    /**
+     * Serves all five carts whatever the tenant has connected — a cart missing from this list is one the FE cannot render a connect prompt for. credentialFields comes from the vendor\'s own adapter, so a connect form built from it cannot drift out of step with what the backend validates. Never returns a credential. Reads < 300ms. Requires API-key scope: catalog:read.
+     * List every e-commerce store Augstash can connect
+     */
+    async listCatalogStores(initOverrides) {
+        const response = await this.listCatalogStoresRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * For BigCommerce, Magento and Ecwid this is the merchant\'s manual version of the sweep that already runs every 15 minutes; for WooCommerce it is the backfill for anything its webhook missed. Product import needs a connected product catalog (422 CATALOG_NOT_CONNECTED otherwise) and can be skipped with importProducts=false. Not paginated: it walks the store\'s pages itself, capped at 50. Writes < 5s (bounded by the merchant\'s own store, not by us). Requires API-key scope: catalog:write.
+     * Sync products and recent orders from one connected store
+     */
+    async syncCatalogStoresRaw(requestParameters, initOverrides) {
+        if (requestParameters['vendor'] == null) {
+            throw new runtime.RequiredError('vendor', 'Required parameter "vendor" was null or undefined when calling syncCatalogStores().');
+        }
+        const queryParameters = {};
+        if (requestParameters['importProducts'] != null) {
+            queryParameters['importProducts'] = requestParameters['importProducts'];
+        }
+        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/catalog/stores/{vendor}/sync`;
+        urlPath = urlPath.replace(`{${"vendor"}}`, encodeURIComponent(String(requestParameters['vendor'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.StoreSyncResponseFromJSON)(jsonValue));
+    }
+    /**
+     * For BigCommerce, Magento and Ecwid this is the merchant\'s manual version of the sweep that already runs every 15 minutes; for WooCommerce it is the backfill for anything its webhook missed. Product import needs a connected product catalog (422 CATALOG_NOT_CONNECTED otherwise) and can be skipped with importProducts=false. Not paginated: it walks the store\'s pages itself, capped at 50. Writes < 5s (bounded by the merchant\'s own store, not by us). Requires API-key scope: catalog:write.
+     * Sync products and recent orders from one connected store
+     */
+    async syncCatalogStores(requestParameters, initOverrides) {
+        const response = await this.syncCatalogStoresRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.StoreApi = StoreApi;

package/dist/generated/src/apis/TallyApi.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 { ConnectTallyRequest, PageResponseTallyVoucherResponse, Pageable, TallyPushRequest, TallyPushResponse, TallyStatusResponse } from '../models/index';
+export interface ConnectIntegrationsRequest {
+    connectTallyRequest: ConnectTallyRequest;
+    xIdempotencyKey?: string;
+}
+export interface PushRequest {
+    tallyPushRequest: TallyPushRequest;
+    xIdempotencyKey?: string;
+}
+export interface VouchersRequest {
+    pageable: Pageable;
+}
+/**
+ * TallyApi - interface
+ *
+ * @export
+ * @interface TallyApiInterface
+ */
+export interface TallyApiInterface {
+    /**
+     * Names the company the bridge will push; no credential is stored because there is none — the bridge authenticates with an ask_live_* key carrying integrations:write. A push naming a different company is refused. Reconnecting re-points the one connection. Writes < 300ms. Requires API-key scope: integrations:write.
+     * @summary Connect a Tally company
+     * @param {ConnectTallyRequest} connectTallyRequest
+     * @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 TallyApiInterface
+     */
+    connectIntegrationsRaw(requestParameters: ConnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TallyStatusResponse>>;
+    /**
+     * Names the company the bridge will push; no credential is stored because there is none — the bridge authenticates with an ask_live_* key carrying integrations:write. A push naming a different company is refused. Reconnecting re-points the one connection. Writes < 300ms. Requires API-key scope: integrations:write.
+     * Connect a Tally company
+     */
+    connectIntegrations(requestParameters: ConnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TallyStatusResponse>;
+    /**
+     * The bridge\'s endpoint. Idempotent: vouchers are keyed on Tally\'s GUID and parties on ledger name, so the bridge may re-push its whole recent day book every run and a re-push refreshes balances rather than duplicating. Parties join the directory by phone then email (tagged tally, NO consent recorded). A SALES voucher announces invoice.issued, then invoice.paid when its balance reaches zero and invoice.overdue past its due date with money owed; a RECEIPT announces payment.received — each once, to automations waiting on ACCOUNTING_EVENT. Vouchers older than the announce-backfill window are stored but announced as nothing. At most max-batch-size records per push. Writes < 2s. Requires API-key scope: integrations:write.
+     * @summary Receive one push from the Tally bridge
+     * @param {TallyPushRequest} tallyPushRequest
+     * @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 TallyApiInterface
+     */
+    pushRaw(requestParameters: PushRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TallyPushResponse>>;
+    /**
+     * The bridge\'s endpoint. Idempotent: vouchers are keyed on Tally\'s GUID and parties on ledger name, so the bridge may re-push its whole recent day book every run and a re-push refreshes balances rather than duplicating. Parties join the directory by phone then email (tagged tally, NO consent recorded). A SALES voucher announces invoice.issued, then invoice.paid when its balance reaches zero and invoice.overdue past its due date with money owed; a RECEIPT announces payment.received — each once, to automations waiting on ACCOUNTING_EVENT. Vouchers older than the announce-backfill window are stored but announced as nothing. At most max-batch-size records per push. Writes < 2s. Requires API-key scope: integrations:write.
+     * Receive one push from the Tally bridge
+     */
+    push(requestParameters: PushRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TallyPushResponse>;
+    /**
+     * Health comes from the shared connection substrate: DEGRADED with lastErrorCode=ACCOUNTING_BRIDGE_STALE means the bridge has not pushed inside the window (a Tally desktop switched off over a weekend is the ordinary cause). lastPushAt and the last* counters describe the most recent push. Reads < 300ms. Requires API-key scope: integrations:read.
+     * @summary Whether this tenant has connected TallyPrime, and when the bridge last pushed
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TallyApiInterface
+     */
+    statusIntegrationsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TallyStatusResponse>>;
+    /**
+     * Health comes from the shared connection substrate: DEGRADED with lastErrorCode=ACCOUNTING_BRIDGE_STALE means the bridge has not pushed inside the window (a Tally desktop switched off over a weekend is the ordinary cause). lastPushAt and the last* counters describe the most recent push. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected TallyPrime, and when the bridge last pushed
+     */
+    statusIntegrations(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TallyStatusResponse>;
+    /**
+     * A read model of what Tally sent. The four *AnnouncedAt fields say which accounting moments each voucher has produced; a voucher with contactId null resolved to nobody — its party ledger carries no phone and no email. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * @summary The vouchers the bridge has pushed, newest first
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TallyApiInterface
+     */
+    vouchersRaw(requestParameters: VouchersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PageResponseTallyVoucherResponse>>;
+    /**
+     * A read model of what Tally sent. The four *AnnouncedAt fields say which accounting moments each voucher has produced; a voucher with contactId null resolved to nobody — its party ledger carries no phone and no email. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The vouchers the bridge has pushed, newest first
+     */
+    vouchers(requestParameters: VouchersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PageResponseTallyVoucherResponse>;
+}
+/**
+ *
+ */
+export declare class TallyApi extends runtime.BaseAPI implements TallyApiInterface {
+    /**
+     * Names the company the bridge will push; no credential is stored because there is none — the bridge authenticates with an ask_live_* key carrying integrations:write. A push naming a different company is refused. Reconnecting re-points the one connection. Writes < 300ms. Requires API-key scope: integrations:write.
+     * Connect a Tally company
+     */
+    connectIntegrationsRaw(requestParameters: ConnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TallyStatusResponse>>;
+    /**
+     * Names the company the bridge will push; no credential is stored because there is none — the bridge authenticates with an ask_live_* key carrying integrations:write. A push naming a different company is refused. Reconnecting re-points the one connection. Writes < 300ms. Requires API-key scope: integrations:write.
+     * Connect a Tally company
+     */
+    connectIntegrations(requestParameters: ConnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TallyStatusResponse>;
+    /**
+     * The bridge\'s endpoint. Idempotent: vouchers are keyed on Tally\'s GUID and parties on ledger name, so the bridge may re-push its whole recent day book every run and a re-push refreshes balances rather than duplicating. Parties join the directory by phone then email (tagged tally, NO consent recorded). A SALES voucher announces invoice.issued, then invoice.paid when its balance reaches zero and invoice.overdue past its due date with money owed; a RECEIPT announces payment.received — each once, to automations waiting on ACCOUNTING_EVENT. Vouchers older than the announce-backfill window are stored but announced as nothing. At most max-batch-size records per push. Writes < 2s. Requires API-key scope: integrations:write.
+     * Receive one push from the Tally bridge
+     */
+    pushRaw(requestParameters: PushRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TallyPushResponse>>;
+    /**
+     * The bridge\'s endpoint. Idempotent: vouchers are keyed on Tally\'s GUID and parties on ledger name, so the bridge may re-push its whole recent day book every run and a re-push refreshes balances rather than duplicating. Parties join the directory by phone then email (tagged tally, NO consent recorded). A SALES voucher announces invoice.issued, then invoice.paid when its balance reaches zero and invoice.overdue past its due date with money owed; a RECEIPT announces payment.received — each once, to automations waiting on ACCOUNTING_EVENT. Vouchers older than the announce-backfill window are stored but announced as nothing. At most max-batch-size records per push. Writes < 2s. Requires API-key scope: integrations:write.
+     * Receive one push from the Tally bridge
+     */
+    push(requestParameters: PushRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TallyPushResponse>;
+    /**
+     * Health comes from the shared connection substrate: DEGRADED with lastErrorCode=ACCOUNTING_BRIDGE_STALE means the bridge has not pushed inside the window (a Tally desktop switched off over a weekend is the ordinary cause). lastPushAt and the last* counters describe the most recent push. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected TallyPrime, and when the bridge last pushed
+     */
+    statusIntegrationsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TallyStatusResponse>>;
+    /**
+     * Health comes from the shared connection substrate: DEGRADED with lastErrorCode=ACCOUNTING_BRIDGE_STALE means the bridge has not pushed inside the window (a Tally desktop switched off over a weekend is the ordinary cause). lastPushAt and the last* counters describe the most recent push. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected TallyPrime, and when the bridge last pushed
+     */
+    statusIntegrations(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TallyStatusResponse>;
+    /**
+     * A read model of what Tally sent. The four *AnnouncedAt fields say which accounting moments each voucher has produced; a voucher with contactId null resolved to nobody — its party ledger carries no phone and no email. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The vouchers the bridge has pushed, newest first
+     */
+    vouchersRaw(requestParameters: VouchersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PageResponseTallyVoucherResponse>>;
+    /**
+     * A read model of what Tally sent. The four *AnnouncedAt fields say which accounting moments each voucher has produced; a voucher with contactId null resolved to nobody — its party ledger carries no phone and no email. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The vouchers the bridge has pushed, newest first
+     */
+    vouchers(requestParameters: VouchersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PageResponseTallyVoucherResponse>;
+}

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

@@ -0,0 +1,215 @@
+"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.TallyApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class TallyApi extends runtime.BaseAPI {
+    /**
+     * Names the company the bridge will push; no credential is stored because there is none — the bridge authenticates with an ask_live_* key carrying integrations:write. A push naming a different company is refused. Reconnecting re-points the one connection. Writes < 300ms. Requires API-key scope: integrations:write.
+     * Connect a Tally company
+     */
+    async connectIntegrationsRaw(requestParameters, initOverrides) {
+        if (requestParameters['connectTallyRequest'] == null) {
+            throw new runtime.RequiredError('connectTallyRequest', 'Required parameter "connectTallyRequest" was null or undefined when calling connectIntegrations().');
+        }
+        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/integrations/tally`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.ConnectTallyRequestToJSON)(requestParameters['connectTallyRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.TallyStatusResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Names the company the bridge will push; no credential is stored because there is none — the bridge authenticates with an ask_live_* key carrying integrations:write. A push naming a different company is refused. Reconnecting re-points the one connection. Writes < 300ms. Requires API-key scope: integrations:write.
+     * Connect a Tally company
+     */
+    async connectIntegrations(requestParameters, initOverrides) {
+        const response = await this.connectIntegrationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * The bridge\'s endpoint. Idempotent: vouchers are keyed on Tally\'s GUID and parties on ledger name, so the bridge may re-push its whole recent day book every run and a re-push refreshes balances rather than duplicating. Parties join the directory by phone then email (tagged tally, NO consent recorded). A SALES voucher announces invoice.issued, then invoice.paid when its balance reaches zero and invoice.overdue past its due date with money owed; a RECEIPT announces payment.received — each once, to automations waiting on ACCOUNTING_EVENT. Vouchers older than the announce-backfill window are stored but announced as nothing. At most max-batch-size records per push. Writes < 2s. Requires API-key scope: integrations:write.
+     * Receive one push from the Tally bridge
+     */
+    async pushRaw(requestParameters, initOverrides) {
+        if (requestParameters['tallyPushRequest'] == null) {
+            throw new runtime.RequiredError('tallyPushRequest', 'Required parameter "tallyPushRequest" was null or undefined when calling push().');
+        }
+        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/integrations/tally/pushes`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.TallyPushRequestToJSON)(requestParameters['tallyPushRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.TallyPushResponseFromJSON)(jsonValue));
+    }
+    /**
+     * The bridge\'s endpoint. Idempotent: vouchers are keyed on Tally\'s GUID and parties on ledger name, so the bridge may re-push its whole recent day book every run and a re-push refreshes balances rather than duplicating. Parties join the directory by phone then email (tagged tally, NO consent recorded). A SALES voucher announces invoice.issued, then invoice.paid when its balance reaches zero and invoice.overdue past its due date with money owed; a RECEIPT announces payment.received — each once, to automations waiting on ACCOUNTING_EVENT. Vouchers older than the announce-backfill window are stored but announced as nothing. At most max-batch-size records per push. Writes < 2s. Requires API-key scope: integrations:write.
+     * Receive one push from the Tally bridge
+     */
+    async push(requestParameters, initOverrides) {
+        const response = await this.pushRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Health comes from the shared connection substrate: DEGRADED with lastErrorCode=ACCOUNTING_BRIDGE_STALE means the bridge has not pushed inside the window (a Tally desktop switched off over a weekend is the ordinary cause). lastPushAt and the last* counters describe the most recent push. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected TallyPrime, and when the bridge last pushed
+     */
+    async statusIntegrationsRaw(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/integrations/tally`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.TallyStatusResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Health comes from the shared connection substrate: DEGRADED with lastErrorCode=ACCOUNTING_BRIDGE_STALE means the bridge has not pushed inside the window (a Tally desktop switched off over a weekend is the ordinary cause). lastPushAt and the last* counters describe the most recent push. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected TallyPrime, and when the bridge last pushed
+     */
+    async statusIntegrations(initOverrides) {
+        const response = await this.statusIntegrationsRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * A read model of what Tally sent. The four *AnnouncedAt fields say which accounting moments each voucher has produced; a voucher with contactId null resolved to nobody — its party ledger carries no phone and no email. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The vouchers the bridge has pushed, newest first
+     */
+    async vouchersRaw(requestParameters, initOverrides) {
+        if (requestParameters['pageable'] == null) {
+            throw new runtime.RequiredError('pageable', 'Required parameter "pageable" was null or undefined when calling vouchers().');
+        }
+        const queryParameters = {};
+        if (requestParameters['pageable'] != null) {
+            queryParameters['pageable'] = requestParameters['pageable'];
+        }
+        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/integrations/tally/vouchers`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PageResponseTallyVoucherResponseFromJSON)(jsonValue));
+    }
+    /**
+     * A read model of what Tally sent. The four *AnnouncedAt fields say which accounting moments each voucher has produced; a voucher with contactId null resolved to nobody — its party ledger carries no phone and no email. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The vouchers the bridge has pushed, newest first
+     */
+    async vouchers(requestParameters, initOverrides) {
+        const response = await this.vouchersRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.TallyApi = TallyApi;