@llmpulse/sdk 0.0.0-stage → 1.60.0

package/src/apis/StoreIntegrationsApi.ts

@@ -0,0 +1,771 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * LLM Pulse API
+ * REST API client for LLM Pulse AI visibility analytics.
+ *
+ * The version of the OpenAPI document: 1.60.0
+ * Contact: info@llmpulse.ai
+ *
+ * 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 AiOrdersResponse,
+    AiOrdersResponseFromJSON,
+    AiOrdersResponseToJSON,
+} from '../models/AiOrdersResponse';
+import {
+    type AiOrdersUpdateRequest,
+    AiOrdersUpdateRequestFromJSON,
+    AiOrdersUpdateRequestToJSON,
+} from '../models/AiOrdersUpdateRequest';
+import {
+    type AiOrdersUpdateResponse,
+    AiOrdersUpdateResponseFromJSON,
+    AiOrdersUpdateResponseToJSON,
+} from '../models/AiOrdersUpdateResponse';
+import {
+    type ApiError,
+    ApiErrorFromJSON,
+    ApiErrorToJSON,
+} from '../models/ApiError';
+import {
+    type CatalogPromptSuggestionIdsRequest,
+    CatalogPromptSuggestionIdsRequestFromJSON,
+    CatalogPromptSuggestionIdsRequestToJSON,
+} from '../models/CatalogPromptSuggestionIdsRequest';
+import {
+    type CatalogPromptSuggestionsAcceptResponse,
+    CatalogPromptSuggestionsAcceptResponseFromJSON,
+    CatalogPromptSuggestionsAcceptResponseToJSON,
+} from '../models/CatalogPromptSuggestionsAcceptResponse';
+import {
+    type CatalogPromptSuggestionsCreateRequest,
+    CatalogPromptSuggestionsCreateRequestFromJSON,
+    CatalogPromptSuggestionsCreateRequestToJSON,
+} from '../models/CatalogPromptSuggestionsCreateRequest';
+import {
+    type CatalogPromptSuggestionsCreateResponse,
+    CatalogPromptSuggestionsCreateResponseFromJSON,
+    CatalogPromptSuggestionsCreateResponseToJSON,
+} from '../models/CatalogPromptSuggestionsCreateResponse';
+import {
+    type CatalogPromptSuggestionsRejectResponse,
+    CatalogPromptSuggestionsRejectResponseFromJSON,
+    CatalogPromptSuggestionsRejectResponseToJSON,
+} from '../models/CatalogPromptSuggestionsRejectResponse';
+import {
+    type CatalogPromptSuggestionsResponse,
+    CatalogPromptSuggestionsResponseFromJSON,
+    CatalogPromptSuggestionsResponseToJSON,
+} from '../models/CatalogPromptSuggestionsResponse';
+import {
+    type StoreConnectionResponse,
+    StoreConnectionResponseFromJSON,
+    StoreConnectionResponseToJSON,
+} from '../models/StoreConnectionResponse';
+
+export interface AcceptCatalogPromptSuggestionsRequest {
+    catalogPromptSuggestionIdsRequest: CatalogPromptSuggestionIdsRequest;
+}
+
+export interface CreateCatalogPromptSuggestionsRequest {
+    catalogPromptSuggestionsCreateRequest: CatalogPromptSuggestionsCreateRequest;
+}
+
+export interface GetStoreConnectionRequest {
+    platform: GetStoreConnectionPlatformEnum;
+    domain: string;
+}
+
+export interface ListAiOrdersRequest {
+    projectId: number;
+    platform?: ListAiOrdersPlatformEnum;
+    from?: Date;
+    to?: Date;
+}
+
+export interface ListCatalogPromptSuggestionsRequest {
+    projectId: number;
+    status?: ListCatalogPromptSuggestionsStatusEnum;
+    productExternalId?: string;
+    page?: number;
+    perPage?: number;
+}
+
+export interface RejectCatalogPromptSuggestionsRequest {
+    catalogPromptSuggestionIdsRequest: CatalogPromptSuggestionIdsRequest;
+}
+
+export interface ReplaceAiOrdersRequest {
+    aiOrdersUpdateRequest: AiOrdersUpdateRequest;
+}
+
+/**
+ * StoreIntegrationsApi - interface
+ * 
+ * @export
+ * @interface StoreIntegrationsApiInterface
+ */
+export interface StoreIntegrationsApiInterface {
+    /**
+     * Creates request options for acceptCatalogPromptSuggestions without sending the request
+     * @param {CatalogPromptSuggestionIdsRequest} catalogPromptSuggestionIdsRequest 
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    acceptCatalogPromptSuggestionsRequestOpts(requestParameters: AcceptCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Starts tracking pending suggestions: each one becomes a prompt, tagged with a collection named after its product. Suggestions that are no longer pending come back in skipped. All accepted suggestions must share one country and language. When the new prompts would exceed the plan, the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary Accept catalog prompt suggestions
+     * @param {CatalogPromptSuggestionIdsRequest} catalogPromptSuggestionIdsRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    acceptCatalogPromptSuggestionsRaw(requestParameters: AcceptCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsAcceptResponse>>;
+
+    /**
+     * Starts tracking pending suggestions: each one becomes a prompt, tagged with a collection named after its product. Suggestions that are no longer pending come back in skipped. All accepted suggestions must share one country and language. When the new prompts would exceed the plan, the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Accept catalog prompt suggestions
+     */
+    acceptCatalogPromptSuggestions(requestParameters: AcceptCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsAcceptResponse>;
+
+    /**
+     * Creates request options for createCatalogPromptSuggestions without sending the request
+     * @param {CatalogPromptSuggestionsCreateRequest} catalogPromptSuggestionsCreateRequest 
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    createCatalogPromptSuggestionsRequestOpts(requestParameters: CreateCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Writes buyer prompts for up to 20 catalog products and saves them as pending suggestions in the project\'s Suggested prompts queue, with the product recorded on each. Generation draws on the hourly prompt-suggestion allowance the app also uses (ERR_QUOTA_EXCEEDED once it is used up); a failed generation returns ERR_GENERATION_FAILED (502) and can be retried. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary Suggest buyer prompts from catalog products
+     * @param {CatalogPromptSuggestionsCreateRequest} catalogPromptSuggestionsCreateRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    createCatalogPromptSuggestionsRaw(requestParameters: CreateCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsCreateResponse>>;
+
+    /**
+     * Writes buyer prompts for up to 20 catalog products and saves them as pending suggestions in the project\'s Suggested prompts queue, with the product recorded on each. Generation draws on the hourly prompt-suggestion allowance the app also uses (ERR_QUOTA_EXCEEDED once it is used up); a failed generation returns ERR_GENERATION_FAILED (502) and can be retried. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Suggest buyer prompts from catalog products
+     */
+    createCatalogPromptSuggestions(requestParameters: CreateCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsCreateResponse>;
+
+    /**
+     * Creates request options for getStoreConnection without sending the request
+     * @param {'shopify'} platform Store platform
+     * @param {string} domain Store domain, with or without scheme, e.g. acme-store.com
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    getStoreConnectionRequestOpts(requestParameters: GetStoreConnectionRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Tells a store app whether the API key\'s account can use it and which project the store belongs to: the live project whose domain equals the store domain, else one whose domain is a parent or a subdomain of it, else null. candidates lists every live project of the account so the app can offer a picker. Takes no project_id. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary Match a store to a project
+     * @param {'shopify'} platform Store platform
+     * @param {string} domain Store domain, with or without scheme, e.g. acme-store.com
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    getStoreConnectionRaw(requestParameters: GetStoreConnectionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<StoreConnectionResponse>>;
+
+    /**
+     * Tells a store app whether the API key\'s account can use it and which project the store belongs to: the live project whose domain equals the store domain, else one whose domain is a parent or a subdomain of it, else null. candidates lists every live project of the account so the app can offer a picker. Takes no project_id. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Match a store to a project
+     */
+    getStoreConnection(requestParameters: GetStoreConnectionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<StoreConnectionResponse>;
+
+    /**
+     * Creates request options for listAiOrders without sending the request
+     * @param {number} projectId Project ID
+     * @param {'shopify'} [platform] Store platform
+     * @param {Date} [from] First day (YYYY-MM-DD). Defaults to 89 days before to
+     * @param {Date} [to] Last day (YYYY-MM-DD). Defaults to today; the window is at most 400 days
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    listAiOrdersRequestOpts(requestParameters: ListAiOrdersRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series of the days with orders. Revenue values are decimal strings in currency. Team members need read access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary Read AI-referred store orders
+     * @param {number} projectId Project ID
+     * @param {'shopify'} [platform] Store platform
+     * @param {Date} [from] First day (YYYY-MM-DD). Defaults to 89 days before to
+     * @param {Date} [to] Last day (YYYY-MM-DD). Defaults to today; the window is at most 400 days
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    listAiOrdersRaw(requestParameters: ListAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiOrdersResponse>>;
+
+    /**
+     * Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series of the days with orders. Revenue values are decimal strings in currency. Team members need read access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Read AI-referred store orders
+     */
+    listAiOrders(requestParameters: ListAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiOrdersResponse>;
+
+    /**
+     * Creates request options for listCatalogPromptSuggestions without sending the request
+     * @param {number} projectId Project ID
+     * @param {'pending' | 'accepted' | 'rejected'} [status] Only suggestions in this status
+     * @param {string} [productExternalId] Only suggestions for this store product id
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    listCatalogPromptSuggestionsRequestOpts(requestParameters: ListCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from. Team members need read access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary List catalog prompt suggestions
+     * @param {number} projectId Project ID
+     * @param {'pending' | 'accepted' | 'rejected'} [status] Only suggestions in this status
+     * @param {string} [productExternalId] Only suggestions for this store product id
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    listCatalogPromptSuggestionsRaw(requestParameters: ListCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsResponse>>;
+
+    /**
+     * Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from. Team members need read access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * List catalog prompt suggestions
+     */
+    listCatalogPromptSuggestions(requestParameters: ListCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsResponse>;
+
+    /**
+     * Creates request options for rejectCatalogPromptSuggestions without sending the request
+     * @param {CatalogPromptSuggestionIdsRequest} catalogPromptSuggestionIdsRequest 
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    rejectCatalogPromptSuggestionsRequestOpts(requestParameters: RejectCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Marks pending suggestions as rejected; suggestions that are no longer pending stay as they are. Requires a `read_write` scope API key and, for team members, update access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary Reject catalog prompt suggestions
+     * @param {CatalogPromptSuggestionIdsRequest} catalogPromptSuggestionIdsRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    rejectCatalogPromptSuggestionsRaw(requestParameters: RejectCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsRejectResponse>>;
+
+    /**
+     * Marks pending suggestions as rejected; suggestions that are no longer pending stay as they are. Requires a `read_write` scope API key and, for team members, update access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Reject catalog prompt suggestions
+     */
+    rejectCatalogPromptSuggestions(requestParameters: RejectCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsRejectResponse>;
+
+    /**
+     * Creates request options for replaceAiOrders without sending the request
+     * @param {AiOrdersUpdateRequest} aiOrdersUpdateRequest 
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    replaceAiOrdersRequestOpts(requestParameters: ReplaceAiOrdersRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Replaces the daily AI-referred orders and revenue of the from..to window. Send the raw referring host or utm_source of each order\'s first visit as referrer: LLM Pulse classifies it and ignores anything that is not an AI assistant. Entries for the same day and assistant are summed. Every stored row of that project and platform inside the window is replaced, so pushing the same window again converges instead of counting twice. Rows are kept per project and platform, not per store, so one store reports per project. Requires a `read_write` scope API key and, for team members, update access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * @summary Replace AI-referred store orders for a window
+     * @param {AiOrdersUpdateRequest} aiOrdersUpdateRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof StoreIntegrationsApiInterface
+     */
+    replaceAiOrdersRaw(requestParameters: ReplaceAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiOrdersUpdateResponse>>;
+
+    /**
+     * Replaces the daily AI-referred orders and revenue of the from..to window. Send the raw referring host or utm_source of each order\'s first visit as referrer: LLM Pulse classifies it and ignores anything that is not an AI assistant. Entries for the same day and assistant are summed. Every stored row of that project and platform inside the window is replaced, so pushing the same window again converges instead of counting twice. Rows are kept per project and platform, not per store, so one store reports per project. Requires a `read_write` scope API key and, for team members, update access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Replace AI-referred store orders for a window
+     */
+    replaceAiOrders(requestParameters: ReplaceAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiOrdersUpdateResponse>;
+
+}
+
+/**
+ * 
+ */
+export class StoreIntegrationsApi extends runtime.BaseAPI implements StoreIntegrationsApiInterface {
+
+    /**
+     * Creates request options for acceptCatalogPromptSuggestions without sending the request
+     */
+    async acceptCatalogPromptSuggestionsRequestOpts(requestParameters: AcceptCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['catalogPromptSuggestionIdsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'catalogPromptSuggestionIdsRequest',
+                'Required parameter "catalogPromptSuggestionIdsRequest" was null or undefined when calling acceptCatalogPromptSuggestions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/catalog_prompt_suggestions/accept`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CatalogPromptSuggestionIdsRequestToJSON(requestParameters['catalogPromptSuggestionIdsRequest']),
+        };
+    }
+
+    /**
+     * Starts tracking pending suggestions: each one becomes a prompt, tagged with a collection named after its product. Suggestions that are no longer pending come back in skipped. All accepted suggestions must share one country and language. When the new prompts would exceed the plan, the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Accept catalog prompt suggestions
+     */
+    async acceptCatalogPromptSuggestionsRaw(requestParameters: AcceptCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsAcceptResponse>> {
+        const requestOptions = await this.acceptCatalogPromptSuggestionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CatalogPromptSuggestionsAcceptResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Starts tracking pending suggestions: each one becomes a prompt, tagged with a collection named after its product. Suggestions that are no longer pending come back in skipped. All accepted suggestions must share one country and language. When the new prompts would exceed the plan, the call returns ERR_LIMIT_REACHED and accepts nothing. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Accept catalog prompt suggestions
+     */
+    async acceptCatalogPromptSuggestions(requestParameters: AcceptCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsAcceptResponse> {
+        const response = await this.acceptCatalogPromptSuggestionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for createCatalogPromptSuggestions without sending the request
+     */
+    async createCatalogPromptSuggestionsRequestOpts(requestParameters: CreateCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['catalogPromptSuggestionsCreateRequest'] == null) {
+            throw new runtime.RequiredError(
+                'catalogPromptSuggestionsCreateRequest',
+                'Required parameter "catalogPromptSuggestionsCreateRequest" was null or undefined when calling createCatalogPromptSuggestions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/catalog_prompt_suggestions`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CatalogPromptSuggestionsCreateRequestToJSON(requestParameters['catalogPromptSuggestionsCreateRequest']),
+        };
+    }
+
+    /**
+     * Writes buyer prompts for up to 20 catalog products and saves them as pending suggestions in the project\'s Suggested prompts queue, with the product recorded on each. Generation draws on the hourly prompt-suggestion allowance the app also uses (ERR_QUOTA_EXCEEDED once it is used up); a failed generation returns ERR_GENERATION_FAILED (502) and can be retried. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Suggest buyer prompts from catalog products
+     */
+    async createCatalogPromptSuggestionsRaw(requestParameters: CreateCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsCreateResponse>> {
+        const requestOptions = await this.createCatalogPromptSuggestionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CatalogPromptSuggestionsCreateResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Writes buyer prompts for up to 20 catalog products and saves them as pending suggestions in the project\'s Suggested prompts queue, with the product recorded on each. Generation draws on the hourly prompt-suggestion allowance the app also uses (ERR_QUOTA_EXCEEDED once it is used up); a failed generation returns ERR_GENERATION_FAILED (502) and can be retried. Requires a `read_write` scope API key and, for team members, create access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Suggest buyer prompts from catalog products
+     */
+    async createCatalogPromptSuggestions(requestParameters: CreateCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsCreateResponse> {
+        const response = await this.createCatalogPromptSuggestionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getStoreConnection without sending the request
+     */
+    async getStoreConnectionRequestOpts(requestParameters: GetStoreConnectionRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['platform'] == null) {
+            throw new runtime.RequiredError(
+                'platform',
+                'Required parameter "platform" was null or undefined when calling getStoreConnection().'
+            );
+        }
+
+        if (requestParameters['domain'] == null) {
+            throw new runtime.RequiredError(
+                'domain',
+                'Required parameter "domain" was null or undefined when calling getStoreConnection().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['platform'] != null) {
+            queryParameters['platform'] = requestParameters['platform'];
+        }
+
+        if (requestParameters['domain'] != null) {
+            queryParameters['domain'] = requestParameters['domain'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/store_connection`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Tells a store app whether the API key\'s account can use it and which project the store belongs to: the live project whose domain equals the store domain, else one whose domain is a parent or a subdomain of it, else null. candidates lists every live project of the account so the app can offer a picker. Takes no project_id. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Match a store to a project
+     */
+    async getStoreConnectionRaw(requestParameters: GetStoreConnectionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<StoreConnectionResponse>> {
+        const requestOptions = await this.getStoreConnectionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => StoreConnectionResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Tells a store app whether the API key\'s account can use it and which project the store belongs to: the live project whose domain equals the store domain, else one whose domain is a parent or a subdomain of it, else null. candidates lists every live project of the account so the app can offer a picker. Takes no project_id. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Match a store to a project
+     */
+    async getStoreConnection(requestParameters: GetStoreConnectionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<StoreConnectionResponse> {
+        const response = await this.getStoreConnectionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listAiOrders without sending the request
+     */
+    async listAiOrdersRequestOpts(requestParameters: ListAiOrdersRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling listAiOrders().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
+        if (requestParameters['platform'] != null) {
+            queryParameters['platform'] = requestParameters['platform'];
+        }
+
+        if (requestParameters['from'] != null) {
+            queryParameters['from'] = (requestParameters['from'] as any).toISOString().substring(0,10);
+        }
+
+        if (requestParameters['to'] != null) {
+            queryParameters['to'] = (requestParameters['to'] as any).toISOString().substring(0,10);
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/ai_orders`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series of the days with orders. Revenue values are decimal strings in currency. Team members need read access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Read AI-referred store orders
+     */
+    async listAiOrdersRaw(requestParameters: ListAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiOrdersResponse>> {
+        const requestOptions = await this.listAiOrdersRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => AiOrdersResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series of the days with orders. Revenue values are decimal strings in currency. Team members need read access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Read AI-referred store orders
+     */
+    async listAiOrders(requestParameters: ListAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiOrdersResponse> {
+        const response = await this.listAiOrdersRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listCatalogPromptSuggestions without sending the request
+     */
+    async listCatalogPromptSuggestionsRequestOpts(requestParameters: ListCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling listCatalogPromptSuggestions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
+        if (requestParameters['status'] != null) {
+            queryParameters['status'] = requestParameters['status'];
+        }
+
+        if (requestParameters['productExternalId'] != null) {
+            queryParameters['product_external_id'] = requestParameters['productExternalId'];
+        }
+
+        if (requestParameters['page'] != null) {
+            queryParameters['page'] = requestParameters['page'];
+        }
+
+        if (requestParameters['perPage'] != null) {
+            queryParameters['per_page'] = requestParameters['perPage'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/catalog_prompt_suggestions`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from. Team members need read access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * List catalog prompt suggestions
+     */
+    async listCatalogPromptSuggestionsRaw(requestParameters: ListCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsResponse>> {
+        const requestOptions = await this.listCatalogPromptSuggestionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CatalogPromptSuggestionsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from. Team members need read access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * List catalog prompt suggestions
+     */
+    async listCatalogPromptSuggestions(requestParameters: ListCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsResponse> {
+        const response = await this.listCatalogPromptSuggestionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for rejectCatalogPromptSuggestions without sending the request
+     */
+    async rejectCatalogPromptSuggestionsRequestOpts(requestParameters: RejectCatalogPromptSuggestionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['catalogPromptSuggestionIdsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'catalogPromptSuggestionIdsRequest',
+                'Required parameter "catalogPromptSuggestionIdsRequest" was null or undefined when calling rejectCatalogPromptSuggestions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/catalog_prompt_suggestions/reject`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CatalogPromptSuggestionIdsRequestToJSON(requestParameters['catalogPromptSuggestionIdsRequest']),
+        };
+    }
+
+    /**
+     * Marks pending suggestions as rejected; suggestions that are no longer pending stay as they are. Requires a `read_write` scope API key and, for team members, update access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Reject catalog prompt suggestions
+     */
+    async rejectCatalogPromptSuggestionsRaw(requestParameters: RejectCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CatalogPromptSuggestionsRejectResponse>> {
+        const requestOptions = await this.rejectCatalogPromptSuggestionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CatalogPromptSuggestionsRejectResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Marks pending suggestions as rejected; suggestions that are no longer pending stay as they are. Requires a `read_write` scope API key and, for team members, update access to Prompts. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Reject catalog prompt suggestions
+     */
+    async rejectCatalogPromptSuggestions(requestParameters: RejectCatalogPromptSuggestionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CatalogPromptSuggestionsRejectResponse> {
+        const response = await this.rejectCatalogPromptSuggestionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for replaceAiOrders without sending the request
+     */
+    async replaceAiOrdersRequestOpts(requestParameters: ReplaceAiOrdersRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['aiOrdersUpdateRequest'] == null) {
+            throw new runtime.RequiredError(
+                'aiOrdersUpdateRequest',
+                'Required parameter "aiOrdersUpdateRequest" was null or undefined when calling replaceAiOrders().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/ai_orders`;
+
+        return {
+            path: urlPath,
+            method: 'PUT',
+            headers: headerParameters,
+            query: queryParameters,
+            body: AiOrdersUpdateRequestToJSON(requestParameters['aiOrdersUpdateRequest']),
+        };
+    }
+
+    /**
+     * Replaces the daily AI-referred orders and revenue of the from..to window. Send the raw referring host or utm_source of each order\'s first visit as referrer: LLM Pulse classifies it and ignores anything that is not an AI assistant. Entries for the same day and assistant are summed. Every stored row of that project and platform inside the window is replaced, so pushing the same window again converges instead of counting twice. Rows are kept per project and platform, not per store, so one store reports per project. Requires a `read_write` scope API key and, for team members, update access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Replace AI-referred store orders for a window
+     */
+    async replaceAiOrdersRaw(requestParameters: ReplaceAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiOrdersUpdateResponse>> {
+        const requestOptions = await this.replaceAiOrdersRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => AiOrdersUpdateResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Replaces the daily AI-referred orders and revenue of the from..to window. Send the raw referring host or utm_source of each order\'s first visit as referrer: LLM Pulse classifies it and ignores anything that is not an AI assistant. Entries for the same day and assistant are summed. Every stored row of that project and platform inside the window is replaced, so pushing the same window again converges instead of counting twice. Rows are kept per project and platform, not per store, so one store reports per project. Requires a `read_write` scope API key and, for team members, update access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).
+     * Replace AI-referred store orders for a window
+     */
+    async replaceAiOrders(requestParameters: ReplaceAiOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiOrdersUpdateResponse> {
+        const response = await this.replaceAiOrdersRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const GetStoreConnectionPlatformEnum = {
+    Shopify: 'shopify'
+} as const;
+export type GetStoreConnectionPlatformEnum = typeof GetStoreConnectionPlatformEnum[keyof typeof GetStoreConnectionPlatformEnum];
+/**
+ * @export
+ */
+export const ListAiOrdersPlatformEnum = {
+    Shopify: 'shopify'
+} as const;
+export type ListAiOrdersPlatformEnum = typeof ListAiOrdersPlatformEnum[keyof typeof ListAiOrdersPlatformEnum];
+/**
+ * @export
+ */
+export const ListCatalogPromptSuggestionsStatusEnum = {
+    Pending: 'pending',
+    Accepted: 'accepted',
+    Rejected: 'rejected'
+} as const;
+export type ListCatalogPromptSuggestionsStatusEnum = typeof ListCatalogPromptSuggestionsStatusEnum[keyof typeof ListCatalogPromptSuggestionsStatusEnum];