@augstash/sdk 0.2.0 → 0.3.0

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

@@ -0,0 +1,188 @@
+/**
+ * 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 { ConnectHubSpotRequest, HubSpotRunResponse, HubSpotStatusResponse, PageResponseHubSpotCompanyResponse, PageResponseHubSpotDealResponse, Pageable, UpdateHubSpotSettingsRequest } from '../models/index';
+export interface CompaniesRequest {
+    pageable: Pageable;
+}
+export interface ConnectIntegrationsHubspotRequest {
+    connectHubSpotRequest: ConnectHubSpotRequest;
+    xIdempotencyKey?: string;
+}
+export interface DealsIntegrationsRequest {
+    pageable: Pageable;
+}
+export interface SyncNowIntegrationsRequest {
+    xIdempotencyKey?: string;
+}
+export interface UpdateSettingsIntegrationsRequest {
+    updateHubSpotSettingsRequest: UpdateHubSpotSettingsRequest;
+    xIdempotencyKey?: string;
+}
+/**
+ * HubSpotApi - interface
+ *
+ * @export
+ * @interface HubSpotApiInterface
+ */
+export interface HubSpotApiInterface {
+    /**
+     * A read model: HubSpot owns these records and nothing here creates, edits or deletes one, so every field but the id may be null. crmModifiedAt is how current the data is and lastPulledAt is when we last looked — a sweep that finds nothing changed advances the second and not the first. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * @summary The companies mirrored from this tenant\'s HubSpot portal
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof HubSpotApiInterface
+     */
+    companiesRaw(requestParameters: CompaniesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PageResponseHubSpotCompanyResponse>>;
+    /**
+     * A read model: HubSpot owns these records and nothing here creates, edits or deletes one, so every field but the id may be null. crmModifiedAt is how current the data is and lastPulledAt is when we last looked — a sweep that finds nothing changed advances the second and not the first. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The companies mirrored from this tenant\'s HubSpot portal
+     */
+    companies(requestParameters: CompaniesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PageResponseHubSpotCompanyResponse>;
+    /**
+     * Takes a private app token the customer generates in their own portal, as credentials.accessToken, and it is verified against HubSpot before it is stored. The token must start with pat-: an OAuth access token or a legacy hapikey is refused before any call is made, because those fail live with a 401 that reads as a wrong token rather than as the wrong kind of credential. Credentials are encrypted at rest and are never returned by any endpoint. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * @summary Connect a HubSpot portal for this tenant
+     * @param {ConnectHubSpotRequest} connectHubSpotRequest
+     * @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 HubSpotApiInterface
+     */
+    connectIntegrationsHubspotRaw(requestParameters: ConnectIntegrationsHubspotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotStatusResponse>>;
+    /**
+     * Takes a private app token the customer generates in their own portal, as credentials.accessToken, and it is verified against HubSpot before it is stored. The token must start with pat-: an OAuth access token or a legacy hapikey is refused before any call is made, because those fail live with a 401 that reads as a wrong token rather than as the wrong kind of credential. Credentials are encrypted at rest and are never returned by any endpoint. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Connect a HubSpot portal for this tenant
+     */
+    connectIntegrationsHubspot(requestParameters: ConnectIntegrationsHubspotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotStatusResponse>;
+    /**
+     * Exists so somebody building an automation can see the stage IDs their own portal uses: a DEAL_STAGE_CHANGED flow triggers on the id, never the label, because a portal\'s owner renames labels freely while ids are stable. stageChangedAt is when we observed the move, not when HubSpot recorded it — HubSpot does not date a stage transition. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * @summary The deals this tenant\'s syncs have observed, most recently moved first
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof HubSpotApiInterface
+     */
+    dealsIntegrationsRaw(requestParameters: DealsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PageResponseHubSpotDealResponse>>;
+    /**
+     * Exists so somebody building an automation can see the stage IDs their own portal uses: a DEAL_STAGE_CHANGED flow triggers on the id, never the label, because a portal\'s owner renames labels freely while ids are stable. stageChangedAt is when we observed the move, not when HubSpot recorded it — HubSpot does not date a stage transition. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The deals this tenant\'s syncs have observed, most recently moved first
+     */
+    dealsIntegrations(requestParameters: DealsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PageResponseHubSpotDealResponse>;
+    /**
+     * Health comes from the shared connection substrate, so status here always matches GET /api/v1/integrations/hubspot. The counters are from the last run and are zero before the first one. timelineWatermark is how far conversation history has been mirrored onto CRM records, which is the only field that answers why a recent chat is not on the record yet. Never returns a credential. Reads < 300ms. Requires API-key scope: integrations:read.
+     * @summary Whether this tenant has connected HubSpot, and what the last sync did
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof HubSpotApiInterface
+     */
+    statusIntegrationsHubspotRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotStatusResponse>>;
+    /**
+     * Health comes from the shared connection substrate, so status here always matches GET /api/v1/integrations/hubspot. The counters are from the last run and are zero before the first one. timelineWatermark is how far conversation history has been mirrored onto CRM records, which is the only field that answers why a recent chat is not on the record yet. Never returns a credential. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected HubSpot, and what the last sync did
+     */
+    statusIntegrationsHubspot(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotStatusResponse>;
+    /**
+     * Four phases in order: companies, contacts, deals, then the conversation timeline. Each is independently fallible, so a rate-limited portal usually yields PARTIAL with phasesCompleted saying how much got through rather than an all-or-nothing failure. Importing a CRM contact records NO consent on any channel — a HubSpot contact list is a sales record, not a permission list. Note that this platform\'s consent model is opt-out, so recording nothing leaves an imported contact reachable exactly as a CSV import does; every one carries the hubspot tag so they can be segmented out. A deal that moved stage raises the DEAL_STAGE_CHANGED automation trigger for every contact on it we hold a link for. Bounded per run, so a large first sync arrives over several runs and each resumes where the last stopped. Runs synchronously and returns what it did, which is why this is a long but bounded budget: < 60s. Requires API-key scope: integrations:write.
+     * @summary Run this tenant\'s HubSpot sync now
+     * @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 HubSpotApiInterface
+     */
+    syncNowIntegrationsRaw(requestParameters: SyncNowIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotRunResponse>>;
+    /**
+     * Four phases in order: companies, contacts, deals, then the conversation timeline. Each is independently fallible, so a rate-limited portal usually yields PARTIAL with phasesCompleted saying how much got through rather than an all-or-nothing failure. Importing a CRM contact records NO consent on any channel — a HubSpot contact list is a sales record, not a permission list. Note that this platform\'s consent model is opt-out, so recording nothing leaves an imported contact reachable exactly as a CSV import does; every one carries the hubspot tag so they can be segmented out. A deal that moved stage raises the DEAL_STAGE_CHANGED automation trigger for every contact on it we hold a link for. Bounded per run, so a large first sync arrives over several runs and each resumes where the last stopped. Runs synchronously and returns what it did, which is why this is a long but bounded budget: < 60s. Requires API-key scope: integrations:write.
+     * Run this tenant\'s HubSpot sync now
+     */
+    syncNowIntegrations(requestParameters: SyncNowIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotRunResponse>;
+    /**
+     * A genuine partial update: send only the fields to change. createMissingContacts defaults FALSE and must be asked for — it creates a HubSpot contact for somebody this business is already in conversation with whom the portal does not have, so their thread has a record to land on. It writes a sales record into the customer\'s own CRM and nothing more: no consent is created or implied by it. Writes < 500ms. Requires API-key scope: integrations:write.
+     * @summary Change how this tenant\'s HubSpot integration behaves
+     * @param {UpdateHubSpotSettingsRequest} updateHubSpotSettingsRequest
+     * @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 HubSpotApiInterface
+     */
+    updateSettingsIntegrationsRaw(requestParameters: UpdateSettingsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotStatusResponse>>;
+    /**
+     * A genuine partial update: send only the fields to change. createMissingContacts defaults FALSE and must be asked for — it creates a HubSpot contact for somebody this business is already in conversation with whom the portal does not have, so their thread has a record to land on. It writes a sales record into the customer\'s own CRM and nothing more: no consent is created or implied by it. Writes < 500ms. Requires API-key scope: integrations:write.
+     * Change how this tenant\'s HubSpot integration behaves
+     */
+    updateSettingsIntegrations(requestParameters: UpdateSettingsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotStatusResponse>;
+}
+/**
+ *
+ */
+export declare class HubSpotApi extends runtime.BaseAPI implements HubSpotApiInterface {
+    /**
+     * A read model: HubSpot owns these records and nothing here creates, edits or deletes one, so every field but the id may be null. crmModifiedAt is how current the data is and lastPulledAt is when we last looked — a sweep that finds nothing changed advances the second and not the first. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The companies mirrored from this tenant\'s HubSpot portal
+     */
+    companiesRaw(requestParameters: CompaniesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PageResponseHubSpotCompanyResponse>>;
+    /**
+     * A read model: HubSpot owns these records and nothing here creates, edits or deletes one, so every field but the id may be null. crmModifiedAt is how current the data is and lastPulledAt is when we last looked — a sweep that finds nothing changed advances the second and not the first. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The companies mirrored from this tenant\'s HubSpot portal
+     */
+    companies(requestParameters: CompaniesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PageResponseHubSpotCompanyResponse>;
+    /**
+     * Takes a private app token the customer generates in their own portal, as credentials.accessToken, and it is verified against HubSpot before it is stored. The token must start with pat-: an OAuth access token or a legacy hapikey is refused before any call is made, because those fail live with a 401 that reads as a wrong token rather than as the wrong kind of credential. Credentials are encrypted at rest and are never returned by any endpoint. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Connect a HubSpot portal for this tenant
+     */
+    connectIntegrationsHubspotRaw(requestParameters: ConnectIntegrationsHubspotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotStatusResponse>>;
+    /**
+     * Takes a private app token the customer generates in their own portal, as credentials.accessToken, and it is verified against HubSpot before it is stored. The token must start with pat-: an OAuth access token or a legacy hapikey is refused before any call is made, because those fail live with a 401 that reads as a wrong token rather than as the wrong kind of credential. Credentials are encrypted at rest and are never returned by any endpoint. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Connect a HubSpot portal for this tenant
+     */
+    connectIntegrationsHubspot(requestParameters: ConnectIntegrationsHubspotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotStatusResponse>;
+    /**
+     * Exists so somebody building an automation can see the stage IDs their own portal uses: a DEAL_STAGE_CHANGED flow triggers on the id, never the label, because a portal\'s owner renames labels freely while ids are stable. stageChangedAt is when we observed the move, not when HubSpot recorded it — HubSpot does not date a stage transition. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The deals this tenant\'s syncs have observed, most recently moved first
+     */
+    dealsIntegrationsRaw(requestParameters: DealsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PageResponseHubSpotDealResponse>>;
+    /**
+     * Exists so somebody building an automation can see the stage IDs their own portal uses: a DEAL_STAGE_CHANGED flow triggers on the id, never the label, because a portal\'s owner renames labels freely while ids are stable. stageChangedAt is when we observed the move, not when HubSpot recorded it — HubSpot does not date a stage transition. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The deals this tenant\'s syncs have observed, most recently moved first
+     */
+    dealsIntegrations(requestParameters: DealsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PageResponseHubSpotDealResponse>;
+    /**
+     * Health comes from the shared connection substrate, so status here always matches GET /api/v1/integrations/hubspot. The counters are from the last run and are zero before the first one. timelineWatermark is how far conversation history has been mirrored onto CRM records, which is the only field that answers why a recent chat is not on the record yet. Never returns a credential. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected HubSpot, and what the last sync did
+     */
+    statusIntegrationsHubspotRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotStatusResponse>>;
+    /**
+     * Health comes from the shared connection substrate, so status here always matches GET /api/v1/integrations/hubspot. The counters are from the last run and are zero before the first one. timelineWatermark is how far conversation history has been mirrored onto CRM records, which is the only field that answers why a recent chat is not on the record yet. Never returns a credential. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected HubSpot, and what the last sync did
+     */
+    statusIntegrationsHubspot(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotStatusResponse>;
+    /**
+     * Four phases in order: companies, contacts, deals, then the conversation timeline. Each is independently fallible, so a rate-limited portal usually yields PARTIAL with phasesCompleted saying how much got through rather than an all-or-nothing failure. Importing a CRM contact records NO consent on any channel — a HubSpot contact list is a sales record, not a permission list. Note that this platform\'s consent model is opt-out, so recording nothing leaves an imported contact reachable exactly as a CSV import does; every one carries the hubspot tag so they can be segmented out. A deal that moved stage raises the DEAL_STAGE_CHANGED automation trigger for every contact on it we hold a link for. Bounded per run, so a large first sync arrives over several runs and each resumes where the last stopped. Runs synchronously and returns what it did, which is why this is a long but bounded budget: < 60s. Requires API-key scope: integrations:write.
+     * Run this tenant\'s HubSpot sync now
+     */
+    syncNowIntegrationsRaw(requestParameters: SyncNowIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotRunResponse>>;
+    /**
+     * Four phases in order: companies, contacts, deals, then the conversation timeline. Each is independently fallible, so a rate-limited portal usually yields PARTIAL with phasesCompleted saying how much got through rather than an all-or-nothing failure. Importing a CRM contact records NO consent on any channel — a HubSpot contact list is a sales record, not a permission list. Note that this platform\'s consent model is opt-out, so recording nothing leaves an imported contact reachable exactly as a CSV import does; every one carries the hubspot tag so they can be segmented out. A deal that moved stage raises the DEAL_STAGE_CHANGED automation trigger for every contact on it we hold a link for. Bounded per run, so a large first sync arrives over several runs and each resumes where the last stopped. Runs synchronously and returns what it did, which is why this is a long but bounded budget: < 60s. Requires API-key scope: integrations:write.
+     * Run this tenant\'s HubSpot sync now
+     */
+    syncNowIntegrations(requestParameters?: SyncNowIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotRunResponse>;
+    /**
+     * A genuine partial update: send only the fields to change. createMissingContacts defaults FALSE and must be asked for — it creates a HubSpot contact for somebody this business is already in conversation with whom the portal does not have, so their thread has a record to land on. It writes a sales record into the customer\'s own CRM and nothing more: no consent is created or implied by it. Writes < 500ms. Requires API-key scope: integrations:write.
+     * Change how this tenant\'s HubSpot integration behaves
+     */
+    updateSettingsIntegrationsRaw(requestParameters: UpdateSettingsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<HubSpotStatusResponse>>;
+    /**
+     * A genuine partial update: send only the fields to change. createMissingContacts defaults FALSE and must be asked for — it creates a HubSpot contact for somebody this business is already in conversation with whom the portal does not have, so their thread has a record to land on. It writes a sales record into the customer\'s own CRM and nothing more: no consent is created or implied by it. Writes < 500ms. Requires API-key scope: integrations:write.
+     * Change how this tenant\'s HubSpot integration behaves
+     */
+    updateSettingsIntegrations(requestParameters: UpdateSettingsIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HubSpotStatusResponse>;
+}

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

@@ -0,0 +1,292 @@
+"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.HubSpotApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class HubSpotApi extends runtime.BaseAPI {
+    /**
+     * A read model: HubSpot owns these records and nothing here creates, edits or deletes one, so every field but the id may be null. crmModifiedAt is how current the data is and lastPulledAt is when we last looked — a sweep that finds nothing changed advances the second and not the first. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The companies mirrored from this tenant\'s HubSpot portal
+     */
+    async companiesRaw(requestParameters, initOverrides) {
+        if (requestParameters['pageable'] == null) {
+            throw new runtime.RequiredError('pageable', 'Required parameter "pageable" was null or undefined when calling companies().');
+        }
+        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/hubspot/companies`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PageResponseHubSpotCompanyResponseFromJSON)(jsonValue));
+    }
+    /**
+     * A read model: HubSpot owns these records and nothing here creates, edits or deletes one, so every field but the id may be null. crmModifiedAt is how current the data is and lastPulledAt is when we last looked — a sweep that finds nothing changed advances the second and not the first. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The companies mirrored from this tenant\'s HubSpot portal
+     */
+    async companies(requestParameters, initOverrides) {
+        const response = await this.companiesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Takes a private app token the customer generates in their own portal, as credentials.accessToken, and it is verified against HubSpot before it is stored. The token must start with pat-: an OAuth access token or a legacy hapikey is refused before any call is made, because those fail live with a 401 that reads as a wrong token rather than as the wrong kind of credential. Credentials are encrypted at rest and are never returned by any endpoint. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Connect a HubSpot portal for this tenant
+     */
+    async connectIntegrationsHubspotRaw(requestParameters, initOverrides) {
+        if (requestParameters['connectHubSpotRequest'] == null) {
+            throw new runtime.RequiredError('connectHubSpotRequest', 'Required parameter "connectHubSpotRequest" was null or undefined when calling connectIntegrationsHubspot().');
+        }
+        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/hubspot`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.ConnectHubSpotRequestToJSON)(requestParameters['connectHubSpotRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.HubSpotStatusResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Takes a private app token the customer generates in their own portal, as credentials.accessToken, and it is verified against HubSpot before it is stored. The token must start with pat-: an OAuth access token or a legacy hapikey is refused before any call is made, because those fail live with a 401 that reads as a wrong token rather than as the wrong kind of credential. Credentials are encrypted at rest and are never returned by any endpoint. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Connect a HubSpot portal for this tenant
+     */
+    async connectIntegrationsHubspot(requestParameters, initOverrides) {
+        const response = await this.connectIntegrationsHubspotRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Exists so somebody building an automation can see the stage IDs their own portal uses: a DEAL_STAGE_CHANGED flow triggers on the id, never the label, because a portal\'s owner renames labels freely while ids are stable. stageChangedAt is when we observed the move, not when HubSpot recorded it — HubSpot does not date a stage transition. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The deals this tenant\'s syncs have observed, most recently moved first
+     */
+    async dealsIntegrationsRaw(requestParameters, initOverrides) {
+        if (requestParameters['pageable'] == null) {
+            throw new runtime.RequiredError('pageable', 'Required parameter "pageable" was null or undefined when calling dealsIntegrations().');
+        }
+        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/hubspot/deals`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PageResponseHubSpotDealResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Exists so somebody building an automation can see the stage IDs their own portal uses: a DEAL_STAGE_CHANGED flow triggers on the id, never the label, because a portal\'s owner renames labels freely while ids are stable. stageChangedAt is when we observed the move, not when HubSpot recorded it — HubSpot does not date a stage transition. Paginated, default 20 and max 100. Reads < 300ms. Requires API-key scope: integrations:read.
+     * The deals this tenant\'s syncs have observed, most recently moved first
+     */
+    async dealsIntegrations(requestParameters, initOverrides) {
+        const response = await this.dealsIntegrationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Health comes from the shared connection substrate, so status here always matches GET /api/v1/integrations/hubspot. The counters are from the last run and are zero before the first one. timelineWatermark is how far conversation history has been mirrored onto CRM records, which is the only field that answers why a recent chat is not on the record yet. Never returns a credential. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected HubSpot, and what the last sync did
+     */
+    async statusIntegrationsHubspotRaw(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/hubspot`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.HubSpotStatusResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Health comes from the shared connection substrate, so status here always matches GET /api/v1/integrations/hubspot. The counters are from the last run and are zero before the first one. timelineWatermark is how far conversation history has been mirrored onto CRM records, which is the only field that answers why a recent chat is not on the record yet. Never returns a credential. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Whether this tenant has connected HubSpot, and what the last sync did
+     */
+    async statusIntegrationsHubspot(initOverrides) {
+        const response = await this.statusIntegrationsHubspotRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * Four phases in order: companies, contacts, deals, then the conversation timeline. Each is independently fallible, so a rate-limited portal usually yields PARTIAL with phasesCompleted saying how much got through rather than an all-or-nothing failure. Importing a CRM contact records NO consent on any channel — a HubSpot contact list is a sales record, not a permission list. Note that this platform\'s consent model is opt-out, so recording nothing leaves an imported contact reachable exactly as a CSV import does; every one carries the hubspot tag so they can be segmented out. A deal that moved stage raises the DEAL_STAGE_CHANGED automation trigger for every contact on it we hold a link for. Bounded per run, so a large first sync arrives over several runs and each resumes where the last stopped. Runs synchronously and returns what it did, which is why this is a long but bounded budget: < 60s. Requires API-key scope: integrations:write.
+     * Run this tenant\'s HubSpot sync now
+     */
+    async syncNowIntegrationsRaw(requestParameters, initOverrides) {
+        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/integrations/hubspot/sync`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.HubSpotRunResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Four phases in order: companies, contacts, deals, then the conversation timeline. Each is independently fallible, so a rate-limited portal usually yields PARTIAL with phasesCompleted saying how much got through rather than an all-or-nothing failure. Importing a CRM contact records NO consent on any channel — a HubSpot contact list is a sales record, not a permission list. Note that this platform\'s consent model is opt-out, so recording nothing leaves an imported contact reachable exactly as a CSV import does; every one carries the hubspot tag so they can be segmented out. A deal that moved stage raises the DEAL_STAGE_CHANGED automation trigger for every contact on it we hold a link for. Bounded per run, so a large first sync arrives over several runs and each resumes where the last stopped. Runs synchronously and returns what it did, which is why this is a long but bounded budget: < 60s. Requires API-key scope: integrations:write.
+     * Run this tenant\'s HubSpot sync now
+     */
+    async syncNowIntegrations(requestParameters = {}, initOverrides) {
+        const response = await this.syncNowIntegrationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * A genuine partial update: send only the fields to change. createMissingContacts defaults FALSE and must be asked for — it creates a HubSpot contact for somebody this business is already in conversation with whom the portal does not have, so their thread has a record to land on. It writes a sales record into the customer\'s own CRM and nothing more: no consent is created or implied by it. Writes < 500ms. Requires API-key scope: integrations:write.
+     * Change how this tenant\'s HubSpot integration behaves
+     */
+    async updateSettingsIntegrationsRaw(requestParameters, initOverrides) {
+        if (requestParameters['updateHubSpotSettingsRequest'] == null) {
+            throw new runtime.RequiredError('updateHubSpotSettingsRequest', 'Required parameter "updateHubSpotSettingsRequest" was null or undefined when calling updateSettingsIntegrations().');
+        }
+        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/hubspot/settings`;
+        const response = await this.request({
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.UpdateHubSpotSettingsRequestToJSON)(requestParameters['updateHubSpotSettingsRequest']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.HubSpotStatusResponseFromJSON)(jsonValue));
+    }
+    /**
+     * A genuine partial update: send only the fields to change. createMissingContacts defaults FALSE and must be asked for — it creates a HubSpot contact for somebody this business is already in conversation with whom the portal does not have, so their thread has a record to land on. It writes a sales record into the customer\'s own CRM and nothing more: no consent is created or implied by it. Writes < 500ms. Requires API-key scope: integrations:write.
+     * Change how this tenant\'s HubSpot integration behaves
+     */
+    async updateSettingsIntegrations(requestParameters, initOverrides) {
+        const response = await this.updateSettingsIntegrationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.HubSpotApi = HubSpotApi;

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

@@ -0,0 +1,111 @@
+/**
+ * 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 { IntegrationConnectionResponse } from '../models/index';
+export interface DisconnectIntegrationsRequest {
+    vendor: string;
+    xIdempotencyKey?: string;
+}
+export interface GetIntegrationsRequest {
+    vendor: string;
+}
+export interface HealthIntegrationsRequest {
+    vendor: string;
+    xIdempotencyKey?: string;
+}
+/**
+ * IntegrationConnectionApi - interface
+ *
+ * @export
+ * @interface IntegrationConnectionApiInterface
+ */
+export interface IntegrationConnectionApiInterface {
+    /**
+     * Idempotent: 204 whether or not a connection existed. Revokes the grant upstream where the vendor supports it, and clears whatever the connector stored of its own. Data already imported is kept — it is the customer\'s history, not the connector\'s. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * @summary Disconnect the tenant from one vendor
+     * @param {string} vendor
+     * @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 IntegrationConnectionApiInterface
+     */
+    disconnectIntegrationsRaw(requestParameters: DisconnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Idempotent: 204 whether or not a connection existed. Revokes the grant upstream where the vendor supports it, and clears whatever the connector stored of its own. Data already imported is kept — it is the customer\'s history, not the connector\'s. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Disconnect the tenant from one vendor
+     */
+    disconnectIntegrations(requestParameters: DisconnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Never returns a credential value — credentialKeys carries the stored credential\'s field NAMES only. Reads < 300ms. Requires API-key scope: integrations:read.
+     * @summary Get the tenant\'s connection to one vendor
+     * @param {string} vendor
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof IntegrationConnectionApiInterface
+     */
+    getIntegrationsRaw(requestParameters: GetIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IntegrationConnectionResponse>>;
+    /**
+     * Never returns a credential value — credentialKeys carries the stored credential\'s field NAMES only. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Get the tenant\'s connection to one vendor
+     */
+    getIntegrations(requestParameters: GetIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IntegrationConnectionResponse>;
+    /**
+     * Asks the vendor now and records the verdict. A vendor that refuses or does not answer is reported as status DEGRADED (or REVOKED, when the credential itself is finished) with a lastErrorCode — not as an error response. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * @summary Re-check the tenant\'s connection to one vendor
+     * @param {string} vendor
+     * @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 IntegrationConnectionApiInterface
+     */
+    healthIntegrationsRaw(requestParameters: HealthIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IntegrationConnectionResponse>>;
+    /**
+     * Asks the vendor now and records the verdict. A vendor that refuses or does not answer is reported as status DEGRADED (or REVOKED, when the credential itself is finished) with a lastErrorCode — not as an error response. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Re-check the tenant\'s connection to one vendor
+     */
+    healthIntegrations(requestParameters: HealthIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IntegrationConnectionResponse>;
+}
+/**
+ *
+ */
+export declare class IntegrationConnectionApi extends runtime.BaseAPI implements IntegrationConnectionApiInterface {
+    /**
+     * Idempotent: 204 whether or not a connection existed. Revokes the grant upstream where the vendor supports it, and clears whatever the connector stored of its own. Data already imported is kept — it is the customer\'s history, not the connector\'s. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Disconnect the tenant from one vendor
+     */
+    disconnectIntegrationsRaw(requestParameters: DisconnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Idempotent: 204 whether or not a connection existed. Revokes the grant upstream where the vendor supports it, and clears whatever the connector stored of its own. Data already imported is kept — it is the customer\'s history, not the connector\'s. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Disconnect the tenant from one vendor
+     */
+    disconnectIntegrations(requestParameters: DisconnectIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Never returns a credential value — credentialKeys carries the stored credential\'s field NAMES only. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Get the tenant\'s connection to one vendor
+     */
+    getIntegrationsRaw(requestParameters: GetIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IntegrationConnectionResponse>>;
+    /**
+     * Never returns a credential value — credentialKeys carries the stored credential\'s field NAMES only. Reads < 300ms. Requires API-key scope: integrations:read.
+     * Get the tenant\'s connection to one vendor
+     */
+    getIntegrations(requestParameters: GetIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IntegrationConnectionResponse>;
+    /**
+     * Asks the vendor now and records the verdict. A vendor that refuses or does not answer is reported as status DEGRADED (or REVOKED, when the credential itself is finished) with a lastErrorCode — not as an error response. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Re-check the tenant\'s connection to one vendor
+     */
+    healthIntegrationsRaw(requestParameters: HealthIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IntegrationConnectionResponse>>;
+    /**
+     * Asks the vendor now and records the verdict. A vendor that refuses or does not answer is reported as status DEGRADED (or REVOKED, when the credential itself is finished) with a lastErrorCode — not as an error response. Vendor round-trips < 2s. Requires API-key scope: integrations:write.
+     * Re-check the tenant\'s connection to one vendor
+     */
+    healthIntegrations(requestParameters: HealthIntegrationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IntegrationConnectionResponse>;
+}