celitech-sdk 2.0.7 → 2.0.10

package/dist/index.d.mts

@@ -0,0 +1,2664 @@
+import { ZodType, z } from 'zod';
+
+/**
+ * Available API environments with their base URLs.
+ * Use these constants to configure the SDK for different environments (production, staging, etc.).
+ */
+declare enum Environment {
+    /** DEFAULT environment base URL */
+    DEFAULT = "https://api.celitech.net/v1"
+}
+
+/**
+ * Standard HTTP methods supported by the SDK.
+ */
+type HttpMethod$1 = 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
+/**
+ * Represents an HTTP request with all its components.
+ */
+interface HttpRequest {
+    /** Base URL of the API endpoint */
+    baseUrl: string;
+    /** HTTP method for the request */
+    method: HttpMethod$1;
+    /** Request path (relative to base URL) */
+    path: string;
+    /** Request headers as key-value pairs */
+    headers: Map<string, unknown>;
+    /** Request body payload (optional) */
+    body?: BodyInit;
+    /** Signal to abort the request (optional) */
+    abortSignal?: AbortSignal;
+    /** Query string parameters */
+    queryParams: Map<string, unknown>;
+    /** Path parameters for URL templating */
+    pathParams: Map<string, unknown>;
+}
+/**
+ * Metadata about an HTTP response.
+ */
+interface HttpMetadata$1 {
+    /** HTTP status code */
+    status: number;
+    /** HTTP status text message */
+    statusText: string;
+    /** Response headers as key-value pairs */
+    headers: Record<string, string>;
+}
+/**
+ * Represents an HTTP response with typed data.
+ * @template T - The type of the response data
+ */
+interface HttpResponse$1<T> {
+    /** Parsed response data (optional) */
+    data?: T;
+    /** Response metadata (status, headers, etc.) */
+    metadata: HttpMetadata$1;
+    /** Raw response object from the HTTP client */
+    raw: ArrayBuffer;
+}
+/**
+ * Represents an HTTP error response.
+ */
+interface HttpError$1 {
+    /** Error message or description */
+    error: string;
+    /** Response metadata (status, headers, etc.) */
+    metadata: HttpMetadata$1;
+}
+/**
+ * Hook interface for intercepting and modifying HTTP requests and responses.
+ * Allows custom logic to be executed at different stages of the request lifecycle.
+ */
+interface Hook {
+    /**
+     * Called before an HTTP request is sent.
+     * Allows modification of the request before execution.
+     * @param request - The HTTP request to be sent
+     * @param params - Additional custom parameters
+     * @returns A promise that resolves to the potentially modified request
+     */
+    beforeRequest(request: HttpRequest, params: Map<string, string>): Promise<HttpRequest>;
+    /**
+     * Called after a successful HTTP response is received.
+     * Allows processing or modification of the response.
+     * @param request - The original HTTP request
+     * @param response - The HTTP response received
+     * @param params - Additional custom parameters
+     * @returns A promise that resolves to the potentially modified response
+     */
+    afterResponse(request: HttpRequest, response: HttpResponse$1<any>, params: Map<string, string>): Promise<HttpResponse$1<any>>;
+    /**
+     * Called when an HTTP request results in an error.
+     * Allows custom error handling and transformation.
+     * @param request - The original HTTP request
+     * @param response - The error response received
+     * @param params - Additional custom parameters
+     * @returns A promise that resolves to an error object
+     */
+    onError(request: HttpRequest, response: HttpResponse$1<any>, params: Map<string, string>): Promise<HttpError$1>;
+}
+
+/**
+ * OpenAPI parameter serialization styles.
+ * Defines how parameters should be formatted in the request.
+ */
+declare enum SerializationStyle {
+    /** Simple comma-separated values (e.g., "3,4,5") */
+    SIMPLE = "simple",
+    /** Label prefix with dot notation (e.g., ".3.4.5") */
+    LABEL = "label",
+    /** Matrix semicolon-prefixed (e.g., ";id=3;id=4") */
+    MATRIX = "matrix",
+    /** Form-style ampersand-separated (e.g., "id=3&id=4") */
+    FORM = "form",
+    /** Space-delimited values (e.g., "id=3 4 5") */
+    SPACE_DELIMITED = "space_delimited",
+    /** Pipe-delimited values (e.g., "id=3|4|5") */
+    PIPE_DELIMITED = "pipe_delimited",
+    /** Deep object notation (e.g., "id[role]=admin") */
+    DEEP_OBJECT = "deep_object",
+    /** No specific style applied */
+    NONE = "none"
+}
+
+/**
+ * Represents an OAuth 2.0 access token with its associated metadata.
+ * Stores the token, granted scopes, and expiration time.
+ */
+declare class OAuthToken {
+    accessToken: string;
+    scopes: Set<string>;
+    expiresAt: number | null;
+    /**
+     * Creates a new OAuth token.
+     * @param accessToken - The access token string
+     * @param scopes - Set of OAuth scopes granted to this token
+     * @param expiresAt - Timestamp when the token expires (milliseconds since epoch), or null if no expiration
+     */
+    constructor(accessToken: string, scopes: Set<string>, expiresAt: number | null);
+    /**
+     * Checks if this token has all the required scopes.
+     * @param scopes - Set of scopes to check for
+     * @returns True if the token has all required scopes, false otherwise
+     */
+    hasAllScopes(scopes: Set<string>): boolean;
+}
+/**
+ * Manages OAuth 2.0 access tokens for the SDK.
+ * Handles token retrieval, caching, and automatic refresh when tokens expire.
+ * Implements a singleton pattern to share tokens across the SDK.
+ */
+declare class OAuthTokenManager {
+    /** Singleton instance of the token manager */
+    private static instance;
+    /** Currently cached OAuth token */
+    private token?;
+    /**
+     * Gets a valid access token for the specified scopes.
+     * Returns a cached token if available and not expired, otherwise requests a new one.
+     * @param scopes - Set of OAuth scopes required for the token
+     * @param config - SDK configuration containing client credentials
+     * @returns A promise that resolves to a valid OAuth token
+     * @throws Error if client credentials are missing or token request fails
+     */
+    getToken(scopes: Set<string>, config: SdkConfig): Promise<OAuthToken>;
+}
+
+/**
+ * Error class that can be thrown explicitly via a throw() method.
+ * Extends the built-in Error class with a convenience method for throwing.
+ */
+declare class ThrowableError extends Error {
+    message: string;
+    protected response?: unknown;
+    /**
+     * Optional metadata about the HTTP response that triggered this error.
+     */
+    metadata?: HttpMetadata;
+    /**
+     * Creates a new throwable error.
+     * @param message - The error message
+     * @param response - Optional response data associated with the error
+     */
+    constructor(message: string, response?: unknown);
+    /**
+     * Creates an error instance from a response body.
+     * Parsing (which can throw) is kept out of the constructor so that constructing
+     * an error while handling an error response never throws. The base implementation
+     * simply constructs the instance; subclasses may override to populate typed fields.
+     *
+     * Contract: every subclass constructor must accept `(message, response?)`. The base
+     * uses `new this(message, response)`, so a subclass with a different constructor
+     * signature must override `from()`.
+     * @param message - The error message
+     * @param response - Optional response data associated with the error
+     * @returns A new error instance
+     */
+    static from(message: string, response?: unknown): ThrowableError;
+    /**
+     * Throws this error instance.
+     * Convenience method for explicitly throwing the error.
+     * @throws This error instance
+     */
+    throw(): void;
+}
+
+/**
+ * Defines an expected response format with schema validation.
+ * Used to match and validate responses based on content type and status code.
+ */
+interface ResponseDefinition {
+    /** Schema for validating the response body */
+    schema: ZodType;
+    /** The content type of this response (e.g., 'application/json') */
+    contentType: ContentType;
+    /** The HTTP status code this definition applies to */
+    status: number;
+}
+/**
+ * Defines an error response format with custom error class.
+ * Used to throw typed errors based on content type and status code.
+ */
+interface ErrorDefinition {
+    /** The error class to instantiate, exposing a static `from` factory */
+    error: (new (...args: any[]) => ThrowableError) & {
+        from(message: string, response?: unknown): ThrowableError;
+    };
+    /** The content type of this error response */
+    contentType: ContentType;
+    /** The HTTP status code this error applies to */
+    status: number;
+}
+/**
+ * Parameters required to create a Request instance.
+ * Contains all configuration needed for HTTP execution, validation, and error handling.
+ *
+ * @template Page - The type of paginated data items
+ */
+interface CreateRequestParameters<Page = unknown[]> {
+    baseUrl: string;
+    method: HttpMethod;
+    body?: any;
+    headers: Map<string, RequestParameter>;
+    queryParams: Map<string, RequestParameter>;
+    pathParams: Map<string, RequestParameter>;
+    cookies: Map<string, RequestParameter>;
+    path: string;
+    config: SdkConfig;
+    responses: ResponseDefinition[];
+    errors: ErrorDefinition[];
+    requestSchema: ZodType;
+    requestContentType: ContentType;
+    pagination?: RequestPagination<Page> | RequestCursorPagination<Page>;
+    filename?: string;
+    filenames?: string[];
+    scopes?: Set<string>;
+    tokenManager: OAuthTokenManager;
+}
+/**
+ * Represents a request parameter with serialization metadata.
+ * Wraps a value with OpenAPI serialization instructions for proper encoding.
+ */
+interface RequestParameter {
+    /** The parameter name (may be undefined for path substitution) */
+    key: string | undefined;
+    /** The actual parameter value */
+    value: unknown;
+    /** Whether to explode arrays/objects into multiple parameters */
+    explode: boolean;
+    /** Whether to URL-encode the value */
+    encode: boolean;
+    /** The OpenAPI serialization style (e.g., SIMPLE, FORM, MATRIX) */
+    style: SerializationStyle;
+    /** Whether this parameter is a pagination limit */
+    isLimit: boolean;
+    /** Whether this parameter is a pagination offset */
+    isOffset: boolean;
+    /** Whether this parameter is a pagination cursor */
+    isCursor: boolean;
+}
+/**
+ * Configuration for limit-offset pagination.
+ * Used for traditional page-based pagination with size and offset.
+ *
+ * @template Page - The type of page data
+ */
+interface RequestPagination<Page> {
+    /** The number of items per page */
+    pageSize?: number;
+    /** JSON path to extract page data from response */
+    pagePath: string[];
+    /** Schema for validating page data */
+    pageSchema?: ZodType<Page, any, any>;
+}
+/**
+ * Configuration for cursor-based pagination.
+ * Used for stateless pagination with cursor tokens.
+ *
+ * @template Page - The type of page data
+ */
+interface RequestCursorPagination<Page> {
+    /** JSON path to extract page data from response */
+    pagePath: string[];
+    /** Schema for validating page data */
+    pageSchema?: ZodType<Page, any, any>;
+    /** JSON path to extract next cursor from response */
+    cursorPath: string[];
+    /** Schema for validating cursor value */
+    cursorSchema?: ZodType<any, any, any>;
+}
+
+/**
+ * Represents an HTTP request with all necessary configuration and parameters.
+ * Handles path/query/header/cookie serialization, pagination, validation, and retry logic.
+ * This is the core request object passed through the handler chain for execution.
+ *
+ * @template PageSchema - The type of paginated data returned by this request
+ */
+declare class Request<PageSchema = unknown[]> {
+    baseUrl: string;
+    headers: Map<string, RequestParameter>;
+    queryParams: Map<string, RequestParameter>;
+    pathParams: Map<string, RequestParameter>;
+    cookies: Map<string, RequestParameter>;
+    body?: any;
+    method: HttpMethod;
+    path: string;
+    config: SdkConfig;
+    responses: ResponseDefinition[];
+    errors: ErrorDefinition[];
+    requestSchema: ZodType;
+    requestContentType: ContentType;
+    pagination?: RequestPagination<PageSchema> | RequestCursorPagination<PageSchema>;
+    filename?: string;
+    filenames?: string[];
+    scopes?: Set<string>;
+    tokenManager: OAuthTokenManager;
+    private readonly pathPattern;
+    constructor(params: CreateRequestParameters<PageSchema>);
+    /**
+     * Adds a header parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The header name
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
+    addHeaderParam(key: string, param: RequestParameter): void;
+    /**
+     * Adds a query parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The query parameter name
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
+    addQueryParam(key: string, param: RequestParameter): void;
+    /**
+     * Adds a path parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The path parameter name (matches template variable in path pattern)
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
+    addPathParam(key: string, param: RequestParameter): void;
+    /**
+     * Sets the request body if the value is defined.
+     *
+     * @param body - The request body to send
+     */
+    addBody(body: any): void;
+    /**
+     * Updates this request from a modified hook request.
+     * Used after hooks modify the request to sync changes back to the internal Request object.
+     *
+     * @param hookRequest - The modified request from hook processing
+     */
+    updateFromHookRequest(hookRequest: HttpRequest): void;
+    /**
+     * Constructs the complete URL by combining base URL, path with substituted parameters,
+     * and serialized query string.
+     *
+     * @returns The fully constructed URL ready for HTTP execution
+     */
+    constructFullUrl(): string;
+    /**
+     * Creates a copy of this request with optional parameter overrides.
+     * Useful for pagination where you need to modify parameters while keeping the rest intact.
+     *
+     * @param overrides - Optional parameters to override in the copied request
+     * @returns A new Request instance with the specified overrides
+     */
+    copy(overrides?: Partial<CreateRequestParameters>): Request<unknown[]>;
+    /**
+     * Serializes headers to a format suitable for HTTP execution.
+     *
+     * @returns Serialized headers as HeadersInit, or undefined if no headers
+     */
+    getHeaders(): HeadersInit | undefined;
+    /**
+     * Serializes cookies to a format suitable for HTTP execution.
+     *
+     * @returns Serialized cookies as a record, or undefined if no cookies
+     */
+    getCookies(): Record<string, string> | undefined;
+    /**
+     * Advances pagination parameters to fetch the next page.
+     * Handles both cursor-based and limit-offset pagination strategies.
+     *
+     * @param cursor - The cursor value for cursor-based pagination (optional for limit-offset)
+     * @param offsetIncrement - Fallback increment for offset pagination with no declared `pageSize`
+     * (stepless offset — gap doc row 200), where the caller only learns the increment after fetching
+     * a page (its item count). Ignored whenever `pageSize` is set, which always wins.
+     */
+    nextPage(cursor?: string, offsetIncrement?: number): void;
+    private constructPath;
+    private getOffsetParam;
+    private getCursorParam;
+    private getAllParams;
+}
+
+/**
+ * Standard HTTP methods supported by the SDK.
+ */
+type HttpMethod = 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
+/**
+ * SDK configuration interface.
+ * Contains all settings required to initialize and configure the SDK.
+ */
+interface BaseConfig {
+    retry?: RetryOptions;
+    validation?: ValidationOptions;
+    baseUrl?: string;
+    environment?: Environment;
+    timeoutMs?: number;
+    oAuthBaseUrl?: string;
+}
+interface ClientCredentialAuthConfig extends BaseConfig {
+    clientId: string;
+    clientSecret: string;
+    accessToken?: never;
+}
+interface TokenAuthConfig extends BaseConfig {
+    clientSecret?: never;
+    clientId?: never;
+    accessToken: string;
+}
+type SdkConfig = ClientCredentialAuthConfig | TokenAuthConfig;
+/**
+ * Metadata about an HTTP response.
+ * Contains status information and headers from the server response.
+ */
+interface HttpMetadata {
+    /** HTTP status code (e.g., 200, 404, 500) */
+    status: number;
+    /** HTTP status text message (e.g., "OK", "Not Found") */
+    statusText: string;
+    /** Response headers as key-value pairs */
+    headers: Record<string, string>;
+}
+/**
+ * Standard HTTP response with typed data.
+ * @template T - The type of the response data
+ */
+interface HttpResponse<T = unknown> {
+    /** Parsed response data (optional) */
+    data?: T;
+    /** Response metadata (status, headers, etc.) */
+    metadata: HttpMetadata;
+    /** Raw response object from the HTTP client */
+    raw: ArrayBuffer;
+}
+/**
+ * HTTP response for paginated API endpoints.
+ * Marker interface extending HttpResponse for type safety with pagination.
+ * @template T - The type of a single page of data
+ */
+interface PaginatedHttpResponse<T = unknown> extends HttpResponse<T> {
+}
+/**
+ * HTTP response for cursor-paginated API endpoints.
+ * Includes a cursor for fetching the next page of results.
+ * @template T - The type of a single page of data
+ */
+interface CursorPaginatedHttpResponse<T = unknown> extends HttpResponse<T> {
+    /** Cursor string for fetching the next page, null if no more pages, undefined if not applicable */
+    nextCursor?: string | null;
+}
+/**
+ * Supported content types for HTTP requests and responses.
+ * Determines how the SDK serializes requests and parses responses.
+ */
+declare enum ContentType {
+    /** JSON format (application/json) */
+    Json = "json",
+    /**
+     * @deprecated XML is handled as text. Use {@link ContentType.Text} instead.
+     * Kept as an alias for backward compatibility; will be removed in a future major version.
+     */
+    Xml = "text",
+    /** PDF document (application/pdf) */
+    Pdf = "pdf",
+    /** Image file (image/*) */
+    Image = "image",
+    /** Generic file */
+    File = "file",
+    /** Binary data (application/octet-stream) */
+    Binary = "binary",
+    /** URL-encoded form data (application/x-www-form-urlencoded) */
+    FormUrlEncoded = "form",
+    /** Plain text (text/plain) */
+    Text = "text",
+    /** Multipart form data for file uploads (multipart/form-data) */
+    MultipartFormData = "multipartFormData",
+    /** Server-sent events stream (text/event-stream) */
+    EventStream = "eventStream",
+    /** No content (HTTP 204) */
+    NoContent = "noContent"
+}
+interface RetryOptions {
+    attempts: number;
+    delayMs?: number;
+    maxDelayMs?: number;
+    backoffFactor?: number;
+    jitterMs?: number;
+    maxRetryAfterDelayMs?: number;
+    statusCodesToRetry?: number[];
+    httpMethodsToRetry?: HttpMethod[];
+}
+interface ValidationOptions {
+    responseValidation?: boolean;
+    requestValidation?: boolean;
+}
+
+/**
+ * Error class for HTTP request failures.
+ * Captures error details including status, metadata, and the raw response.
+ */
+declare class HttpError extends Error {
+    /** Error message or status text */
+    readonly error: string;
+    /** HTTP response metadata (status, headers, etc.) */
+    readonly metadata: HttpMetadata;
+    /** Raw response object from the HTTP client */
+    readonly raw?: ArrayBuffer;
+    /**
+     * Creates a new HTTP error.
+     * @param metadata - HTTP response metadata
+     * @param raw - Raw response object (optional)
+     * @param error - Custom error message (optional, defaults to status text)
+     */
+    constructor(metadata: HttpMetadata, raw?: ArrayBuffer, error?: string);
+}
+
+/**
+ * Default implementation of the Hook interface that provides pass-through behavior.
+ * This hook can be extended to add custom logic for request/response interception.
+ */
+declare class CustomHook implements Hook {
+    /**
+     * Called before an HTTP request is sent.
+     * Default implementation returns the request unchanged.
+     * @param request - The HTTP request to be sent
+     * @param params - Additional custom parameters
+     * @returns A promise that resolves to the unmodified request
+     */
+    beforeRequest(request: HttpRequest, params: Map<string, string>): Promise<HttpRequest>;
+    /**
+     * Called after a successful HTTP response is received.
+     * Default implementation returns the response unchanged.
+     * @param request - The original HTTP request
+     * @param response - The HTTP response received
+     * @param params - Additional custom parameters
+     * @returns A promise that resolves to the unmodified response
+     */
+    afterResponse(request: HttpRequest, response: HttpResponse$1<any>, params: Map<string, string>): Promise<HttpResponse$1<any>>;
+    /**
+     * Called when an HTTP request results in an error.
+     * Default implementation wraps the error response in an HttpError object.
+     * @param request - The original HTTP request
+     * @param response - The error response received
+     * @param params - Additional custom parameters
+     * @returns A promise that resolves to an HttpError object
+     */
+    onError(request: HttpRequest, response: HttpResponse$1<any>, params: Map<string, string>): Promise<HttpError>;
+}
+
+/**
+ * Core HTTP client for making API requests.
+ * Manages request/response handling through a chain of handlers for validation, retry, hooks, and more.
+ */
+declare class HttpClient {
+    private config;
+    /** Chain of request handlers that process requests in sequence */
+    private readonly requestHandlerChain;
+    /**
+     * Creates a new HTTP client with configured request handlers.
+     * @param config - SDK configuration including base URL and authentication
+     * @param hook - Optional custom hook for request/response interception
+     */
+    constructor(config: SdkConfig, hook?: CustomHook);
+    /**
+     * Executes a standard HTTP request.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to execute
+     * @returns A promise that resolves to the HTTP response
+     */
+    call<T>(request: Request): Promise<HttpResponse<T>>;
+    /**
+     * Executes a standard HTTP request and returns only the data directly.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to execute
+     * @returns A promise that resolves to the response data
+     */
+    callDirect<T>(request: Request): Promise<T>;
+    /**
+     * Executes a streaming HTTP request that yields responses incrementally.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to execute
+     * @returns An async generator that yields HTTP responses
+     */
+    stream<T>(request: Request): AsyncGenerator<HttpResponse<T>>;
+    /**
+     * Executes a paginated HTTP request and extracts the page data from the response.
+     * @template FullResponse - The complete response type from the API
+     * @template Page - The type of a single page of data
+     * @param request - The paginated HTTP request to execute
+     * @returns A promise that resolves to the paginated HTTP response
+     * @throws Error if the response contains no data to paginate through
+     */
+    callPaginated<FullResponse, Page>(request: Request<Page>): Promise<PaginatedHttpResponse<Page>>;
+    /**
+     * Executes a cursor-paginated HTTP request and extracts both page data and the next cursor.
+     * @template FullResponse - The complete response type from the API
+     * @template Page - The type of a single page of data
+     * @param request - The cursor-paginated HTTP request to execute
+     * @returns A promise that resolves to the cursor-paginated HTTP response with next cursor
+     * @throws Error if the response contains no data to paginate through
+     */
+    callCursorPaginated<FullResponse, Page>(request: Request<Page>): Promise<CursorPaginatedHttpResponse<Page>>;
+    /**
+     * Updates the base URL for all subsequent requests.
+     * @param url - The new base URL to use
+     */
+    setBaseUrl(url: string): void;
+    /**
+     * Updates the SDK configuration.
+     * @param config - The new SDK configuration
+     */
+    setConfig(config: SdkConfig): void;
+    /**
+     * Extracts page data from a full API response using the configured pagination path.
+     * @template FullResponse - The complete response type from the API
+     * @template Page - The type of a single page of data
+     * @param request - The request containing pagination configuration
+     * @param data - The full response data to extract the page from
+     * @returns The extracted and parsed page data
+     * @throws Error if pagination is not configured or page extraction fails
+     */
+    private getPage;
+    /**
+     * Extracts the next cursor from a full API response for cursor-based pagination.
+     * @template FullResponse - The complete response type from the API
+     * @template Page - The type of a single page of data
+     * @param request - The request containing cursor pagination configuration
+     * @param data - The full response data to extract the cursor from
+     * @returns The next cursor string, null if no more pages, or undefined if not cursor pagination
+     */
+    private getNextCursor;
+}
+
+/**
+ * Base service class that all API service classes extend.
+ * Provides common functionality including HTTP client management and configuration.
+ */
+declare class BaseService {
+    config: SdkConfig;
+    protected tokenManager: OAuthTokenManager;
+    /** The HTTP client instance used to make API requests */
+    client: HttpClient;
+    /** Service-level configuration overrides */
+    protected serviceConfig?: Partial<SdkConfig>;
+    constructor(config: SdkConfig, tokenManager: OAuthTokenManager);
+    /**
+     * Sets service-level configuration that applies to all methods in this service.
+     * @param config - Partial configuration to override SDK-level defaults
+     * @returns This service instance for method chaining
+     */
+    setConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Recursively merges two objects. Plain nested objects are merged key-by-key so a
+     * partial override (e.g. `{ retry: { attempts: 5 } }`) only overwrites the specified
+     * keys instead of replacing the whole nested object. Arrays and non-plain values are
+     * replaced wholesale.
+     *
+     * Override keys with the value `undefined` are skipped so the base value is preserved,
+     * matching the common JS merge idiom (e.g. lodash.merge). To explicitly clear a key,
+     * assign `null` or omit the key from the override entirely.
+     */
+    private static deepMerge;
+    private static isPlainObject;
+    /**
+     * Resolves configuration from the hierarchy: requestConfig > methodConfig > serviceConfig > sdkConfig
+     * Deep-merges all config levels so partial nested overrides (e.g. `{ retry: { attempts: 5 } }`)
+     * preserve unoverridden sibling keys from the SDK default.
+     * @param methodConfig - Method-level configuration override
+     * @param requestConfig - Request-level configuration override
+     * @returns Merged configuration with all overrides applied
+     */
+    protected getResolvedConfig(methodConfig?: Partial<SdkConfig>, requestConfig?: Partial<SdkConfig>): SdkConfig;
+    protected toBase64(str: string): string;
+    set baseUrl(baseUrl: string);
+    set environment(environment: Environment);
+    set timeoutMs(timeoutMs: number);
+    set clientId(clientId: string);
+    set clientSecret(clientSecret: string);
+    set oAuthBaseUrl(oAuthBaseUrl: string);
+    set accessToken(accessToken: string);
+}
+
+/**
+ * Zod schema for the ListDestinationsOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const listDestinationsOkResponse: z.ZodLazy<z.ZodObject<{
+    destinations: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        name: z.ZodString;
+        destination: z.ZodString;
+        destinationIso2: z.ZodString;
+        supportedCountries: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        destination: string;
+        destinationIso2: string;
+        supportedCountries: string[];
+    }, {
+        name: string;
+        destination: string;
+        destinationIso2: string;
+        supportedCountries: string[];
+    }>>, "many">;
+}, "strip", z.ZodTypeAny, {
+    destinations: {
+        name: string;
+        destination: string;
+        destinationIso2: string;
+        supportedCountries: string[];
+    }[];
+}, {
+    destinations: {
+        name: string;
+        destination: string;
+        destinationIso2: string;
+        supportedCountries: string[];
+    }[];
+}>>;
+/**
+ * @typedef {ListDestinationsOkResponse} listDestinationsOkResponse
+ * @property {Destinations[]} destinations
+ */
+type ListDestinationsOkResponse = z.infer<typeof listDestinationsOkResponse>;
+
+/**
+ * Service class for DestinationsService operations.
+ * Provides methods to interact with DestinationsService-related API endpoints.
+ * All methods return promises and handle request/response serialization automatically.
+ */
+declare class DestinationsService extends BaseService {
+    protected listDestinationsConfig?: Partial<SdkConfig>;
+    /**
+     * Sets method-level configuration for listDestinations.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setListDestinationsConfig(config: Partial<SdkConfig>): this;
+    /**
+     * List Destinations
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<ListDestinationsOkResponse>>} - Successful Response
+     */
+    listDestinations(requestConfig?: Partial<SdkConfig>): Promise<ListDestinationsOkResponse>;
+}
+
+/**
+ * Zod schema for the Destinations model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const destinations: z.ZodLazy<z.ZodObject<{
+    name: z.ZodString;
+    destination: z.ZodString;
+    destinationIso2: z.ZodString;
+    supportedCountries: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    destination: string;
+    destinationIso2: string;
+    supportedCountries: string[];
+}, {
+    name: string;
+    destination: string;
+    destinationIso2: string;
+    supportedCountries: string[];
+}>>;
+/**
+ * @typedef {Destinations} destinations
+ * @property {string} name - Name of the destination
+ * @property {string} destination - ISO3 representation of the destination
+ * @property {string} destinationIso2 - ISO2 representation of the destination
+ * @property {string[]} supportedCountries - This array indicates the geographical area covered by a specific destination. If the destination represents a single country, the array will include that country. However, if the destination represents a broader regional scope, the array will be populated with the names of the countries belonging to that region.
+ */
+type Destinations = z.infer<typeof destinations>;
+
+/**
+ * Zod schema for the ListPackagesOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const listPackagesOkResponse: z.ZodLazy<z.ZodObject<{
+    packages: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        destination: z.ZodString;
+        destinationIso2: z.ZodString;
+        dataLimitInBytes: z.ZodNumber;
+        dataLimitInGb: z.ZodNumber;
+        minDays: z.ZodNumber;
+        maxDays: z.ZodNumber;
+        priceInCents: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        minDays: number;
+        maxDays: number;
+        priceInCents: number;
+    }, {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        minDays: number;
+        maxDays: number;
+        priceInCents: number;
+    }>>, "many">;
+    afterCursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    packages: {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        minDays: number;
+        maxDays: number;
+        priceInCents: number;
+    }[];
+    afterCursor: string | null;
+}, {
+    packages: {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        minDays: number;
+        maxDays: number;
+        priceInCents: number;
+    }[];
+    afterCursor: string | null;
+}>>;
+/**
+ * @typedef {ListPackagesOkResponse} listPackagesOkResponse
+ * @property {Packages[]} packages
+ * @property {string} afterCursor - The cursor value representing the end of the current page of results. Use this cursor value as the "afterCursor" parameter in your next request to retrieve the subsequent page of results. It ensures that you continue fetching data from where you left off, facilitating smooth pagination
+ */
+type ListPackagesOkResponse = z.infer<typeof listPackagesOkResponse>;
+
+interface ListPackagesParams {
+    destination?: string;
+    dataLimitInGb?: number;
+    startDate?: string;
+    endDate?: string;
+    afterCursor?: string;
+    limit?: number;
+    startTime?: number;
+    endTime?: number;
+    includeUnlimited?: boolean;
+}
+
+/**
+ * Service class for PackagesService operations.
+ * Provides methods to interact with PackagesService-related API endpoints.
+ * All methods return promises and handle request/response serialization automatically.
+ */
+declare class PackagesService extends BaseService {
+    protected listPackagesConfig?: Partial<SdkConfig>;
+    /**
+     * Sets method-level configuration for listPackages.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setListPackagesConfig(config: Partial<SdkConfig>): this;
+    /**
+     * List Packages
+     * @param {string} [params.destination] - ISO representation of the package's destination. Supports both ISO2 (e.g., 'FR') and ISO3 (e.g., 'FRA') country codes.
+     * @param {number} [params.dataLimitInGb] - Filter packages by data limit in GB. When provided, only packages with this exact data limit are returned. Use `-1` together with `includeUnlimited=true` to return only unlimited packages. A value of `0` is ignored.
+     * @param {string} [params.startDate] - Start date of the package's validity in the format 'yyyy-MM-dd'. This date can be set to the current day or any day within the next 12 months.
+     * @param {string} [params.endDate] - End date of the package's validity in the format 'yyyy-MM-dd'. End date can be maximum 90 days after Start date.
+     * @param {string} [params.afterCursor] - To get the next batch of results, use this parameter. It tells the API where to start fetching data after the last item you received. It helps you avoid repeats and efficiently browse through large sets of data.
+     * @param {number} [params.limit] - Maximum number of packages to be returned in the response. The value must be greater than 0 and less than or equal to 160. If not provided, the default value is 20
+     * @param {number} [params.startTime] - Epoch value representing the start time of the package's validity. This timestamp can be set to the current time or any time within the next 12 months
+     * @param {number} [params.endTime] - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time
+     * @param {boolean} [params.includeUnlimited] - Whether to include unlimited (date-based) packages in the results. Unlimited packages are excluded by default; set this to `true` to include them. An unlimited package has `dataLimitInGB` and `dataLimitInBytes` equal to `-1`, and is offered for 3 to 30 days with `minDays` equal to `maxDays`.
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<ListPackagesOkResponse>>} - Successful Response
+     */
+    listPackages(params?: ListPackagesParams, requestConfig?: Partial<SdkConfig>): Promise<ListPackagesOkResponse>;
+}
+
+/**
+ * Zod schema for the Packages model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const packages: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    destination: z.ZodString;
+    destinationIso2: z.ZodString;
+    dataLimitInBytes: z.ZodNumber;
+    dataLimitInGb: z.ZodNumber;
+    minDays: z.ZodNumber;
+    maxDays: z.ZodNumber;
+    priceInCents: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    destination: string;
+    destinationIso2: string;
+    id: string;
+    dataLimitInBytes: number;
+    dataLimitInGb: number;
+    minDays: number;
+    maxDays: number;
+    priceInCents: number;
+}, {
+    destination: string;
+    destinationIso2: string;
+    id: string;
+    dataLimitInBytes: number;
+    dataLimitInGb: number;
+    minDays: number;
+    maxDays: number;
+    priceInCents: number;
+}>>;
+/**
+ * @typedef {Packages} packages
+ * @property {string} id - ID of the package
+ * @property {string} destination - ISO3 representation of the package's destination.
+ * @property {string} destinationIso2 - ISO2 representation of the package's destination.
+ * @property {number} dataLimitInBytes - Size of the package in Bytes. A value of `-1` indicates an unlimited package.
+ * @property {number} dataLimitInGb - Size of the package in GB. A value of `-1` indicates an unlimited (date-based) package.
+ * @property {number} minDays - Min number of days for the package
+ * @property {number} maxDays - Max number of days for the package
+ * @property {number} priceInCents - Price of the package in cents
+ */
+type Packages = z.infer<typeof packages>;
+
+/**
+ * Zod schema for the CreatePurchaseV2Request model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseV2Request: z.ZodLazy<z.ZodObject<{
+    destination: z.ZodString;
+    dataLimitInGb: z.ZodNumber;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    quantity: z.ZodNumber;
+    email: z.ZodOptional<z.ZodString>;
+    referenceId: z.ZodOptional<z.ZodString>;
+    networkBrand: z.ZodOptional<z.ZodString>;
+    emailBrand: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    destination: string;
+    dataLimitInGb: number;
+    quantity: number;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    duration?: number | undefined;
+    email?: string | undefined;
+    referenceId?: string | undefined;
+    networkBrand?: string | undefined;
+    emailBrand?: string | undefined;
+    language?: string | undefined;
+}, {
+    destination: string;
+    dataLimitInGb: number;
+    quantity: number;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    duration?: number | undefined;
+    email?: string | undefined;
+    referenceId?: string | undefined;
+    networkBrand?: string | undefined;
+    emailBrand?: string | undefined;
+    language?: string | undefined;
+}>>;
+/**
+ * @typedef {CreatePurchaseV2Request} createPurchaseV2Request
+ * @property {string} destination - ISO representation of the package's destination. Supports both ISO2 (e.g., 'FR') and ISO3 (e.g., 'FRA') country codes.
+ * @property {number} dataLimitInGb - Size of the package in GB. The available options are 0.5, 1, 2, 3, 5, 8, 20, 50GB. Use `-1` to purchase an unlimited (date-based) package — provide `startDate`/`endDate` spanning 3 to 30 days (`duration` is not supported for unlimited packages).
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-dd'. This date can be set to the current day or any day within the next 12 months.
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-dd'. End date can be maximum 90 days after Start date.
+ * @property {number} duration - Duration of the package in days. Available values are 1, 2, 7, 14, 30, or 90. Either provide startDate/endDate or duration. Not supported for unlimited packages (`dataLimitInGB` = -1), which are date-based — provide startDate/endDate instead.
+ * @property {number} quantity - Number of eSIMs to purchase.
+ * @property {string} email - Email address where the purchase confirmation email will be sent (including QR Code & activation steps)
+ * @property {string} referenceId - An identifier provided by the partner to link this purchase to their booking or transaction for analytics and debugging purposes. Letters, digits, `-`, `_`, `.`, `@` and `+` are allowed (so an email address works), up to 255 characters.
+ * @property {string} networkBrand - Customize the network brand of the issued eSIM. The `networkBrand` parameter cannot exceed 15 characters in length and must contain only letters, numbers, dots (.), ampersands (&), and spaces. This feature is available to platforms with Diamond tier only.
+ * @property {string} emailBrand - Customize the email subject brand. The `emailBrand` parameter cannot exceed 25 characters in length and must contain only letters, numbers, and spaces. This feature is available to platforms with Diamond tier only.
+ * @property {CreatePurchaseV2RequestLanguage} language - Language of the confirmation email sent to the customer.
+ */
+type CreatePurchaseV2Request = z.infer<typeof createPurchaseV2Request>;
+
+/**
+ * Zod schema for the CreatePurchaseV2OkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseV2OkResponse: z.ZodLazy<z.ZodObject<{
+    purchase: z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        packageId: z.ZodString;
+        createdDate: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        packageId: string;
+        createdDate: string;
+    }, {
+        id: string;
+        packageId: string;
+        createdDate: string;
+    }>>;
+    profile: z.ZodLazy<z.ZodObject<{
+        iccid: z.ZodString;
+        activationCode: z.ZodString;
+        manualActivationCode: z.ZodString;
+        iosActivationLink: z.ZodString;
+        androidActivationLink: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        iosActivationLink: string;
+        androidActivationLink: string;
+    }, {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        iosActivationLink: string;
+        androidActivationLink: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    purchase: {
+        id: string;
+        packageId: string;
+        createdDate: string;
+    };
+    profile: {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        iosActivationLink: string;
+        androidActivationLink: string;
+    };
+}, {
+    purchase: {
+        id: string;
+        packageId: string;
+        createdDate: string;
+    };
+    profile: {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        iosActivationLink: string;
+        androidActivationLink: string;
+    };
+}>>;
+/**
+ * @typedef {CreatePurchaseV2OkResponse} createPurchaseV2OkResponse
+ * @property {CreatePurchaseV2OkResponsePurchase} purchase
+ * @property {CreatePurchaseV2OkResponseProfile} profile
+ */
+type CreatePurchaseV2OkResponse = z.infer<typeof createPurchaseV2OkResponse>;
+
+interface CreatePurchaseV2Params {
+    idempotencyKey?: string;
+}
+interface ListPurchasesParams {
+    purchaseId?: string;
+    iccid?: string;
+    afterDate?: string;
+    beforeDate?: string;
+    email?: string;
+    referenceId?: string;
+    afterCursor?: string;
+    limit?: number;
+    after?: number;
+    before?: number;
+}
+interface CreatePurchaseParams {
+    idempotencyKey?: string;
+}
+interface TopUpEsimParams {
+    idempotencyKey?: string;
+}
+interface EditPurchaseParams {
+    idempotencyKey?: string;
+}
+
+/**
+ * Zod schema for the ListPurchasesOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const listPurchasesOkResponse: z.ZodLazy<z.ZodObject<{
+    purchases: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        startDate: z.ZodNullable<z.ZodString>;
+        endDate: z.ZodNullable<z.ZodString>;
+        duration: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        createdDate: z.ZodString;
+        startTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        endTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        package: z.ZodLazy<z.ZodObject<{
+            id: z.ZodString;
+            dataLimitInBytes: z.ZodNumber;
+            dataLimitInGb: z.ZodNumber;
+            destination: z.ZodString;
+            destinationIso2: z.ZodString;
+            destinationName: z.ZodString;
+            priceInCents: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            destination: string;
+            destinationIso2: string;
+            id: string;
+            dataLimitInBytes: number;
+            dataLimitInGb: number;
+            priceInCents: number;
+            destinationName: string;
+        }, {
+            destination: string;
+            destinationIso2: string;
+            id: string;
+            dataLimitInBytes: number;
+            dataLimitInGb: number;
+            priceInCents: number;
+            destinationName: string;
+        }>>;
+        esim: z.ZodLazy<z.ZodObject<{
+            iccid: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            iccid: string;
+        }, {
+            iccid: string;
+        }>>;
+        source: z.ZodString;
+        purchaseType: z.ZodString;
+        referenceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        createdDate: string;
+        package: {
+            destination: string;
+            destinationIso2: string;
+            id: string;
+            dataLimitInBytes: number;
+            dataLimitInGb: number;
+            priceInCents: number;
+            destinationName: string;
+        };
+        esim: {
+            iccid: string;
+        };
+        source: string;
+        purchaseType: string;
+        duration?: number | null | undefined;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+        createdAt?: number | undefined;
+        referenceId?: string | null | undefined;
+    }, {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        createdDate: string;
+        package: {
+            destination: string;
+            destinationIso2: string;
+            id: string;
+            dataLimitInBytes: number;
+            dataLimitInGb: number;
+            priceInCents: number;
+            destinationName: string;
+        };
+        esim: {
+            iccid: string;
+        };
+        source: string;
+        purchaseType: string;
+        duration?: number | null | undefined;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+        createdAt?: number | undefined;
+        referenceId?: string | null | undefined;
+    }>>, "many">;
+    afterCursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    afterCursor: string | null;
+    purchases: {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        createdDate: string;
+        package: {
+            destination: string;
+            destinationIso2: string;
+            id: string;
+            dataLimitInBytes: number;
+            dataLimitInGb: number;
+            priceInCents: number;
+            destinationName: string;
+        };
+        esim: {
+            iccid: string;
+        };
+        source: string;
+        purchaseType: string;
+        duration?: number | null | undefined;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+        createdAt?: number | undefined;
+        referenceId?: string | null | undefined;
+    }[];
+}, {
+    afterCursor: string | null;
+    purchases: {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        createdDate: string;
+        package: {
+            destination: string;
+            destinationIso2: string;
+            id: string;
+            dataLimitInBytes: number;
+            dataLimitInGb: number;
+            priceInCents: number;
+            destinationName: string;
+        };
+        esim: {
+            iccid: string;
+        };
+        source: string;
+        purchaseType: string;
+        duration?: number | null | undefined;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+        createdAt?: number | undefined;
+        referenceId?: string | null | undefined;
+    }[];
+}>>;
+/**
+ * @typedef {ListPurchasesOkResponse} listPurchasesOkResponse
+ * @property {Purchases[]} purchases
+ * @property {string} afterCursor - The cursor value representing the end of the current page of results. Use this cursor value as the "afterCursor" parameter in your next request to retrieve the subsequent page of results. It ensures that you continue fetching data from where you left off, facilitating smooth pagination.
+ */
+type ListPurchasesOkResponse = z.infer<typeof listPurchasesOkResponse>;
+
+/**
+ * Zod schema for the CreatePurchaseRequest model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseRequest: z.ZodLazy<z.ZodObject<{
+    destination: z.ZodString;
+    dataLimitInGb: z.ZodNumber;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+    referenceId: z.ZodOptional<z.ZodString>;
+    networkBrand: z.ZodOptional<z.ZodString>;
+    emailBrand: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    destination: string;
+    dataLimitInGb: number;
+    startDate: string;
+    endDate: string;
+    email?: string | undefined;
+    referenceId?: string | undefined;
+    networkBrand?: string | undefined;
+    emailBrand?: string | undefined;
+    language?: string | undefined;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+}, {
+    destination: string;
+    dataLimitInGb: number;
+    startDate: string;
+    endDate: string;
+    email?: string | undefined;
+    referenceId?: string | undefined;
+    networkBrand?: string | undefined;
+    emailBrand?: string | undefined;
+    language?: string | undefined;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+}>>;
+/**
+ * @typedef {CreatePurchaseRequest} createPurchaseRequest
+ * @property {string} destination - ISO representation of the package's destination. Supports both ISO2 (e.g., 'FR') and ISO3 (e.g., 'FRA') country codes.
+ * @property {number} dataLimitInGb - Size of the package in GB. The available options are 0.5, 1, 2, 3, 5, 8, 20, 50GB. Use `-1` to purchase an unlimited (date-based) package — provide `startDate`/`endDate` spanning 3 to 30 days.
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-dd'. This date can be set to the current day or any day within the next 12 months.
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-dd'. End date can be maximum 90 days after Start date.
+ * @property {string} email - Email address where the purchase confirmation email will be sent (including QR Code & activation steps)
+ * @property {string} referenceId - An identifier provided by the partner to link this purchase to their booking or transaction for analytics and debugging purposes. Letters, digits, `-`, `_`, `.`, `@` and `+` are allowed (so an email address works), up to 255 characters.
+ * @property {string} networkBrand - Customize the network brand of the issued eSIM. The `networkBrand` parameter cannot exceed 15 characters in length and must contain only letters, numbers, dots (.), ampersands (&), and spaces. This feature is available to platforms with Diamond tier only.
+ * @property {string} emailBrand - Customize the email subject brand. The `emailBrand` parameter cannot exceed 25 characters in length and must contain only letters, numbers, and spaces. This feature is available to platforms with Diamond tier only.
+ * @property {CreatePurchaseRequestLanguage} language - Language of the confirmation email sent to the customer.
+ * @property {number} startTime - Epoch value representing the start time of the package's validity. This timestamp can be set to the current time or any time within the next 12 months.
+ * @property {number} endTime - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time.
+ */
+type CreatePurchaseRequest = z.infer<typeof createPurchaseRequest>;
+
+/**
+ * Zod schema for the CreatePurchaseOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseOkResponse: z.ZodLazy<z.ZodObject<{
+    purchase: z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        packageId: z.ZodString;
+        startDate: z.ZodNullable<z.ZodString>;
+        endDate: z.ZodNullable<z.ZodString>;
+        createdDate: z.ZodString;
+        startTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        endTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    }, {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    }>>;
+    profile: z.ZodLazy<z.ZodObject<{
+        iccid: z.ZodString;
+        activationCode: z.ZodString;
+        manualActivationCode: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+    }, {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    purchase: {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    };
+    profile: {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+    };
+}, {
+    purchase: {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    };
+    profile: {
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+    };
+}>>;
+/**
+ * @typedef {CreatePurchaseOkResponse} createPurchaseOkResponse
+ * @property {CreatePurchaseOkResponsePurchase} purchase
+ * @property {CreatePurchaseOkResponseProfile} profile
+ */
+type CreatePurchaseOkResponse = z.infer<typeof createPurchaseOkResponse>;
+
+/**
+ * Zod schema for the TopUpEsimRequest model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const topUpEsimRequest: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+    dataLimitInGb: z.ZodNumber;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    email: z.ZodOptional<z.ZodString>;
+    referenceId: z.ZodOptional<z.ZodString>;
+    emailBrand: z.ZodOptional<z.ZodString>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    dataLimitInGb: number;
+    iccid: string;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    duration?: number | undefined;
+    email?: string | undefined;
+    referenceId?: string | undefined;
+    emailBrand?: string | undefined;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+}, {
+    dataLimitInGb: number;
+    iccid: string;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    duration?: number | undefined;
+    email?: string | undefined;
+    referenceId?: string | undefined;
+    emailBrand?: string | undefined;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+}>>;
+/**
+ * @typedef {TopUpEsimRequest} topUpEsimRequest
+ * @property {string} iccid - ID of the eSIM
+ * @property {number} dataLimitInGb - Size of the package in GB. The available options are 0.5, 1, 2, 3, 5, 8, 20, 50GB. Use `-1` to top up with an unlimited (date-based) package — provide `startDate`/`endDate` spanning 3 to 30 days (`duration` is not supported for unlimited packages).
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-dd'. This date can be set to the current day or any day within the next 12 months.
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-dd'. End date can be maximum 90 days after Start date.
+ * @property {number} duration - Duration of the package in days. Available values are 1, 2, 7, 14, 30, or 90. Either provide startDate/endDate or duration. Not supported for unlimited packages (`dataLimitInGB` = -1), which are date-based — provide startDate/endDate instead.
+ * @property {string} email - Email address where the purchase confirmation email will be sent (excluding QR Code & activation steps).
+ * @property {string} referenceId - An identifier provided by the partner to link this purchase to their booking or transaction for analytics and debugging purposes. Letters, digits, `-`, `_`, `.`, `@` and `+` are allowed (so an email address works), up to 255 characters.
+ * @property {string} emailBrand - Customize the email subject brand. The `emailBrand` parameter cannot exceed 25 characters in length and must contain only letters, numbers, and spaces. This feature is available to platforms with Diamond tier only.
+ * @property {number} startTime - Epoch value representing the start time of the package's validity. This timestamp can be set to the current time or any time within the next 12 months.
+ * @property {number} endTime - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time.
+ */
+type TopUpEsimRequest = z.infer<typeof topUpEsimRequest>;
+
+/**
+ * Zod schema for the TopUpEsimOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const topUpEsimOkResponse: z.ZodLazy<z.ZodObject<{
+    purchase: z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        packageId: z.ZodString;
+        startDate: z.ZodNullable<z.ZodString>;
+        endDate: z.ZodNullable<z.ZodString>;
+        createdDate: z.ZodString;
+        startTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        endTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    }, {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    }>>;
+    profile: z.ZodLazy<z.ZodObject<{
+        iccid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        iccid: string;
+    }, {
+        iccid: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    purchase: {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    };
+    profile: {
+        iccid: string;
+    };
+}, {
+    purchase: {
+        id: string;
+        startDate: string | null;
+        endDate: string | null;
+        packageId: string;
+        createdDate: string;
+        startTime?: number | null | undefined;
+        endTime?: number | null | undefined;
+    };
+    profile: {
+        iccid: string;
+    };
+}>>;
+/**
+ * @typedef {TopUpEsimOkResponse} topUpEsimOkResponse
+ * @property {TopUpEsimOkResponsePurchase} purchase
+ * @property {TopUpEsimOkResponseProfile} profile
+ */
+type TopUpEsimOkResponse = z.infer<typeof topUpEsimOkResponse>;
+
+/**
+ * Zod schema for the EditPurchaseRequest model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const editPurchaseRequest: z.ZodLazy<z.ZodObject<{
+    purchaseId: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    endDate: string;
+    purchaseId: string;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+}, {
+    startDate: string;
+    endDate: string;
+    purchaseId: string;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+}>>;
+/**
+ * @typedef {EditPurchaseRequest} editPurchaseRequest
+ * @property {string} purchaseId - ID of the purchase
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-dd'. This date can be set to the current day or any day within the next 12 months.
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-dd'. End date can be maximum 90 days after Start date.
+ * @property {number} startTime - Epoch value representing the start time of the package's validity. This timestamp can be set to the current time or any time within the next 12 months.
+ * @property {number} endTime - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time.
+ */
+type EditPurchaseRequest = z.infer<typeof editPurchaseRequest>;
+
+/**
+ * Zod schema for the EditPurchaseOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const editPurchaseOkResponse: z.ZodLazy<z.ZodObject<{
+    purchaseId: z.ZodString;
+    newStartDate: z.ZodNullable<z.ZodString>;
+    newEndDate: z.ZodNullable<z.ZodString>;
+    newStartTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    newEndTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    purchaseId: string;
+    newStartDate: string | null;
+    newEndDate: string | null;
+    newStartTime?: number | null | undefined;
+    newEndTime?: number | null | undefined;
+}, {
+    purchaseId: string;
+    newStartDate: string | null;
+    newEndDate: string | null;
+    newStartTime?: number | null | undefined;
+    newEndTime?: number | null | undefined;
+}>>;
+/**
+ * @typedef {EditPurchaseOkResponse} editPurchaseOkResponse
+ * @property {string} purchaseId - ID of the purchase
+ * @property {string} newStartDate - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {string} newEndDate - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {number} newStartTime - Epoch value representing the new start time of the package's validity
+ * @property {number} newEndTime - Epoch value representing the new end time of the package's validity
+ */
+type EditPurchaseOkResponse = z.infer<typeof editPurchaseOkResponse>;
+
+/**
+ * Zod schema for the GetPurchaseConsumptionOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const getPurchaseConsumptionOkResponse: z.ZodLazy<z.ZodObject<{
+    dataUsageRemainingInBytes: z.ZodNumber;
+    dataUsageRemainingInGb: z.ZodNumber;
+    status: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    dataUsageRemainingInBytes: number;
+    dataUsageRemainingInGb: number;
+}, {
+    status: string;
+    dataUsageRemainingInBytes: number;
+    dataUsageRemainingInGb: number;
+}>>;
+/**
+ * @typedef {GetPurchaseConsumptionOkResponse} getPurchaseConsumptionOkResponse
+ * @property {number} dataUsageRemainingInBytes - Remaining balance of the package in bytes. Returns `-1` for unlimited packages.
+ * @property {number} dataUsageRemainingInGb - Remaining balance of the package in GB. Returns `-1` for unlimited packages.
+ * @property {string} status - Status of the connectivity, possible values are 'ACTIVE' or 'NOT_ACTIVE'
+ */
+type GetPurchaseConsumptionOkResponse = z.infer<typeof getPurchaseConsumptionOkResponse>;
+
+/**
+ * Service class for PurchasesService operations.
+ * Provides methods to interact with PurchasesService-related API endpoints.
+ * All methods return promises and handle request/response serialization automatically.
+ */
+declare class PurchasesService extends BaseService {
+    protected createPurchaseV2Config?: Partial<SdkConfig>;
+    protected listPurchasesConfig?: Partial<SdkConfig>;
+    protected createPurchaseConfig?: Partial<SdkConfig>;
+    protected topUpEsimConfig?: Partial<SdkConfig>;
+    protected editPurchaseConfig?: Partial<SdkConfig>;
+    protected getPurchaseConsumptionConfig?: Partial<SdkConfig>;
+    /**
+     * Sets method-level configuration for createPurchaseV2.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setCreatePurchaseV2Config(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for listPurchases.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setListPurchasesConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for createPurchase.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setCreatePurchaseConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for topUpEsim.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setTopUpEsimConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for editPurchase.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setEditPurchaseConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for getPurchaseConsumption.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setGetPurchaseConsumptionConfig(config: Partial<SdkConfig>): this;
+    /**
+     * This endpoint is used to purchase a new eSIM by providing the package details.
+     * @param {string} [params.idempotencyKey] - Optional. A unique value (for example a UUID) that makes this request safe to retry. If a request with the same `Idempotency-Key` and the same body succeeds, repeating it returns the original response instead of performing the action again, and the response includes the header `Idempotent-Replayed: true`. Keys are scoped to your credentials and remembered for 3 days. Only successful (2xx) responses are remembered, so a request that failed can be retried with the same key. Reusing a key with a different request returns `422`; sending it while the original request is still being processed returns `409`. If the idempotency store is temporarily unavailable, the request is not processed and returns `503`; retry it. Must be 1 to 255 printable ASCII characters, without spaces.
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<CreatePurchaseV2OkResponse[]>>} - Successful Response
+     */
+    createPurchaseV2(body: CreatePurchaseV2Request, params?: CreatePurchaseV2Params, requestConfig?: Partial<SdkConfig>): Promise<CreatePurchaseV2OkResponse[]>;
+    /**
+     * This endpoint can be used to list all the successful purchases made between a given interval.
+     * @param {string} [params.purchaseId] - ID of the purchase
+     * @param {string} [params.iccid] - ID of the eSIM
+     * @param {string} [params.afterDate] - Start date of the interval for filtering purchases in the format 'yyyy-MM-dd'
+     * @param {string} [params.beforeDate] - End date of the interval for filtering purchases in the format 'yyyy-MM-dd'
+     * @param {string} [params.email] - Email associated to the purchase.
+     * @param {string} [params.referenceId] - The referenceId that was provided by the partner during the purchase or topup flow.
+     * @param {string} [params.afterCursor] - To get the next batch of results, use this parameter. It tells the API where to start fetching data after the last item you received. It helps you avoid repeats and efficiently browse through large sets of data.
+     * @param {number} [params.limit] - Maximum number of purchases to be returned in the response. The value must be greater than 0 and less than or equal to 100. If not provided, the default value is 20
+     * @param {number} [params.after] - Epoch value representing the start of the time interval for filtering purchases
+     * @param {number} [params.before] - Epoch value representing the end of the time interval for filtering purchases
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<ListPurchasesOkResponse>>} - Successful Response
+     */
+    listPurchases(params?: ListPurchasesParams, requestConfig?: Partial<SdkConfig>): Promise<ListPurchasesOkResponse>;
+    /**
+     * This endpoint is used to purchase a new eSIM by providing the package details.
+     * @param {string} [params.idempotencyKey] - Optional. A unique value (for example a UUID) that makes this request safe to retry. If a request with the same `Idempotency-Key` and the same body succeeds, repeating it returns the original response instead of performing the action again, and the response includes the header `Idempotent-Replayed: true`. Keys are scoped to your credentials and remembered for 3 days. Only successful (2xx) responses are remembered, so a request that failed can be retried with the same key. Reusing a key with a different request returns `422`; sending it while the original request is still being processed returns `409`. If the idempotency store is temporarily unavailable, the request is not processed and returns `503`; retry it. Must be 1 to 255 printable ASCII characters, without spaces.
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<CreatePurchaseOkResponse>>} - Successful Response
+     */
+    createPurchase(body: CreatePurchaseRequest, params?: CreatePurchaseParams, requestConfig?: Partial<SdkConfig>): Promise<CreatePurchaseOkResponse>;
+    /**
+     * This endpoint is used to top-up an existing eSIM with the previously associated destination by providing its ICCID and package details. To determine if an eSIM can be topped up, use the Get eSIM endpoint, which returns the `isTopUpAllowed` flag.
+     * @param {string} [params.idempotencyKey] - Optional. A unique value (for example a UUID) that makes this request safe to retry. If a request with the same `Idempotency-Key` and the same body succeeds, repeating it returns the original response instead of performing the action again, and the response includes the header `Idempotent-Replayed: true`. Keys are scoped to your credentials and remembered for 3 days. Only successful (2xx) responses are remembered, so a request that failed can be retried with the same key. Reusing a key with a different request returns `422`; sending it while the original request is still being processed returns `409`. If the idempotency store is temporarily unavailable, the request is not processed and returns `503`; retry it. Must be 1 to 255 printable ASCII characters, without spaces.
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<TopUpEsimOkResponse>>} - Successful Response
+     */
+    topUpEsim(body: TopUpEsimRequest, params?: TopUpEsimParams, requestConfig?: Partial<SdkConfig>): Promise<TopUpEsimOkResponse>;
+    /**
+   * This endpoint allows you to modify the validity dates of an existing purchase.
+  **Behavior:**
+  - If the purchase has **not yet been activated**, both the start and end dates can be updated.
+  - If the purchase is **already active**, only the **end date** can be updated, while the **start date must remain unchanged** (and should be passed as originally set).
+  - Updates must comply with the same pricing structure; the modification cannot alter the package size or change its duration category.
+  
+  The end date can be extended or shortened as long as it adheres to the same pricing category and does not exceed the allowed duration limits.
+  
+   * @param {string} [params.idempotencyKey] - Optional. A unique value (for example a UUID) that makes this request safe to retry. If a request with the same `Idempotency-Key` and the same body succeeds, repeating it returns the original response instead of performing the action again, and the response includes the header `Idempotent-Replayed: true`. Keys are scoped to your credentials and remembered for 3 days. Only successful (2xx) responses are remembered, so a request that failed can be retried with the same key. Reusing a key with a different request returns `422`; sending it while the original request is still being processed returns `409`. If the idempotency store is temporarily unavailable, the request is not processed and returns `503`; retry it. Must be 1 to 255 printable ASCII characters, without spaces.
+   * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<EditPurchaseOkResponse>>} - Successful Response
+   */
+    editPurchase(body: EditPurchaseRequest, params?: EditPurchaseParams, requestConfig?: Partial<SdkConfig>): Promise<EditPurchaseOkResponse>;
+    /**
+     * This endpoint can be called for consumption notifications (e.g. every 1 hour or when the user clicks a button). It returns the data balance (consumption) of purchased packages.
+     * @param {string} purchaseId - ID of the purchase
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<GetPurchaseConsumptionOkResponse>>} - Successful Response
+     */
+    getPurchaseConsumption(purchaseId: string, requestConfig?: Partial<SdkConfig>): Promise<GetPurchaseConsumptionOkResponse>;
+}
+
+/**
+ * Zod schema for the CreatePurchaseV2OkResponsePurchase model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseV2OkResponsePurchase: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    packageId: z.ZodString;
+    createdDate: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    packageId: string;
+    createdDate: string;
+}, {
+    id: string;
+    packageId: string;
+    createdDate: string;
+}>>;
+/**
+ * @typedef {CreatePurchaseV2OkResponsePurchase} createPurchaseV2OkResponsePurchase
+ * @property {string} id - ID of the purchase
+ * @property {string} packageId - ID of the package
+ * @property {string} createdDate - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ */
+type CreatePurchaseV2OkResponsePurchase = z.infer<typeof createPurchaseV2OkResponsePurchase>;
+
+/**
+ * Zod schema for the CreatePurchaseV2OkResponseProfile model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseV2OkResponseProfile: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+    activationCode: z.ZodString;
+    manualActivationCode: z.ZodString;
+    iosActivationLink: z.ZodString;
+    androidActivationLink: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    iccid: string;
+    activationCode: string;
+    manualActivationCode: string;
+    iosActivationLink: string;
+    androidActivationLink: string;
+}, {
+    iccid: string;
+    activationCode: string;
+    manualActivationCode: string;
+    iosActivationLink: string;
+    androidActivationLink: string;
+}>>;
+/**
+ * @typedef {CreatePurchaseV2OkResponseProfile} createPurchaseV2OkResponseProfile
+ * @property {string} iccid - ID of the eSIM
+ * @property {string} activationCode - QR Code of the eSIM as base64
+ * @property {string} manualActivationCode - Manual Activation Code of the eSIM
+ * @property {string} iosActivationLink - iOS Activation Link of the eSIM
+ * @property {string} androidActivationLink - Android Activation Link of the eSIM
+ */
+type CreatePurchaseV2OkResponseProfile = z.infer<typeof createPurchaseV2OkResponseProfile>;
+
+declare enum CreatePurchaseV2RequestLanguage {
+    EN = "en",
+    ES = "es",
+    FR = "fr",
+    DE = "de",
+    PT_BR = "pt-br"
+}
+
+/**
+ * Zod schema for the Purchases model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const purchases: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    startDate: z.ZodNullable<z.ZodString>;
+    endDate: z.ZodNullable<z.ZodString>;
+    duration: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    createdDate: z.ZodString;
+    startTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    endTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    package: z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        dataLimitInBytes: z.ZodNumber;
+        dataLimitInGb: z.ZodNumber;
+        destination: z.ZodString;
+        destinationIso2: z.ZodString;
+        destinationName: z.ZodString;
+        priceInCents: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        priceInCents: number;
+        destinationName: string;
+    }, {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        priceInCents: number;
+        destinationName: string;
+    }>>;
+    esim: z.ZodLazy<z.ZodObject<{
+        iccid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        iccid: string;
+    }, {
+        iccid: string;
+    }>>;
+    source: z.ZodString;
+    purchaseType: z.ZodString;
+    referenceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    startDate: string | null;
+    endDate: string | null;
+    createdDate: string;
+    package: {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        priceInCents: number;
+        destinationName: string;
+    };
+    esim: {
+        iccid: string;
+    };
+    source: string;
+    purchaseType: string;
+    duration?: number | null | undefined;
+    startTime?: number | null | undefined;
+    endTime?: number | null | undefined;
+    createdAt?: number | undefined;
+    referenceId?: string | null | undefined;
+}, {
+    id: string;
+    startDate: string | null;
+    endDate: string | null;
+    createdDate: string;
+    package: {
+        destination: string;
+        destinationIso2: string;
+        id: string;
+        dataLimitInBytes: number;
+        dataLimitInGb: number;
+        priceInCents: number;
+        destinationName: string;
+    };
+    esim: {
+        iccid: string;
+    };
+    source: string;
+    purchaseType: string;
+    duration?: number | null | undefined;
+    startTime?: number | null | undefined;
+    endTime?: number | null | undefined;
+    createdAt?: number | undefined;
+    referenceId?: string | null | undefined;
+}>>;
+/**
+ * @typedef {Purchases} purchases
+ * @property {string} id - ID of the purchase
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {number} duration - Duration of the package in days. Possible values are 1, 2, 7, 14, 30, or 90. `null` for unlimited (date-based) packages.
+ * @property {string} createdDate - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {number} startTime - Epoch value representing the start time of the package's validity
+ * @property {number} endTime - Epoch value representing the end time of the package's validity
+ * @property {number} createdAt - Epoch value representing the date of creation of the purchase
+ * @property {Package_} package
+ * @property {PurchasesEsim} esim
+ * @property {string} source - The `source` indicates whether the purchase was made from the API, dashboard, landing-page, promo-page or iframe. For purchases made before September 8, 2023, the value will be displayed as 'Not available'.
+ * @property {string} purchaseType - The `purchaseType` indicates whether this is the initial purchase that creates the eSIM (First Purchase) or a subsequent top-up on an existing eSIM (Top-up Purchase).
+ * @property {string} referenceId - The `referenceId` that was provided by the partner during the purchase or top-up flow. This identifier can be used for analytics and debugging purposes.
+ */
+type Purchases = z.infer<typeof purchases>;
+
+/**
+ * Zod schema for the Package_ model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const package_: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    dataLimitInBytes: z.ZodNumber;
+    dataLimitInGb: z.ZodNumber;
+    destination: z.ZodString;
+    destinationIso2: z.ZodString;
+    destinationName: z.ZodString;
+    priceInCents: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    destination: string;
+    destinationIso2: string;
+    id: string;
+    dataLimitInBytes: number;
+    dataLimitInGb: number;
+    priceInCents: number;
+    destinationName: string;
+}, {
+    destination: string;
+    destinationIso2: string;
+    id: string;
+    dataLimitInBytes: number;
+    dataLimitInGb: number;
+    priceInCents: number;
+    destinationName: string;
+}>>;
+/**
+ * @typedef {Package_} package_
+ * @property {string} id - ID of the package
+ * @property {number} dataLimitInBytes - Size of the package in Bytes. A value of `-1` indicates an unlimited package.
+ * @property {number} dataLimitInGb - Size of the package in GB. A value of `-1` indicates an unlimited (date-based) package.
+ * @property {string} destination - ISO3 representation of the package's destination.
+ * @property {string} destinationIso2 - ISO2 representation of the package's destination.
+ * @property {string} destinationName - Name of the package's destination
+ * @property {number} priceInCents - Price of the package in cents
+ */
+type Package_ = z.infer<typeof package_>;
+
+/**
+ * Zod schema for the PurchasesEsim model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const purchasesEsim: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    iccid: string;
+}, {
+    iccid: string;
+}>>;
+/**
+ * @typedef {PurchasesEsim} purchasesEsim
+ * @property {string} iccid - ID of the eSIM
+ */
+type PurchasesEsim = z.infer<typeof purchasesEsim>;
+
+/**
+ * Zod schema for the CreatePurchaseOkResponsePurchase model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseOkResponsePurchase: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    packageId: z.ZodString;
+    startDate: z.ZodNullable<z.ZodString>;
+    endDate: z.ZodNullable<z.ZodString>;
+    createdDate: z.ZodString;
+    startTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    endTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    startDate: string | null;
+    endDate: string | null;
+    packageId: string;
+    createdDate: string;
+    startTime?: number | null | undefined;
+    endTime?: number | null | undefined;
+}, {
+    id: string;
+    startDate: string | null;
+    endDate: string | null;
+    packageId: string;
+    createdDate: string;
+    startTime?: number | null | undefined;
+    endTime?: number | null | undefined;
+}>>;
+/**
+ * @typedef {CreatePurchaseOkResponsePurchase} createPurchaseOkResponsePurchase
+ * @property {string} id - ID of the purchase
+ * @property {string} packageId - ID of the package
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {string} createdDate - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {number} startTime - Epoch value representing the start time of the package's validity
+ * @property {number} endTime - Epoch value representing the end time of the package's validity
+ */
+type CreatePurchaseOkResponsePurchase = z.infer<typeof createPurchaseOkResponsePurchase>;
+
+/**
+ * Zod schema for the CreatePurchaseOkResponseProfile model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const createPurchaseOkResponseProfile: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+    activationCode: z.ZodString;
+    manualActivationCode: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    iccid: string;
+    activationCode: string;
+    manualActivationCode: string;
+}, {
+    iccid: string;
+    activationCode: string;
+    manualActivationCode: string;
+}>>;
+/**
+ * @typedef {CreatePurchaseOkResponseProfile} createPurchaseOkResponseProfile
+ * @property {string} iccid - ID of the eSIM
+ * @property {string} activationCode - QR Code of the eSIM as base64
+ * @property {string} manualActivationCode - Manual Activation Code of the eSIM
+ */
+type CreatePurchaseOkResponseProfile = z.infer<typeof createPurchaseOkResponseProfile>;
+
+declare enum CreatePurchaseRequestLanguage {
+    EN = "en",
+    ES = "es",
+    FR = "fr",
+    DE = "de",
+    PT_BR = "pt-br"
+}
+
+/**
+ * Zod schema for the TopUpEsimOkResponsePurchase model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const topUpEsimOkResponsePurchase: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    packageId: z.ZodString;
+    startDate: z.ZodNullable<z.ZodString>;
+    endDate: z.ZodNullable<z.ZodString>;
+    createdDate: z.ZodString;
+    startTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    endTime: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    startDate: string | null;
+    endDate: string | null;
+    packageId: string;
+    createdDate: string;
+    startTime?: number | null | undefined;
+    endTime?: number | null | undefined;
+}, {
+    id: string;
+    startDate: string | null;
+    endDate: string | null;
+    packageId: string;
+    createdDate: string;
+    startTime?: number | null | undefined;
+    endTime?: number | null | undefined;
+}>>;
+/**
+ * @typedef {TopUpEsimOkResponsePurchase} topUpEsimOkResponsePurchase
+ * @property {string} id - ID of the purchase
+ * @property {string} packageId - ID of the package
+ * @property {string} startDate - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {string} endDate - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {string} createdDate - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {number} startTime - Epoch value representing the start time of the package's validity
+ * @property {number} endTime - Epoch value representing the end time of the package's validity
+ */
+type TopUpEsimOkResponsePurchase = z.infer<typeof topUpEsimOkResponsePurchase>;
+
+/**
+ * Zod schema for the TopUpEsimOkResponseProfile model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const topUpEsimOkResponseProfile: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    iccid: string;
+}, {
+    iccid: string;
+}>>;
+/**
+ * @typedef {TopUpEsimOkResponseProfile} topUpEsimOkResponseProfile
+ * @property {string} iccid - ID of the eSIM
+ */
+type TopUpEsimOkResponseProfile = z.infer<typeof topUpEsimOkResponseProfile>;
+
+/**
+ * Zod schema for the GetEsimOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const getEsimOkResponse: z.ZodLazy<z.ZodObject<{
+    esim: z.ZodLazy<z.ZodObject<{
+        iccid: z.ZodString;
+        smdpAddress: z.ZodString;
+        activationCode: z.ZodString;
+        manualActivationCode: z.ZodString;
+        status: z.ZodString;
+        connectivityStatus: z.ZodString;
+        isTopUpAllowed: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        smdpAddress: string;
+        connectivityStatus: string;
+        isTopUpAllowed: boolean;
+    }, {
+        status: string;
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        smdpAddress: string;
+        connectivityStatus: string;
+        isTopUpAllowed: boolean;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    esim: {
+        status: string;
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        smdpAddress: string;
+        connectivityStatus: string;
+        isTopUpAllowed: boolean;
+    };
+}, {
+    esim: {
+        status: string;
+        iccid: string;
+        activationCode: string;
+        manualActivationCode: string;
+        smdpAddress: string;
+        connectivityStatus: string;
+        isTopUpAllowed: boolean;
+    };
+}>>;
+/**
+ * @typedef {GetEsimOkResponse} getEsimOkResponse
+ * @property {GetEsimOkResponseEsim} esim
+ */
+type GetEsimOkResponse = z.infer<typeof getEsimOkResponse>;
+
+interface GetEsimParams {
+    iccid: string;
+}
+interface SuspendEsimParams {
+    idempotencyKey?: string;
+}
+
+/**
+ * Zod schema for the GetEsimDeviceOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const getEsimDeviceOkResponse: z.ZodLazy<z.ZodObject<{
+    device: z.ZodLazy<z.ZodObject<{
+        oem: z.ZodString;
+        hardwareName: z.ZodString;
+        hardwareModel: z.ZodString;
+        eid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        oem: string;
+        hardwareName: string;
+        hardwareModel: string;
+        eid: string;
+    }, {
+        oem: string;
+        hardwareName: string;
+        hardwareModel: string;
+        eid: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    device: {
+        oem: string;
+        hardwareName: string;
+        hardwareModel: string;
+        eid: string;
+    };
+}, {
+    device: {
+        oem: string;
+        hardwareName: string;
+        hardwareModel: string;
+        eid: string;
+    };
+}>>;
+/**
+ * @typedef {GetEsimDeviceOkResponse} getEsimDeviceOkResponse
+ * @property {Device} device
+ */
+type GetEsimDeviceOkResponse = z.infer<typeof getEsimDeviceOkResponse>;
+
+/**
+ * Zod schema for the GetEsimHistoryOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const getEsimHistoryOkResponse: z.ZodLazy<z.ZodObject<{
+    esim: z.ZodLazy<z.ZodObject<{
+        iccid: z.ZodString;
+        history: z.ZodArray<z.ZodLazy<z.ZodObject<{
+            status: z.ZodString;
+            statusDate: z.ZodString;
+            date: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            statusDate: string;
+            date?: number | undefined;
+        }, {
+            status: string;
+            statusDate: string;
+            date?: number | undefined;
+        }>>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        iccid: string;
+        history: {
+            status: string;
+            statusDate: string;
+            date?: number | undefined;
+        }[];
+    }, {
+        iccid: string;
+        history: {
+            status: string;
+            statusDate: string;
+            date?: number | undefined;
+        }[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    esim: {
+        iccid: string;
+        history: {
+            status: string;
+            statusDate: string;
+            date?: number | undefined;
+        }[];
+    };
+}, {
+    esim: {
+        iccid: string;
+        history: {
+            status: string;
+            statusDate: string;
+            date?: number | undefined;
+        }[];
+    };
+}>>;
+/**
+ * @typedef {GetEsimHistoryOkResponse} getEsimHistoryOkResponse
+ * @property {GetEsimHistoryOkResponseEsim} esim
+ */
+type GetEsimHistoryOkResponse = z.infer<typeof getEsimHistoryOkResponse>;
+
+/**
+ * Zod schema for the SuspendEsimOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const suspendEsimOkResponse: z.ZodLazy<z.ZodObject<{
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+}, {
+    message: string;
+}>>;
+/**
+ * @typedef {SuspendEsimOkResponse} suspendEsimOkResponse
+ * @property {string} message - Confirmation message
+ */
+type SuspendEsimOkResponse = z.infer<typeof suspendEsimOkResponse>;
+
+/**
+ * Service class for ESimService operations.
+ * Provides methods to interact with ESimService-related API endpoints.
+ * All methods return promises and handle request/response serialization automatically.
+ */
+declare class ESimService extends BaseService {
+    protected getEsimConfig?: Partial<SdkConfig>;
+    protected getEsimDeviceConfig?: Partial<SdkConfig>;
+    protected getEsimHistoryConfig?: Partial<SdkConfig>;
+    protected suspendEsimConfig?: Partial<SdkConfig>;
+    /**
+     * Sets method-level configuration for getEsim.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setGetEsimConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for getEsimDevice.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setGetEsimDeviceConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for getEsimHistory.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setGetEsimHistoryConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Sets method-level configuration for suspendEsim.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setSuspendEsimConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Get eSIM
+     * @param {string} params.iccid - ID of the eSIM
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<GetEsimOkResponse>>} - Successful Response
+     */
+    getEsim(params: GetEsimParams, requestConfig?: Partial<SdkConfig>): Promise<GetEsimOkResponse>;
+    /**
+     * Get eSIM Device
+     * @param {string} iccid - ID of the eSIM
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<GetEsimDeviceOkResponse>>} - Successful Response
+     */
+    getEsimDevice(iccid: string, requestConfig?: Partial<SdkConfig>): Promise<GetEsimDeviceOkResponse>;
+    /**
+     * Get eSIM History
+     * @param {string} iccid - ID of the eSIM
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<GetEsimHistoryOkResponse>>} - Successful Response
+     */
+    getEsimHistory(iccid: string, requestConfig?: Partial<SdkConfig>): Promise<GetEsimHistoryOkResponse>;
+    /**
+     * Suspends an eSIM to prevent abuse. All of the eSIM's packages are terminated and its connectivity is switched off. The eSIM is not refunded: the charge stays.
+     * @param {string} iccid - ID of the eSIM
+     * @param {string} [params.idempotencyKey] - Optional. A unique value (for example a UUID) that makes this request safe to retry. If a request with the same `Idempotency-Key` and the same body succeeds, repeating it returns the original response instead of performing the action again, and the response includes the header `Idempotent-Replayed: true`. Keys are scoped to your credentials and remembered for 3 days. Only successful (2xx) responses are remembered, so a request that failed can be retried with the same key. Reusing a key with a different request returns `422`; sending it while the original request is still being processed returns `409`. If the idempotency store is temporarily unavailable, the request is not processed and returns `503`; retry it. Must be 1 to 255 printable ASCII characters, without spaces.
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<SuspendEsimOkResponse>>} - Successful Response
+     */
+    suspendEsim(iccid: string, params?: SuspendEsimParams, requestConfig?: Partial<SdkConfig>): Promise<SuspendEsimOkResponse>;
+}
+
+/**
+ * Zod schema for the GetEsimOkResponseEsim model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const getEsimOkResponseEsim: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+    smdpAddress: z.ZodString;
+    activationCode: z.ZodString;
+    manualActivationCode: z.ZodString;
+    status: z.ZodString;
+    connectivityStatus: z.ZodString;
+    isTopUpAllowed: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    iccid: string;
+    activationCode: string;
+    manualActivationCode: string;
+    smdpAddress: string;
+    connectivityStatus: string;
+    isTopUpAllowed: boolean;
+}, {
+    status: string;
+    iccid: string;
+    activationCode: string;
+    manualActivationCode: string;
+    smdpAddress: string;
+    connectivityStatus: string;
+    isTopUpAllowed: boolean;
+}>>;
+/**
+ * @typedef {GetEsimOkResponseEsim} getEsimOkResponseEsim
+ * @property {string} iccid - ID of the eSIM
+ * @property {string} smdpAddress - SM-DP+ Address
+ * @property {string} activationCode - QR Code of the eSIM as base64
+ * @property {string} manualActivationCode - The manual activation code
+ * @property {string} status - Status of the eSIM, possible values are 'RELEASED', 'DOWNLOADED', 'INSTALLED', 'ENABLED', 'DELETED', or 'ERROR'
+ * @property {string} connectivityStatus - Status of the eSIM connectivity, possible values are 'ACTIVE' or 'NOT_ACTIVE'
+ * @property {boolean} isTopUpAllowed - Indicates whether the eSIM is currently eligible for a top-up. This flag should be checked before attempting a top-up request.
+ */
+type GetEsimOkResponseEsim = z.infer<typeof getEsimOkResponseEsim>;
+
+/**
+ * Zod schema for the Device model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const device: z.ZodLazy<z.ZodObject<{
+    oem: z.ZodString;
+    hardwareName: z.ZodString;
+    hardwareModel: z.ZodString;
+    eid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    oem: string;
+    hardwareName: string;
+    hardwareModel: string;
+    eid: string;
+}, {
+    oem: string;
+    hardwareName: string;
+    hardwareModel: string;
+    eid: string;
+}>>;
+/**
+ * @typedef {Device} device
+ * @property {string} oem - Name of the OEM
+ * @property {string} hardwareName - Name of the Device
+ * @property {string} hardwareModel - Model of the Device
+ * @property {string} eid - Serial Number of the eSIM
+ */
+type Device = z.infer<typeof device>;
+
+/**
+ * Zod schema for the GetEsimHistoryOkResponseEsim model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const getEsimHistoryOkResponseEsim: z.ZodLazy<z.ZodObject<{
+    iccid: z.ZodString;
+    history: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        status: z.ZodString;
+        statusDate: z.ZodString;
+        date: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        statusDate: string;
+        date?: number | undefined;
+    }, {
+        status: string;
+        statusDate: string;
+        date?: number | undefined;
+    }>>, "many">;
+}, "strip", z.ZodTypeAny, {
+    iccid: string;
+    history: {
+        status: string;
+        statusDate: string;
+        date?: number | undefined;
+    }[];
+}, {
+    iccid: string;
+    history: {
+        status: string;
+        statusDate: string;
+        date?: number | undefined;
+    }[];
+}>>;
+/**
+ * @typedef {GetEsimHistoryOkResponseEsim} getEsimHistoryOkResponseEsim
+ * @property {string} iccid - ID of the eSIM
+ * @property {History[]} history
+ */
+type GetEsimHistoryOkResponseEsim = z.infer<typeof getEsimHistoryOkResponseEsim>;
+
+/**
+ * Zod schema for the History model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const history: z.ZodLazy<z.ZodObject<{
+    status: z.ZodString;
+    statusDate: z.ZodString;
+    date: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    statusDate: string;
+    date?: number | undefined;
+}, {
+    status: string;
+    statusDate: string;
+    date?: number | undefined;
+}>>;
+/**
+ * @typedef {History} history
+ * @property {string} status - The status of the eSIM at a given time, possible values are 'RELEASED', 'DOWNLOADED', 'INSTALLED', 'ENABLED', 'DELETED', or 'ERROR'
+ * @property {string} statusDate - The date when the eSIM status changed in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @property {number} date - Epoch value representing the date when the eSIM status changed
+ */
+type History = z.infer<typeof history>;
+
+/**
+ * Zod schema for the TokenOkResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const tokenOkResponse: z.ZodLazy<z.ZodObject<{
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+}, {
+    token: string;
+}>>;
+/**
+ * @typedef {TokenOkResponse} tokenOkResponse
+ * @property {string} token - The generated token
+ */
+type TokenOkResponse = z.infer<typeof tokenOkResponse>;
+
+/**
+ * Service class for IFrameService operations.
+ * Provides methods to interact with IFrameService-related API endpoints.
+ * All methods return promises and handle request/response serialization automatically.
+ */
+declare class IFrameService extends BaseService {
+    protected tokenConfig?: Partial<SdkConfig>;
+    /**
+     * Sets method-level configuration for token.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setTokenConfig(config: Partial<SdkConfig>): this;
+    /**
+     * Generate a new token to be used in the iFrame
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<TokenOkResponse>>} - Successful Response
+     */
+    token(requestConfig?: Partial<SdkConfig>): Promise<TokenOkResponse>;
+}
+
+/**
+ * Zod schema for the OAuthTokenRequest model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const oAuthTokenRequest: z.ZodLazy<z.ZodObject<{
+    grantType: z.ZodString;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    scope: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+    clientSecret: string;
+    grantType: string;
+    scope: string;
+}, {
+    clientId: string;
+    clientSecret: string;
+    grantType: string;
+    scope: string;
+}>>;
+/**
+ * @typedef {OAuthTokenRequest} oAuthTokenRequest
+ * @property {GrantType} grantType
+ * @property {string} clientId
+ * @property {string} clientSecret
+ * @property {string} scope
+ */
+type OAuthTokenRequest = z.infer<typeof oAuthTokenRequest>;
+
+/**
+ * Zod schema for the OAuthTokenResponse model.
+ * Defines the structure and validation rules for this data type.
+ * This is the shape used in application code - what developers interact with.
+ */
+declare const oAuthTokenResponse: z.ZodLazy<z.ZodObject<{
+    accessToken: z.ZodOptional<z.ZodString>;
+    expiresIn: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    accessToken?: string | undefined;
+    expiresIn?: number | null | undefined;
+}, {
+    accessToken?: string | undefined;
+    expiresIn?: number | null | undefined;
+}>>;
+/**
+ * @typedef {OAuthTokenResponse} oAuthTokenResponse
+ * @property {string} accessToken
+ * @property {number} expiresIn
+ */
+type OAuthTokenResponse = z.infer<typeof oAuthTokenResponse>;
+
+/**
+ * Service class for OAuthService operations.
+ * Provides methods to interact with OAuthService-related API endpoints.
+ * All methods return promises and handle request/response serialization automatically.
+ */
+declare class OAuthService extends BaseService {
+    protected getAccessTokenConfig?: Partial<SdkConfig>;
+    /**
+     * Sets method-level configuration for getAccessToken.
+     * @param config - Partial configuration to override service-level defaults
+     * @returns This service instance for method chaining
+     */
+    setGetAccessTokenConfig(config: Partial<SdkConfig>): this;
+    /**
+     *
+     * @param {Partial<SdkConfig>} [requestConfig] - The request configuration for retry and validation.
+     * @returns {Promise<HttpResponse<OAuthTokenResponse>>} - OAuth token
+     */
+    getAccessToken(body: OAuthTokenRequest, requestConfig?: Partial<SdkConfig>): Promise<OAuthTokenResponse>;
+}
+
+declare enum GrantType {
+    CLIENT_CREDENTIALS = "client_credentials"
+}
+
+declare class ErrorResponse extends ThrowableError {
+    message: string;
+    protected response?: unknown;
+    constructor(message: string, response?: unknown);
+    static from(message: string, response?: unknown): ErrorResponse;
+    throw(): void;
+}
+
+declare class Celitech {
+    config: SdkConfig;
+    readonly destinations: DestinationsService;
+    readonly packages: PackagesService;
+    readonly purchases: PurchasesService;
+    readonly eSim: ESimService;
+    readonly iFrame: IFrameService;
+    protected tokenManager: OAuthTokenManager;
+    constructor(config: SdkConfig);
+    set baseUrl(baseUrl: string);
+    set environment(environment: Environment);
+    set timeoutMs(timeoutMs: number);
+    set clientId(clientId: string);
+    set clientSecret(clientSecret: string);
+    set oAuthBaseUrl(oAuthBaseUrl: string);
+    set accessToken(accessToken: string);
+}
+
+export { Celitech, CreatePurchaseOkResponse, CreatePurchaseOkResponseProfile, CreatePurchaseOkResponsePurchase, CreatePurchaseRequest, CreatePurchaseRequestLanguage, CreatePurchaseV2OkResponse, CreatePurchaseV2OkResponseProfile, CreatePurchaseV2OkResponsePurchase, CreatePurchaseV2Request, CreatePurchaseV2RequestLanguage, Destinations, DestinationsService, Device, ESimService, EditPurchaseOkResponse, EditPurchaseRequest, Environment, ErrorResponse, GetEsimDeviceOkResponse, GetEsimHistoryOkResponse, GetEsimHistoryOkResponseEsim, GetEsimOkResponse, GetEsimOkResponseEsim, GetPurchaseConsumptionOkResponse, GrantType, History, HttpError, HttpMetadata, HttpMethod, HttpResponse, IFrameService, ListDestinationsOkResponse, ListPackagesOkResponse, ListPurchasesOkResponse, OAuthService, OAuthTokenRequest, OAuthTokenResponse, Package_, Packages, PackagesService, Purchases, PurchasesEsim, PurchasesService, RetryOptions, SdkConfig, SuspendEsimOkResponse, TokenOkResponse, TopUpEsimOkResponse, TopUpEsimOkResponseProfile, TopUpEsimOkResponsePurchase, TopUpEsimRequest, ValidationOptions };