chargebee 3.3.0 → 3.4.0

package/esm/util.js

@@ -148,47 +148,52 @@ export function encodeListParams(paramObj) {
     }
     return encodeParams(paramObj);
 }
-export function getHost(env) {
+export function getHost(env, subDomain) {
+    if (subDomain != null) {
+        return env.site + '.' + subDomain + env.hostSuffix;
+    }
     return env.site + env.hostSuffix;
 }
-export function encodeParams(paramObj, serialized, scope, index) {
+export function encodeParams(paramObj, serialized, scope, index, jsonKeys, level = 0) {
     let key, value;
     if (typeof serialized === 'undefined' || serialized === null) {
         serialized = [];
     }
     for (key in paramObj) {
         value = paramObj[key];
+        const originalKey = key;
         if (scope) {
-            key = '' + scope + '[' + key + ']';
+            key = `${scope}[${key}]`;
         }
         if (typeof index !== 'undefined' && index !== null) {
-            key = key + '[' + index + ']';
+            key = `${key}[${index}]`;
+        }
+        if (jsonKeys && jsonKeys[originalKey] === level) {
+            let attrVal = '';
+            if (value !== null) {
+                attrVal = encodeURIComponent(Object.prototype.toString.call(value) === '[object String]'
+                    ? trim(value)
+                    : JSON.stringify(value));
+            }
+            serialized.push(encodeURIComponent(key) + '=' + attrVal);
         }
-        if (isArray(value)) {
+        else if (isArray(value) &&
+            !(jsonKeys && jsonKeys[originalKey] === level)) {
             for (let arrIdx = 0; arrIdx < value.length; arrIdx++) {
                 if (typeof value[arrIdx] === 'object' || isArray(value[arrIdx])) {
-                    encodeParams(value[arrIdx], serialized, key, arrIdx);
+                    encodeParams(value[arrIdx], serialized, key, arrIdx, jsonKeys, level + 1);
                 }
                 else {
                     if (typeof value[arrIdx] !== 'undefined') {
-                        serialized.push(encodeURIComponent(key + '[' + arrIdx + ']') +
+                        serialized.push(encodeURIComponent(`${key}[${arrIdx}]`) +
                             '=' +
                             encodeURIComponent(trim(value[arrIdx]) !== '' ? value[arrIdx] : ''));
                     }
                 }
             }
         }
-        else if (key === 'meta_data' || key === 'metadata') {
-            let attrVal = '';
-            if (value !== null) {
-                attrVal = encodeURIComponent(Object.prototype.toString.call(value) === '[object String]'
-                    ? trim(value)
-                    : JSON.stringify(value));
-            }
-            serialized.push(encodeURIComponent(key) + '=' + attrVal);
-        }
         else if (typeof value === 'object' && !isArray(value)) {
-            encodeParams(value, serialized, key);
+            encodeParams(value, serialized, key, undefined, jsonKeys, level + 1);
         }
         else {
             if (typeof value !== 'undefined') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chargebee",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "A library for integrating with Chargebee.",
   "scripts": {
     "prepack": "npm install && npm run build",

package/types/core.d.ts

@@ -9,6 +9,7 @@ declare module 'chargebee' {
   export type ChargebeeResponse<T> = T & {
     headers: { [key: string]: string };
     isIdempotencyReplayed?: boolean | string;
+    httpStatusCode: number | null;
   };
   export type ChargebeeRequestHeader = {
     [key: string]: string | undefined;
@@ -135,7 +136,8 @@ declare module 'chargebee' {
     | 'price_variant'
     | 'omnichannel_subscription'
     | 'omnichannel_subscription_item'
-    | 'omnichannel_transaction';
+    | 'omnichannel_transaction'
+    | 'recorded_purchase';
   type EventNameEnum = 'cancellation_page_loaded';
   type EventTypeEnum =
     | 'coupon_created'
@@ -329,6 +331,10 @@ declare module 'chargebee' {
     | 'omnichannel_subscription_item_grace_period_expired'
     | 'omnichannel_subscription_item_dunning_started'
     | 'omnichannel_subscription_item_dunning_expired'
+    | 'rule_created'
+    | 'rule_updated'
+    | 'rule_deleted'
+    | 'record_purchase_failed'
     | 'plan_created'
     | 'plan_updated'
     | 'plan_deleted'

package/types/index.d.ts

@@ -65,6 +65,7 @@
 ///<reference path='./resources/Ramp.d.ts' />
 ///<reference path='./resources/RecordedPurchase.d.ts' />
 ///<reference path='./resources/ResourceMigration.d.ts' />
+///<reference path='./resources/Rule.d.ts' />
 ///<reference path='./resources/SiteMigrationDetail.d.ts' />
 ///<reference path='./resources/Subscription.d.ts' />
 ///<reference path='./resources/SubscriptionEntitlement.d.ts' />
@@ -76,6 +77,7 @@
 ///<reference path='./resources/Transaction.d.ts' />
 ///<reference path='./resources/UnbilledCharge.d.ts' />
 ///<reference path='./resources/Usage.d.ts' />
+///<reference path='./resources/UsageEvent.d.ts' />
 ///<reference path='./resources/VirtualBankAccount.d.ts' />
 
 export type Config = {
@@ -163,6 +165,7 @@ declare module 'chargebee' {
     ramp: Ramp.RampResource;
     recordedPurchase: RecordedPurchase.RecordedPurchaseResource;
     resourceMigration: ResourceMigration.ResourceMigrationResource;
+    rule: Rule.RuleResource;
     siteMigrationDetail: SiteMigrationDetail.SiteMigrationDetailResource;
     subscription: Subscription.SubscriptionResource;
     subscriptionEntitlement: SubscriptionEntitlement.SubscriptionEntitlementResource;
@@ -170,6 +173,7 @@ declare module 'chargebee' {
     transaction: Transaction.TransactionResource;
     unbilledCharge: UnbilledCharge.UnbilledChargeResource;
     usage: Usage.UsageResource;
+    usageEvent: UsageEvent.UsageEventResource;
     virtualBankAccount: VirtualBankAccount.VirtualBankAccountResource;
   }
 }

package/types/resources/AttachedItem.d.ts

@@ -18,6 +18,7 @@ declare module 'chargebee' {
     updated_at?: number;
     channel?: ChannelEnum;
     business_entity_id?: string;
+    deleted: boolean;
   }
 
   export namespace AttachedItem {

package/types/resources/Comment.d.ts

@@ -79,6 +79,7 @@ declare module 'chargebee' {
         | 'omnichannel_subscription'
         | 'omnichannel_subscription_item'
         | 'omnichannel_transaction'
+        | 'recorded_purchase'
         | 'item_family'
         | 'item'
         | 'item_price'

package/types/resources/Coupon.d.ts

@@ -41,6 +41,7 @@ declare module 'chargebee' {
     invoice_notes?: string;
     meta_data?: any;
     coupon_constraints?: Coupon.CouponConstraint[];
+    deleted: boolean;
   }
 
   export namespace Coupon {
@@ -160,10 +161,7 @@ declare module 'chargebee' {
       discount_type?: 'fixed_amount' | 'percentage' | 'offer_quantity';
       discount_amount?: number;
       currency_code?: string;
-      discount_percentage?: number /**
-       * @deprecated Please refer API docs to use other attributes
-       */;
-
+      discount_percentage?: number;
       discount_quantity?: number;
       apply_on: 'invoice_amount' | 'each_specified_item';
       duration_type?: 'one_time' | 'forever' | 'limited_period';
@@ -188,10 +186,7 @@ declare module 'chargebee' {
       discount_type?: 'fixed_amount' | 'percentage' | 'offer_quantity';
       discount_amount?: number;
       currency_code?: string;
-      discount_percentage?: number /**
-       * @deprecated Please refer API docs to use other attributes
-       */;
-
+      discount_percentage?: number;
       discount_quantity?: number;
       apply_on: 'invoice_amount' | 'each_specified_item';
       duration_type?: 'one_time' | 'forever' | 'limited_period';
@@ -216,10 +211,7 @@ declare module 'chargebee' {
       discount_type?: 'fixed_amount' | 'percentage' | 'offer_quantity';
       discount_amount?: number;
       currency_code?: string;
-      discount_percentage?: number /**
-       * @deprecated Please refer API docs to use other attributes
-       */;
-
+      discount_percentage?: number;
       discount_quantity?: number;
       apply_on?: 'invoice_amount' | 'each_specified_item';
       duration_type?: 'one_time' | 'forever' | 'limited_period';
@@ -259,10 +251,7 @@ declare module 'chargebee' {
       discount_type?: 'fixed_amount' | 'percentage' | 'offer_quantity';
       discount_amount?: number;
       currency_code?: string;
-      discount_percentage?: number /**
-       * @deprecated Please refer API docs to use other attributes
-       */;
-
+      discount_percentage?: number;
       discount_quantity?: number;
       apply_on?: 'invoice_amount' | 'each_specified_item';
       duration_type?: 'one_time' | 'forever' | 'limited_period';

package/types/resources/CreditNote.d.ts

@@ -7,7 +7,7 @@ declare module 'chargebee' {
     customer_id: string;
     subscription_id?: string;
     reference_invoice_id?: string;
-    type: 'adjustment' | 'refundable';
+    type: 'adjustment' | 'refundable' | 'store';
     reason_code?:
       | 'write_off'
       | 'subscription_change'
@@ -360,6 +360,7 @@ declare module 'chargebee' {
         | 'not_paid'
         | 'voided'
         | 'pending';
+      tax_application?: 'pre_tax' | 'post_tax';
     }
     export interface ShippingAddress {
       first_name?: string;
@@ -409,7 +410,7 @@ declare module 'chargebee' {
       reference_invoice_id?: string;
       customer_id?: string;
       total?: number;
-      type: 'adjustment' | 'refundable';
+      type: 'adjustment' | 'refundable' | 'store';
       reason_code?:
         | 'product_unsatisfactory'
         | 'service_unsatisfactory'
@@ -480,7 +481,7 @@ declare module 'chargebee' {
       customer_id?: string;
       subscription_id?: string;
       reference_invoice_id: string;
-      type: 'adjustment' | 'refundable';
+      type: 'adjustment' | 'refundable' | 'store';
       currency_code?: string;
       create_reason_code: string;
       date: number;

package/types/resources/CreditNoteEstimate.d.ts

@@ -4,7 +4,7 @@
 declare module 'chargebee' {
   export interface CreditNoteEstimate {
     reference_invoice_id: string;
-    type: 'adjustment' | 'refundable';
+    type: 'adjustment' | 'refundable' | 'store';
     price_type: PriceTypeEnum;
     currency_code: string;
     sub_total: number;

package/types/resources/Customer.d.ts

@@ -608,7 +608,6 @@ declare module 'chargebee' {
     export interface MoveInputParam {
       id_at_from_site: string;
       from_site: string;
-      tax_providers_fields?: TaxProvidersFieldsMoveInputParam[];
     }
     export interface ChangeBillingDateInputParam {
       billing_date?: number;
@@ -627,7 +626,6 @@ declare module 'chargebee' {
     export interface MergeInputParam {
       from_customer_id: string;
       to_customer_id: string;
-      tax_providers_fields?: TaxProvidersFieldsMergeInputParam[];
     }
     export interface RelationshipsInputParam {
       parent_id?: string;
@@ -921,16 +919,6 @@ declare module 'chargebee' {
       invoice_id: string;
       allocation_amount?: number;
     }
-    export interface TaxProvidersFieldsMoveInputParam {
-      provider_name?: string;
-      field_id?: string;
-      field_value?: string;
-    }
-    export interface TaxProvidersFieldsMergeInputParam {
-      provider_name?: string;
-      field_id?: string;
-      field_value?: string;
-    }
     export interface ParentAccountAccessRelationshipsInputParam {
       portal_edit_child_subscriptions?: 'yes' | 'view_only' | 'no';
       portal_download_child_invoices?: 'yes' | 'view_only' | 'no';

package/types/resources/DifferentialPrice.d.ts

@@ -17,6 +17,7 @@ declare module 'chargebee' {
     currency_code: string;
     parent_periods?: DifferentialPrice.ParentPeriod[];
     business_entity_id?: string;
+    deleted: boolean;
   }
 
   export namespace DifferentialPrice {

package/types/resources/Feature.d.ts

@@ -3,6 +3,7 @@
 ///<reference path='./filter.d.ts'/>
 declare module 'chargebee' {
   export interface Feature {
+    [key: string]: unknown;
     id: string;
     name: string;
     description?: string;

package/types/resources/Invoice.d.ts

@@ -54,6 +54,7 @@ declare module 'chargebee' {
     line_item_discounts?: Invoice.LineItemDiscount[];
     taxes?: Invoice.Tax[];
     line_item_taxes?: Invoice.LineItemTax[];
+    line_item_credits?: Invoice.LineItemCredit[];
     line_item_tiers?: Invoice.LineItemTier[];
     linked_payments?: Invoice.LinkedPayment[];
     dunning_attempts?: Invoice.DunningAttempt[];
@@ -566,6 +567,11 @@ declare module 'chargebee' {
       tax_amount_in_local_currency?: number;
       local_currency_code?: string;
     }
+    export interface LineItemCredit {
+      cn_id: string;
+      applied_amount: number;
+      line_item_id?: string;
+    }
     export interface LineItemTier {
       line_item_id?: string;
       starting_unit: number;
@@ -627,6 +633,7 @@ declare module 'chargebee' {
       cn_create_reason_code?: string;
       cn_date?: number;
       cn_status: 'adjusted' | 'refunded' | 'refund_due' | 'voided';
+      tax_application?: 'pre_tax' | 'post_tax';
     }
     export interface AdjustmentCreditNote {
       cn_id: string;

package/types/resources/InvoiceEstimate.d.ts

@@ -16,6 +16,7 @@ declare module 'chargebee' {
     taxes?: InvoiceEstimate.Tax[];
     line_item_taxes?: InvoiceEstimate.LineItemTax[];
     line_item_tiers?: InvoiceEstimate.LineItemTier[];
+    line_item_credits?: InvoiceEstimate.LineItemCredit[];
     line_item_discounts?: InvoiceEstimate.LineItemDiscount[];
     round_off_amount?: number;
     customer_id?: string;
@@ -125,6 +126,11 @@ declare module 'chargebee' {
       quantity_used_in_decimal?: string;
       unit_amount_in_decimal?: string;
     }
+    export interface LineItemCredit {
+      cn_id: string;
+      applied_amount: number;
+      line_item_id?: string;
+    }
     export interface LineItemDiscount {
       line_item_id: string;
       discount_type:

package/types/resources/Item.d.ts

@@ -30,6 +30,7 @@ declare module 'chargebee' {
     bundle_items?: Item.BundleItem[];
     bundle_configuration?: Item.BundleConfiguration;
     metadata?: any;
+    deleted: boolean;
     business_entity_id?: string;
   }
 

package/types/resources/ItemFamily.d.ts

@@ -12,6 +12,7 @@ declare module 'chargebee' {
     updated_at?: number;
     channel?: ChannelEnum;
     business_entity_id?: string;
+    deleted: boolean;
   }
 
   export namespace ItemFamily {

package/types/resources/ItemPrice.d.ts

@@ -48,6 +48,7 @@ declare module 'chargebee' {
     parent_item_id?: string;
     show_description_in_invoices?: boolean;
     show_description_in_quotes?: boolean;
+    deleted: boolean;
     business_entity_id?: string;
   }
 

package/types/resources/Order.d.ts

@@ -317,7 +317,7 @@ declare module 'chargebee' {
     }
     export interface LinkedCreditNote {
       amount?: number;
-      type: 'adjustment' | 'refundable';
+      type: 'adjustment' | 'refundable' | 'store';
       id: string;
       status: 'adjusted' | 'refunded' | 'refund_due' | 'voided';
       amount_adjusted?: number;

package/types/resources/PriceVariant.d.ts

@@ -15,6 +15,7 @@ declare module 'chargebee' {
     archived_at?: number;
     attributes?: PriceVariant.Attribute[];
     business_entity_id?: string;
+    deleted: boolean;
   }
 
   export namespace PriceVariant {

package/types/resources/Rule.d.ts

@@ -0,0 +1,33 @@
+///<reference path='./../core.d.ts'/>
+///<reference path='./../index.d.ts'/>
+
+declare module 'chargebee' {
+  export interface Rule {
+    id: string;
+    namespace: string;
+    rule_name: string;
+    rule_order?: number;
+    status: 'active' | 'disabled';
+    conditions?: string;
+    outcome?: string;
+    deleted: boolean;
+    created_at: number;
+    modified_at: number;
+  }
+
+  export namespace Rule {
+    export class RuleResource {
+      retrieve(
+        rule_id: string,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<RetrieveResponse>>;
+    }
+
+    export interface RetrieveResponse {
+      rule: Rule;
+    }
+
+    // REQUEST PARAMS
+    //---------------
+  }
+}

package/types/resources/Subscription.d.ts

@@ -1174,6 +1174,7 @@ declare module 'chargebee' {
       tiers?: TiersImportUnbilledChargesInputParam[];
     }
     export interface ImportForItemsInputParam {
+      exhausted_coupon_ids?: string[];
       id?: string;
       trial_end?: number;
       billing_cycles?: number /**

package/types/resources/UsageEvent.d.ts

@@ -0,0 +1,53 @@
+///<reference path='./../core.d.ts'/>
+///<reference path='./../index.d.ts'/>
+
+declare module 'chargebee' {
+  export interface UsageEvent {
+    subscription_id: string;
+    deduplication_id: string;
+    usage_timestamp: number;
+    properties: any;
+  }
+
+  export namespace UsageEvent {
+    export class UsageEventResource {
+      create(
+        input: CreateInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<CreateResponse>>;
+
+      batchIngest(
+        input: BatchIngestInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<BatchIngestResponse>>;
+    }
+
+    export interface CreateResponse {
+      usage_event: UsageEvent;
+    }
+
+    export interface BatchIngestResponse {
+      batch_id: string;
+      failed_events: any[];
+    }
+
+    // REQUEST PARAMS
+    //---------------
+
+    export interface CreateInputParam {
+      deduplication_id: string;
+      subscription_id: string;
+      usage_timestamp: number;
+      properties: any;
+    }
+    export interface BatchIngestInputParam {
+      events?: EventsBatchIngestInputParam[];
+    }
+    export interface EventsBatchIngestInputParam {
+      deduplication_id: string;
+      subscription_id: string;
+      usage_timestamp: number;
+      properties: any;
+    }
+  }
+}