chargebee 3.11.0 → 3.12.0

package/CHANGELOG.md

@@ -1,3 +1,67 @@
+### v3.12.0 (2025-08-19)
+* * * 
+
+### New Resources: 
+* WebhookEndpoints has been added. 
+* OmnichannelOneTimeOrder has been added.
+* OmnichannelOneTimeOrderItem has been added. 
+
+### New Attributes: 
+* business_entity_id has been added to Comment.
+* business_entity_id has been added to PromotionalCredit.
+* quantity has been added to Discount.
+* business_entity_id has been added to PromotionalCredit.
+* coupon_applicability_mappings[] has been added to QuotedCharge.
+* linked_omnichannel_one_time_orders[] has been added to RecordedPurchase.
+* quantity has been added to Subscripiton#Discount.
+
+### New Input Parameters: 
+* transaction[id] has been added to Customer#RecordExcessPaymentRequest.
+* discounts[quantity][] has been added to Estimate#CreateSubItemEstimateRequest.
+* consolidate_entitlements has been added to CustomerEntitlement#EntitlementsForCustomer.
+* discounts[quantity][] has been added to Estimate#CreateSubItemEstimateRequest.
+* discounts[quantity][] has been added to Estimate#CreateSubItemForCustomerEstimateRequest.
+* discounts[quantity][] has been added to Estimate#UpdateSubscriptionForItemsRequest.
+* discounts[quantity][] has been added to Estimate#CreateInvoiceForItemsRequest.
+* discounts[quantity][] has been added to HostedPage#CheckoutOneTimeForItemsRequest.
+* discounts[quantity][] has been added to HostedPage#CheckoutNewForItemsRequest.
+* discounts[quantity][] has been added to HostedPage#CheckoutExistingForItemsRequest.
+* discounts[quantity][] has been added to PricingPageSession#CreateForNewSubscriptionRequest.
+* discounts[quantity][] has been added to PricingPageSession#CreateForExistingSubscriptionRequest.
+* discounts[quantity][] has been added to Purchase#CreateRequest.
+* discounts[quantity][] has been added to Purchase#EstimateRequest.
+* discounts[quantity][] has been added to Quote#CreateSubItemsForCustomerQuoteRequest.
+* discounts[quantity][] has been added to Quote#EditCreateSubCustomerQuoteForItemsRequest.
+* discounts[quantity][] has been added to Quote#UpdateSubscriptionQuoteForItemsRequest.
+* discounts[quantity][] has been added to Quote#EditUpdateSubscriptionQuoteForItemsRequest.
+* discounts[quantity][] has been added to Quote#CreateForChargeItemsAndChargesRequest.
+* discounts[quantity][] has been added to Quote#EditForChargeItemsAndChargesRequest.
+* discounts[quantity][] has been added to Subscription#CreateWithItemsRequest.
+* discounts[quantity][] has been added to Subscription#UpdateForItemsRequest.
+* discounts[quantity][] has been added to Subscription#ImportForItemsRequest.
+* google_play_store[product_id] has been added to RecordedPurchase#CreateRequest.
+* google_play_store[order_id] has been added to RecordedPurchase#CreateRequest.
+
+### New Enums
+* PAUSE has been added to OmnichannelSubscriptionItemScheduledChange#ChangeType.
+* OFFER_QUANTITY has been added to Discount#Type.
+* OFFER_QUANTITY has been added to Subscription#Discount#Type.
+* OMNICHANNEL_ONE_TIME_ORDER has been added to EntityType.
+* OMNICHANNEL_ONE_TIME_ORDER_ITEM has been added to EntityType.
+* USAGE_FILE has been added to EntityType.
+* OMNICHANNEL_ONE_TIME_ORDER_CREATED has been added to EventType.
+* OMNICHANNEL_ONE_TIME_ORDER_ITEM_CANCELLED has been added to EventType.
+* USAGE_FILE_INGESTED has been added to EventType.
+* OMNICHANNEL_SUBSCRIPTION_ITEM_PAUSE_SCHEDULED has been added to EventType.
+
+
+### v3.12.0-beta.1 (2025-07-23) 
+* * * 
+
+### Bug Fixes: 
+* Resolved a module dependency issue that was causing runtime failures in the Edge environment. 
+
+
 ### v3.11.0 (2025-07-18) 
 * * * 
 

package/cjs/environment.js

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

package/cjs/resources/api_endpoints.js

@@ -4676,6 +4676,31 @@ exports.Endpoints = {
         ],
         ['retrieve', 'GET', '/recorded_purchases', null, true, null, false, {}, {}],
     ],
+    omnichannelOneTimeOrder: [
+        [
+            'retrieve',
+            'GET',
+            '/omnichannel_one_time_orders',
+            null,
+            true,
+            null,
+            false,
+            {},
+            {},
+        ],
+        [
+            'list',
+            'GET',
+            '/omnichannel_one_time_orders',
+            null,
+            false,
+            null,
+            false,
+            {},
+            {},
+        ],
+    ],
+    omnichannelOneTimeOrderItem: [],
     rule: [['retrieve', 'GET', '/rules', null, true, null, false, {}, {}]],
     usageEvent: [
         [
@@ -4708,10 +4733,10 @@ exports.Endpoints = {
     omnichannelSubscriptionItemScheduledChange: [],
     usageFile: [
         [
-            'upload',
+            'uploadUrl',
             'POST',
             '/usage_files',
-            '/upload',
+            '/upload_url',
             false,
             'file-ingest',
             false,
@@ -4719,10 +4744,10 @@ exports.Endpoints = {
             {},
         ],
         [
-            'status',
+            'processingStatus',
             'GET',
             '/usage_files',
-            '/status',
+            '/processing_status',
             true,
             'file-ingest',
             false,
@@ -4731,4 +4756,50 @@ exports.Endpoints = {
         ],
     ],
     brand: [],
+    webhookEndpoint: [
+        [
+            'create',
+            'POST',
+            '/webhook_endpoints',
+            null,
+            false,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        [
+            'update',
+            'POST',
+            '/webhook_endpoints',
+            null,
+            true,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        ['retrieve', 'GET', '/webhook_endpoints', null, true, null, false, {}, {}],
+        [
+            'delete',
+            'POST',
+            '/webhook_endpoints',
+            '/delete',
+            true,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        ['list', 'GET', '/webhook_endpoints', null, false, null, false, {}, {}],
+    ],
+    impactedCustomer: [],
+    subscriptionEntitlementsUpdatedDetail: [],
+    subscriptionEntitlementsCreatedDetail: [],
 };

package/cjs/util.js

@@ -230,19 +230,10 @@ function log(env, { level = 'INFO', message = '', context = {}, functionName = '
     const logLine = `[${timestamp}] [${level.toUpperCase()}] [${service}] ${functionName} - ${message}${metaString ? ` (${metaString})` : ''}`;
     console.debug(logLine);
 }
-const crypto_1 = require("crypto");
 function generateUUIDv4() {
-    const bytes = (0, crypto_1.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('-');
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
 }

package/esm/environment.js

@@ -8,7 +8,7 @@ export const Environment = {
     hostSuffix: '.chargebee.com',
     apiPath: '/api/v2',
     timeout: DEFAULT_TIME_OUT,
-    clientVersion: 'v3.11.0',
+    clientVersion: 'v3.12.0',
     port: DEFAULT_PORT,
     timemachineWaitInMillis: DEFAULT_TIME_MACHINE_WAIT,
     exportWaitInMillis: DEFAULT_EXPORT_WAIT,

package/esm/resources/api_endpoints.js

@@ -4673,6 +4673,31 @@ export const Endpoints = {
         ],
         ['retrieve', 'GET', '/recorded_purchases', null, true, null, false, {}, {}],
     ],
+    omnichannelOneTimeOrder: [
+        [
+            'retrieve',
+            'GET',
+            '/omnichannel_one_time_orders',
+            null,
+            true,
+            null,
+            false,
+            {},
+            {},
+        ],
+        [
+            'list',
+            'GET',
+            '/omnichannel_one_time_orders',
+            null,
+            false,
+            null,
+            false,
+            {},
+            {},
+        ],
+    ],
+    omnichannelOneTimeOrderItem: [],
     rule: [['retrieve', 'GET', '/rules', null, true, null, false, {}, {}]],
     usageEvent: [
         [
@@ -4705,10 +4730,10 @@ export const Endpoints = {
     omnichannelSubscriptionItemScheduledChange: [],
     usageFile: [
         [
-            'upload',
+            'uploadUrl',
             'POST',
             '/usage_files',
-            '/upload',
+            '/upload_url',
             false,
             'file-ingest',
             false,
@@ -4716,10 +4741,10 @@ export const Endpoints = {
             {},
         ],
         [
-            'status',
+            'processingStatus',
             'GET',
             '/usage_files',
-            '/status',
+            '/processing_status',
             true,
             'file-ingest',
             false,
@@ -4728,4 +4753,50 @@ export const Endpoints = {
         ],
     ],
     brand: [],
+    webhookEndpoint: [
+        [
+            'create',
+            'POST',
+            '/webhook_endpoints',
+            null,
+            false,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        [
+            'update',
+            'POST',
+            '/webhook_endpoints',
+            null,
+            true,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        ['retrieve', 'GET', '/webhook_endpoints', null, true, null, false, {}, {}],
+        [
+            'delete',
+            'POST',
+            '/webhook_endpoints',
+            '/delete',
+            true,
+            null,
+            false,
+            {},
+            {
+                isIdempotent: true,
+            },
+        ],
+        ['list', 'GET', '/webhook_endpoints', null, false, null, false, {}, {}],
+    ],
+    impactedCustomer: [],
+    subscriptionEntitlementsUpdatedDetail: [],
+    subscriptionEntitlementsCreatedDetail: [],
 };

package/esm/util.js

@@ -212,19 +212,10 @@ export function log(env, { level = 'INFO', message = '', context = {}, functionN
     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('-');
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chargebee",
-  "version": "3.11.0",
+  "version": "3.12.0",
   "description": "A library for integrating with Chargebee.",
   "scripts": {
     "prepack": "npm install && npm run build",
@@ -36,6 +36,10 @@
   },
   "exports": {
     "types": "./types/index.d.ts",
+    "browser": {
+      "import": "./esm/chargebee.esm.worker.js",
+      "require": "./cjs/chargebee.cjs.worker.js"
+    },
     "worker": {
       "import": "./esm/chargebee.esm.worker.js",
       "require": "./cjs/chargebee.cjs.worker.js"

package/types/core.d.ts

@@ -144,7 +144,10 @@ declare module 'chargebee' {
     | 'omnichannel_transaction'
     | 'recorded_purchase'
     | 'omnichannel_subscription_item_scheduled_change'
-    | 'sales_order';
+    | 'sales_order'
+    | 'omnichannel_one_time_order'
+    | 'omnichannel_one_time_order_item'
+    | 'usage_file';
   type EventNameEnum = 'cancellation_page_loaded';
   type EventTypeEnum =
     | 'coupon_created'
@@ -349,6 +352,10 @@ declare module 'chargebee' {
     | 'omnichannel_subscription_item_changed'
     | 'omnichannel_subscription_item_paused'
     | 'omnichannel_subscription_item_resumed'
+    | 'omnichannel_one_time_order_created'
+    | 'omnichannel_one_time_order_item_cancelled'
+    | 'usage_file_ingested'
+    | 'omnichannel_subscription_item_pause_scheduled'
     | 'plan_created'
     | 'plan_updated'
     | 'plan_deleted'

package/types/index.d.ts

@@ -33,6 +33,7 @@
 ///<reference path='./resources/Gift.d.ts' />
 ///<reference path='./resources/Hierarchy.d.ts' />
 ///<reference path='./resources/HostedPage.d.ts' />
+///<reference path='./resources/ImpactedCustomer.d.ts' />
 ///<reference path='./resources/ImpactedItem.d.ts' />
 ///<reference path='./resources/ImpactedItemPrice.d.ts' />
 ///<reference path='./resources/ImpactedSubscription.d.ts' />
@@ -45,6 +46,8 @@
 ///<reference path='./resources/ItemPrice.d.ts' />
 ///<reference path='./resources/Metadata.d.ts' />
 ///<reference path='./resources/NonSubscription.d.ts' />
+///<reference path='./resources/OmnichannelOneTimeOrder.d.ts' />
+///<reference path='./resources/OmnichannelOneTimeOrderItem.d.ts' />
 ///<reference path='./resources/OmnichannelSubscription.d.ts' />
 ///<reference path='./resources/OmnichannelSubscriptionItem.d.ts' />
 ///<reference path='./resources/OmnichannelSubscriptionItemScheduledChange.d.ts' />
@@ -75,6 +78,8 @@
 ///<reference path='./resources/SiteMigrationDetail.d.ts' />
 ///<reference path='./resources/Subscription.d.ts' />
 ///<reference path='./resources/SubscriptionEntitlement.d.ts' />
+///<reference path='./resources/SubscriptionEntitlementsCreatedDetail.d.ts' />
+///<reference path='./resources/SubscriptionEntitlementsUpdatedDetail.d.ts' />
 ///<reference path='./resources/SubscriptionEstimate.d.ts' />
 ///<reference path='./resources/TaxWithheld.d.ts' />
 ///<reference path='./resources/ThirdPartyPaymentMethod.d.ts' />
@@ -86,6 +91,7 @@
 ///<reference path='./resources/UsageEvent.d.ts' />
 ///<reference path='./resources/UsageFile.d.ts' />
 ///<reference path='./resources/VirtualBankAccount.d.ts' />
+///<reference path='./resources/WebhookEndpoint.d.ts' />
 
 export type Config = {
   /**
@@ -186,6 +192,7 @@ declare module 'chargebee' {
     itemFamily: ItemFamily.ItemFamilyResource;
     itemPrice: ItemPrice.ItemPriceResource;
     nonSubscription: NonSubscription.NonSubscriptionResource;
+    omnichannelOneTimeOrder: OmnichannelOneTimeOrder.OmnichannelOneTimeOrderResource;
     omnichannelSubscription: OmnichannelSubscription.OmnichannelSubscriptionResource;
     omnichannelSubscriptionItem: OmnichannelSubscriptionItem.OmnichannelSubscriptionItemResource;
     order: Order.OrderResource;
@@ -214,5 +221,6 @@ declare module 'chargebee' {
     usageEvent: UsageEvent.UsageEventResource;
     usageFile: UsageFile.UsageFileResource;
     virtualBankAccount: VirtualBankAccount.VirtualBankAccountResource;
+    webhookEndpoint: WebhookEndpoint.WebhookEndpointResource;
   }
 }

package/types/resources/Comment.d.ts

@@ -10,6 +10,7 @@ declare module 'chargebee' {
     created_at: number;
     type: 'user' | 'system';
     entity_id: string;
+    business_entity_id?: string;
   }
 
   export namespace Comment {
@@ -82,6 +83,9 @@ declare module 'chargebee' {
         | 'recorded_purchase'
         | 'omnichannel_subscription_item_scheduled_change'
         | 'sales_order'
+        | 'omnichannel_one_time_order'
+        | 'omnichannel_one_time_order_item'
+        | 'usage_file'
         | 'item_family'
         | 'item'
         | 'item_price'