chargebee 2.26.0 → 2.26.1

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+### v2.26.1 (2023-08-11)
+* * *
+* Support Descriptions for the attributes and actions has been added.
+
 ### v2.26.0 (2023-07-31)
 * * *
 

package/lib/chargebee.js

@@ -11,7 +11,7 @@ ChargeBee._env = {
     hostSuffix: '.chargebee.com',
     apiPath: '/api/v2',
     timeout: 80000,
-    clientVersion: 'v2.26.0',
+    clientVersion: 'v2.26.1',
     port: 443,
     timemachineWaitInMillis: 3000,
     exportWaitInMillis: 3000

package/package.json

@@ -1,6 +1,6 @@
 {
    "name":"chargebee",
-   "version":"2.26.0",
+   "version":"2.26.1",
    "description":"A library for integrating with ChargeBee.",
    "keywords":[
       "payments",

package/types/core.d.ts

@@ -57,6 +57,7 @@ declare module 'chargebee' {
   type Operation = 'create' | 'update' | 'delete'
   type OperationType = 'add' | 'remove'
   type PauseOption = 'end_of_term' | 'billing_cycles' | 'immediately' | 'specific_date'
+  type PaymentInitiator = 'merchant' | 'customer'
   type PaymentMethod = 'other' | 'netbanking_emandates' | 'ach_credit' | 'dotpay' | 'boleto' | 'direct_debit' | 'chargeback' | 'wechat_pay' | 'cash' | 'giropay' | 'bank_transfer' | 'alipay' | 'ideal' | 'google_pay' | 'custom' | 'unionpay' | 'check' | 'sofort' | 'amazon_payments' | 'upi' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'sepa_credit' | 'card'
   type PaymentMethodType = 'giropay' | 'alipay' | 'ideal' | 'google_pay' | 'netbanking_emandates' | 'dotpay' | 'unionpay' | 'direct_debit' | 'generic' | 'sofort' | 'amazon_payments' | 'upi' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'wechat_pay' | 'card'
   type PaymentVoucherType = 'boleto'

package/types/resources/Address.d.ts

@@ -1,54 +1,294 @@
 ///<reference path='./../core.d.ts'/>
 declare module 'chargebee' {
   export interface Address {
+    
+    /**
+      * @description Label to identify the address. This is unique for all the address for a subscription.
+
+      */
+    
     label:string;
+    
+    /**
+      * @description First name
+
+      */
+    
     first_name?:string;
+    
+    /**
+      * @description Last name
+
+      */
+    
     last_name?:string;
+    
+    /**
+      * @description Email
+
+      */
+    
     email?:string;
+    
+    /**
+      * @description Company name
+
+      */
+    
     company?:string;
+    
+    /**
+      * @description Phone number
+
+      */
+    
     phone?:string;
+    
+    /**
+      * @description Address line 1
+
+      */
+    
     addr?:string;
+    
+    /**
+      * @description Address line 2
+
+      */
+    
     extended_addr?:string;
+    
+    /**
+      * @description Address line 3
+
+      */
+    
     extended_addr2?:string;
+    
+    /**
+      * @description Name of the city
+
+      */
+    
     city?:string;
+    
+    /**
+      * @description The [ISO 3166-2 state/province code](https://www.iso.org/obp/ui/#search) without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set &#x60;state_code&#x60; as &#x60;AZ&#x60; (not &#x60;US-AZ&#x60;). For Tamil Nadu (India), set as &#x60;TN&#x60; (not &#x60;IN-TN&#x60;). For British Columbia (Canada), set as &#x60;BC&#x60; (not &#x60;CA-BC&#x60;).
+
+      */
+    
     state_code?:string;
+    
+    /**
+      * @description State or Province
+
+      */
+    
     state?:string;
+    
+    /**
+      * @description The billing address country of the customer. Must be one of [ISO 3166 alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html).   
+
+**Note** : If you enter an invalid country code, the system will return an error.  
+
+**Brexit**
+
+
+If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or later, or have [manually enable](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, then &#x60;XI&#x60; (the code for **United Kingdom -- Northern Ireland**) is available as an option.
+
+      */
+    
     country?:string;
+    
+    /**
+      * @description Zip or postal code. The number of characters is validated according to the rules [specified here](https://chromium-i18n.appspot.com/ssl-address).
+
+      */
+    
     zip?:string;
+    
+    /**
+      * @description The address verification status. \* partially_valid - The address is valid for taxability but has not been validated for shipping. \* not_validated - Address is not yet validated. \* invalid - Address is invalid. \* valid - Address was validated successfully.
+
+      */
+    
     validation_status?:ValidationStatus;
+    
+    /**
+      * @description A unique and immutable identifier for the subscription. If not provided, it is autogenerated.
+
+      */
+    
     subscription_id:string;
   }
   export namespace Address {
-    export class AddressResource {
+    export class AddressResource {  
+      /**
+        * @description Retrieves an address resource for a subscription and the specified label.
+
+        */
+      
       retrieve(input:RetrieveInputParam):ChargebeeRequest<RetrieveResponse>;
+       
+      /**
+        * @description Adds or replaces the address for a subscription. If an address is already present for the specified label, it will be replaced otherwise new address is added with that label.
+
+        */
+      
       update(input:UpdateInputParam):ChargebeeRequest<UpdateResponse>;
     }
-    export interface RetrieveResponse {
-      address:Address;
+    export interface RetrieveResponse {  
+      /**
+        * @description Retrieves an address resource for a subscription and the specified label.
+
+        */
+       
+       address:Address;
     }
     export interface RetrieveInputParam {
+       
+      /**
+        * @description Retrieves an address resource for a subscription and the specified label.
+
+        */
+        
       subscription_id:string;
+       
+      /**
+        * @description Retrieves an address resource for a subscription and the specified label.
+
+        */
+        
       label:string;
     }
-    export interface UpdateResponse {
-      address:Address;
+    export interface UpdateResponse {  
+      /**
+        * @description Adds or replaces the address for a subscription. If an address is already present for the specified label, it will be replaced otherwise new address is added with that label.
+
+        */
+       
+       address:Address;
     }
     export interface UpdateInputParam {
+       
+      /**
+        * @description A unique and immutable identifier for the subscription. If not provided, it is autogenerated.
+
+        */
+       
       subscription_id:string;
+       
+      /**
+        * @description Label to identify the address. This is unique for all the address for a subscription.
+
+        */
+       
       label:string;
+       
+      /**
+        * @description First name.
+
+        */
+       
       first_name?:string;
+       
+      /**
+        * @description Last name.
+
+        */
+       
       last_name?:string;
+       
+      /**
+        * @description Email.
+
+        */
+       
       email?:string;
+       
+      /**
+        * @description Company name.
+
+        */
+       
       company?:string;
+       
+      /**
+        * @description Phone number.
+
+        */
+       
       phone?:string;
+       
+      /**
+        * @description Address line 1.
+
+        */
+       
       addr?:string;
+       
+      /**
+        * @description Address line 2.
+
+        */
+       
       extended_addr?:string;
+       
+      /**
+        * @description Address line 3.
+
+        */
+       
       extended_addr2?:string;
+       
+      /**
+        * @description Name of the city.
+
+        */
+       
       city?:string;
+       
+      /**
+        * @description The [ISO 3166-2 state/province code](https://www.iso.org/obp/ui/#search/code) without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set &#x60;state_code&#x60; as &#x60;AZ&#x60; (not &#x60;US-AZ&#x60;). For Tamil Nadu (India), set as &#x60;TN&#x60; (not &#x60;IN-TN&#x60;). For British Columbia (Canada), set as &#x60;BC&#x60; (not &#x60;CA-BC&#x60;).
+
+        */
+       
       state_code?:string;
+       
+      /**
+        * @description The state/province name. Is set by Chargebee automatically for US, Canada and India If &#x60;state_code&#x60; is provided.
+
+        */
+       
       state?:string;
+       
+      /**
+        * @description Zip or postal code. The number of characters is validated according to the rules [specified here](https://chromium-i18n.appspot.com/ssl-address).
+
+        */
+       
       zip?:string;
+       
+      /**
+        * @description The billing address country of the customer. Must be one of [ISO 3166 alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html).   
+
+**Note** : If you enter an invalid country code, the system will return an error.  
+
+**Brexit**
+
+
+If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or later, or have [manually enable](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, then &#x60;XI&#x60; (the code for **United Kingdom -- Northern Ireland**) is available as an option.
+.
+
+        */
+       
       country?:string;
+       
+      /**
+        * @description The address verification status. \* partially_valid - The address is valid for taxability but has not been validated for shipping. \* not_validated - Address is not yet validated. \* invalid - Address is invalid. \* valid - Address was validated successfully.
+
+        */
+       
       validation_status?:ValidationStatus;
     }
     

package/types/resources/AdvanceInvoiceSchedule.d.ts

@@ -1,25 +1,101 @@
 ///<reference path='./../core.d.ts'/>
 declare module 'chargebee' {
   export interface AdvanceInvoiceSchedule {
+    
+    /**
+      * @description System-generated and immutable unique Id for the &#x60;advance_invoice_schedule&#x60;.
+
+      */
+    
     id:string;
+    
+    /**
+      * @description The type of advance invoice or advance invoicing schedule. \* specific_dates - The advance charges occur on specific dates. For each date, [a fixed number of billing cycles](advance_invoice_schedules#advance_invoice_schedule_specific_dates_schedule_terms_to_charge) is charged for. There can be up to 5 dates configured. \* fixed_intervals - The advance charges occur at [fixed intervals of time](advance_invoice_schedules#advance_invoice_schedule_fixed_interval_schedule_terms_to_charge).
+
+      */
+    
     schedule_type?:'specific_dates' | 'fixed_intervals';
+    
+    /**
+      * @description When the &#x60;schedule_type&#x60; is &#x60;fixed_intervals&#x60;, this object gives further details of the schedule.
+
+      */
+    
     fixed_interval_schedule?:AdvanceInvoiceSchedule.FixedIntervalSchedule;
+    
+    /**
+      * @description The advance charges occur on specific dates. For each date, [a fixed number of billing cycles](advance_invoice_schedules#advance_invoice_schedule_specific_dates_schedule_terms_to_charge) is charged for. There can be up to 5 dates configured.
+
+      */
+    
     specific_dates_schedule?:AdvanceInvoiceSchedule.SpecificDatesSchedule;
   }
   export namespace AdvanceInvoiceSchedule {
     
     
-    export interface FixedIntervalSchedule {
+    export interface FixedIntervalSchedule {  
+         /**
+          * @description Specifies when the schedule should end. \* after_number_of_intervals - Advance invoices are generated a &#x60;specified number of times&#x60; \* subscription_end - Advance invoices are generated for as long as the subscription is active. \* specific_date - End the advance invoicing schedule on a &#x60;specific date&#x60;.
+
+          */
+       
       end_schedule_on?:EndScheduleOn;
+       
+         /**
+          * @description The number of advance invoices to generate. The schedule is created such that the total number of billing cycles in the schedule does not exceed the [&#x60;remaining_billing_cycles&#x60;](subscriptions#subscription_remaining_billing_cycles) of the subscription. This parameter is applicable only when [&#x60;fixed_interval_schedule[end_schedule_on]&#x60;](advance_invoice_schedules#advance_invoice_schedule_fixed_interval_schedule_end_schedule_on) &#x3D; &#x60;after_number_of_intervals&#x60;
+
+          */
+       
       number_of_occurrences?:number;
+       
+         /**
+          * @description The number of days before each interval that advance invoices are generated.
+
+          */
+       
       days_before_renewal?:number;
+       
+         /**
+          * @description The date when the schedule should end. Advance invoices are not generated beyond this date. It must be at least 1 day before the start of the last billing cycle of the subscription and also within 5 years from the current date. This parameter is only applicable when [&#x60;fixed_interval_schedule[end_schedule_on]&#x60;](advance_invoice_schedules#advance_invoice_schedule_fixed_interval_schedule_end_schedule_on) &#x3D; &#x60;specific_date&#x60;.
+
+          */
+       
       end_date?:number;
+       
+         /**
+          * @description The date when this advance invoicing schedule was created.
+
+          */
+       
       created_at?:number;
+       
+         /**
+          * @description The number of billing cycles in one interval.
+
+          */
+       
       terms_to_charge?:number;
     }
-    export interface SpecificDatesSchedule {
+    export interface SpecificDatesSchedule {  
+         /**
+          * @description The number of billing cycles to charge for, on the date specified. Applicable only when [&#x60;schedule_type&#x60;](advance_invoice_schedules#advance_invoice_schedule_schedule_type) is specific_dates.
+
+          */
+       
       terms_to_charge?:number;
+       
+         /**
+          * @description The unique id of the member of the advance_invoice_schedule array which corresponds to the specific_dates_schedule that you intend to modify. Only applicable when [&#x60;schedule_type&#x60;](advance_invoice_schedules#advance_invoice_schedule_schedule_type) is &#x60;specific_dates&#x60;.
+
+          */
+       
       date?:number;
+       
+         /**
+          * @description The date when this advance invoicing schedule was created.
+
+          */
+       
       created_at?:number;
     }
   }