celitech-sdk 2.0.6 → 2.0.10

package/dist/index.d.ts

@@ -182,6 +182,20 @@ declare class ThrowableError extends Error {
      * @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.
@@ -195,7 +209,7 @@ declare class ThrowableError extends Error {
  * Used to match and validate responses based on content type and status code.
  */
 interface ResponseDefinition {
-    /** Zod schema for validating the response body */
+    /** Schema for validating the response body */
     schema: ZodType;
     /** The content type of this response (e.g., 'application/json') */
     contentType: ContentType;
@@ -207,8 +221,10 @@ interface ResponseDefinition {
  * Used to throw typed errors based on content type and status code.
  */
 interface ErrorDefinition {
-    /** Constructor for the error class to instantiate */
-    error: new (...args: any[]) => ThrowableError;
+    /** 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 */
@@ -273,7 +289,7 @@ interface RequestPagination<Page> {
     pageSize?: number;
     /** JSON path to extract page data from response */
     pagePath: string[];
-    /** Zod schema for validating page data */
+    /** Schema for validating page data */
     pageSchema?: ZodType<Page, any, any>;
 }
 /**
@@ -285,12 +301,12 @@ interface RequestPagination<Page> {
 interface RequestCursorPagination<Page> {
     /** JSON path to extract page data from response */
     pagePath: string[];
-    /** Zod schema for validating page data */
+    /** Schema for validating page data */
     pageSchema?: ZodType<Page, any, any>;
     /** JSON path to extract next cursor from response */
     cursorPath: string[];
-    /** Zod schema for validating cursor value */
-    cursorSchema?: ZodType<string | null | undefined>;
+    /** Schema for validating cursor value */
+    cursorSchema?: ZodType<any, any, any>;
 }
 
 /**
@@ -387,8 +403,11 @@ declare class Request<PageSchema = unknown[]> {
      * 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): void;
+    nextPage(cursor?: string, offsetIncrement?: number): void;
     private constructPath;
     private getOffsetParam;
     private getCursorParam;
@@ -469,8 +488,11 @@ interface CursorPaginatedHttpResponse<T = unknown> extends HttpResponse<T> {
 declare enum ContentType {
     /** JSON format (application/json) */
     Json = "json",
-    /** XML format (application/xml, text/xml) */
-    Xml = "xml",
+    /**
+     * @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/*) */
@@ -496,11 +518,13 @@ interface RetryOptions {
     maxDelayMs?: number;
     backoffFactor?: number;
     jitterMs?: number;
+    maxRetryAfterDelayMs?: number;
     statusCodesToRetry?: number[];
     httpMethodsToRetry?: HttpMethod[];
 }
 interface ValidationOptions {
     responseValidation?: boolean;
+    requestValidation?: boolean;
 }
 
 /**
@@ -679,6 +703,7 @@ declare class BaseService {
      * @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);
@@ -726,9 +751,8 @@ declare const listDestinationsOkResponse: z.ZodLazy<z.ZodObject<{
     }[];
 }>>;
 /**
- *
- * @typedef  {ListDestinationsOkResponse} listDestinationsOkResponse
- * @property {Destinations[]}
+ * @typedef {ListDestinationsOkResponse} listDestinationsOkResponse
+ * @property {Destinations[]} destinations
  */
 type ListDestinationsOkResponse = z.infer<typeof listDestinationsOkResponse>;
 
@@ -775,12 +799,11 @@ declare const destinations: z.ZodLazy<z.ZodObject<{
     supportedCountries: string[];
 }>>;
 /**
- *
- * @typedef  {Destinations} destinations
- * @property {string} - Name of the destination
- * @property {string} - ISO3 representation of the destination
- * @property {string} - ISO2 representation of the destination
- * @property {string[]} - 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.
+ * @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>;
 
@@ -845,10 +868,9 @@ declare const listPackagesOkResponse: z.ZodLazy<z.ZodObject<{
     afterCursor: string | null;
 }>>;
 /**
- *
- * @typedef  {ListPackagesOkResponse} listPackagesOkResponse
- * @property {Packages[]}
- * @property {string} - 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
+ * @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>;
 
@@ -928,16 +950,15 @@ declare const packages: z.ZodLazy<z.ZodObject<{
     priceInCents: number;
 }>>;
 /**
- *
- * @typedef  {Packages} packages
- * @property {string} - ID of the package
- * @property {string} - ISO3 representation of the package's destination.
- * @property {string} - ISO2 representation of the package's destination.
- * @property {number} - Size of the package in Bytes. A value of `-1` indicates an unlimited package.
- * @property {number} - Size of the package in GB. A value of `-1` indicates an unlimited (date-based) package.
- * @property {number} - Min number of days for the package
- * @property {number} - Max number of days for the package
- * @property {number} - Price of the package in cents
+ * @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>;
 
@@ -984,19 +1005,18 @@ declare const createPurchaseV2Request: z.ZodLazy<z.ZodObject<{
     language?: string | undefined;
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseV2Request} createPurchaseV2Request
- * @property {string} - ISO representation of the package's destination. Supports both ISO2 (e.g., 'FR') and ISO3 (e.g., 'FRA') country codes.
- * @property {number} - 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} - 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} - 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 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} - Number of eSIMs to purchase.
- * @property {string} - Email address where the purchase confirmation email will be sent (including QR Code & activation steps)
- * @property {string} - An identifier provided by the partner to link this purchase to their booking or transaction for analytics and debugging purposes.
- * @property {string} - 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} - 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 of the confirmation email sent to the customer.
+ * @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>;
 
@@ -1066,13 +1086,37 @@ declare const createPurchaseV2OkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseV2OkResponse} createPurchaseV2OkResponse
- * @property {CreatePurchaseV2OkResponsePurchase}
- * @property {CreatePurchaseV2OkResponseProfile}
+ * @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.
@@ -1229,26 +1273,12 @@ declare const listPurchasesOkResponse: z.ZodLazy<z.ZodObject<{
     }[];
 }>>;
 /**
- *
- * @typedef  {ListPurchasesOkResponse} listPurchasesOkResponse
- * @property {Purchases[]}
- * @property {string} - 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.
+ * @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>;
 
-interface ListPurchasesParams {
-    purchaseId?: string;
-    iccid?: string;
-    afterDate?: string;
-    beforeDate?: string;
-    email?: string;
-    referenceId?: string;
-    afterCursor?: string;
-    limit?: number;
-    after?: number;
-    before?: number;
-}
-
 /**
  * Zod schema for the CreatePurchaseRequest model.
  * Defines the structure and validation rules for this data type.
@@ -1292,19 +1322,18 @@ declare const createPurchaseRequest: z.ZodLazy<z.ZodObject<{
     endTime?: number | undefined;
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseRequest} createPurchaseRequest
- * @property {string} - ISO representation of the package's destination. Supports both ISO2 (e.g., 'FR') and ISO3 (e.g., 'FRA') country codes.
- * @property {number} - 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} - 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} - 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 address where the purchase confirmation email will be sent (including QR Code & activation steps)
- * @property {string} - An identifier provided by the partner to link this purchase to their booking or transaction for analytics and debugging purposes.
- * @property {string} - 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} - 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 of the confirmation email sent to the customer.
- * @property {number} - 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} - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time.
+ * @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>;
 
@@ -1384,10 +1413,9 @@ declare const createPurchaseOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseOkResponse} createPurchaseOkResponse
- * @property {CreatePurchaseOkResponsePurchase}
- * @property {CreatePurchaseOkResponseProfile}
+ * @typedef {CreatePurchaseOkResponse} createPurchaseOkResponse
+ * @property {CreatePurchaseOkResponsePurchase} purchase
+ * @property {CreatePurchaseOkResponseProfile} profile
  */
 type CreatePurchaseOkResponse = z.infer<typeof createPurchaseOkResponse>;
 
@@ -1431,18 +1459,17 @@ declare const topUpEsimRequest: z.ZodLazy<z.ZodObject<{
     endTime?: number | undefined;
 }>>;
 /**
- *
- * @typedef  {TopUpEsimRequest} topUpEsimRequest
- * @property {string} - ID of the eSIM
- * @property {number} - 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} - 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} - 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 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 address where the purchase confirmation email will be sent (excluding QR Code & activation steps).
- * @property {string} - An identifier provided by the partner to link this purchase to their booking or transaction for analytics and debugging purposes.
- * @property {string} - 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} - 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} - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time.
+ * @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>;
 
@@ -1512,10 +1539,9 @@ declare const topUpEsimOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {TopUpEsimOkResponse} topUpEsimOkResponse
- * @property {TopUpEsimOkResponsePurchase}
- * @property {TopUpEsimOkResponseProfile}
+ * @typedef {TopUpEsimOkResponse} topUpEsimOkResponse
+ * @property {TopUpEsimOkResponsePurchase} purchase
+ * @property {TopUpEsimOkResponseProfile} profile
  */
 type TopUpEsimOkResponse = z.infer<typeof topUpEsimOkResponse>;
 
@@ -1544,13 +1570,12 @@ declare const editPurchaseRequest: z.ZodLazy<z.ZodObject<{
     endTime?: number | undefined;
 }>>;
 /**
- *
- * @typedef  {EditPurchaseRequest} editPurchaseRequest
- * @property {string} - ID of the purchase
- * @property {string} - 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} - 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} - 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} - Epoch value representing the end time of the package's validity. End time can be maximum 90 days after Start time.
+ * @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>;
 
@@ -1579,13 +1604,12 @@ declare const editPurchaseOkResponse: z.ZodLazy<z.ZodObject<{
     newEndTime?: number | null | undefined;
 }>>;
 /**
- *
- * @typedef  {EditPurchaseOkResponse} editPurchaseOkResponse
- * @property {string} - ID of the purchase
- * @property {string} - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {string} - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {number} - Epoch value representing the new start time of the package's validity
- * @property {number} - Epoch value representing the new end time of the package's validity
+ * @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>;
 
@@ -1608,11 +1632,10 @@ declare const getPurchaseConsumptionOkResponse: z.ZodLazy<z.ZodObject<{
     dataUsageRemainingInGb: number;
 }>>;
 /**
- *
- * @typedef  {GetPurchaseConsumptionOkResponse} getPurchaseConsumptionOkResponse
- * @property {number} - Remaining balance of the package in bytes. Returns `-1` for unlimited packages.
- * @property {number} - Remaining balance of the package in GB. Returns `-1` for unlimited packages.
- * @property {string} - Status of the connectivity, possible values are 'ACTIVE' or 'NOT_ACTIVE'
+ * @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>;
 
@@ -1666,10 +1689,11 @@ declare class PurchasesService extends BaseService {
     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, requestConfig?: Partial<SdkConfig>): Promise<CreatePurchaseV2OkResponse[]>;
+    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
@@ -1688,16 +1712,18 @@ declare class PurchasesService extends BaseService {
     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, requestConfig?: Partial<SdkConfig>): Promise<CreatePurchaseOkResponse>;
+    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, requestConfig?: Partial<SdkConfig>): Promise<TopUpEsimOkResponse>;
+    topUpEsim(body: TopUpEsimRequest, params?: TopUpEsimParams, requestConfig?: Partial<SdkConfig>): Promise<TopUpEsimOkResponse>;
     /**
    * This endpoint allows you to modify the validity dates of an existing purchase.
   **Behavior:**
@@ -1707,10 +1733,11 @@ declare class PurchasesService extends BaseService {
   
   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, requestConfig?: Partial<SdkConfig>): Promise<EditPurchaseOkResponse>;
+    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
@@ -1739,11 +1766,10 @@ declare const createPurchaseV2OkResponsePurchase: z.ZodLazy<z.ZodObject<{
     createdDate: string;
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseV2OkResponsePurchase} createPurchaseV2OkResponsePurchase
- * @property {string} - ID of the purchase
- * @property {string} - ID of the package
- * @property {string} - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
+ * @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>;
 
@@ -1772,13 +1798,12 @@ declare const createPurchaseV2OkResponseProfile: z.ZodLazy<z.ZodObject<{
     androidActivationLink: string;
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseV2OkResponseProfile} createPurchaseV2OkResponseProfile
- * @property {string} - ID of the eSIM
- * @property {string} - QR Code of the eSIM as base64
- * @property {string} - Manual Activation Code of the eSIM
- * @property {string} - iOS Activation Link of the eSIM
- * @property {string} - Android Activation Link of the eSIM
+ * @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>;
 
@@ -1889,21 +1914,20 @@ declare const purchases: z.ZodLazy<z.ZodObject<{
     referenceId?: string | null | undefined;
 }>>;
 /**
- *
- * @typedef  {Purchases} purchases
- * @property {string} - ID of the purchase
- * @property {string} - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {string} - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {number} - Duration of the package in days. Possible values are 1, 2, 7, 14, 30, or 90. `null` for unlimited (date-based) packages.
- * @property {string} - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {number} - Epoch value representing the start time of the package's validity
- * @property {number} - Epoch value representing the end time of the package's validity
- * @property {number} - Epoch value representing the date of creation of the purchase
- * @property {Package_}
- * @property {PurchasesEsim}
- * @property {string} - 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} - 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} - 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.
+ * @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>;
 
@@ -1938,15 +1962,14 @@ declare const package_: z.ZodLazy<z.ZodObject<{
     destinationName: string;
 }>>;
 /**
- *
- * @typedef  {Package_} package_
- * @property {string} - ID of the package
- * @property {number} - Size of the package in Bytes. A value of `-1` indicates an unlimited package.
- * @property {number} - Size of the package in GB. A value of `-1` indicates an unlimited (date-based) package.
- * @property {string} - ISO3 representation of the package's destination.
- * @property {string} - ISO2 representation of the package's destination.
- * @property {string} - Name of the package's destination
- * @property {number} - Price of the package in cents
+ * @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_>;
 
@@ -1963,9 +1986,8 @@ declare const purchasesEsim: z.ZodLazy<z.ZodObject<{
     iccid: string;
 }>>;
 /**
- *
- * @typedef  {PurchasesEsim} purchasesEsim
- * @property {string} - ID of the eSIM
+ * @typedef {PurchasesEsim} purchasesEsim
+ * @property {string} iccid - ID of the eSIM
  */
 type PurchasesEsim = z.infer<typeof purchasesEsim>;
 
@@ -2000,15 +2022,14 @@ declare const createPurchaseOkResponsePurchase: z.ZodLazy<z.ZodObject<{
     endTime?: number | null | undefined;
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseOkResponsePurchase} createPurchaseOkResponsePurchase
- * @property {string} - ID of the purchase
- * @property {string} - ID of the package
- * @property {string} - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {string} - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {string} - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {number} - Epoch value representing the start time of the package's validity
- * @property {number} - Epoch value representing the end time of the package's validity
+ * @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>;
 
@@ -2031,11 +2052,10 @@ declare const createPurchaseOkResponseProfile: z.ZodLazy<z.ZodObject<{
     manualActivationCode: string;
 }>>;
 /**
- *
- * @typedef  {CreatePurchaseOkResponseProfile} createPurchaseOkResponseProfile
- * @property {string} - ID of the eSIM
- * @property {string} - QR Code of the eSIM as base64
- * @property {string} - Manual Activation Code of the eSIM
+ * @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>;
 
@@ -2078,15 +2098,14 @@ declare const topUpEsimOkResponsePurchase: z.ZodLazy<z.ZodObject<{
     endTime?: number | null | undefined;
 }>>;
 /**
- *
- * @typedef  {TopUpEsimOkResponsePurchase} topUpEsimOkResponsePurchase
- * @property {string} - ID of the purchase
- * @property {string} - ID of the package
- * @property {string} - Start date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {string} - End date of the package's validity in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {string} - Creation date of the purchase in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {number} - Epoch value representing the start time of the package's validity
- * @property {number} - Epoch value representing the end time of the package's validity
+ * @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>;
 
@@ -2103,9 +2122,8 @@ declare const topUpEsimOkResponseProfile: z.ZodLazy<z.ZodObject<{
     iccid: string;
 }>>;
 /**
- *
- * @typedef  {TopUpEsimOkResponseProfile} topUpEsimOkResponseProfile
- * @property {string} - ID of the eSIM
+ * @typedef {TopUpEsimOkResponseProfile} topUpEsimOkResponseProfile
+ * @property {string} iccid - ID of the eSIM
  */
 type TopUpEsimOkResponseProfile = z.infer<typeof topUpEsimOkResponseProfile>;
 
@@ -2162,15 +2180,17 @@ declare const getEsimOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {GetEsimOkResponse} getEsimOkResponse
- * @property {GetEsimOkResponseEsim}
+ * @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.
@@ -2210,9 +2230,8 @@ declare const getEsimDeviceOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {GetEsimDeviceOkResponse} getEsimDeviceOkResponse
- * @property {Device}
+ * @typedef {GetEsimDeviceOkResponse} getEsimDeviceOkResponse
+ * @property {Device} device
  */
 type GetEsimDeviceOkResponse = z.infer<typeof getEsimDeviceOkResponse>;
 
@@ -2272,12 +2291,29 @@ declare const getEsimHistoryOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {GetEsimHistoryOkResponse} getEsimHistoryOkResponse
- * @property {GetEsimHistoryOkResponseEsim}
+ * @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.
@@ -2287,6 +2323,7 @@ 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
@@ -2305,6 +2342,12 @@ declare class ESimService extends BaseService {
      * @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
@@ -2326,6 +2369,14 @@ declare class ESimService extends BaseService {
      * @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>;
 }
 
 /**
@@ -2359,15 +2410,14 @@ declare const getEsimOkResponseEsim: z.ZodLazy<z.ZodObject<{
     isTopUpAllowed: boolean;
 }>>;
 /**
- *
- * @typedef  {GetEsimOkResponseEsim} getEsimOkResponseEsim
- * @property {string} - ID of the eSIM
- * @property {string} - SM-DP+ Address
- * @property {string} - QR Code of the eSIM as base64
- * @property {string} - The manual activation code
- * @property {string} - Status of the eSIM, possible values are 'RELEASED', 'DOWNLOADED', 'INSTALLED', 'ENABLED', 'DELETED', or 'ERROR'
- * @property {string} - Status of the eSIM connectivity, possible values are 'ACTIVE' or 'NOT_ACTIVE'
- * @property {boolean} - Indicates whether the eSIM is currently eligible for a top-up. This flag should be checked before attempting a top-up request.
+ * @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>;
 
@@ -2393,12 +2443,11 @@ declare const device: z.ZodLazy<z.ZodObject<{
     eid: string;
 }>>;
 /**
- *
- * @typedef  {Device} device
- * @property {string} - Name of the OEM
- * @property {string} - Name of the Device
- * @property {string} - Model of the Device
- * @property {string} - Serial Number of the eSIM
+ * @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>;
 
@@ -2438,10 +2487,9 @@ declare const getEsimHistoryOkResponseEsim: z.ZodLazy<z.ZodObject<{
     }[];
 }>>;
 /**
- *
- * @typedef  {GetEsimHistoryOkResponseEsim} getEsimHistoryOkResponseEsim
- * @property {string} - ID of the eSIM
- * @property {History[]}
+ * @typedef {GetEsimHistoryOkResponseEsim} getEsimHistoryOkResponseEsim
+ * @property {string} iccid - ID of the eSIM
+ * @property {History[]} history
  */
 type GetEsimHistoryOkResponseEsim = z.infer<typeof getEsimHistoryOkResponseEsim>;
 
@@ -2464,11 +2512,10 @@ declare const history: z.ZodLazy<z.ZodObject<{
     date?: number | undefined;
 }>>;
 /**
- *
- * @typedef  {History} history
- * @property {string} - The status of the eSIM at a given time, possible values are 'RELEASED', 'DOWNLOADED', 'INSTALLED', 'ENABLED', 'DELETED', or 'ERROR'
- * @property {string} - The date when the eSIM status changed in the format 'yyyy-MM-ddThh:mm:ssZZ'
- * @property {number} - Epoch value representing the date when the eSIM status changed
+ * @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>;
 
@@ -2485,9 +2532,8 @@ declare const tokenOkResponse: z.ZodLazy<z.ZodObject<{
     token: string;
 }>>;
 /**
- *
- * @typedef  {TokenOkResponse} tokenOkResponse
- * @property {string} - The generated token
+ * @typedef {TokenOkResponse} tokenOkResponse
+ * @property {string} token - The generated token
  */
 type TokenOkResponse = z.infer<typeof tokenOkResponse>;
 
@@ -2534,12 +2580,11 @@ declare const oAuthTokenRequest: z.ZodLazy<z.ZodObject<{
     scope: string;
 }>>;
 /**
- *
- * @typedef  {OAuthTokenRequest} oAuthTokenRequest
- * @property {GrantType}
- * @property {string}
- * @property {string}
- * @property {string}
+ * @typedef {OAuthTokenRequest} oAuthTokenRequest
+ * @property {GrantType} grantType
+ * @property {string} clientId
+ * @property {string} clientSecret
+ * @property {string} scope
  */
 type OAuthTokenRequest = z.infer<typeof oAuthTokenRequest>;
 
@@ -2559,10 +2604,9 @@ declare const oAuthTokenResponse: z.ZodLazy<z.ZodObject<{
     expiresIn?: number | null | undefined;
 }>>;
 /**
- *
- * @typedef  {OAuthTokenResponse} oAuthTokenResponse
- * @property {string}
- * @property {number}
+ * @typedef {OAuthTokenResponse} oAuthTokenResponse
+ * @property {string} accessToken
+ * @property {number} expiresIn
  */
 type OAuthTokenResponse = z.infer<typeof oAuthTokenResponse>;
 
@@ -2591,17 +2635,11 @@ declare enum GrantType {
     CLIENT_CREDENTIALS = "client_credentials"
 }
 
-declare class BadRequest extends ThrowableError {
-    message: string;
-    protected response?: unknown;
-    constructor(message: string, response?: unknown);
-    throw(): void;
-}
-
-declare class Unauthorized extends ThrowableError {
+declare class ErrorResponse extends ThrowableError {
     message: string;
     protected response?: unknown;
     constructor(message: string, response?: unknown);
+    static from(message: string, response?: unknown): ErrorResponse;
     throw(): void;
 }
 
@@ -2623,4 +2661,4 @@ declare class Celitech {
     set accessToken(accessToken: string);
 }
 
-export { BadRequest, Celitech, CreatePurchaseOkResponse, CreatePurchaseOkResponseProfile, CreatePurchaseOkResponsePurchase, CreatePurchaseRequest, CreatePurchaseRequestLanguage, CreatePurchaseV2OkResponse, CreatePurchaseV2OkResponseProfile, CreatePurchaseV2OkResponsePurchase, CreatePurchaseV2Request, CreatePurchaseV2RequestLanguage, Destinations, DestinationsService, Device, ESimService, EditPurchaseOkResponse, EditPurchaseRequest, Environment, 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, TokenOkResponse, TopUpEsimOkResponse, TopUpEsimOkResponseProfile, TopUpEsimOkResponsePurchase, TopUpEsimRequest, Unauthorized, ValidationOptions };
+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 };