chargebee 2.41.0 → 3.0.0-beta.2

package/types/resources/CustomerEntitlement.d.ts

@@ -1,47 +1,36 @@
 ///<reference path='./../core.d.ts'/>
 ///<reference path='./../index.d.ts'/>
+///<reference path='./filter.d.ts'/>
 declare module 'chargebee' {
   export interface CustomerEntitlement {
-    
-
-    customer_id:string;
-
-    subscription_id?:string;
-
-    feature_id?:string;
-
-    value?:string;
-
-    name?:string;
-
-    is_enabled:boolean;
-
+    customer_id: string;
+    subscription_id?: string;
+    feature_id?: string;
+    value?: string;
+    name?: string;
+    is_enabled: boolean;
   }
+
   export namespace CustomerEntitlement {
-    export class CustomerEntitlementResource {  
-      entitlements_for_customer(customer_id:string, input?:EntitlementsForCustomerInputParam):ChargebeeRequest<EntitlementsForCustomerResponse>;
+    export class CustomerEntitlementResource {
+      entitlementsForCustomer(
+        customer_id: string,
+        input?: EntitlementsForCustomerInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<EntitlementsForCustomerResponse>>;
     }
-    export interface EntitlementsForCustomerResponse {  
-       list:{customer_entitlement:CustomerEntitlement}[];
-       
-       next_offset?:string;
+
+    export interface EntitlementsForCustomerResponse {
+      list: { customer_entitlement: CustomerEntitlement }[];
+      next_offset?: string;
     }
-    export interface EntitlementsForCustomerInputParam {
-      [key : string]: any;  
-      /**
-        * @description The number of resources to be returned.
 
-        */
-        
-      limit?:number;
-       
-      /**
-        * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
+    // REQUEST PARAMS
+    //---------------
 
-        */
-        
-      offset?:string;
+    export interface EntitlementsForCustomerInputParam {
+      limit?: number;
+      offset?: string;
     }
-    
   }
-}
+}

package/types/resources/DifferentialPrice.d.ts

@@ -1,340 +1,142 @@
 ///<reference path='./../core.d.ts'/>
+///<reference path='./../index.d.ts'/>
+///<reference path='./filter.d.ts'/>
 declare module 'chargebee' {
   export interface DifferentialPrice {
-    
-    /**
-      * @description A unique and immutable ID for the differential price. It is auto-generated when the differential price is created.
-
-      */
-    
-    id:string;
-    
-    /**
-      * @description The ID of the item price (&#x60;addon&#x60; or &#x60;charge&#x60;) whose price should change according to the plan-item it is applied to.
-
-      */
-    
-    item_price_id:string;
-    
-    /**
-      * @description The ID of the plan-item, in relation to which, the differential pricing for the addon or charge is defined. For example, this would be the id of the *Standard* or *Enterprise* plans-items mentioned in the [examples above](./differential_prices?prod_cat_ver&#x3D;2).
-
-      */
-    
-    parent_item_id:string;
-    
-    /**
-      * @description The differential price. If the pricing model of the &#x60;item_price_id&#x60; is &#x60;tiered&#x60;, &#x60;volume&#x60;, or &#x60;stairstep&#x60;, pass &#x60;tiers&#x60; instead of this.
-
-      */
-    
-    price?:number;
-    
-    /**
-      * @description The price of the item when the pricing_model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in decimal and in major units of the currency. Also, this is only applicable when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
-
-      */
-    
-    price_in_decimal?:string;
-    
-    /**
-      * @description The item family state. \* active - New items can be created with the item family. \* deleted - No items allowed for the item family.
-
-      */
-    
-    status?:'deleted' | 'active';
-    
-    /**
-      * @description Version number of this resource. The &#x60;resource_version&#x60; is updated with a new timestamp in milliseconds for every change made to the resource. This attribute will be present only if the resource has been updated after 2016-09-28.
-
-      */
-    
-    resource_version?:number;
-    
-    /**
-      * @description Timestamp when this differential price was last updated.
-
-      */
-    
-    updated_at?:number;
-    
-    /**
-      * @description Timestamp at which this differential price was created.
-
-      */
-    
-    created_at:number;
-    
-    /**
-      * @description Timestamp at which this differential price was last modified.
-
-      */
-    
-    modified_at:number;
-    
-    /**
-      * @description The currency code (ISO 4217 format) of the plan
-
-      */
-    
-    currency_code:string;
-    
-    /**
-      * @description List of quantity-based pricing tiers for the differential price. Applicable only for &#x60;tiered&#x60;, &#x60;volume&#x60;, and &#x60;stairstep&#x60; &#x60;pricing_model&#x60; s. The tiers are exactly the same as those set for the item price. Only the &#x60;price&#x60; attribute for the various tiers can be overridden for the differential price.
-
-      */
-    
-    tiers?:DifferentialPrice.Tier[];
-    
-    /**
-      * @description When &#x60;item_price_id&#x60; is a charge-item, you can specify the plan period for which the price applies. Although an array, currently you can specify only one period. In other words, only index &#x60;0&#x60; is allowed. Create another differential price to specify another period. Is permitted only when &#x60;item_price_id&#x60; is a charge-item.
-
-      */
-    
-    parent_periods?:DifferentialPrice.ParentPeriod[];
+    id: string;
+    item_price_id: string;
+    parent_item_id: string;
+    price?: number;
+    price_in_decimal?: string;
+    status?: 'active' | 'deleted';
+    resource_version?: number;
+    updated_at?: number;
+    created_at: number;
+    modified_at: number;
+    tiers?: DifferentialPrice.Tier[];
+    currency_code: string;
+    parent_periods?: DifferentialPrice.ParentPeriod[];
   }
-  export namespace DifferentialPrice {
-    export class DifferentialPriceResource {  
-      /**
-        * @description Create a differential price for addon item price, addon item price with tiered pricing, or charge item price.
-
-        */
-      
-      create(item_price_id:string, input:CreateInputParam):ChargebeeRequest<CreateResponse>;
-       
-      /**
-        * @description Retrieve a differential price using a &#x60;differential_price_id&#x60; and &#x60;item_price_id&#x60;.
-
-        */
-      
-      retrieve(differential_price_id:string, input:RetrieveInputParam):ChargebeeRequest<RetrieveResponse>;
-       
-      /**
-        * @description Update a differential price using a &#x60;differential_price_id&#x60; and &#x60;item_price_id&#x60;.
-
-        */
-      
-      update(differential_price_id:string, input:UpdateInputParam):ChargebeeRequest<UpdateResponse>;
-       
-      /**
-        * @description Delete a differential price using a &#x60;differential_price_id&#x60; and &#x60;item_price_id&#x60;.
 
-        */
-      
-      delete(differential_price_id:string, input:DeleteInputParam):ChargebeeRequest<DeleteResponse>;
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-      
-      list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
+  export namespace DifferentialPrice {
+    export class DifferentialPriceResource {
+      create(
+        item_price_id: string,
+        input: CreateInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<CreateResponse>>;
+
+      retrieve(
+        differential_price_id: string,
+        input: RetrieveInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<RetrieveResponse>>;
+
+      update(
+        differential_price_id: string,
+        input: UpdateInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<UpdateResponse>>;
+
+      delete(
+        differential_price_id: string,
+        input: DeleteInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<DeleteResponse>>;
+
+      list(
+        input?: ListInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<ListResponse>>;
     }
-    export interface CreateResponse {  
-       differential_price:DifferentialPrice;
+
+    export interface CreateResponse {
+      differential_price: DifferentialPrice;
     }
-    export interface CreateInputParam {
-       
-      /**
-        * @description The id of the plan-item, in relation to which, the differential pricing for the addon or charge is defined. For example, this would be the id of the *Standard* or *Enterprise* plans-items mentioned in the [examples above](./differential_prices?prod_cat_ver&#x3D;2).
 
-        */
-       
-      parent_item_id:string;
-       
-      /**
-        * @description The differential price. If the pricing model of the &#x60;item_price_id&#x60; is &#x60;tiered&#x60;, &#x60;volume&#x60;, or &#x60;stairstep&#x60;, pass &#x60;tiers&#x60; instead of this.
+    export interface RetrieveResponse {
+      differential_price: DifferentialPrice;
+    }
 
-        */
-       
-      price?:number;
-       
-      /**
-        * @description The price of the item when the pricing_model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in decimal and in major units of the currency. Also, this is only applicable when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
+    export interface UpdateResponse {
+      differential_price: DifferentialPrice;
+    }
 
-        */
-       
-      price_in_decimal?:string;
-       
-      /**
-        * @description Parameters for parent_periods
+    export interface DeleteResponse {
+      differential_price: DifferentialPrice;
+    }
 
-        */
-       
-      parent_periods?:{period?:any[],period_unit:'week' | 'month' | 'year' | 'day'}[];
-       
-      /**
-        * @description Parameters for tiers
+    export interface ListResponse {
+      list: { differential_price: DifferentialPrice }[];
+      next_offset?: string;
+    }
 
-        */
-       
-      tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
+    export interface Tier {
+      starting_unit: number;
+      ending_unit?: number;
+      price: number;
+      starting_unit_in_decimal?: string;
+      ending_unit_in_decimal?: string;
+      price_in_decimal?: string;
     }
-    export interface RetrieveResponse {  
-       differential_price:DifferentialPrice;
+    export interface ParentPeriod {
+      period_unit: 'day' | 'week' | 'month' | 'year';
+      period?: any[];
     }
-    export interface RetrieveInputParam {
-       
-      /**
-        * @description Retrieve a differential price using a &#x60;differential_price_id&#x60; and &#x60;item_price_id&#x60;.
+    // REQUEST PARAMS
+    //---------------
 
-        */
-        
-      item_price_id:string;
+    export interface CreateInputParam {
+      parent_item_id: string;
+      price?: number;
+      price_in_decimal?: string;
+      parent_periods?: ParentPeriodsCreateInputParam[];
+      tiers?: TiersCreateInputParam[];
     }
-    export interface UpdateResponse {  
-       differential_price:DifferentialPrice;
+    export interface RetrieveInputParam {
+      item_price_id: string;
     }
     export interface UpdateInputParam {
-       
-      /**
-        * @description The id of the item price (&#x60;addon&#x60; or &#x60;charge&#x60;) whose price should change according to the plan-item it is applied to.
-
-        */
-       
-      item_price_id:string;
-       
-      /**
-        * @description The differential price. If the pricing model of the &#x60;item_price_id&#x60; is &#x60;tiered&#x60;, &#x60;volume&#x60;, or &#x60;stairstep&#x60;, pass &#x60;tiers&#x60; instead of this.
-
-        */
-       
-      price?:number;
-       
-      /**
-        * @description The price of the item when the pricing_model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in decimal and in major units of the currency. Also, this is only applicable when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
-
-        */
-       
-      price_in_decimal?:string;
-       
-      /**
-        * @description Parameters for parent_periods
-
-        */
-       
-      parent_periods?:{period?:any[],period_unit:'week' | 'month' | 'year' | 'day'}[];
-       
-      /**
-        * @description Parameters for tiers
-
-        */
-       
-      tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
-    }
-    export interface DeleteResponse {  
-       differential_price:DifferentialPrice;
+      item_price_id: string;
+      price?: number;
+      price_in_decimal?: string;
+      parent_periods?: ParentPeriodsUpdateInputParam[];
+      tiers?: TiersUpdateInputParam[];
     }
     export interface DeleteInputParam {
-       
-      /**
-        * @description The id of the item price (&#x60;addon&#x60; or &#x60;charge&#x60;) whose price should change according to the plan-item it is applied to.
-
-        */
-       
-      item_price_id:string;
-    }
-    export interface ListResponse {  
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-       
-       list:{differential_price:DifferentialPrice}[];
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-       
-       next_offset?:string;
+      item_price_id: string;
     }
     export interface ListInputParam {
-      [key : string]: any;  
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-        
-      limit?:number;
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-        
-      offset?:string;
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-        
-      item_price_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-        
-      item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-        
-      id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
-       
-      /**
-        * @description Returns a list of differential prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order (latest first).
-
-        */
-        
-      parent_item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
+      limit?: number;
+      offset?: string;
+      item_price_id?: filter.String;
+      item_id?: filter.String;
+      id?: filter.String;
+      parent_item_id?: filter.String;
     }
-    export interface Tier {  
-         /**
-          * @description The lower limit of a range of units for the tier
-
-          */
-       
-      starting_unit:number;
-       
-         /**
-          * @description The upper limit of a range of units for the tier
-
-          */
-       
-      ending_unit?:number;
-       
-         /**
-          * @description The per-unit price for the tier when the &#x60;pricing_model&#x60; is &#x60;tiered&#x60; or &#x60;volume&#x60;; the total cost for the item price when the &#x60;pricing_model&#x60; is &#x60;stairstep&#x60;. The value is in the [minor unit of the currency](https://apidocs.chargebee.com/docs/api#handling_currency_units).
-
-          */
-       
-      price:number;
-       
-      starting_unit_in_decimal?:string;
-       
-      ending_unit_in_decimal?:string;
-       
-      price_in_decimal?:string;
+    export interface TiersCreateInputParam {
+      starting_unit?: number;
+      ending_unit?: number;
+      price?: number;
+      starting_unit_in_decimal?: string;
+      ending_unit_in_decimal?: string;
+      price_in_decimal?: string;
     }
-    export interface ParentPeriod {  
-         /**
-          * @description The unit of time for &#x60;period&#x60;. \* month - A period of 1 calendar month. \* day - A period of 24 hours. \* week - A period of 7 days. \* year - A period of 1 calendar year.
-
-          */
-       
-      period_unit:'week' | 'month' | 'year' | 'day';
-       
-         /**
-          * @description The billing period of the plan in &#x60;period_unit&#x60;s. For example, a 6 month plan has &#x60;period&#x60; as 6 and &#x60;period_unit&#x60; as &#x60;month&#x60;.
-
-          */
-       
-      period?:any[];
+    export interface ParentPeriodsCreateInputParam {
+      period_unit: 'day' | 'week' | 'month' | 'year';
+      period?: any;
+    }
+    export interface TiersUpdateInputParam {
+      starting_unit?: number;
+      ending_unit?: number;
+      price?: number;
+      starting_unit_in_decimal?: string;
+      ending_unit_in_decimal?: string;
+      price_in_decimal?: string;
+    }
+    export interface ParentPeriodsUpdateInputParam {
+      period_unit: 'day' | 'week' | 'month' | 'year';
+      period?: any;
     }
   }
-}
+}

package/types/resources/Discount.d.ts

@@ -1,129 +1,24 @@
 ///<reference path='./../core.d.ts'/>
+///<reference path='./../index.d.ts'/>
+
 declare module 'chargebee' {
   export interface Discount {
-    
-    /**
-      * @description An immutable unique id for the discount. It is always auto-generated.
-
-      */
-    
-    id:string;
-    
-    /**
-      * @description The name of the discount as it should appear on customer-facing pages and documents such as [invoices](/docs/api/invoices?prod_cat_ver&#x3D;2) and [hosted pages](/docs/api/hosted_pages?prod_cat_ver&#x3D;2). This is auto-generated based on the &#x60;type&#x60;, &#x60;amount&#x60;, and &#x60;currency_code&#x60; of the discount. For example, it can be &#x60;10% off&#x60; or &#x60;10$ off&#x60;.
-
-      */
-    
-    invoice_name?:string;
-    
-    /**
-      * @description The type of discount. Possible value are: \* percentage - The specified percentage will be given as discount. \* fixed_amount - The specified amount will be given as discount.
-
-      */
-    
-    type:'fixed_amount' | 'percentage';
-    
-    /**
-      * @description The percentage of the original amount that should be deducted from it. Only applicable when &#x60;discount.type&#x60; is percentage.
-
-      */
-    
-    percentage?:number;
-    
-    /**
-      * @description The value of the discount. [The format of this value](https://apidocs.chargebee.com/docs/api?prod_cat_ver&#x3D;2#currencies) depends on the kind of currency. This is only applicable when &#x60;discount.type&#x60; is &#x60;fixed_amount&#x60;.
-
-      */
-    
-    amount?:number;
-    
-    /**
-      * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/supported-currencies.html)) of the discount. This is only applicable when &#x60;discount.type&#x60; is &#x60;fixed_amount&#x60;.
-
-      */
-    
-    currency_code?:string;
-    
-    /**
-      * @description Specifies the time duration for which this discount is attached to the subscription. \* forever - The discount is attached to the subscription and applied on the invoices till it is [explicitly removed](/docs/api/subscriptions?prod_cat_ver&#x3D;2#update_subscription_for_items_discounts_operation_type). \* limited_period - The discount is attached to the subscription and applied on the invoices for a limited duration. This duration starts from the point it is applied to an invoice for the first time and expires after a period specified by &#x60;period&#x60; and &#x60;period_unit&#x60;. \* one_time - The discount stays attached to the subscription till it is applied on an invoice **once**. It is removed after that from the subscription.
-
-      */
-    
-    duration_type:DurationType;
-    
-    /**
-      * @description The duration of time for which the discount is attached to the subscription, in &#x60;period_units&#x60;. Applicable only when &#x60;duration_type&#x60; is &#x60;limited_period&#x60;.
-
-      */
-    
-    period?:number;
-    
-    /**
-      * @description The unit of time for &#x60;period&#x60;. Applicable only when &#x60;duration_type&#x60; is &#x60;limited_period&#x60;. \* year - A period of 1 calendar year. \* month - A period of 1 calendar month. \* week - A period of 7 days. \* day - A period of 24 hours.
-
-      */
-    
-    period_unit?:PeriodUnit;
-    
-    /**
-      * @description The discount is included in MRR calculations for your site. This attribute is only applicable when &#x60;duration_type&#x60; is &#x60;one_time&#x60; and when the [feature is enabled](https://www.chargebee.com/docs/reporting.html#dashboards_flexible-mrr-calculation) in Chargebee. Also, If the [site-level setting](https://www.chargebee.com/docs/reporting.html#chart_flexible-mrr-calculation) is to exclude one-time discounts from MRR calculations, this value is always returned &#x60;false&#x60;.
-
-      */
-    
-    included_in_mrr:boolean;
-    
-    /**
-      * @description The amount on the invoice to which the discount is applied. \* invoice_amount - The discount is applied to the invoice &#x60;sub_total&#x60;. \* specific_item_price - The discount is applied to the &#x60;invoice.line_item.amount&#x60; that corresponds to the item price specified by &#x60;item_price_id&#x60;.
-
-      */
-    
-    apply_on:ApplyOn;
-    
-    /**
-      * @description The [id of the item price](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_subscription_items_item_price_id) in the subscription to which the discount is to be applied. Relevant only when &#x60;apply_on&#x60; &#x3D; &#x60;specific_item_price&#x60;.
-
-      */
-    
-    item_price_id?:string;
-    
-    /**
-      * @description Timestamp indicating when this discount is created.
-
-      */
-    
-    created_at:number;
-    
-    /**
-      * @description Specifies till when the limited period discount is applicable. This attribute will be sent in the response only for &#x60;limited_period&#x60; duration type discount.
-
-      */
-    
-    apply_till?:number;
-    
-    /**
-      * @description Specifies the number of times the discount has been applied.
-
-      */
-    
-    applied_count?:number;
-    
-    /**
-      * @description Used to uniquely identify the coupon in your website/application and to integrate with Chargebee.  
-**Note:**
-
-
-When the coupon ID contains a special character; for example: &#x60;#&#x60;, the API returns an error.
-Make sure that you [encode](https://www.urlencoder.org/) the coupon ID in the path parameter before making an API call.
-
-      */
-    
-    coupon_id:string;
-    
-    /**
-      * @description The index number of the subscription to which the item price is added. Provide a unique number between &#x60;0&#x60; and &#x60;4&#x60; (inclusive) for each subscription that is to be created.
-
-      */
-    
-    index:number;
+    id: string;
+    invoice_name?: string;
+    type: 'fixed_amount' | 'percentage';
+    percentage?: number;
+    amount?: number;
+    currency_code?: string;
+    duration_type: DurationType;
+    period?: number;
+    period_unit?: PeriodUnit;
+    included_in_mrr: boolean;
+    apply_on: ApplyOn;
+    item_price_id?: string;
+    created_at: number;
+    apply_till?: number;
+    applied_count?: number;
+    coupon_id: string;
+    index: number;
   }
-}
+}