@nizza/core 0.8.0 → 0.8.1-beta.0

package/dist/lib/accounts/core/infrastructure/repositories/rest-account-plan.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-account-plan.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/accounts/core/infrastructure/repositories/rest-account-plan.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EAErB,SAAS,EACV,MAAM,cAAc,CAAC;AAItB,qBAAa,yBAA0B,YAAW,qBAAqB;IAC/D,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAa3D,MAAM,CAAC,KAAK,EAAE,SAAS;CAY9B"}
+{"version":3,"file":"rest-account-plan.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/accounts/core/infrastructure/repositories/rest-account-plan.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EAErB,SAAS,EACV,MAAM,cAAc,CAAC;AAEtB,qBAAa,yBAA0B,YAAW,qBAAqB;IAC/D,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAU3D,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAW9C"}

package/dist/lib/accounts/core/infrastructure/repositories/rest-private-account.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-private-account.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/accounts/core/infrastructure/repositories/rest-private-account.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAM7E,qBAAa,4BAA6B,YAAW,wBAAwB;IACrE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAWhE"}
+{"version":3,"file":"rest-private-account.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/accounts/core/infrastructure/repositories/rest-private-account.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI7E,qBAAa,4BAA6B,YAAW,wBAAwB;IACrE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAShE"}

package/dist/lib/accounts/core/infrastructure/repositories/rest-public-account.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-public-account.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/accounts/core/infrastructure/repositories/rest-public-account.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAMrE,qBAAa,2BAA4B,YAAW,uBAAuB;IACnE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAUzD"}
+{"version":3,"file":"rest-public-account.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/accounts/core/infrastructure/repositories/rest-public-account.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAIrE,qBAAa,2BAA4B,YAAW,uBAAuB;IACnE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAQzD"}

package/dist/lib/api-client/client.d.ts

@@ -0,0 +1,192 @@
+import { Variables as LibGraphQLVariables } from 'graphql-request';
+import { ApiClientConfig, GraphQLDocument, GraphQLRequestOptions, RawApiResponse, RestRequestConfig, StandardRestResponse } from './types';
+/**
+ * ApiClient is a unified HTTP client for making REST and GraphQL requests.
+ * It provides a consistent, library-agnostic interface, robust error handling,
+ * and configurable options for authentication, timeouts, and request cancellation.
+ *
+ * ## How to Use ApiClient
+ *
+ * 1.  **Prerequisites:**
+ * * Ensure you have an implementation of the `Logger` interface (e.g., from `../logger`).
+ * * Define a `GetAuthTokenFn` function if you need authenticated requests.
+ *
+ * 2.  **Import necessary items:**
+ * ```typescript
+ * import {
+ * ApiClient,
+ * type ApiClientConfig,
+ * // ... other types and errors
+ * } from './api-client'; // Adjust path to your api-client module
+ * import type { Logger } from '../logger'; // Adjust path
+ * // import { yourGetAuthTokenImplementation } from './auth';
+ * // import { myLoggerInstance } from './logging';
+ * ```
+ *
+ * 3.  **Define `getAuthToken` function (if using secure requests):**
+ * ```typescript
+ * const getMyAuthToken: GetAuthTokenFn = async () => {
+ * // Example: return (await Auth.currentSession()).getIdToken().getJwtToken();
+ * return 'your-actual-jwt-token-or-null';
+ * };
+ * ```
+ *
+ * 4.  **Create an `ApiClientConfig`:**
+ * ```typescript
+ * const apiClientConfig: ApiClientConfig = {
+ * restApiBaseUrl: '[https://api.example.com/v1](https://api.example.com/v1)', // Required
+ * graphqlApiBaseUrl: '[https://api.example.com/graphql](https://api.example.com/graphql)', // Required
+ * logger: myLoggerInstance, // Required
+ * defaultTimeout: 20000, // Optional
+ * getAuthToken: getMyAuthToken, // Optional, for secure requests
+ * };
+ * ```
+ *
+ * 5.  **Instantiate `ApiClient`:**
+ * ```typescript
+ * const apiClient = new ApiClient(apiClientConfig);
+ * ```
+ * It's highly recommended to create a single instance and reuse it.
+ *
+ * 6.  **Making REST Requests (`rest` method):**
+ * See the JSDoc for the `rest` method for detailed examples on object responses,
+ * array/primitive responses (using `_rawData`), and raw responses.
+ *
+ * 7.  **Making GraphQL Requests (`graphql` method):**
+ * See the JSDoc for the `graphql` method for detailed examples.
+ *
+ * ## Error Handling
+ * The `ApiClient` throws custom error types extending `ApiError` (e.g., `RestApiError`,
+ * `GraphQLApiError`, `TimeoutError`, `NetworkError`). Use `instanceof` for granular
+ * error handling.
+ *
+ * ## `_rawData` Field in REST Responses
+ * When `raw: false` and the API response body isn't a plain object, the `_rawData`
+ * field in the returned object holds the original parsed data.
+ */
+export declare class ApiClient {
+    private readonly logger;
+    private readonly defaultTimeout;
+    private readonly getAuthTokenFn;
+    private readonly axiosInstance;
+    private readonly graphqlClient;
+    readonly restBaseUrl: string;
+    readonly graphqlApiBaseUrl: string;
+    /**
+     * Creates an instance of ApiClient.
+     * @param {ApiClientConfig} config - Configuration for the ApiClient.
+     * `restApiBaseUrl`, `graphqlApiBaseUrl`, and `logger` are required.
+     * @throws {Error} If required configuration properties are missing.
+     */
+    constructor(config: ApiClientConfig);
+    /**
+     * Performs a REST request and returns a library-agnostic raw response.
+     * Use this when you need access to status codes, headers, or non-JSON response bodies.
+     *
+     * @template TData The expected type of the raw response body (e.g., string, ArrayBuffer).
+     * @param {RestRequestConfig & { raw: true }} config Configuration for the REST request, with `raw` set to true.
+     * @returns {Promise<RawApiResponse<TData>>} A promise resolving to a `RawApiResponse` object.
+     * @throws {RestApiError | TimeoutError | NetworkError | ApiError} Throws a custom API error on failure.
+     */
+    rest<TData = any>(config: RestRequestConfig & {
+        raw: true;
+    }): Promise<RawApiResponse<TData>>;
+    /**
+     * Performs a REST request and returns a processed response compatible with legacy customFetch.
+     * This is the default behavior.
+     *
+     * @template TData The expected type of the data in the JSON response body.
+     * @param {RestRequestConfig} config Configuration for the REST request. `raw` should be falsy.
+     * @returns {Promise<StandardRestResponse<TData>>}
+     * A promise resolving to an object:
+     * - If TData is an object: `TData` spread with `success` and `statusCode`.
+     * - If TData is not an object: `{ _rawData: TData, success: boolean, statusCode: number }`.
+     * @throws {RestApiError | TimeoutError | NetworkError | ApiError} Throws a custom API error on failure.
+     */
+    rest<TData = any>(config: RestRequestConfig & {
+        raw?: false | undefined;
+    }): Promise<StandardRestResponse<TData>>;
+    /**
+     * Performs a GraphQL request with improved type inference using TypedDocumentNode.
+     * If a plain string or a non-typed DocumentNode is passed, TResult (response data type)
+     * will default to `any` unless explicitly provided by the caller.
+     *
+     * @template TResult The expected shape of the data returned by the GraphQL query/mutation.
+     * This is often inferred if a TypedDocumentNode is provided as the `document`.
+     * @template TVars The shape of the variables object for the GraphQL query/mutation.
+     * This is also often inferred if a TypedDocumentNode is provided.
+     * @param {GraphQLDocument<TResult, TVars>} document The GraphQL query or mutation.
+     * Your `GraphQLDocument` type should be `string | LibGraphQLRequestDocument | TypedDocumentNode<TResult, TVars>`.
+     * @param {TVars} [variables] An object containing variables for the GraphQL request.
+     * The type should match the variables expected by the document.
+     * @param {GraphQLRequestOptions} [options={}] Optional configurations for this GraphQL request.
+     * @returns {Promise<TResult>} A promise that resolves to the typed data from the GraphQL response.
+     * @throws {GraphQLApiError | TimeoutError | NetworkError | ApiError} Throws a custom API error on failure.
+     *
+     * @example
+     * // Assuming GetUserDocument is a TypedDocumentNode<UserData, UserVars>
+     * // const { user } = await apiClient.graphql(GetUserDocument, { id: "123" });
+     * // console.log(user.name); // user and its properties are strongly typed
+     *
+     * // With a string query, explicit types are needed for TResult if not 'any'
+     * // const { specificField } = await apiClient.graphql<{ specificField: string }>(
+     * //   "query { specificField }",
+     * // );
+     * // console.log(specificField);
+     */
+    graphql<TResult = any, TVars extends LibGraphQLVariables = LibGraphQLVariables>(document: GraphQLDocument<TResult, TVars>, variables?: TVars, options?: GraphQLRequestOptions): Promise<TResult>;
+    /**
+     * Executes the actual REST request using the configured Axios instance.
+     * @private
+     */
+    private executeRestRequest;
+    /**
+     * Processes a successful standard (non-raw) REST response into the customFetch-compatible format.
+     * @private
+     */
+    private processStandardRestResponse;
+    /**
+     * Handles errors from REST requests, transforming them into custom ApiError types.
+     * This method always throws.
+     * @private
+     * @returns {never}
+     */
+    private handleRestError;
+    /**
+     * Executes the actual GraphQL request using the configured GraphQLClient instance.
+     * @private
+     */
+    private executeGraphQLRequest;
+    /**
+     * Handles errors from GraphQL requests, transforming them into custom ApiError types.
+     * This method always throws.
+     * @private
+     * @returns {never}
+     */
+    private handleGraphQLError;
+    /**
+     * Retrieves the JWT authentication token using the injected `getAuthTokenFn`.
+     * @private
+     * @returns {Promise<string | null>} The JWT token or null if unavailable/error.
+     */
+    private getAuthToken;
+    /**
+     * Prepares request headers, primarily for authentication.
+     * It merges existing headers with authentication headers if `secure` is true.
+     * @private
+     * @param options Configuration for header preparation, including security flags and existing headers.
+     * @returns {Promise<Record<string, string>>} The prepared headers.
+     */
+    private prepareAuthHeaders;
+    /**
+     * Creates and manages a combined AbortSignal for request timeout and external cancellation.
+     * Uses `createCombinedSignal` utility.
+     * @private
+     * @param externalSignal An optional AbortSignal provided by the caller.
+     * @param requestTimeout The timeout duration for this specific request.
+     * @returns An object containing the `operationSignal` to be used for the request,
+     * and a `clearInternalTimeout` function to clear any internal timers.
+     */
+    private createAbortSignal;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/api-client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lib/api-client/client.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,SAAS,IAAI,mBAAmB,EACtC,MAAM,iBAAiB,CAAC;AASzB,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC;;;;;OAKG;gBACS,MAAM,EAAE,eAAe;IA6CnC;;;;;;;;OAQG;IACU,IAAI,CAAC,KAAK,GAAG,GAAG,EAC3B,MAAM,EAAE,iBAAiB,GAAG;QAAE,GAAG,EAAE,IAAI,CAAA;KAAE,GACxC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAEjC;;;;;;;;;;;OAWG;IACU,IAAI,CAAC,KAAK,GAAG,GAAG,EAC3B,MAAM,EAAE,iBAAiB,GAAG;QAAE,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;KAAE,GACtD,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IA+DvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,OAAO,CAClB,OAAO,GAAG,GAAG,EACb,KAAK,SAAS,mBAAmB,GAAG,mBAAmB,EAEvD,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,EACzC,SAAS,CAAC,EAAE,KAAK,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC;IAiCnB;;;OAGG;YACW,kBAAkB;IAMhC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAyBnC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAsDvB;;;OAGG;YACW,qBAAqB;IAOnC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IA2C1B;;;;OAIG;YACW,YAAY;IAa1B;;;;;;OAMG;YACW,kBAAkB;IA0ChC;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;CAuC1B"}

package/dist/lib/api-client/errors.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file errors.ts
+ * @description Defines custom error classes for the ApiClient.
+ * These errors provide a consistent, library-agnostic way to handle issues
+ * arising from API requests.
+ */
+/**
+ * Base class for all custom errors originating from the ApiClient.
+ * It includes an optional `originalError` property for debugging purposes.
+ */
+export declare class ApiError extends Error {
+    /** The original error object, useful for debugging underlying issues. */
+    readonly originalError?: any;
+    /** Discriminator property to easily identify errors from this client. */
+    readonly isApiClientError: boolean;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Represents an error due to a request timeout.
+ */
+export declare class TimeoutError extends ApiError {
+    constructor(message?: string, originalError?: any);
+}
+/**
+ * Represents an error due to network issues (e.g., connectivity problems).
+ */
+export declare class NetworkError extends ApiError {
+    constructor(message?: string, originalError?: any);
+}
+/**
+ * Contextual information for a REST API error response.
+ */
+export interface RestApiResponseErrorContext {
+    status: number;
+    data: any;
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * Represents an error specific to a REST API request,
+ * often including details from the HTTP response.
+ */
+export declare class RestApiError extends ApiError {
+    readonly response?: RestApiResponseErrorContext;
+    constructor(message: string, response?: RestApiResponseErrorContext, originalError?: any);
+}
+/**
+ * Contextual information for a GraphQL API error response.
+ */
+export interface GraphQLResponseErrorContext {
+    status?: number;
+    data?: any;
+    errors?: Array<{
+        message: string;
+        [key: string]: any;
+    }>;
+}
+/**
+ * Represents an error specific to a GraphQL API request,
+ * often including GraphQL-specific error details.
+ */
+export declare class GraphQLApiError extends ApiError {
+    readonly response?: GraphQLResponseErrorContext;
+    constructor(message: string, response?: GraphQLResponseErrorContext, originalError?: any);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/api-client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/api-client/errors.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,yEAAyE;IACzE,SAAgB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpC,yEAAyE;IACzE,SAAgB,gBAAgB,EAAE,OAAO,CAAQ;gBAErC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG;CAOjD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,SAAsB,EAAE,aAAa,CAAC,EAAE,GAAG;CAG/D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,SAA6B,EAAE,aAAa,CAAC,EAAE,GAAG;CAGtE;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,SAAgB,QAAQ,CAAC,EAAE,2BAA2B,CAAC;gBAGrD,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,2BAA2B,EACtC,aAAa,CAAC,EAAE,GAAG;CAKtB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,SAAgB,QAAQ,CAAC,EAAE,2BAA2B,CAAC;gBAGrD,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,2BAA2B,EACtC,aAAa,CAAC,EAAE,GAAG;CAKtB"}

package/dist/lib/api-client/index.d.ts

@@ -0,0 +1,4 @@
+export * from './client';
+export * from './errors';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/api-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/api-client/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/lib/api-client/types.d.ts

@@ -0,0 +1,132 @@
+import { TypedDocumentNode } from '@graphql-typed-document-node/core';
+import { DocumentNode as LibGraphQLRequestDocument } from 'graphql';
+import { Logger } from '../logger';
+/**
+ * Signature for a function that retrieves an authentication token.
+ * @returns A Promise resolving to the token string or null if unavailable.
+ */
+export type GetAuthTokenFn = () => Promise<string | null>;
+/**
+ * Configuration for the ApiClient constructor.
+ */
+export interface ApiClientConfig {
+    /** Base URL for REST API requests. This is a **required** field. */
+    restApiBaseUrl: string;
+    /** Base URL for GraphQL API requests. This is a **required** field. */
+    graphqlApiBaseUrl: string;
+    /** A Logger instance conforming to the Logger interface. This is a **required** field. */
+    logger: Logger;
+    /** Default timeout in milliseconds for all requests. Defaults to 30000 (30s). */
+    defaultTimeout?: number;
+    /**
+     * An optional function to retrieve the authentication token.
+     * Strongly recommended if you intend to make secure requests (`secure: true`).
+     * If not provided, secure calls will attempt to proceed without a token unless this function is a no-op.
+     */
+    getAuthToken?: GetAuthTokenFn;
+}
+/**
+ * Base options applicable to authenticated requests and timeout/cancellation.
+ */
+interface BaseRequestOptions {
+    /** If true, the request will attempt to include an Authorization token. Defaults to false. */
+    secure?: boolean;
+    /** Account identifier, often included in a custom header (e.g., 'ls-account') if 'secure' is true. */
+    account?: string;
+    /** Request-specific timeout in milliseconds. Overrides `defaultTimeout`. */
+    timeout?: number;
+    /** An AbortSignal to allow for external cancellation of the request. */
+    signal?: AbortSignal;
+}
+/**
+ * Configuration for a REST request made via the `apiClient.rest()` method.
+ */
+export interface RestRequestConfig extends BaseRequestOptions {
+    /**
+     * Relative path for the REST request (e.g., 'users/1').
+     * If not provided, it is assumed that path = "" but it is necessary to provide baseURL
+     */
+    path?: string;
+    /** Overrides the ApiClient's instance-level `restApiBaseUrl` for this single request. */
+    baseURL?: string;
+    /** HTTP method for the request. */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD';
+    /** Request body, typically for 'POST', 'PUT', 'PATCH' methods. */
+    body?: any;
+    /** Query parameters to be appended to the URL. */
+    queryParams?: Record<string, any>;
+    /** Custom headers for this specific request. */
+    headers?: Record<string, string>;
+    /**
+     * If true, returns a library-agnostic `RawApiResponse` object.
+     * If false (default), returns a `customFetch`-compatible structure (see `ApiClient.rest` method docs).
+     */
+    raw?: boolean;
+    /**
+     * The expected type of the response data.
+     * For `raw: false`, this is typically 'json'.
+     * For `raw: true`, common values are 'text', 'arraybuffer', 'blob', 'stream'.
+     * This influences how the underlying HTTP client processes the response body.
+     */
+    responseType?: 'json' | 'text' | 'arraybuffer' | 'blob' | 'stream';
+}
+/**
+ * Defines the structure for a "raw" API response.
+ * This is used when `raw: true` is specified in `RestRequestConfig`.
+ * @template TData The expected type of the raw response data.
+ */
+export interface RawApiResponse<TData = any> {
+    status: number;
+    data: TData;
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * The structure returned by the `ApiClient.rest` method when `raw` is `false`
+ * and the response data from the API is not a plain JavaScript object (e.g., an array or primitive).
+ * In such cases, `_rawData` contains the original parsed response data.
+ */
+export type NonObjectRestResponse<TData> = {
+    _rawData: TData;
+    success: boolean;
+    statusCode: number;
+};
+export type CustomFieldsRestResponse = {
+    success: boolean;
+    statusCode: number;
+};
+/**
+ * A utility type that evaluates to `true` if T is a plain, "spreadable" object,
+ * and `false` otherwise (e.g., for arrays, functions, dates, primitives).
+ * This is an internal helper type for StandardRestResponse.
+ * @template T The type to check.
+ */
+type IsSpreadableObject<T> = T extends any[] | Date | Function ? false : T extends object ? true : false;
+/**
+ * Represents the standard (non-raw) processed response from `ApiClient.rest`.
+ * It intelligently adapts its structure based on whether TData is a plain object or not.
+ *
+ * - If `TData` is a plain object, the response will be `TData & { success, statusCode }`.
+ * - If `TData` is an array, primitive, or other non-plain object, the response will be `NonObjectRestResponse<TData>`.
+ *
+ * @template TData The expected type of the data in the response body.
+ */
+export type StandardRestResponse<TData> = IsSpreadableObject<TData> extends true ? TData & CustomFieldsRestResponse : NonObjectRestResponse<TData>;
+/**
+ * Configuration options for a GraphQL request made via `apiClient.graphql()`.
+ */
+export interface GraphQLRequestOptions extends BaseRequestOptions {
+    /** Custom headers for this specific GraphQL request. Can be a plain object or HeadersInit. */
+    headers?: Record<string, string> | HeadersInit;
+}
+/**
+ * Represents the GraphQL document, which can be a string or a parsed AST Node.
+ * `LibGraphQLRequestDocument` is typically `graphql.DocumentNode`.
+ */
+export type GraphQLDocument<TResult = any, TVariables = Record<string, any>> = string | LibGraphQLRequestDocument | TypedDocumentNode<TResult, TVariables>;
+/**
+ * Represents variables for a GraphQL request.
+ * It's an object where keys are variable names and values are their corresponding values.
+ */
+export type GraphQLVariables = Record<string, any>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/api-client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/api-client/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/api-client/utils.d.ts

@@ -0,0 +1,17 @@
+import { AxiosResponse } from 'axios';
+/**
+ * Creates a single AbortSignal that aborts when any of the provided signals abort,
+ * or if any of the signals are already aborted.
+ * Uses AbortSignal.any() if available, otherwise provides a basic fallback.
+ * Filters out undefined/null signals before processing.
+ *
+ * @param signals An array of AbortSignal instances (can include undefined).
+ * @returns A single AbortSignal, or undefined if no valid signals are provided.
+ */
+export declare function createCombinedSignal(signals: (AbortSignal | undefined)[]): AbortSignal | undefined;
+/**
+ * Normalizes Axios headers to the format expected by RawApiResponse.
+ * AxiosHeaderValue can be string, number, boolean, or null. We want string, string[], or undefined.
+ */
+export declare function normalizeAxiosHeaders(headers: AxiosResponse['headers']): Record<string, string | string[] | undefined>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/api-client/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/api-client/utils.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GACnC,WAAW,GAAG,SAAS,CAmCzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAmB/C"}

package/dist/lib/constants/products.d.ts

@@ -5,7 +5,6 @@ export declare enum NizzaVariationTypes {
 export declare enum NizzaProductRequestOriginTypes {
     VTEX = "VTEX",
     PLATFORM = "platform",
-    CACE = "CACE",
     GLOBAL_PAGE = "globalPage",
     CUSTOMIZATION = "customization",
     FAST_STORE = "faststore",

package/dist/lib/constants/products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/lib/constants/products.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,KAAK,WAAW;CACjB;AAED,oBAAY,8BAA8B;IACxC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,WAAW,eAAe;IAC1B,aAAa,kBAAkB;IAC/B,UAAU,cAAc;IACxB,OAAO,YAAY;CACpB"}
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/lib/constants/products.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,KAAK,WAAW;CACjB;AAED,oBAAY,8BAA8B;IACxC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,WAAW,eAAe;IAC1B,aAAa,kBAAkB;IAC/B,UAAU,cAAc;IACxB,OAAO,YAAY;CACpB"}

package/dist/lib/index.d.ts

@@ -1,5 +1,6 @@
 export * from './accounts';
 export * from './add-to-cart';
+export * from './api-client';
 export * from './clean-architecture';
 export * from './constants';
 export * from './dependency-injector';

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/lib/ivs/socket/core/infrastructure/graphql-event-chat-room.repository.d.ts

@@ -1,8 +1,6 @@
 import { EventChatRoomRepository, GetChatRoomInput } from '../domain';
 import { EventChatRoom } from '../domain/entities';
 export declare class GraphqlEventChatRoomRepository implements EventChatRoomRepository {
-    private client;
-    constructor();
     getChatRoom(input: GetChatRoomInput): Promise<EventChatRoom>;
     private propagateGraphqlErrorIfExists;
 }

package/dist/lib/ivs/socket/core/infrastructure/graphql-event-chat-room.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-event-chat-room.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/ivs/socket/core/infrastructure/graphql-event-chat-room.repository.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EAEvB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,qBAAa,8BAA+B,YAAW,uBAAuB;IAC5E,OAAO,CAAC,MAAM,CAAgB;;IAMxB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBlE,OAAO,CAAC,6BAA6B;CAGtC"}
+{"version":3,"file":"graphql-event-chat-room.repository.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/ivs/socket/core/infrastructure/graphql-event-chat-room.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,EAEvB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,qBAAa,8BAA+B,YAAW,uBAAuB;IACtE,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBlE,OAAO,CAAC,6BAA6B;CAGtC"}

package/dist/lib/logger/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,gBAAgB,CAO7D,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,gBAAgB,CAO7D,CAAC"}

package/dist/lib/logger/core/loggers/http.logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.logger.d.ts","sourceRoot":"","sources":["../../../../../src/lib/logger/core/loggers/http.logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAiB7C,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,OAAO,CAAC,aAAa;YAWP,KAAK;YA2BL,gBAAgB;YAWhB,YAAY;IAM1B,OAAO,CAAC,sBAAsB;YAwBhB,QAAQ;IAStB,OAAO,CAAC,YAAY;YAIN,UAAU;IAKxB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;YAYL,cAAc;IAK5B,OAAO,CAAC,mBAAmB;CAiB5B"}
+{"version":3,"file":"http.logger.d.ts","sourceRoot":"","sources":["../../../../../src/lib/logger/core/loggers/http.logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAIrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAiB7C,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,OAAO,CAAC,aAAa;YAWP,KAAK;YA2BL,gBAAgB;YAWhB,YAAY;IAM1B,OAAO,CAAC,sBAAsB;YAwBhB,QAAQ;IAQtB,OAAO,CAAC,YAAY;YAWN,UAAU;IAKxB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;YAYL,cAAc;IAK5B,OAAO,CAAC,mBAAmB;CAiB5B"}