@squidcloud/client 1.0.175 → 1.0.177

package/dist/cjs/index.js

@@ -27525,7 +27525,8 @@ __webpack_require__.d(__webpack_exports__, {
   deserializeQuery: () => (/* reexport */ deserializeQuery),
   generateId: () => (/* reexport */ generateId),
   generateShortId: () => (/* reexport */ generateShortId),
-  isSimpleCondition: () => (/* reexport */ isSimpleCondition)
+  isSimpleCondition: () => (/* reexport */ isSimpleCondition),
+  limiterConfigToOptions: () => (/* reexport */ limiterConfigToOptions)
 });
 
 // EXTERNAL MODULE: external "rxjs"
@@ -28730,7 +28731,7 @@ class AiChatbotContextReference {
      * Updates an existing context entry on the chatbot profile. This will result in an error if an entry has not yet
      * been created for the current context id.
      *
-     * @param data An object containing options for updated the entry.
+     * @param data An object containing options for updating the entry.
      * @param data.title - The title of the entry.
      * @param data.context - The context data.
      * @returns A promise that resolves when the context is successfully updated.
@@ -28803,7 +28804,7 @@ class AiChatbotInstructionReference {
      * Updates an existing instruction entry on the chatbot profile. This will result in an error if an entry has not
      * yet been created for the current instruction id.
      *
-     * @param data An object containing options for updated the entry.
+     * @param data An object containing options for updating the entry.
      * @param data.instruction - The instruction data.
      * @returns A promise that resolves when the instruction is successfully updated.
      */
@@ -28886,7 +28887,7 @@ class ApiCallContext {
         this.body = prototype.body;
         this.queryParams = prototype.queryParams;
         this.pathParams = prototype.pathParams;
-        this.serverUrlOverride = prototype.serverUrlOverride;
+        this.options = prototype.options;
     }
 }
 
@@ -29087,6 +29088,51 @@ class BaseQueryBuilder {
     }
 }
 
+;// CONCATENATED MODULE: ../internal-common/src/public-types/bundle-api.public-types.ts
+/**
+ * Convert LimiterConfig to LimiterOptions.
+ *
+ * This decouples the required syntax for the developer from the internal implementation.
+ *
+ * @param config LimiterConfig to convert.
+ */
+function limiterConfigToOptions(config) {
+    // Deal with rateLimit if provided.
+    if (config.rateLimit !== undefined) {
+        // Check if rateLimit is of type number and convert to RateLimitOptions.
+        if (typeof config.rateLimit === 'number') {
+            config.rateLimit = [{ value: config.rateLimit, scope: 'global' }];
+        }
+        else if (typeof config.rateLimit === 'object' && !Array.isArray(config.rateLimit)) {
+            config.rateLimit = [config.rateLimit];
+        }
+        // Set defaults if not provided for each item in rateLimit and quotaLimit.
+        config.rateLimit.forEach((options) => {
+            if (options.scope === undefined) {
+                options.scope = 'global';
+            }
+        });
+    }
+    // Same for quotaLimit.
+    if (config.quotaLimit !== undefined) {
+        if (typeof config.quotaLimit === 'number') {
+            config.quotaLimit = [{ value: config.quotaLimit, scope: 'global', renewPeriod: 'monthly' }];
+        }
+        else if (typeof config.quotaLimit === 'object' && !Array.isArray(config.quotaLimit)) {
+            config.quotaLimit = [config.quotaLimit];
+        }
+        config.quotaLimit.forEach((options) => {
+            if (options.scope === undefined) {
+                options.scope = 'global';
+            }
+            if (options.renewPeriod === undefined) {
+                options.renewPeriod = 'monthly';
+            }
+        });
+    }
+    return config;
+}
+
 ;// CONCATENATED MODULE: ../internal-common/src/public-types/communication.public-types.ts
 const ENVIRONMENT_IDS = ['dev', 'prod'];
 // noinspection JSUnusedGtypeslobalSymbols
@@ -29349,12 +29395,14 @@ function replaceKeyInRecord(record, a, b) {
         delete record[a];
     }
 }
+function isNil(obj) {
+    return obj === undefined || obj === null;
+}
 
 ;// CONCATENATED MODULE: ../internal-common/src/public-types/pagination.public-types.ts
 
 
 
-
 class Pagination {
     /** @internal */
     constructor(snapshotEmitter, options = {}) {
@@ -29400,10 +29448,10 @@ class Pagination {
         this.snapshotSubject.next(firstPageSnapshot);
     }
     static compareValues(a, b) {
-        if (lodash_default().isNil(a)) {
-            return lodash_default().isNil(b) ? 0 : -1;
+        if (isNil(a)) {
+            return isNil(b) ? 0 : -1;
         }
-        if (lodash_default().isNil(b)) {
+        if (isNil(b)) {
             return 1;
         }
         if (a > b) {
@@ -29417,7 +29465,7 @@ class Pagination {
         }
     }
     compare(doc1, doc2) {
-        if (lodash_default().isNil(doc2)) {
+        if (isNil(doc2)) {
             return 1;
         }
         for (const so of this.templateSnapshotEmitter.getSortOrders()) {
@@ -29696,6 +29744,7 @@ function decodeValueForMapping(encodedString) {
 ;// CONCATENATED MODULE: ../internal-common/src/types/query.types.ts
 
 
+
 /**
  * Example query mapping:
  * Queries:
@@ -29734,30 +29783,30 @@ function compareOperator(conditionValue, valueInDocument, operator) {
     // Nulls can only be compared for (in)equality, not other operators.
     switch (operator) {
         case '<':
-            if (lodash_default().isNil(conditionValue))
+            if (isNil(conditionValue))
                 return false;
-            if (lodash_default().isNil(valueInDocument))
+            if (isNil(valueInDocument))
                 return true;
             return valueInDocument < conditionValue;
         case '<=':
-            if (lodash_default().isNil(valueInDocument)) {
+            if (isNil(valueInDocument)) {
                 return true;
             }
-            if (lodash_default().isNil(conditionValue)) {
+            if (isNil(conditionValue)) {
                 return false;
             }
             return valueInDocument <= conditionValue;
         case '>':
-            if (lodash_default().isNil(valueInDocument))
+            if (isNil(valueInDocument))
                 return false;
-            if (lodash_default().isNil(conditionValue))
+            if (isNil(conditionValue))
                 return true;
             return valueInDocument > conditionValue;
         case '>=':
-            if (lodash_default().isNil(conditionValue)) {
+            if (isNil(conditionValue)) {
                 return true;
             }
-            if (lodash_default().isNil(valueInDocument)) {
+            if (isNil(valueInDocument)) {
                 return false;
             }
             return valueInDocument >= conditionValue;
@@ -47733,17 +47782,16 @@ class AiChatbotClientFactory {
 
 
 class ApiManager {
-    constructor(clientIdService, rpcManager, apiServerUrlOverrideMapping = {}) {
+    constructor(clientIdService, rpcManager) {
         this.clientIdService = clientIdService;
         this.rpcManager = rpcManager;
-        this.apiServerUrlOverrideMapping = apiServerUrlOverrideMapping;
     }
-    callApiAndSubscribe(integrationId, endpointId, request) {
+    callApiAndSubscribe(integrationId, endpointId, request, options) {
         const callApiRequest = {
             integrationId,
             endpointId,
             request,
-            serverUrlOverride: this.apiServerUrlOverrideMapping[integrationId],
+            options,
         };
         return (0,external_rxjs_.race)((0,external_rxjs_.from)(this.rpcManager.post('api/call', callApiRequest)).pipe(map(response => {
             const parsedPayload = response.payload ? deserializeObj(response.payload) : undefined;
@@ -49104,10 +49152,10 @@ class DocumentStore {
         return this.squidDocIdToDoc.get(squidDocId);
     }
     compareValues(a, b) {
-        if (lodash_default().isNil(a)) {
-            return lodash_default().isNil(b) ? 0 : -1;
+        if (isNil(a)) {
+            return isNil(b) ? 0 : -1;
         }
-        if (lodash_default().isNil(b))
+        if (isNil(b))
             return 1;
         if (a === b)
             return 0;
@@ -50254,9 +50302,115 @@ class RateLimiter {
 ;// CONCATENATED MODULE: external "axios"
 const external_axios_namespaceObject = require("axios");
 var external_axios_default = /*#__PURE__*/__webpack_require__.n(external_axios_namespaceObject);
-;// CONCATENATED MODULE: ./src/rpc.manager.ts
+;// CONCATENATED MODULE: ./src/squid-http-client.ts
+
+
+
 
+/** @internal. */
+class RpcError extends Error {
+    constructor(statusCode, statusText, headers, url, message) {
+        super(message || `RPC error ${statusCode} ${statusText} calling ${url}`);
+        this.statusCode = statusCode;
+        this.statusText = statusText;
+        this.headers = headers;
+        this.url = url;
+    }
+}
+/**
+ * Runs a post request to the given URL.
+ * @internal.
+ */
+async function squidHttpPost({ url, headers, files, filesFieldName, message }) {
+    const isFetch = !!getSquidPrivateOption(SQUID_PRIVATE_OPTION_USE_FETCH_IN_RPC_MANAGER);
+    if (isFetch) {
+        const requestOptionHeaders = new Headers(headers);
+        const requestOptions = { method: 'POST', headers: requestOptionHeaders, body: undefined };
+        if (files.length) {
+            const formData = new FormData();
+            for (const file of files) {
+                const blob = file instanceof Blob ? file : file.blob;
+                const filename = file instanceof Blob ? undefined : file.name;
+                formData.append(filesFieldName, blob, filename);
+            }
+            formData.append('body', serializeObj(message));
+            requestOptions.body = formData;
+        }
+        else {
+            requestOptionHeaders.append('Content-Type', 'application/json');
+            requestOptions.body = serializeObj(message);
+        }
+        const response = await fetch(url, requestOptions);
+        if (!response.ok) {
+            const errorBody = await response.text();
+            const errorResponse = tryDeserializing(errorBody);
+            const errorResponseMessage = typeof errorResponse === 'string' ? errorResponse : errorResponse['message'];
+            throw new RpcError(response.status, response.statusText, response.headers, url, errorResponseMessage);
+        }
+        const responseData = await response.text();
+        const parsedResponse = tryDeserializing(responseData);
+        DebugLogger.debug(`received response: ${JSON.stringify(parsedResponse)}`);
+        return parsedResponse;
+    }
+    else {
+        let axiosResponse;
+        try {
+            if (files.length) {
+                const formData = new FormData();
+                for (const file of files) {
+                    const blob = file instanceof Blob ? file : file.blob;
+                    const filename = file instanceof Blob ? undefined : file.name;
+                    formData.append(filesFieldName, blob, filename);
+                }
+                formData.append('body', serializeObj(message));
+                // Make the axios call
+                axiosResponse = await external_axios_default().post(url, formData, {
+                    headers: Object.assign({}, headers),
+                    responseType: 'text',
+                });
+            }
+            else {
+                axiosResponse = await external_axios_default().post(url, serializeObj(message), {
+                    headers: Object.assign(Object.assign({}, headers), { 'Content-Type': 'application/json' }),
+                    responseType: 'text',
+                });
+            }
+        }
+        catch (error) {
+            if ((0,external_axios_namespaceObject.isAxiosError)(error)) {
+                const { response } = error;
+                if (!response)
+                    throw error;
+                let message;
+                try {
+                    const errorResponse = tryDeserializing(response.data);
+                    message = typeof errorResponse === 'string' ? errorResponse : errorResponse['message'];
+                }
+                catch (_a) { }
+                if (!message)
+                    message = response.statusText;
+                throw new RpcError(response.status, response.statusText, response.headers, url, message);
+            }
+            else {
+                throw error;
+            }
+        }
+        const parsedResponse = tryDeserializing(axiosResponse.data);
+        DebugLogger.debug(`received response: ${JSON.stringify(parsedResponse)}`);
+        return parsedResponse;
+    }
+}
+function tryDeserializing(text) {
+    if (!text)
+        return undefined;
+    try {
+        return deserializeObj(text);
+    }
+    catch (_a) { }
+    return text;
+}
 
+;// CONCATENATED MODULE: ./src/rpc.manager.ts
 
 
 
@@ -50323,105 +50477,16 @@ class RpcManager {
         this.onGoingRpcCounter.next(this.onGoingRpcCounter.value + 1);
         try {
             await this.getRateLimiterBucket(path).consume();
-            let headers = {};
-            if (Object.keys(this.staticHeaders)) {
-                headers = Object.assign(Object.assign({}, headers), this.staticHeaders);
-            }
             const authHeaders = await this.getAuthHeaders();
-            headers = Object.assign(Object.assign({}, headers), authHeaders);
+            const headers = Object.assign(Object.assign({}, this.staticHeaders), authHeaders);
             DebugLogger.debug(`sending request: path: ${path} message: ${JSON.stringify(message)}`);
             const url = getApplicationUrl(this.region, this.appId, path);
-            const isFetch = !!getSquidPrivateOption(SQUID_PRIVATE_OPTION_USE_FETCH_IN_RPC_MANAGER);
-            if (isFetch) {
-                const requestOptionHeaders = new Headers(headers);
-                const requestOptions = { method: 'POST', headers: requestOptionHeaders, body: undefined };
-                if (files.length) {
-                    const formData = new FormData();
-                    files.forEach(file => {
-                        const blob = file instanceof Blob ? file : file.blob;
-                        const filename = file instanceof Blob ? undefined : file.name;
-                        formData.append(filesFieldName, blob, filename);
-                    });
-                    formData.append('body', serializeObj(message));
-                    requestOptions.body = formData;
-                }
-                else {
-                    requestOptionHeaders.append('Content-Type', 'application/json');
-                    requestOptions.body = serializeObj(message);
-                }
-                const response = await fetch(url, requestOptions);
-                if (!response.ok) {
-                    const errorBody = await response.text();
-                    const errorResponse = this.tryDeserializing(errorBody);
-                    const errorResponseMessage = typeof errorResponse === 'string' ? errorResponse : errorResponse['message'];
-                    throw new RpcError(response.status, response.statusText, response.headers, url, errorResponseMessage);
-                }
-                const responseData = await response.text();
-                const parsedResponse = this.tryDeserializing(responseData);
-                DebugLogger.debug(`received response: ${JSON.stringify(parsedResponse)}`);
-                return parsedResponse;
-            }
-            else {
-                let axiosResponse;
-                try {
-                    if (files.length) {
-                        const formData = new FormData();
-                        files.forEach(file => {
-                            const blob = file instanceof Blob ? file : file.blob;
-                            const filename = file instanceof Blob ? undefined : file.name;
-                            formData.append(filesFieldName, blob, filename);
-                        });
-                        formData.append('body', serializeObj(message));
-                        // Make the axios call
-                        axiosResponse = await external_axios_default().post(url, formData, {
-                            headers: Object.assign({}, headers),
-                            responseType: 'text',
-                        });
-                    }
-                    else {
-                        axiosResponse = await external_axios_default().post(url, serializeObj(message), {
-                            headers: Object.assign(Object.assign({}, headers), { 'Content-Type': 'application/json' }),
-                            responseType: 'text',
-                        });
-                    }
-                }
-                catch (error) {
-                    if ((0,external_axios_namespaceObject.isAxiosError)(error)) {
-                        const { response } = error;
-                        if (!response)
-                            throw error;
-                        let message;
-                        try {
-                            const errorResponse = this.tryDeserializing(response.data);
-                            message = typeof errorResponse === 'string' ? errorResponse : errorResponse['message'];
-                        }
-                        catch (_a) { }
-                        if (!message)
-                            message = response.statusText;
-                        throw new RpcError(response.status, response.statusText, response.headers, url, message);
-                    }
-                    else {
-                        throw error;
-                    }
-                }
-                const parsedResponse = this.tryDeserializing(axiosResponse.data);
-                DebugLogger.debug(`received response: ${JSON.stringify(parsedResponse)}`);
-                return parsedResponse;
-            }
+            return await squidHttpPost({ url, headers, message, files, filesFieldName });
         }
         finally {
             this.onGoingRpcCounter.next(this.onGoingRpcCounter.value - 1);
         }
     }
-    tryDeserializing(text) {
-        if (!text)
-            return undefined;
-        try {
-            return deserializeObj(text);
-        }
-        catch (_a) { }
-        return text;
-    }
     getRateLimiterBucket(path) {
         if (path.startsWith('ai/chatbot')) {
             return (0,dist.truthy)(this.rateLimiters['ai'], 'MISSING_RATE_LIMITER_AI');
@@ -50432,15 +50497,6 @@ class RpcManager {
         return (0,dist.truthy)(this.rateLimiters['default'], 'MISSING_RATE_LIMITER_DEFAULT');
     }
 }
-class RpcError extends Error {
-    constructor(statusCode, statusText, headers, url, message) {
-        super(message || `RPC error ${statusCode} ${statusText} calling ${url}`);
-        this.statusCode = statusCode;
-        this.statusText = statusText;
-        this.headers = headers;
-        this.url = url;
-    }
-}
 
 ;// CONCATENATED MODULE: ./src/secret.client.ts
 class SecretClient {
@@ -50900,7 +50956,7 @@ class AiAssistantClient {
      * @param name - The name of the assistant.
      * @param instructions - Instructions for the assistant.
      * @param functions - Array of function names annotated with "@aiFunction" in your Squid backend that will be
-     *   available tol the assistant.
+     *   available to the assistant.
      * @param toolTypes - Optional array of tool types. If you want to use files for retrieval, you must add them using
      *   the addFileToAssistant method.
      * @returns A promise that resolves to the created assistant's ID.
@@ -51356,7 +51412,7 @@ class Squid {
         this.documentReferenceFactory.setDataManager(this.dataManager);
         this.backendFunctionManager = new BackendFunctionManager(this.clientIdService, this.rpcManager);
         this.nativeQueryManager = new NativeQueryManager(this.rpcManager);
-        this.apiManager = new ApiManager(this.clientIdService, this.rpcManager, options.apiServerUrlOverrideMapping);
+        this.apiManager = new ApiManager(this.clientIdService, this.rpcManager);
         this.graphqlClientFactory = new GraphQLClientFactory(this.rpcManager, options.region, appId);
         this.secretClient = new SecretClient(this.rpcManager);
         this._connectionDetails = new ConnectionDetails(this.clientIdService, this.socketManager);
@@ -51474,12 +51530,13 @@ class Squid {
      * @param integrationId The id of the integration that the API is defined with.
      * @param endpointId The id of the endpoint in the API integration.
      * @param request The request parameters to pass to the API.
+     * @param options optional options for the API call.
      * @returns A promise that resolves with the response of the API.
      * @typeParam T The type of the response of the API.
      */
-    callApi(integrationId, endpointId, request = {}) {
+    callApi(integrationId, endpointId, request = {}, options) {
         this._validateNotDestructed();
-        return (0,external_rxjs_.firstValueFrom)(this.apiManager.callApiAndSubscribe(integrationId, endpointId, request));
+        return (0,external_rxjs_.firstValueFrom)(this.apiManager.callApiAndSubscribe(integrationId, endpointId, request, options || {}));
     }
     /**
      * Returns a GraphQL client for the given integration. The GraphQL client can be used to execute GraphQL queries and

package/dist/internal-common/src/public-types/api-call.public-context.d.ts

@@ -10,5 +10,21 @@ export declare class ApiCallContext {
     readonly body: Record<string, any>;
     readonly queryParams: Record<string, string | number | boolean>;
     readonly pathParams: Record<string, string>;
-    readonly serverUrlOverride: string | undefined;
+    readonly options: ApiOptions;
+}
+/** The options for calling an API. */
+export interface ApiOptions {
+    /** If true, the response will be returned as-is without any processing. */
+    nativeResponse?: boolean;
+    /**
+     * An optional string to override the default origin of the API (e.g. https://host:port). Useful for
+     * scenarios such as testing, development, or accessing the API from different environments.
+     */
+    originOverride?: string;
+}
+/** A native API call response. */
+export interface NativeApiCallResponse<T = unknown> {
+    body: T;
+    headers: ApiHeaders;
+    status: number;
 }

package/dist/internal-common/src/public-types/bundle-api.public-types.d.ts

@@ -30,6 +30,56 @@ export interface TriggerRequest<T extends DocumentData = any> {
     docAfter?: T;
 }
 export type SchedulerAction = () => void | Promise<void>;
+export type LimitedAction = () => any | Promise<any>;
+export type LimiterScope = 'ip' | 'user' | 'global';
+export type QuotaRenewPeriod = 'hourly' | 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'annually';
+/**
+ * Options for rate limiting.
+ *
+ * @param value Number of executions permitted per second. Note that we
+ *              permit bursts of up to 3x the specified limit.
+ *  @param scope What this limit applies to: per user? per IP? global?
+ */
+export interface RateLimitOptions {
+    value: number;
+    scope?: LimiterScope;
+}
+/**
+ * Options for quota limiting.
+ *
+ * @param value Number of total executions allowed. Note that this would be
+ *              reset upon any redeployment of the backend.
+ *  @param scope What this limit applies to: per user? per IP? global?
+ */
+export interface QuotaLimitOptions {
+    value: number;
+    scope?: LimiterScope;
+    renewPeriod?: QuotaRenewPeriod;
+}
+/**
+ * Options for rate and quota limiting backend functions.
+ *
+ * This mirrors the type in Kotlin. It is not the type the developer defines in their code, which is LimiterConfig.
+ *
+ * @param rateLimit RateLimitOptions configurations. Allows for different limits at different scopes.
+ * @param quotaLimit QuotaLimitOptions configurations. Allows for different limits at different scopes.
+ */
+export interface LimiterOptions {
+    rateLimit?: RateLimitOptions[];
+    quotaLimit?: QuotaLimitOptions[];
+}
+export type LimiterConfig = {
+    rateLimit?: number | RateLimitOptions | Array<RateLimitOptions>;
+    quotaLimit?: number | QuotaLimitOptions | Array<QuotaLimitOptions>;
+};
+/**
+ * Convert LimiterConfig to LimiterOptions.
+ *
+ * This decouples the required syntax for the developer from the internal implementation.
+ *
+ * @param config LimiterConfig to convert.
+ */
+export declare function limiterConfigToOptions(config: LimiterConfig): LimiterOptions;
 export type WebhookAction = ((request: WebhookRequest) => any) | (() => any);
 /** The context provided to a webhook function. */
 export interface WebhookRequest<T = any> {

package/dist/internal-common/src/utils/object.d.ts

@@ -3,3 +3,4 @@ export declare function setInPath(obj: object, path: string, value: unknown, del
 export declare function deleteInPath(obj: object, path: string, delimiter?: string): void;
 export declare function replaceKeyInMap<K, T>(map: Map<K, T | undefined>, a: K, b: K): void;
 export declare function replaceKeyInRecord<K extends keyof any, T>(record: Record<K, T>, a: K, b: K): void;
+export declare function isNil(obj: unknown): obj is null | undefined;

package/dist/typescript-client/src/ai-assistant-client.d.ts

@@ -14,7 +14,7 @@ export declare class AiAssistantClient {
      * @param name - The name of the assistant.
      * @param instructions - Instructions for the assistant.
      * @param functions - Array of function names annotated with "@aiFunction" in your Squid backend that will be
-     *   available tol the assistant.
+     *   available to the assistant.
      * @param toolTypes - Optional array of tool types. If you want to use files for retrieval, you must add them using
      *   the addFileToAssistant method.
      * @returns A promise that resolves to the created assistant's ID.

package/dist/typescript-client/src/ai-chatbot-client.d.ts

@@ -113,7 +113,7 @@ declare class AiChatbotContextReference {
      * Updates an existing context entry on the chatbot profile. This will result in an error if an entry has not yet
      * been created for the current context id.
      *
-     * @param data An object containing options for updated the entry.
+     * @param data An object containing options for updating the entry.
      * @param data.title - The title of the entry.
      * @param data.context - The context data.
      * @returns A promise that resolves when the context is successfully updated.
@@ -150,7 +150,7 @@ declare class AiChatbotInstructionReference {
      * Updates an existing instruction entry on the chatbot profile. This will result in an error if an entry has not
      * yet been created for the current instruction id.
      *
-     * @param data An object containing options for updated the entry.
+     * @param data An object containing options for updating the entry.
      * @param data.instruction - The instruction data.
      * @returns A promise that resolves when the instruction is successfully updated.
      */

package/dist/typescript-client/src/api.manager.d.ts

@@ -1,11 +1,10 @@
 import { Observable } from 'rxjs';
 import { RpcManager } from './rpc.manager';
 import { ClientIdService } from './client-id.service';
-import { ApiEndpointId, IntegrationId } from './public-types';
+import { ApiEndpointId, ApiOptions, IntegrationId } from './public-types';
 export declare class ApiManager {
     private readonly clientIdService;
     private readonly rpcManager;
-    private readonly apiServerUrlOverrideMapping;
-    constructor(clientIdService: ClientIdService, rpcManager: RpcManager, apiServerUrlOverrideMapping?: Record<IntegrationId, string>);
-    callApiAndSubscribe<T>(integrationId: IntegrationId, endpointId: ApiEndpointId, request: Record<string, any>): Observable<T>;
+    constructor(clientIdService: ClientIdService, rpcManager: RpcManager);
+    callApiAndSubscribe<T>(integrationId: IntegrationId, endpointId: ApiEndpointId, request: Record<string, any>, options: ApiOptions): Observable<T>;
 }

package/dist/typescript-client/src/rpc.manager.d.ts

@@ -18,13 +18,5 @@ export declare class RpcManager {
     deleteStaticHeader(key: string): void;
     getStaticHeaders(): Record<string, string>;
     post<T>(path: string, message: unknown, files?: Array<File | BlobAndFilename>, filesFieldName?: string): Promise<T>;
-    private tryDeserializing;
     private getRateLimiterBucket;
 }
-export declare class RpcError extends Error {
-    readonly statusCode: number;
-    readonly statusText: string;
-    readonly headers: Headers;
-    readonly url: string;
-    constructor(statusCode: number, statusText: string, headers: Headers, url: string, message?: string);
-}

package/dist/typescript-client/src/squid-http-client.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/typescript-client/src/squid.d.ts

@@ -5,7 +5,7 @@ import { GraphQLClient } from './graphql-client';
 import { SecretClient } from './secret.client';
 import { TransactionId } from './types';
 import { AiClient } from './ai.types';
-import { ApiEndpointId, ApiKey, AppId, CollectionName, DocumentData, EnvironmentId, IntegrationId, SquidDeveloperId, SquidRegion } from './public-types';
+import { ApiEndpointId, ApiKey, AppId, ApiOptions, CollectionName, DocumentData, EnvironmentId, IntegrationId, NativeApiCallResponse, SquidDeveloperId, SquidRegion } from './public-types';
 import { QueueManager } from './queue.manager';
 /** The different options that can be used to initialize a Squid instance. */
 export interface SquidOptions {
@@ -48,11 +48,6 @@ export interface SquidOptions {
      * The user ID of the developer that runs the environment locally.
      */
     squidDeveloperId?: SquidDeveloperId;
-    /**
-     * A list of API endpoints that can be used for overriding the default API endpoints for the different integrations.
-     * This is useful for APIs that have multiple base urls hosted in different regions.
-     */
-    apiServerUrlOverrideMapping?: Record<IntegrationId, string>;
 }
 /** Authentication data provider for Squid requests. */
 export interface SquidAuthProvider {
@@ -188,21 +183,12 @@ export declare class Squid {
      * @type {Promise<Array<SquidDocument>>}
      */
     executeNativeRelationalQuery<T = any>(integrationId: IntegrationId, query: string, params?: Record<string, any>): Promise<Array<T>>;
-    /**
-     * Invokes the given HTTP API (defined by the integration ID and the endpoint ID) with the given request parameters
-     * and returns a promise with the response. The structure of the request and the response is defined in the
-     * integration's schema page.
-     *
-     * For more information about API integrations in Squid, please refer to the
-     * {@link https://docs.squid.cloud/docs/integrations/api/httpapi documentation}.
-     *
-     * @param integrationId The id of the integration that the API is defined with.
-     * @param endpointId The id of the endpoint in the API integration.
-     * @param request The request parameters to pass to the API.
-     * @returns A promise that resolves with the response of the API.
-     * @typeParam T The type of the response of the API.
-     */
-    callApi<T = any>(integrationId: IntegrationId, endpointId: ApiEndpointId, request?: Record<string, any>): Promise<T>;
+    callApi<T = any>(integrationId: IntegrationId, endpointId: ApiEndpointId, request?: Record<string, any>, options?: Omit<ApiOptions, 'nativeResponse'> | (ApiOptions & {
+        nativeResponse: false;
+    })): Promise<T>;
+    callApi<T = any>(integrationId: IntegrationId, endpointId: ApiEndpointId, request?: Record<string, any>, options?: ApiOptions & {
+        nativeResponse: true;
+    }): Promise<NativeApiCallResponse<T>>;
     /**
      * Returns a GraphQL client for the given integration. The GraphQL client can be used to execute GraphQL queries and
      * mutations. For more information about GraphQL in Squid, please refer to the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.175",
+  "version": "1.0.177",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "types": "dist/typescript-client/src/index.d.ts",
@@ -21,7 +21,8 @@
     "test:cov": "jest --coverage",
     "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
     "test:e2e": "jest --config ./test/jest-e2e.json",
-    "publish:public": "npm run build && npm publish --access public"
+    "publish:public": "npm run build && npm publish --access public",
+    "full-bundle-size-report": "cross-env BUILD_FULL_BUNDLE_SIZE_REPORT=1 webpack --mode=production"
   },
   "keywords": [
     "typescript",