celitech-sdk 2.0.6 → 2.0.7

package/README.md

@@ -1,11 +1,11 @@
-# Celitech TypeScript SDK 2.0.6
+# Celitech TypeScript SDK 2.0.7
 
 Welcome to the Celitech SDK documentation. This guide will help you get started with integrating and using the Celitech SDK in your project.
 
 ## Versions
 
-- API version: `2.0.6`
-- SDK version: `2.0.6`
+- API version: `2.0.7`
+- SDK version: `2.0.7`
 
 ## About the API
 

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.
@@ -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 */
@@ -469,8 +485,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,6 +515,7 @@ interface RetryOptions {
     maxDelayMs?: number;
     backoffFactor?: number;
     jitterMs?: number;
+    maxRetryAfterDelayMs?: number;
     statusCodesToRetry?: number[];
     httpMethodsToRetry?: HttpMethod[];
 }
@@ -726,9 +746,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 +794,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 +863,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 +945,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 +1000,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.
+ * @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,10 +1081,9 @@ 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>;
 
@@ -1229,10 +1243,9 @@ 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>;
 
@@ -1292,19 +1305,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.
+ * @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 +1396,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 +1442,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.
+ * @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 +1522,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 +1553,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 +1587,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 +1615,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>;
 
@@ -1739,11 +1745,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 +1777,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 +1893,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 +1941,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 +1965,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 +2001,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 +2031,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 +2077,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 +2101,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,9 +2159,8 @@ declare const getEsimOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {GetEsimOkResponse} getEsimOkResponse
- * @property {GetEsimOkResponseEsim}
+ * @typedef {GetEsimOkResponse} getEsimOkResponse
+ * @property {GetEsimOkResponseEsim} esim
  */
 type GetEsimOkResponse = z.infer<typeof getEsimOkResponse>;
 
@@ -2210,9 +2206,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,9 +2267,8 @@ declare const getEsimHistoryOkResponse: z.ZodLazy<z.ZodObject<{
     };
 }>>;
 /**
- *
- * @typedef  {GetEsimHistoryOkResponse} getEsimHistoryOkResponse
- * @property {GetEsimHistoryOkResponseEsim}
+ * @typedef {GetEsimHistoryOkResponse} getEsimHistoryOkResponse
+ * @property {GetEsimHistoryOkResponseEsim} esim
  */
 type GetEsimHistoryOkResponse = z.infer<typeof getEsimHistoryOkResponse>;
 
@@ -2359,15 +2353,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 +2386,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 +2430,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 +2455,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 +2475,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 +2523,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 +2547,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>;
 
@@ -2595,6 +2582,7 @@ declare class BadRequest extends ThrowableError {
     message: string;
     protected response?: unknown;
     constructor(message: string, response?: unknown);
+    static from(message: string, response?: unknown): BadRequest;
     throw(): void;
 }
 
@@ -2602,6 +2590,7 @@ declare class Unauthorized extends ThrowableError {
     message: string;
     protected response?: unknown;
     constructor(message: string, response?: unknown);
+    static from(message: string, response?: unknown): Unauthorized;
     throw(): void;
 }
 

package/dist/index.js

@@ -382,7 +382,7 @@ var TransportHookAdapter = class {
 function getContentTypeDefinition(contentType) {
   const ct = contentType.toLowerCase();
   if (ct.startsWith("application/") && ct.includes("xml")) {
-    return "xml" /* Xml */;
+    return "text" /* Text */;
   }
   if (ct === "application/x-www-form-urlencoded") {
     return "form" /* FormUrlEncoded */;
@@ -455,7 +455,7 @@ var HookHandler = class {
         } catch (e) {
         }
       }
-      const customError = new error.error((json == null ? void 0 : json.message) || "", json);
+      const customError = error.error.from((json == null ? void 0 : json.message) || "", json);
       customError.metadata = response.metadata;
       customError.throw();
     }
@@ -592,7 +592,6 @@ var ResponseValidationHandler = class {
       ["image" /* Image */]: this.decodeFile,
       ["multipartFormData" /* MultipartFormData */]: this.decodeMultipartFormData,
       ["text" /* Text */]: this.decodeText,
-      ["xml" /* Xml */]: this.decodeText,
       ["form" /* FormUrlEncoded */]: this.decodeFormUrlEncoded,
       ["eventStream" /* EventStream */]: this.decodeEventStream
     };
@@ -808,7 +807,7 @@ var RequestValidationHandler = class {
         }
         throw error;
       }
-    } else if (request.requestContentType === "xml" /* Xml */ || request.requestContentType === "text" /* Text */ || request.requestContentType === "image" /* Image */ || request.requestContentType === "binary" /* Binary */) {
+    } else if (request.requestContentType === "text" /* Text */ || request.requestContentType === "image" /* Image */ || request.requestContentType === "binary" /* Binary */) {
       request.body = request.body;
     } else if (request.requestContentType === "form" /* FormUrlEncoded */) {
       request.body = this.toFormUrlEncoded(request);
@@ -844,7 +843,7 @@ var RequestValidationHandler = class {
       });
       return params.toString();
     }
-    if (typeof validatedBody === "object" && !Array.isArray(validatedBody)) {
+    if (typeof validatedBody === "object" && validatedBody !== null && !Array.isArray(validatedBody)) {
       const params = new URLSearchParams();
       for (const [key, value] of Object.entries(validatedBody)) {
         if (value != null) {
@@ -1060,10 +1059,7 @@ var RequestFetchAdapter = class {
     return headers;
   }
   toArrayBuffer(uint8Array) {
-    return uint8Array.buffer.slice(
-      uint8Array.byteOffset,
-      uint8Array.byteOffset + uint8Array.byteLength
-    );
+    return new Uint8Array(uint8Array).buffer;
   }
 };
 
@@ -1113,7 +1109,7 @@ var RetryHandler = class {
         if (!this.shouldRetry(error, request) || attempt === maxAttempts) {
           throw error;
         }
-        const delayMs = this.calculateDelay(attempt, request);
+        const delayMs = this.calculateDelay(attempt, request, error);
         await this.delay(delayMs);
       }
     }
@@ -1140,7 +1136,7 @@ var RetryHandler = class {
         if (!this.shouldRetry(error, request) || attempt === maxAttempts) {
           throw error;
         }
-        const delayMs = this.calculateDelay(attempt, request);
+        const delayMs = this.calculateDelay(attempt, request, error);
         await this.delay(delayMs);
       }
     }
@@ -1173,18 +1169,25 @@ var RetryHandler = class {
     return shouldRetryStatus && shouldRetryMethod;
   }
   /**
-   * Calculates the delay before the next retry attempt using exponential backoff.
-   * Optionally adds jitter to prevent thundering herd problems.
+   * Calculates the delay before the next retry attempt. A server rate-limit timing header
+   * (Retry-After / X-RateLimit-Reset) on the error, when present, overrides the computed
+   * exponential backoff; otherwise falls back to exponential backoff with optional jitter.
    * @param attempt - The current retry attempt number (1-indexed)
    * @param request - The HTTP request being retried
+   * @param error - The error that triggered the retry (carries the response headers)
    * @returns The delay in milliseconds, capped at the configured maximum delay
    */
-  calculateDelay(attempt, request) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    const baseDelay = (_b = (_a = request.config.retry) == null ? void 0 : _a.delayMs) != null ? _b : 150;
-    const backoffFactor = (_d = (_c = request.config.retry) == null ? void 0 : _c.backoffFactor) != null ? _d : 2;
-    const maxDelay = (_f = (_e = request.config.retry) == null ? void 0 : _e.maxDelayMs) != null ? _f : 5e3;
-    const jitter = (_h = (_g = request.config.retry) == null ? void 0 : _g.jitterMs) != null ? _h : 50;
+  calculateDelay(attempt, request, error) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    const maxRetryAfterDelay = (_b = (_a = request.config.retry) == null ? void 0 : _a.maxRetryAfterDelayMs) != null ? _b : 6e4;
+    const headerDelay = this.retryAfterDelay(error, maxRetryAfterDelay);
+    if (headerDelay !== null) {
+      return Math.floor(headerDelay);
+    }
+    const baseDelay = (_d = (_c = request.config.retry) == null ? void 0 : _c.delayMs) != null ? _d : 150;
+    const backoffFactor = (_f = (_e = request.config.retry) == null ? void 0 : _e.backoffFactor) != null ? _f : 2;
+    const maxDelay = (_h = (_g = request.config.retry) == null ? void 0 : _g.maxDelayMs) != null ? _h : 5e3;
+    const jitter = (_j = (_i = request.config.retry) == null ? void 0 : _i.jitterMs) != null ? _j : 50;
     let delay = baseDelay * Math.pow(backoffFactor, attempt - 1);
     delay = Math.min(delay, maxDelay);
     if (jitter > 0) {
@@ -1192,6 +1195,65 @@ var RetryHandler = class {
     }
     return Math.floor(delay);
   }
+  /**
+   * Returns the server-directed retry delay (ms) from rate-limit response headers,
+   * honoring Retry-After (delta-seconds or HTTP-date) and, when absent, X-RateLimit-Reset
+   * (epoch seconds), clamped to maxRetryAfterDelayMs. Returns null when no usable header is
+   * present so the caller falls back to the computed exponential backoff.
+   * @param error - The error that triggered the retry (carries the response headers)
+   * @param maxRetryAfterDelayMs - Upper bound for a server-directed delay
+   * @returns The delay in milliseconds, or null to use exponential backoff
+   */
+  retryAfterDelay(error, maxRetryAfterDelayMs) {
+    var _a;
+    const headers = (_a = error == null ? void 0 : error.metadata) == null ? void 0 : _a.headers;
+    if (!headers || maxRetryAfterDelayMs <= 0) {
+      return null;
+    }
+    const retryAfterMs = headers["retry-after-ms"];
+    if (retryAfterMs !== void 0 && /^\d+(\.\d+)?$/.test(retryAfterMs.trim())) {
+      return Math.min(Number(retryAfterMs.trim()), maxRetryAfterDelayMs);
+    }
+    const seconds = this.parseRetryAfter(headers["retry-after"]);
+    if (seconds !== null) {
+      return Math.min(Math.max(seconds * 1e3, 0), maxRetryAfterDelayMs);
+    }
+    const reset = headers["x-ratelimit-reset"];
+    if (reset !== void 0 && reset.trim() !== "") {
+      const epoch = Number(reset);
+      if (Number.isFinite(epoch)) {
+        const deltaMs = epoch * 1e3 - Date.now();
+        if (deltaMs > 0) {
+          return Math.min(deltaMs, maxRetryAfterDelayMs);
+        }
+      }
+    }
+    return null;
+  }
+  /**
+   * Parses a Retry-After header value: an integer/float number of seconds, or an HTTP-date
+   * (a past date yields 0). Returns the delay in seconds, or null if empty/unparseable.
+   * @param value - The raw Retry-After header value
+   * @returns The delay in seconds, or null
+   */
+  parseRetryAfter(value) {
+    if (value === void 0) {
+      return null;
+    }
+    const trimmed = value.trim();
+    if (trimmed === "") {
+      return null;
+    }
+    if (/^\d+(\.\d+)?$/.test(trimmed)) {
+      return Number(trimmed);
+    }
+    const dateMs = Date.parse(trimmed);
+    if (!Number.isNaN(dateMs)) {
+      const deltaSeconds = (dateMs - Date.now()) / 1e3;
+      return deltaSeconds > 0 ? deltaSeconds : 0;
+    }
+    return null;
+  }
   /**
    * Delays execution for a specified duration before retrying.
    * @param delayMs - The delay in milliseconds
@@ -1553,7 +1615,7 @@ var QuerySerializer = class extends Serializer {
     }
     const query = [];
     queryParams.forEach((param) => {
-      if (param.value === void 0) {
+      if (param.value === void 0 || param.value === null) {
         return;
       }
       return query.push(`${this.serializeValue(param)}`);
@@ -1575,7 +1637,7 @@ var HeaderSerializer = class extends Serializer {
     }
     const headers = {};
     headerParams.forEach((param) => {
-      if (!param.key) {
+      if (!param.key || param.value === void 0 || param.value === null) {
         return;
       }
       headers[param.key] = this.serializeValue(param);
@@ -1597,7 +1659,7 @@ var CookieSerializer = class {
     }
     const cookies = {};
     cookieParams.forEach((param) => {
-      if (!param.key || param.value === void 0) {
+      if (!param.key || param.value === void 0 || param.value === null) {
         return;
       }
       cookies[param.key] = this.serializeCookieValue(param);
@@ -1917,7 +1979,6 @@ var RequestBuilder = class {
         clientId: "",
         clientSecret: "",
         retry: {
-          attempts: 3,
           delayMs: 150,
           maxDelayMs: 5e3,
           backoffFactor: 2,
@@ -1938,7 +1999,7 @@ var RequestBuilder = class {
     };
     this.addHeaderParam({
       key: "User-Agent",
-      value: "postman-codegen/1.7.0 celitech-sdk/2.0.6 (typescript)"
+      value: "postman-codegen/2.6.0 celitech-sdk/2.0.7 (typescript)"
     });
   }
   setConfig(config) {
@@ -2438,6 +2499,22 @@ var ThrowableError = class extends Error {
     this.message = message;
     this.response = response;
   }
+  /**
+   * 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, response) {
+    return new this(message, response);
+  }
   /**
    * Throws this error instance.
    * Convenience method for explicitly throwing the error.
@@ -2461,11 +2538,16 @@ var BadRequest = class extends ThrowableError {
     super(message);
     this.message = message;
     this.response = response;
-    const parsedResponse = badRequestResponse.parse(response);
-    this.message = parsedResponse.message || "";
+  }
+  static from(message, response) {
+    const error = new BadRequest(message, response);
+    const result = badRequestResponse.safeParse(response);
+    const parsedResponse = result.success ? result.data : response || {};
+    error.message = parsedResponse.message || "";
+    return error;
   }
   throw() {
-    const error = new BadRequest(this.message, this.response);
+    const error = BadRequest.from(this.message, this.response);
     error.metadata = this.metadata;
     throw error;
   }
@@ -2485,11 +2567,16 @@ var Unauthorized = class extends ThrowableError {
     super(message);
     this.message = message;
     this.response = response;
-    const parsedResponse = unauthorizedResponse.parse(response);
-    this.message = parsedResponse.message || "";
+  }
+  static from(message, response) {
+    const error = new Unauthorized(message, response);
+    const result = unauthorizedResponse.safeParse(response);
+    const parsedResponse = result.success ? result.data : response || {};
+    error.message = parsedResponse.message || "";
+    return error;
   }
   throw() {
-    const error = new Unauthorized(this.message, this.response);
+    const error = Unauthorized.from(this.message, this.response);
     error.metadata = this.metadata;
     throw error;
   }

package/dist/index.mjs

@@ -336,7 +336,7 @@ var TransportHookAdapter = class {
 function getContentTypeDefinition(contentType) {
   const ct = contentType.toLowerCase();
   if (ct.startsWith("application/") && ct.includes("xml")) {
-    return "xml" /* Xml */;
+    return "text" /* Text */;
   }
   if (ct === "application/x-www-form-urlencoded") {
     return "form" /* FormUrlEncoded */;
@@ -409,7 +409,7 @@ var HookHandler = class {
         } catch (e) {
         }
       }
-      const customError = new error.error((json == null ? void 0 : json.message) || "", json);
+      const customError = error.error.from((json == null ? void 0 : json.message) || "", json);
       customError.metadata = response.metadata;
       customError.throw();
     }
@@ -546,7 +546,6 @@ var ResponseValidationHandler = class {
       ["image" /* Image */]: this.decodeFile,
       ["multipartFormData" /* MultipartFormData */]: this.decodeMultipartFormData,
       ["text" /* Text */]: this.decodeText,
-      ["xml" /* Xml */]: this.decodeText,
       ["form" /* FormUrlEncoded */]: this.decodeFormUrlEncoded,
       ["eventStream" /* EventStream */]: this.decodeEventStream
     };
@@ -762,7 +761,7 @@ var RequestValidationHandler = class {
         }
         throw error;
       }
-    } else if (request.requestContentType === "xml" /* Xml */ || request.requestContentType === "text" /* Text */ || request.requestContentType === "image" /* Image */ || request.requestContentType === "binary" /* Binary */) {
+    } else if (request.requestContentType === "text" /* Text */ || request.requestContentType === "image" /* Image */ || request.requestContentType === "binary" /* Binary */) {
       request.body = request.body;
     } else if (request.requestContentType === "form" /* FormUrlEncoded */) {
       request.body = this.toFormUrlEncoded(request);
@@ -798,7 +797,7 @@ var RequestValidationHandler = class {
       });
       return params.toString();
     }
-    if (typeof validatedBody === "object" && !Array.isArray(validatedBody)) {
+    if (typeof validatedBody === "object" && validatedBody !== null && !Array.isArray(validatedBody)) {
       const params = new URLSearchParams();
       for (const [key, value] of Object.entries(validatedBody)) {
         if (value != null) {
@@ -1014,10 +1013,7 @@ var RequestFetchAdapter = class {
     return headers;
   }
   toArrayBuffer(uint8Array) {
-    return uint8Array.buffer.slice(
-      uint8Array.byteOffset,
-      uint8Array.byteOffset + uint8Array.byteLength
-    );
+    return new Uint8Array(uint8Array).buffer;
   }
 };
 
@@ -1067,7 +1063,7 @@ var RetryHandler = class {
         if (!this.shouldRetry(error, request) || attempt === maxAttempts) {
           throw error;
         }
-        const delayMs = this.calculateDelay(attempt, request);
+        const delayMs = this.calculateDelay(attempt, request, error);
         await this.delay(delayMs);
       }
     }
@@ -1094,7 +1090,7 @@ var RetryHandler = class {
         if (!this.shouldRetry(error, request) || attempt === maxAttempts) {
           throw error;
         }
-        const delayMs = this.calculateDelay(attempt, request);
+        const delayMs = this.calculateDelay(attempt, request, error);
         await this.delay(delayMs);
       }
     }
@@ -1127,18 +1123,25 @@ var RetryHandler = class {
     return shouldRetryStatus && shouldRetryMethod;
   }
   /**
-   * Calculates the delay before the next retry attempt using exponential backoff.
-   * Optionally adds jitter to prevent thundering herd problems.
+   * Calculates the delay before the next retry attempt. A server rate-limit timing header
+   * (Retry-After / X-RateLimit-Reset) on the error, when present, overrides the computed
+   * exponential backoff; otherwise falls back to exponential backoff with optional jitter.
    * @param attempt - The current retry attempt number (1-indexed)
    * @param request - The HTTP request being retried
+   * @param error - The error that triggered the retry (carries the response headers)
    * @returns The delay in milliseconds, capped at the configured maximum delay
    */
-  calculateDelay(attempt, request) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    const baseDelay = (_b = (_a = request.config.retry) == null ? void 0 : _a.delayMs) != null ? _b : 150;
-    const backoffFactor = (_d = (_c = request.config.retry) == null ? void 0 : _c.backoffFactor) != null ? _d : 2;
-    const maxDelay = (_f = (_e = request.config.retry) == null ? void 0 : _e.maxDelayMs) != null ? _f : 5e3;
-    const jitter = (_h = (_g = request.config.retry) == null ? void 0 : _g.jitterMs) != null ? _h : 50;
+  calculateDelay(attempt, request, error) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    const maxRetryAfterDelay = (_b = (_a = request.config.retry) == null ? void 0 : _a.maxRetryAfterDelayMs) != null ? _b : 6e4;
+    const headerDelay = this.retryAfterDelay(error, maxRetryAfterDelay);
+    if (headerDelay !== null) {
+      return Math.floor(headerDelay);
+    }
+    const baseDelay = (_d = (_c = request.config.retry) == null ? void 0 : _c.delayMs) != null ? _d : 150;
+    const backoffFactor = (_f = (_e = request.config.retry) == null ? void 0 : _e.backoffFactor) != null ? _f : 2;
+    const maxDelay = (_h = (_g = request.config.retry) == null ? void 0 : _g.maxDelayMs) != null ? _h : 5e3;
+    const jitter = (_j = (_i = request.config.retry) == null ? void 0 : _i.jitterMs) != null ? _j : 50;
     let delay = baseDelay * Math.pow(backoffFactor, attempt - 1);
     delay = Math.min(delay, maxDelay);
     if (jitter > 0) {
@@ -1146,6 +1149,65 @@ var RetryHandler = class {
     }
     return Math.floor(delay);
   }
+  /**
+   * Returns the server-directed retry delay (ms) from rate-limit response headers,
+   * honoring Retry-After (delta-seconds or HTTP-date) and, when absent, X-RateLimit-Reset
+   * (epoch seconds), clamped to maxRetryAfterDelayMs. Returns null when no usable header is
+   * present so the caller falls back to the computed exponential backoff.
+   * @param error - The error that triggered the retry (carries the response headers)
+   * @param maxRetryAfterDelayMs - Upper bound for a server-directed delay
+   * @returns The delay in milliseconds, or null to use exponential backoff
+   */
+  retryAfterDelay(error, maxRetryAfterDelayMs) {
+    var _a;
+    const headers = (_a = error == null ? void 0 : error.metadata) == null ? void 0 : _a.headers;
+    if (!headers || maxRetryAfterDelayMs <= 0) {
+      return null;
+    }
+    const retryAfterMs = headers["retry-after-ms"];
+    if (retryAfterMs !== void 0 && /^\d+(\.\d+)?$/.test(retryAfterMs.trim())) {
+      return Math.min(Number(retryAfterMs.trim()), maxRetryAfterDelayMs);
+    }
+    const seconds = this.parseRetryAfter(headers["retry-after"]);
+    if (seconds !== null) {
+      return Math.min(Math.max(seconds * 1e3, 0), maxRetryAfterDelayMs);
+    }
+    const reset = headers["x-ratelimit-reset"];
+    if (reset !== void 0 && reset.trim() !== "") {
+      const epoch = Number(reset);
+      if (Number.isFinite(epoch)) {
+        const deltaMs = epoch * 1e3 - Date.now();
+        if (deltaMs > 0) {
+          return Math.min(deltaMs, maxRetryAfterDelayMs);
+        }
+      }
+    }
+    return null;
+  }
+  /**
+   * Parses a Retry-After header value: an integer/float number of seconds, or an HTTP-date
+   * (a past date yields 0). Returns the delay in seconds, or null if empty/unparseable.
+   * @param value - The raw Retry-After header value
+   * @returns The delay in seconds, or null
+   */
+  parseRetryAfter(value) {
+    if (value === void 0) {
+      return null;
+    }
+    const trimmed = value.trim();
+    if (trimmed === "") {
+      return null;
+    }
+    if (/^\d+(\.\d+)?$/.test(trimmed)) {
+      return Number(trimmed);
+    }
+    const dateMs = Date.parse(trimmed);
+    if (!Number.isNaN(dateMs)) {
+      const deltaSeconds = (dateMs - Date.now()) / 1e3;
+      return deltaSeconds > 0 ? deltaSeconds : 0;
+    }
+    return null;
+  }
   /**
    * Delays execution for a specified duration before retrying.
    * @param delayMs - The delay in milliseconds
@@ -1507,7 +1569,7 @@ var QuerySerializer = class extends Serializer {
     }
     const query = [];
     queryParams.forEach((param) => {
-      if (param.value === void 0) {
+      if (param.value === void 0 || param.value === null) {
         return;
       }
       return query.push(`${this.serializeValue(param)}`);
@@ -1529,7 +1591,7 @@ var HeaderSerializer = class extends Serializer {
     }
     const headers = {};
     headerParams.forEach((param) => {
-      if (!param.key) {
+      if (!param.key || param.value === void 0 || param.value === null) {
         return;
       }
       headers[param.key] = this.serializeValue(param);
@@ -1551,7 +1613,7 @@ var CookieSerializer = class {
     }
     const cookies = {};
     cookieParams.forEach((param) => {
-      if (!param.key || param.value === void 0) {
+      if (!param.key || param.value === void 0 || param.value === null) {
         return;
       }
       cookies[param.key] = this.serializeCookieValue(param);
@@ -1871,7 +1933,6 @@ var RequestBuilder = class {
         clientId: "",
         clientSecret: "",
         retry: {
-          attempts: 3,
           delayMs: 150,
           maxDelayMs: 5e3,
           backoffFactor: 2,
@@ -1892,7 +1953,7 @@ var RequestBuilder = class {
     };
     this.addHeaderParam({
       key: "User-Agent",
-      value: "postman-codegen/1.7.0 celitech-sdk/2.0.6 (typescript)"
+      value: "postman-codegen/2.6.0 celitech-sdk/2.0.7 (typescript)"
     });
   }
   setConfig(config) {
@@ -2392,6 +2453,22 @@ var ThrowableError = class extends Error {
     this.message = message;
     this.response = response;
   }
+  /**
+   * 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, response) {
+    return new this(message, response);
+  }
   /**
    * Throws this error instance.
    * Convenience method for explicitly throwing the error.
@@ -2415,11 +2492,16 @@ var BadRequest = class extends ThrowableError {
     super(message);
     this.message = message;
     this.response = response;
-    const parsedResponse = badRequestResponse.parse(response);
-    this.message = parsedResponse.message || "";
+  }
+  static from(message, response) {
+    const error = new BadRequest(message, response);
+    const result = badRequestResponse.safeParse(response);
+    const parsedResponse = result.success ? result.data : response || {};
+    error.message = parsedResponse.message || "";
+    return error;
   }
   throw() {
-    const error = new BadRequest(this.message, this.response);
+    const error = BadRequest.from(this.message, this.response);
     error.metadata = this.metadata;
     throw error;
   }
@@ -2439,11 +2521,16 @@ var Unauthorized = class extends ThrowableError {
     super(message);
     this.message = message;
     this.response = response;
-    const parsedResponse = unauthorizedResponse.parse(response);
-    this.message = parsedResponse.message || "";
+  }
+  static from(message, response) {
+    const error = new Unauthorized(message, response);
+    const result = unauthorizedResponse.safeParse(response);
+    const parsedResponse = result.success ? result.data : response || {};
+    error.message = parsedResponse.message || "";
+    return error;
   }
   throw() {
-    const error = new Unauthorized(this.message, this.response);
+    const error = Unauthorized.from(this.message, this.response);
     error.metadata = this.metadata;
     throw error;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "celitech-sdk",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "description": "Welcome to the CELITECH API documentation!  Useful links: [Homepage](https://www.celitech.com) | [Support email](mailto:support@celitech.com) | [Blog](https://www.celitech.com/blog/)",
   "source": "./src/index.ts",
   "main": "./dist/index.js",