chargebee 3.6.1 → 3.8.0-beta.1

package/esm/util.js

@@ -2,48 +2,43 @@ export const extend = (deep, target, copy) => {
     _extendsFn(deep, target, copy);
 };
 const _extendsFn = (...args) => {
-    {
-        let options, name, src, copy, copyIsArray, clone, target = args[0] || {}, i = 1, length = args.length, deep = false;
-        if (typeof target === 'boolean') {
-            deep = target;
-            target = args[1] || {};
-            i = 2;
-        }
-        if (typeof target !== 'object' && typeof target !== 'function') {
-            target = {};
-        }
-        if (length === i) {
-            target = this;
-            --i;
-        }
-        for (; i < length; i++) {
-            if ((options = args[i]) !== null) {
-                for (name in options) {
-                    src = target[name];
-                    copy = options[name];
-                    if (target === copy) {
-                        continue;
-                    }
-                    if (deep &&
-                        copy &&
-                        (typeof copy === 'object' || (copyIsArray = isArray(copy)))) {
-                        if (copyIsArray) {
-                            copyIsArray = false;
-                            clone = src && isArray(src) ? src : [];
-                        }
-                        else {
-                            clone = src && typeof src === 'object' ? src : {};
-                        }
-                        target[name] = extend(deep, clone, copy);
+    let options, name, src, copy, copyIsArray, clone;
+    let target = args[0] || {};
+    let i = 1;
+    const length = args.length;
+    let deep = false;
+    if (typeof target === 'boolean') {
+        deep = target;
+        target = args[1] || {};
+        i = 2;
+    }
+    if (typeof target !== 'object' && typeof target !== 'function') {
+        target = {};
+    }
+    for (; i < length; i++) {
+        if ((options = args[i]) !== null && options !== undefined) {
+            for (name in options) {
+                src = target[name];
+                copy = options[name];
+                if (target === copy) {
+                    continue;
+                }
+                if (deep && copy && (typeof copy === 'object' || isArray(copy))) {
+                    if (isArray(copy)) {
+                        clone = isArray(src) ? src : [];
                     }
-                    else if (copy !== undefined) {
-                        target[name] = copy;
+                    else {
+                        clone = isObject(src) ? src : {};
                     }
+                    target[name] = _extendsFn(deep, clone, copy);
+                }
+                else if (copy !== undefined) {
+                    target[name] = copy;
                 }
             }
         }
-        return target;
     }
+    return target;
 };
 export const isArray = (obj) => {
     return (Array.isArray(obj) ||
@@ -205,3 +200,31 @@ export function encodeParams(paramObj, serialized, scope, index, jsonKeys, level
     }
     return serialized.join('&').replace(/%20/g, '+');
 }
+export function log(env, { level = 'INFO', message = '', context = {}, functionName = '' }) {
+    if (!env.enableDebugLogs) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    const service = 'chargebee-node';
+    const metaString = Object.entries(context)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(', ');
+    const logLine = `[${timestamp}] [${level.toUpperCase()}] [${service}] ${functionName} - ${message}${metaString ? ` (${metaString})` : ''}`;
+    console.debug(logLine);
+}
+import { randomBytes } from 'crypto';
+export function generateUUIDv4() {
+    const bytes = randomBytes(16);
+    // Set version to 4 (UUIDv4)
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    // Set variant to 10xxxxxx
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20),
+    ].join('-');
+}

package/package.json

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

package/types/core.d.ts

@@ -344,6 +344,7 @@ declare module 'chargebee' {
     | 'sales_order_created'
     | 'sales_order_updated'
     | 'omnichannel_subscription_item_changed'
+    | 'omnichannel_subscription_item_paused'
     | 'plan_created'
     | 'plan_updated'
     | 'plan_deleted'

package/types/index.d.ts

@@ -81,6 +81,7 @@
 ///<reference path='./resources/UnbilledCharge.d.ts' />
 ///<reference path='./resources/Usage.d.ts' />
 ///<reference path='./resources/UsageEvent.d.ts' />
+///<reference path='./resources/UsageFile.d.ts' />
 ///<reference path='./resources/VirtualBankAccount.d.ts' />
 
 export type Config = {
@@ -120,6 +121,29 @@ export type Config = {
    * @hostSuffix url host suffix, default value is .chargebee.com
    */
   hostSuffix?: string;
+
+  /**
+   * @retryConfig retry configuration for the client, default value is { enabled: false, maxRetries: 3, delayMs: 1000, retryOn: [500, 502, 503, 504]}
+   */
+  retryConfig?: RetryConfig;
+
+  /**
+   * @enableDebugLogs whether to enable debug logs, default value is false
+   */
+  enableDebugLogs?: boolean;
+};
+
+export type RetryConfig = {
+  /**
+   * @enabled whether to enable retry logic, default value is false
+   * @maxRetries maximum number of retries, default value is 3
+   * @delayMs delay in milliseconds between retries, default value is 1000ms
+   * @retryOn array of HTTP status codes to retry on, default value is [500, 502, 503, 504]
+   */
+  enabled?: boolean;
+  maxRetries?: number;
+  delayMs?: number;
+  retryOn?: Array<number>;
 };
 declare module 'chargebee' {
   export default class Chargebee {
@@ -180,6 +204,7 @@ declare module 'chargebee' {
     unbilledCharge: UnbilledCharge.UnbilledChargeResource;
     usage: Usage.UsageResource;
     usageEvent: UsageEvent.UsageEventResource;
+    usageFile: UsageFile.UsageFileResource;
     virtualBankAccount: VirtualBankAccount.VirtualBankAccountResource;
   }
 }

package/types/resources/Estimate.d.ts

@@ -615,7 +615,7 @@ declare module 'chargebee' {
       charge_on_option?: ChargeOnOptionEnum;
     }
     export interface DiscountsCreateSubItemEstimateInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -751,7 +751,7 @@ declare module 'chargebee' {
       charge_on_option?: ChargeOnOptionEnum;
     }
     export interface DiscountsCreateSubItemForCustomerEstimateInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -909,7 +909,7 @@ declare module 'chargebee' {
       proration_type?: ProrationTypeEnum;
     }
     export interface DiscountsUpdateSubscriptionForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;

package/types/resources/HostedPage.d.ts

@@ -842,7 +842,7 @@ declare module 'chargebee' {
       charge_on_option?: ChargeOnOptionEnum;
     }
     export interface DiscountsCheckoutNewForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -977,7 +977,7 @@ declare module 'chargebee' {
       item_type?: ItemTypeEnum;
     }
     export interface DiscountsCheckoutExistingForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;

package/types/resources/Invoice.d.ts

@@ -956,6 +956,7 @@ declare module 'chargebee' {
       taxes?: TaxesImportInvoiceInputParam[];
       payments?: PaymentsImportInvoiceInputParam[];
       notes?: NotesImportInvoiceInputParam[];
+      line_item_addresses?: LineItemAddressesImportInvoiceInputParam[];
     }
     export interface ApplyPaymentsInputParam {
       comment?: string;
@@ -1539,6 +1540,23 @@ declare module 'chargebee' {
       quantity_used_in_decimal?: string;
       unit_amount_in_decimal?: string;
     }
+    export interface LineItemAddressesImportInvoiceInputParam {
+      line_item_id?: string;
+      first_name?: string;
+      last_name?: string;
+      email?: string;
+      company?: string;
+      phone?: string;
+      line1?: string;
+      line2?: string;
+      line3?: string;
+      city?: string;
+      state_code?: string;
+      state?: string;
+      zip?: string;
+      country?: string;
+      validation_status?: ValidationStatusEnum;
+    }
     export interface LineItemsImportInvoiceInputParam {
       id?: string;
       date_from?: number;

package/types/resources/OmnichannelSubscription.d.ts

@@ -67,6 +67,7 @@ declare module 'chargebee' {
     export interface ListInputParam {
       limit?: number;
       offset?: string;
+      source?: filter.Enum;
       customer_id?: filter.String;
     }
     export interface OmnichannelTransactionsForOmnichannelSubscriptionInputParam {

package/types/resources/OmnichannelSubscriptionItem.d.ts

@@ -11,7 +11,8 @@ declare module 'chargebee' {
       | 'expired'
       | 'cancelled'
       | 'in_dunning'
-      | 'in_grace_period';
+      | 'in_grace_period'
+      | 'paused';
     auto_renew_status?: 'off' | 'on';
     current_term_start?: number;
     current_term_end?: number;
@@ -22,7 +23,8 @@ declare module 'chargebee' {
       | 'customer_cancelled'
       | 'customer_did_not_consent_to_price_increase'
       | 'refunded_due_to_app_issue'
-      | 'refunded_for_other_reason';
+      | 'refunded_for_other_reason'
+      | 'merchant_revoked';
     grace_period_expires_at?: number;
     has_scheduled_changes: boolean;
     resource_version?: number;

package/types/resources/PricingPageSession.d.ts

@@ -98,7 +98,7 @@ declare module 'chargebee' {
     }
 
     export interface DiscountsCreateForNewSubscriptionInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -116,7 +116,7 @@ declare module 'chargebee' {
     }
 
     export interface DiscountsCreateForExistingSubscriptionInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;

package/types/resources/Quote.d.ts

@@ -1083,7 +1083,7 @@ declare module 'chargebee' {
       charge_on_option?: ChargeOnOptionEnum;
     }
     export interface DiscountsCreateSubItemsForCustomerQuoteInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -1153,7 +1153,7 @@ declare module 'chargebee' {
       charge_on_option?: ChargeOnOptionEnum;
     }
     export interface DiscountsEditCreateSubCustomerQuoteForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -1249,7 +1249,7 @@ declare module 'chargebee' {
       item_type?: ItemTypeEnum;
     }
     export interface DiscountsUpdateSubscriptionQuoteForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -1346,7 +1346,7 @@ declare module 'chargebee' {
       item_type?: ItemTypeEnum;
     }
     export interface DiscountsEditUpdateSubscriptionQuoteForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;

package/types/resources/Subscription.d.ts

@@ -1644,7 +1644,7 @@ declare module 'chargebee' {
       usage_accumulation_reset_frequency?: UsageAccumulationResetFrequencyEnum;
     }
     export interface DiscountsCreateWithItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -1981,7 +1981,7 @@ declare module 'chargebee' {
       usage_accumulation_reset_frequency?: UsageAccumulationResetFrequencyEnum;
     }
     export interface DiscountsUpdateForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;
@@ -2389,7 +2389,7 @@ declare module 'chargebee' {
       item_type?: ItemTypeEnum;
     }
     export interface DiscountsImportForItemsInputParam {
-      apply_on: ApplyOnEnum;
+      apply_on?: ApplyOnEnum;
       duration_type: DurationTypeEnum;
       percentage?: number;
       amount?: number;

package/types/resources/UsageFile.d.ts

@@ -0,0 +1,56 @@
+///<reference path='./../core.d.ts'/>
+///<reference path='./../index.d.ts'/>
+
+declare module 'chargebee' {
+  export interface UsageFile {
+    id: string;
+    name: string;
+    mime_type: string;
+    error_code?: string;
+    error_reason?: string;
+    status?: 'queued' | 'imported' | 'processing' | 'processed' | 'failed';
+    total_records_count?: number;
+    processed_records_count?: number;
+    failed_records_count?: number;
+    file_size_in_bytes?: number;
+    processing_started_at?: number;
+    processing_completed_at?: number;
+    uploaded_by?: string;
+    uploaded_at?: number;
+    upload_details?: UsageFile.UploadDetail;
+  }
+
+  export namespace UsageFile {
+    export class UsageFileResource {
+      upload(
+        input: UploadInputParam,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<UploadResponse>>;
+
+      status(
+        usage_file_id: string,
+        headers?: ChargebeeRequestHeader,
+      ): Promise<ChargebeeResponse<StatusResponse>>;
+    }
+
+    export interface UploadResponse {
+      usage_file: UsageFile;
+    }
+
+    export interface StatusResponse {
+      usage_file: UsageFile;
+    }
+
+    export interface UploadDetail {
+      url: string;
+      expires_at: number;
+    }
+    // REQUEST PARAMS
+    //---------------
+
+    export interface UploadInputParam {
+      file_name: string;
+      mime_type: string;
+    }
+  }
+}

package/types/resources/VirtualBankAccount.d.ts

@@ -17,7 +17,7 @@ declare module 'chargebee' {
     bank_name?: string;
     account_number: string;
     routing_number?: string;
-    swift_code: string;
+    swift_code?: string;
     gateway: GatewayEnum;
     gateway_account_id: string;
     resource_version?: number;