chargebee 3.23.1 → 3.25.0-beta.1

package/CHANGELOG.md

@@ -1,3 +1,100 @@
+### v3.25.0-beta.1 (2026-05-14)
+* * *
+
+### Experimental
+- **Zod-backed request validation (beta)** — Enable `enableValidation` on the client to validate outgoing request payloads against generated Zod schemas before each API call; invalid payloads raise `ChargebeeZodValidationError` with the original `ZodError` for inspection.
+- **Runtime dependency** — Added [`zod`](https://www.npmjs.com/package/zod) (v4) as a dependency to support the above.
+
+
+### v3.24.0 (2026-05-04)
+* * *
+### New Resources:
+- [`QuoteEntitlement`](https://apidocs.chargebee.com/docs/api/quote_entitlements) has been added.
+
+
+### New Actions:
+- [`list_applicable_alerts_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription) has been added to [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`retrieve_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/retrieve-an-alert) has been added to [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`update_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/update-an-alert) has been added to [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`delete_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/delete-an-alert) has been added to [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) has been added to [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) has been added to [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`list_alert_statuses_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription) has been added to [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`list_alert_statuses_for_an_alert`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert) has been added to [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+
+
+### New Attributes:
+- [`alarm_status`](https://apidocs.chargebee.com/docs/api/alert_statuses/alert-status-object#alarm_status) has been added to [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+
+
+### New Parameters:
+- [`limit`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription#limit) has been added as query parameter to [`list_applicable_alerts_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`offset`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription#offset) has been added as query parameter to [`list_applicable_alerts_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`status`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription#status) has been added as query parameter to [`list_applicable_alerts_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`type`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription#type) has been added as query parameter to [`list_applicable_alerts_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`limit`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts#limit) has been added as query parameter to [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`offset`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts#offset) has been added as query parameter to [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`id`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts#id) has been added as query parameter to [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`type`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts#type) has been added as query parameter to [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`subscription_id`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts#subscription_id) has been added as query parameter to [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`status`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts#status) has been added as query parameter to [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`limit`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription#limit) has been added as query parameter to [`list_alert_statuses_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`offset`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription#offset) has been added as query parameter to [`list_alert_statuses_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`alarm_status`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription#alarm_status) has been added as query parameter to [`list_alert_statuses_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`alert_id`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription#alert_id) has been added as query parameter to [`list_alert_statuses_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-a-subscription) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`limit`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert#limit) has been added as query parameter to [`list_alert_statuses_for_an_alert`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`offset`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert#offset) has been added as query parameter to [`list_alert_statuses_for_an_alert`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`alarm_status`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert#alarm_status) has been added as query parameter to [`list_alert_statuses_for_an_alert`](https://apidocs.chargebee.com/docs/api/alert_statuses/list-alert-statuses-for-an-alert) in [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+- [`exclude`](https://apidocs.chargebee.com/docs/api/invoices/list-invoices#exclude) has been added as query parameter to [`list_invoices`](https://apidocs.chargebee.com/docs/api/invoices/list-invoices) in [`Invoice`](https://apidocs.chargebee.com/docs/api/invoices).
+- [`threshold`](https://apidocs.chargebee.com/docs/api/alerts/update-an-alert#threshold) has been added as request body parameter to [`update_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/update-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`status`](https://apidocs.chargebee.com/docs/api/alerts/update-an-alert#status) has been added as request body parameter to [`update_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/update-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`threshold`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#threshold) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`filter_conditions`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#filter_conditions) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`type`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#type) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`name`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#name) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`description`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#description) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`metered_feature_id`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#metered_feature_id) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`subscription_id`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#subscription_id) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`meta`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert#meta) has been added as request body parameter to [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) in [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- [`defer_payment_method_type`](https://apidocs.chargebee.com/docs/api/payment_intents/create-a-payment-intent#defer_payment_method_type) has been added as request body parameter to [`create_a_payment_intent`](https://apidocs.chargebee.com/docs/api/payment_intents/create-a-payment-intent) in [`PaymentIntent`](https://apidocs.chargebee.com/docs/api/payment_intents).
+- [`net_term_days`](https://apidocs.chargebee.com/docs/api/quotes/edit-quote-for-charge-items-and-charges#net_term_days) has been added as request body parameter to [`edit_quote_for_charge_items_and_charges`](https://apidocs.chargebee.com/docs/api/quotes/edit-quote-for-charge-items-and-charges) in [`Quote`](https://apidocs.chargebee.com/docs/api/quotes).
+- [`net_term_days`](https://apidocs.chargebee.com/docs/api/quotes/create-a-quote-for-charge-and-charge-items#net_term_days) has been added as request body parameter to [`create_a_quote_for_charge_and_charge_items`](https://apidocs.chargebee.com/docs/api/quotes/create-a-quote-for-charge-and-charge-items) in [`Quote`](https://apidocs.chargebee.com/docs/api/quotes).
+
+
+### Deleted Attributes:
+- `alarm_triggered_at` has been removed from [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `scope` has been removed from [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `alert_status` has been removed from [`AlertStatus`](https://apidocs.chargebee.com/docs/api/alert_statuses).
+
+
+### New Enums:
+- `within_limit` and `in_alarm` have been added as new values enum `AlarmStatus`.
+- `moyasar` and `payway` have been added as new values enum `Gateway`.
+- `absolute` and `percentage` have been added as new values enum `Mode`.
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values enum `PaymentMethod`.
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values enum `PaymentMethodType`.
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values enum `Type`.
+- `mada` has been added as a new value to enum attribute [`card_type`](https://apidocs.chargebee.com/docs/api/cards/card-object#card_type) in [`Card`](https://apidocs.chargebee.com/docs/api/cards).
+- `rate_limited` has been added as a new value to enum attribute [`webhook_status`](https://apidocs.chargebee.com/docs/api/events/event-object#webhook_status) in [`Event`](https://apidocs.chargebee.com/docs/api/events).
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values to enum attribute [`payment_method_type`](https://apidocs.chargebee.com/docs/api/payment_intents/payment-intent-object#payment_method_type) in [`PaymentIntent`](https://apidocs.chargebee.com/docs/api/payment_intents).
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values to enum attribute [`active_payment_attempt.payment_method_type`](https://apidocs.chargebee.com/docs/api/payment_intents/payment-intent-object#active_payment_attempt_payment_method_type) in [`PaymentIntent`](https://apidocs.chargebee.com/docs/api/payment_intents).
+- `mada` has been added as a new value to enum attribute [`card.brand`](https://apidocs.chargebee.com/docs/api/payment_sources/payment-source-object#card_brand) in [`PaymentSource`](https://apidocs.chargebee.com/docs/api/payment_sources).
+- `plan_price`, `addon_price`, `charge_price`, and `charge` have been added as new values to enum attribute [`entity_type`](https://apidocs.chargebee.com/docs/api/quote_entitlements/quote-entitlement-object#entity_type) in [`QuoteEntitlement`](https://apidocs.chargebee.com/docs/api/quote_entitlements).
+- `disabled` and `enabled` have been added as new values to enum query parameter `status.is` in [`list_applicable_alerts_for_a_subscription`](https://apidocs.chargebee.com/docs/api/alerts/list-applicable-alerts-for-a-subscription) of [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `enabled` and `disabled` have been added as new values to enum request body parameter `status` in [`update_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/update-an-alert) of [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `disabled` and `enabled` have been added as new values to enum query parameter `status.is` in [`list_alerts`](https://apidocs.chargebee.com/docs/api/alerts/list-alerts) of [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `plan_price_id` has been added as a new value to enum request body parameter `filter_conditions.field` in [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) of [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `not_equals` and `equals` have been added as new values to enum request body parameter `filter_conditions.operator` in [`create_an_alert`](https://apidocs.chargebee.com/docs/api/alerts/create-an-alert) of [`Alert`](https://apidocs.chargebee.com/docs/api/alerts).
+- `rate_limited` has been added as a new value to enum query parameter `webhook_status.is` in [`list_events`](https://apidocs.chargebee.com/docs/api/events/list-events) of [`Event`](https://apidocs.chargebee.com/docs/api/events).
+- `rate_limited` has been added as a new value to enum query parameter `webhook_status.is_not` in [`list_events`](https://apidocs.chargebee.com/docs/api/events/list-events) of [`Event`](https://apidocs.chargebee.com/docs/api/events).
+- `rate_limited` has been added as a new value to enum query parameter `webhook_status.in` in [`list_events`](https://apidocs.chargebee.com/docs/api/events/list-events) of [`Event`](https://apidocs.chargebee.com/docs/api/events).
+- `rate_limited` has been added as a new value to enum query parameter `webhook_status.not_in` in [`list_events`](https://apidocs.chargebee.com/docs/api/events/list-events) of [`Event`](https://apidocs.chargebee.com/docs/api/events).
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values to enum request body parameter `payment_method_type` in [`update_a_payment_intent`](https://apidocs.chargebee.com/docs/api/payment_intents/update-a-payment-intent) of [`PaymentIntent`](https://apidocs.chargebee.com/docs/api/payment_intents).
+- `twint`, `go_pay`, `grab_pay`, `pay_co`, `after_pay`, `swish`, and `payme` have been added as new values to enum request body parameter `payment_method_type` in [`create_a_payment_intent`](https://apidocs.chargebee.com/docs/api/payment_intents/create-a-payment-intent) of [`PaymentIntent`](https://apidocs.chargebee.com/docs/api/payment_intents).
+- `mada` has been added as a new value to enum request body parameter `card.brand` in [`create_using_permanent_token`](https://apidocs.chargebee.com/docs/api/payment_sources/create-using-permanent-token) of [`PaymentSource`](https://apidocs.chargebee.com/docs/api/payment_sources).
+
+
+
 ### v3.23.1 (2026-04-22)
 * * * 
 

package/README.md

@@ -124,6 +124,45 @@ try {
 }
 ```
 
+### Request parameter validation (Zod)
+
+When `enableValidation` is set to `true`, the SDK validates parameters for **every** API request against Zod schemas **before** the HTTP call is made. If you omit the params object on a call, it is validated as `{}`. This is **off by default**. Schemas are included for API actions that support them; actions without a bundled schema behave as usual.
+
+```typescript
+import Chargebee, { ChargebeeZodValidationError } from 'chargebee';
+
+const chargebee = new Chargebee({
+  site: '{{site}}',
+  apiKey: '{{api-key}}',
+  enableValidation: true,
+});
+
+try {
+  await chargebee.customer.create({
+    id: 'a'.repeat(100),
+    auto_collection: 'invalid',
+  });
+} catch (err) {
+  if (err instanceof ChargebeeZodValidationError) {
+    console.error(err.message);
+    console.error(err.actionName);
+    console.error(err.zodError.issues);
+  } else {
+    throw err;
+  }
+}
+```
+
+Invalid parameters produce a `ChargebeeZodValidationError`. The error message lists every problem (field path and message). You can also inspect `actionName` (the API action, for example `create`) and `zodError` (Zod’s `ZodError`, including `issues`) for structured handling.
+
+**Example message:**
+
+```text
+ChargebeeZodValidationError: [Chargebee] Validation failed for 'create': id: Too big: expected string to have <=50 characters; auto_collection: Invalid option: expected one of "on"|"off"
+```
+
+The same `ChargebeeZodValidationError` shape applies to any action with a schema when parameters are invalid (for example bad filters or limits on `list`).
+
 ### Using filters in the List API
 
 For pagination, `offset` is the parameter that is being used. The value used for this parameter must be the value returned for `next_offset` parameter in the previous API call.

package/cjs/RequestWrapper.js

@@ -4,6 +4,8 @@ exports.RequestWrapper = void 0;
 const util_js_1 = require("./util.js");
 const coreCommon_js_1 = require("./coreCommon.js");
 const node_buffer_1 = require("node:buffer");
+const chargebeeZodValidationError_js_1 = require("./chargebeeZodValidationError.js");
+const validationLoader_js_1 = require("./validationLoader.js");
 class RequestWrapper {
     constructor(args, apiCall, envArg) {
         this.getRequest = () => {
@@ -23,6 +25,17 @@ class RequestWrapper {
         }
         return idParam;
     }
+    /**
+     * Validate parameters against the action's Zod schema when enableValidation is true.
+     * Query params are validated as `params ?? {}`; body params are validated when `params` is non-null.
+     * Throws a descriptive error listing every validation violation.
+     */
+    static _validateParams(params, schema, actionName) {
+        const result = schema.safeParse(params);
+        if (!result.success) {
+            throw new chargebeeZodValidationError_js_1.ChargebeeZodValidationError(actionName, result.error);
+        }
+    }
     static parseRetryAfter(retryAfter) {
         if (!retryAfter)
             return null;
@@ -42,6 +55,20 @@ class RequestWrapper {
             ? this.args[1]
             : this.args[0];
         let headers = this.apiCall.hasIdInUrl ? this.args[2] : this.args[1];
+        // Lazy-load Zod schema when enableValidation is true
+        if (env.enableValidation &&
+            this.apiCall.resourceKey &&
+            this.apiCall.actionName) {
+            const schema = await (0, validationLoader_js_1.getSchema)(this.apiCall.resourceKey, this.apiCall.actionName);
+            if (schema) {
+                if (this.apiCall.httpMethod === 'GET') {
+                    RequestWrapper._validateParams(params !== null && params !== void 0 ? params : {}, schema, this.apiCall.methodName);
+                }
+                else if (params != null) {
+                    RequestWrapper._validateParams(params, schema, this.apiCall.methodName);
+                }
+            }
+        }
         Object.assign(this.httpHeaders, headers);
         if (this.apiCall.httpMethod === 'POST' &&
             !this.httpHeaders['chargebee-idempotency-key'] &&

package/cjs/chargebee.cjs.js

@@ -4,6 +4,7 @@ const createChargebee_js_1 = require("./createChargebee.js");
 const FetchClient_js_1 = require("./net/FetchClient.js");
 const handler_js_1 = require("./resources/webhook/handler.js");
 const auth_js_1 = require("./resources/webhook/auth.js");
+const chargebeeZodValidationError_js_1 = require("./chargebeeZodValidationError.js");
 const httpClient = new FetchClient_js_1.FetchHttpClient();
 const Chargebee = (0, createChargebee_js_1.CreateChargebee)(httpClient);
 module.exports = Chargebee;
@@ -18,3 +19,5 @@ module.exports.WebhookError = handler_js_1.WebhookError;
 module.exports.WebhookAuthenticationError = handler_js_1.WebhookAuthenticationError;
 module.exports.WebhookPayloadValidationError = handler_js_1.WebhookPayloadValidationError;
 module.exports.WebhookPayloadParseError = handler_js_1.WebhookPayloadParseError;
+// Export validation error class
+module.exports.ChargebeeZodValidationError = chargebeeZodValidationError_js_1.ChargebeeZodValidationError;

package/cjs/chargebee.cjs.worker.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookPayloadParseError = exports.WebhookPayloadValidationError = exports.WebhookAuthenticationError = exports.WebhookError = exports.basicAuthValidator = exports.WebhookContentType = exports.WebhookEventType = void 0;
 const createChargebee_js_1 = require("./createChargebee.js");
 const FetchClient_js_1 = require("./net/FetchClient.js");
+const chargebeeZodValidationError_js_1 = require("./chargebeeZodValidationError.js");
 const httpClient = new FetchClient_js_1.FetchHttpClient();
 const Chargebee = (0, createChargebee_js_1.CreateChargebee)(httpClient);
 module.exports = Chargebee;
@@ -19,3 +20,4 @@ Object.defineProperty(exports, "WebhookError", { enumerable: true, get: function
 Object.defineProperty(exports, "WebhookAuthenticationError", { enumerable: true, get: function () { return handler_js_2.WebhookAuthenticationError; } });
 Object.defineProperty(exports, "WebhookPayloadValidationError", { enumerable: true, get: function () { return handler_js_2.WebhookPayloadValidationError; } });
 Object.defineProperty(exports, "WebhookPayloadParseError", { enumerable: true, get: function () { return handler_js_2.WebhookPayloadParseError; } });
+module.exports.ChargebeeZodValidationError = chargebeeZodValidationError_js_1.ChargebeeZodValidationError;

package/cjs/chargebeeZodValidationError.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChargebeeZodValidationError = void 0;
+class ChargebeeZodValidationError extends Error {
+    constructor(actionName, zodError) {
+        var _a;
+        const messages = zodError.issues
+            .map((e) => `${e.path.join('.')}: ${e.message}`)
+            .join('; ');
+        super(`[Chargebee] Validation failed for '${actionName}': ${messages}`);
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.name = 'ChargebeeZodValidationError';
+        this.actionName = actionName;
+        this.zodError = zodError;
+        (_a = Error.captureStackTrace) === null || _a === void 0 ? void 0 : _a.call(Error, this, this.constructor);
+    }
+}
+exports.ChargebeeZodValidationError = ChargebeeZodValidationError;

package/cjs/createChargebee.js

@@ -96,6 +96,11 @@ const CreateChargebee = (httpClient) => {
                         jsonKeys: metaArr[7],
                         options: metaArr[8],
                     };
+                    if (this._env.enableValidation) {
+                        // Store resource and action for lazy schema loading in RequestWrapper
+                        apiCall.resourceKey = res;
+                        apiCall.actionName = metaArr[0];
+                    }
                     this[res][apiCall.methodName] = this._createApiFunc(apiCall, this._env);
                 }
             }

package/cjs/environment.js

@@ -11,7 +11,7 @@ exports.Environment = {
     hostSuffix: '.chargebee.com',
     apiPath: '/api/v2',
     timeout: DEFAULT_TIME_OUT,
-    clientVersion: 'v3.23.1',
+    clientVersion: 'v3.25.0-beta.1',
     port: DEFAULT_PORT,
     timemachineWaitInMillis: DEFAULT_TIME_MACHINE_WAIT,
     exportWaitInMillis: DEFAULT_EXPORT_WAIT,

package/cjs/resources/api_endpoints.js

@@ -3032,6 +3032,7 @@ exports.Endpoints = {
     quotedDeltaRamp: [],
     billingConfiguration: [],
     quoteLineGroup: [],
+    quoteEntitlement: [],
     cpqQuoteSignature: [],
     plan: [
         [
@@ -4975,8 +4976,85 @@ exports.Endpoints = {
             {},
         ],
     ],
-    alert: [],
-    alertStatus: [],
+    alert: [
+        [
+            'create',
+            'POST',
+            '/alerts',
+            null,
+            false,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        ['retrieve', 'GET', '/alerts', null, true, null, false, {}, {}],
+        ['list', 'GET', '/alerts', null, false, null, false, {}, {}],
+        [
+            'update',
+            'POST',
+            '/alerts',
+            null,
+            true,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        [
+            'delete',
+            'POST',
+            '/alerts',
+            '/delete',
+            true,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        [
+            'application_alertsForSubscription',
+            'GET',
+            '/subscriptions',
+            '/applicable_alerts',
+            true,
+            null,
+            false,
+            {},
+            {},
+        ],
+    ],
+    filterCondition: [],
+    alertStatus: [
+        [
+            'alert_statusesForSubscription',
+            'GET',
+            '/subscriptions',
+            '/alert_statuses',
+            true,
+            null,
+            false,
+            {},
+            {},
+        ],
+        [
+            'alert_statusesForAlert',
+            'GET',
+            '/alerts',
+            '/alert_statuses',
+            true,
+            null,
+            false,
+            {},
+            {},
+        ],
+    ],
     impactedCustomer: [],
     subscriptionEntitlementsUpdatedDetail: [],
     subscriptionEntitlementsCreatedDetail: [],

package/cjs/schema/addon.schema.js

@@ -0,0 +1,153 @@
+"use strict";
+// Generated Zod schemas: Addon
+// Actions: create, update, copy
+// Do not edit manually – regenerate via sdk-generator
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopyAddonBodySchema = exports.UpdateAddonBodySchema = exports.CreateAddonBodySchema = void 0;
+const zod_1 = require("zod");
+//Addon.create
+const CreateAddonMetaDataSchema = zod_1.z.looseObject({});
+const CreateAddonTiersSchema = zod_1.z.object({
+    starting_unit: zod_1.z.array(zod_1.z.number().int().min(1).optional()).optional(),
+    ending_unit: zod_1.z.array(zod_1.z.number().int().optional()).optional(),
+    price: zod_1.z.array(zod_1.z.number().int().min(0).optional()).optional(),
+    starting_unit_in_decimal: zod_1.z.array(zod_1.z.string().max(33).optional()).optional(),
+    ending_unit_in_decimal: zod_1.z.array(zod_1.z.string().max(33).optional()).optional(),
+    price_in_decimal: zod_1.z.array(zod_1.z.string().max(39).optional()).optional(),
+});
+const CreateAddonTaxProvidersFieldsSchema = zod_1.z.object({
+    provider_name: zod_1.z.array(zod_1.z.string().max(50).optional()),
+    field_id: zod_1.z.array(zod_1.z.string().max(50).optional()),
+    field_value: zod_1.z.array(zod_1.z.string().max(50).optional()),
+});
+const CreateAddonBodySchema = zod_1.z.looseObject({
+    id: zod_1.z.string().max(100),
+    name: zod_1.z.string().max(100),
+    invoice_name: zod_1.z.string().max(100).optional(),
+    description: zod_1.z.string().max(2000).optional(),
+    charge_type: zod_1.z.enum(['recurring', 'non_recurring']),
+    price: zod_1.z.number().int().min(0).optional(),
+    currency_code: zod_1.z.string().max(3).optional(),
+    period: zod_1.z.number().int().min(1).optional(),
+    period_unit: zod_1.z
+        .enum(['day', 'week', 'month', 'year', 'not_applicable'])
+        .optional(),
+    pricing_model: zod_1.z
+        .enum(['flat_fee', 'per_unit', 'tiered', 'volume', 'stairstep'])
+        .optional(),
+    type: zod_1.z
+        .enum(['on_off', 'quantity', 'tiered', 'volume', 'stairstep'])
+        .optional(),
+    unit: zod_1.z.string().max(30).optional(),
+    enabled_in_portal: zod_1.z.boolean().default(true).optional(),
+    taxable: zod_1.z.boolean().default(true).optional(),
+    tax_profile_id: zod_1.z.string().max(50).optional(),
+    avalara_sale_type: zod_1.z
+        .enum(['wholesale', 'retail', 'consumed', 'vendor_use'])
+        .optional(),
+    avalara_transaction_type: zod_1.z.number().int().optional(),
+    avalara_service_type: zod_1.z.number().int().optional(),
+    tax_code: zod_1.z.string().max(50).optional(),
+    hsn_code: zod_1.z.string().max(50).optional(),
+    taxjar_product_code: zod_1.z.string().max(50).optional(),
+    invoice_notes: zod_1.z.string().max(2000).optional(),
+    meta_data: CreateAddonMetaDataSchema.optional(),
+    sku: zod_1.z.string().max(100).optional(),
+    accounting_code: zod_1.z.string().max(100).optional(),
+    accounting_category1: zod_1.z.string().max(100).optional(),
+    accounting_category2: zod_1.z.string().max(100).optional(),
+    accounting_category3: zod_1.z.string().max(100).optional(),
+    accounting_category4: zod_1.z.string().max(100).optional(),
+    is_shippable: zod_1.z.boolean().default(false).optional(),
+    shipping_frequency_period: zod_1.z.number().int().min(1).optional(),
+    shipping_frequency_period_unit: zod_1.z
+        .enum(['year', 'month', 'week', 'day'])
+        .optional(),
+    included_in_mrr: zod_1.z.boolean().optional(),
+    show_description_in_invoices: zod_1.z.boolean().default(false).optional(),
+    show_description_in_quotes: zod_1.z.boolean().default(false).optional(),
+    price_in_decimal: zod_1.z.string().max(39).optional(),
+    proration_type: zod_1.z
+        .enum(['site_default', 'partial_term', 'full_term'])
+        .optional(),
+    status: zod_1.z.enum(['active', 'archived']).optional(),
+    tiers: CreateAddonTiersSchema.optional(),
+    tax_providers_fields: CreateAddonTaxProvidersFieldsSchema.optional(),
+});
+exports.CreateAddonBodySchema = CreateAddonBodySchema;
+//Addon.update
+const UpdateAddonMetaDataSchema = zod_1.z.looseObject({});
+const UpdateAddonTiersSchema = zod_1.z.object({
+    starting_unit: zod_1.z.array(zod_1.z.number().int().min(1).optional()).optional(),
+    ending_unit: zod_1.z.array(zod_1.z.number().int().optional()).optional(),
+    price: zod_1.z.array(zod_1.z.number().int().min(0).optional()).optional(),
+    starting_unit_in_decimal: zod_1.z.array(zod_1.z.string().max(33).optional()).optional(),
+    ending_unit_in_decimal: zod_1.z.array(zod_1.z.string().max(33).optional()).optional(),
+    price_in_decimal: zod_1.z.array(zod_1.z.string().max(39).optional()).optional(),
+});
+const UpdateAddonTaxProvidersFieldsSchema = zod_1.z.object({
+    provider_name: zod_1.z.array(zod_1.z.string().max(50).optional()),
+    field_id: zod_1.z.array(zod_1.z.string().max(50).optional()),
+    field_value: zod_1.z.array(zod_1.z.string().max(50).optional()),
+});
+const UpdateAddonBodySchema = zod_1.z.looseObject({
+    name: zod_1.z.string().max(100).optional(),
+    invoice_name: zod_1.z.string().max(100).optional(),
+    description: zod_1.z.string().max(2000).optional(),
+    charge_type: zod_1.z.enum(['recurring', 'non_recurring']).optional(),
+    price: zod_1.z.number().int().min(0).optional(),
+    currency_code: zod_1.z.string().max(3).optional(),
+    period: zod_1.z.number().int().min(1).optional(),
+    period_unit: zod_1.z
+        .enum(['day', 'week', 'month', 'year', 'not_applicable'])
+        .optional(),
+    pricing_model: zod_1.z
+        .enum(['flat_fee', 'per_unit', 'tiered', 'volume', 'stairstep'])
+        .optional(),
+    type: zod_1.z
+        .enum(['on_off', 'quantity', 'tiered', 'volume', 'stairstep'])
+        .optional(),
+    unit: zod_1.z.string().max(30).optional(),
+    enabled_in_portal: zod_1.z.boolean().default(true).optional(),
+    taxable: zod_1.z.boolean().default(true).optional(),
+    tax_profile_id: zod_1.z.string().max(50).optional(),
+    avalara_sale_type: zod_1.z
+        .enum(['wholesale', 'retail', 'consumed', 'vendor_use'])
+        .optional(),
+    avalara_transaction_type: zod_1.z.number().int().optional(),
+    avalara_service_type: zod_1.z.number().int().optional(),
+    tax_code: zod_1.z.string().max(50).optional(),
+    hsn_code: zod_1.z.string().max(50).optional(),
+    taxjar_product_code: zod_1.z.string().max(50).optional(),
+    invoice_notes: zod_1.z.string().max(2000).optional(),
+    meta_data: UpdateAddonMetaDataSchema.optional(),
+    sku: zod_1.z.string().max(100).optional(),
+    accounting_code: zod_1.z.string().max(100).optional(),
+    accounting_category1: zod_1.z.string().max(100).optional(),
+    accounting_category2: zod_1.z.string().max(100).optional(),
+    accounting_category3: zod_1.z.string().max(100).optional(),
+    accounting_category4: zod_1.z.string().max(100).optional(),
+    is_shippable: zod_1.z.boolean().default(false).optional(),
+    shipping_frequency_period: zod_1.z.number().int().min(1).optional(),
+    shipping_frequency_period_unit: zod_1.z
+        .enum(['year', 'month', 'week', 'day'])
+        .optional(),
+    included_in_mrr: zod_1.z.boolean().optional(),
+    show_description_in_invoices: zod_1.z.boolean().default(false).optional(),
+    show_description_in_quotes: zod_1.z.boolean().default(false).optional(),
+    price_in_decimal: zod_1.z.string().max(39).optional(),
+    proration_type: zod_1.z
+        .enum(['site_default', 'partial_term', 'full_term'])
+        .optional(),
+    tiers: UpdateAddonTiersSchema.optional(),
+    tax_providers_fields: UpdateAddonTaxProvidersFieldsSchema.optional(),
+});
+exports.UpdateAddonBodySchema = UpdateAddonBodySchema;
+//Addon.copy
+const CopyAddonBodySchema = zod_1.z.looseObject({
+    from_site: zod_1.z.string().max(50),
+    id_at_from_site: zod_1.z.string().max(100),
+    id: zod_1.z.string().max(100).optional(),
+    for_site_merging: zod_1.z.boolean().default(false).optional(),
+});
+exports.CopyAddonBodySchema = CopyAddonBodySchema;

package/cjs/schema/address.schema.js

@@ -0,0 +1,35 @@
+"use strict";
+// Generated Zod schemas: Address
+// Actions: retrieve, update
+// Do not edit manually – regenerate via sdk-generator
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAddressBodySchema = exports.RetrieveAddressBodySchema = void 0;
+const zod_1 = require("zod");
+//Address.retrieve
+const RetrieveAddressBodySchema = zod_1.z.looseObject({
+    subscription_id: zod_1.z.string().max(50),
+    label: zod_1.z.string().max(50),
+});
+exports.RetrieveAddressBodySchema = RetrieveAddressBodySchema;
+//Address.update
+const UpdateAddressBodySchema = zod_1.z.looseObject({
+    subscription_id: zod_1.z.string().max(50),
+    label: zod_1.z.string().max(50),
+    first_name: zod_1.z.string().max(150).optional(),
+    last_name: zod_1.z.string().max(150).optional(),
+    email: zod_1.z.string().email().max(70).optional(),
+    company: zod_1.z.string().max(250).optional(),
+    phone: zod_1.z.string().max(50).optional(),
+    addr: zod_1.z.string().max(150).optional(),
+    extended_addr: zod_1.z.string().max(150).optional(),
+    extended_addr2: zod_1.z.string().max(150).optional(),
+    city: zod_1.z.string().max(50).optional(),
+    state_code: zod_1.z.string().max(50).optional(),
+    state: zod_1.z.string().max(50).optional(),
+    zip: zod_1.z.string().max(20).optional(),
+    country: zod_1.z.string().max(50).optional(),
+    validation_status: zod_1.z
+        .enum(['not_validated', 'valid', 'partially_valid', 'invalid'])
+        .optional(),
+});
+exports.UpdateAddressBodySchema = UpdateAddressBodySchema;

package/cjs/schema/alert.schema.js

@@ -0,0 +1,38 @@
+"use strict";
+// Generated Zod schemas: Alert
+// Actions: create, update
+// Do not edit manually – regenerate via sdk-generator
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAlertBodySchema = exports.CreateAlertBodySchema = void 0;
+const zod_1 = require("zod");
+//Alert.create
+const CreateAlertThresholdSchema = zod_1.z.object({
+    mode: zod_1.z.enum(['absolute', 'percentage']),
+    value: zod_1.z.number(),
+});
+const CreateAlertFilterConditionsSchema = zod_1.z.object({
+    field: zod_1.z.array(zod_1.z.enum(['plan_price_id']).optional()).optional(),
+    operator: zod_1.z.array(zod_1.z.enum(['equals', 'not_equals']).optional()).optional(),
+    value: zod_1.z.array(zod_1.z.string().max(50).optional()).optional(),
+});
+const CreateAlertBodySchema = zod_1.z.looseObject({
+    type: zod_1.z.enum(['usage_exceeded']),
+    name: zod_1.z.string().max(50),
+    description: zod_1.z.string().max(65000).optional(),
+    metered_feature_id: zod_1.z.string().max(50),
+    subscription_id: zod_1.z.string().max(50).optional(),
+    meta: zod_1.z.string().max(65000).optional(),
+    threshold: CreateAlertThresholdSchema.optional(),
+    filter_conditions: CreateAlertFilterConditionsSchema.optional(),
+});
+exports.CreateAlertBodySchema = CreateAlertBodySchema;
+//Alert.update
+const UpdateAlertThresholdSchema = zod_1.z.object({
+    mode: zod_1.z.enum(['absolute', 'percentage']).optional(),
+    value: zod_1.z.number().optional(),
+});
+const UpdateAlertBodySchema = zod_1.z.looseObject({
+    status: zod_1.z.enum(['enabled', 'disabled']).optional(),
+    threshold: UpdateAlertThresholdSchema.optional(),
+});
+exports.UpdateAlertBodySchema = UpdateAlertBodySchema;