zuora-sdk-js 3.8.0-beta.1 → 3.9.0-beta.1

package/README.md

@@ -4,8 +4,8 @@ ZuoraSdkJs - JavaScript client for zuora-sdk-js
 REST API reference for the Zuora Billing, Payments, and Central Platform! Check out the [REST API Overview](https://www.zuora.com/developer/api-references/api/overview/).
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 2024-05-20
-- Package version: 3.8.0-beta.1
+- API version: 2025-08-12
+- Package version: 3.9.0-beta.1
 - Generator version: 7.6.0
 - Build package: org.openapitools.codegen.languages.JavascriptClientCodegen
 
@@ -418,8 +418,10 @@ Class | Method | HTTP request | Description
 *ZuoraSdkJs.ObjectQueriesApi* | [**queryBillingRunByKey**](docs/ObjectQueriesApi.md#queryBillingRunByKey) | **GET** /object-query/billing-runs/{key} | 
 *ZuoraSdkJs.ObjectQueriesApi* | [**queryBillingRuns**](docs/ObjectQueriesApi.md#queryBillingRuns) | **GET** /object-query/billing-runs | 
 *ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentByKey**](docs/ObjectQueriesApi.md#queryCommitmentByKey) | **GET** /object-query/commitment/{key} | 
-*ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentSegmentByKey**](docs/ObjectQueriesApi.md#queryCommitmentSegmentByKey) | **GET** /object-query/commitmentSegment/{key} | 
-*ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentSegments**](docs/ObjectQueriesApi.md#queryCommitmentSegments) | **GET** /object-query/commitmentSegment | 
+*ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentCycleByKey**](docs/ObjectQueriesApi.md#queryCommitmentCycleByKey) | **GET** /object-query/commitment-cycle/{key} | 
+*ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentCycles**](docs/ObjectQueriesApi.md#queryCommitmentCycles) | **GET** /object-query/commitment-cycle | 
+*ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentSegmentByKey**](docs/ObjectQueriesApi.md#queryCommitmentSegmentByKey) | **GET** /object-query/commitment-segment/{key} | 
+*ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitmentSegments**](docs/ObjectQueriesApi.md#queryCommitmentSegments) | **GET** /object-query/commitment-segment | 
 *ZuoraSdkJs.ObjectQueriesApi* | [**queryCommitments**](docs/ObjectQueriesApi.md#queryCommitments) | **GET** /object-query/commitment | 
 *ZuoraSdkJs.ObjectQueriesApi* | [**queryContactByKey**](docs/ObjectQueriesApi.md#queryContactByKey) | **GET** /object-query/contacts/{key} | 
 *ZuoraSdkJs.ObjectQueriesApi* | [**queryContactSnapshotByKey**](docs/ObjectQueriesApi.md#queryContactSnapshotByKey) | **GET** /object-query/contact-snapshots/{key} | 
@@ -753,6 +755,7 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.AccountingCodeItemResponse](docs/AccountingCodeItemResponse.md)
  - [ZuoraSdkJs.AccountingCodeStatus](docs/AccountingCodeStatus.md)
  - [ZuoraSdkJs.AccountingCodeType](docs/AccountingCodeType.md)
+ - [ZuoraSdkJs.ActionType](docs/ActionType.md)
  - [ZuoraSdkJs.ActionsErrorResponse](docs/ActionsErrorResponse.md)
  - [ZuoraSdkJs.AddSubscriptionComponent](docs/AddSubscriptionComponent.md)
  - [ZuoraSdkJs.AddSubscriptionRatePlan](docs/AddSubscriptionRatePlan.md)
@@ -768,6 +771,7 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.ApplyPaymentInvoiceApplication](docs/ApplyPaymentInvoiceApplication.md)
  - [ZuoraSdkJs.ApplyPaymentInvoiceApplicationItem](docs/ApplyPaymentInvoiceApplicationItem.md)
  - [ZuoraSdkJs.ApplyPaymentRequest](docs/ApplyPaymentRequest.md)
+ - [ZuoraSdkJs.AssociationRule](docs/AssociationRule.md)
  - [ZuoraSdkJs.AsyncApplyCreditMemoRequest](docs/AsyncApplyCreditMemoRequest.md)
  - [ZuoraSdkJs.AsyncApplyCreditMemoToInvoice](docs/AsyncApplyCreditMemoToInvoice.md)
  - [ZuoraSdkJs.AsyncOperationResponse](docs/AsyncOperationResponse.md)
@@ -896,10 +900,21 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.CollectDebitMemoResponseDebitMemo](docs/CollectDebitMemoResponseDebitMemo.md)
  - [ZuoraSdkJs.CollectDebitMemoResponseProcessedPayment](docs/CollectDebitMemoResponseProcessedPayment.md)
  - [ZuoraSdkJs.CollectDebitMemoResponseProcessedPaymentStatus](docs/CollectDebitMemoResponseProcessedPaymentStatus.md)
+ - [ZuoraSdkJs.CommitmentBaseAttributes](docs/CommitmentBaseAttributes.md)
+ - [ZuoraSdkJs.CommitmentCycleAttributes](docs/CommitmentCycleAttributes.md)
+ - [ZuoraSdkJs.CommitmentInput](docs/CommitmentInput.md)
  - [ZuoraSdkJs.CommitmentLevel](docs/CommitmentLevel.md)
+ - [ZuoraSdkJs.CommitmentOutput](docs/CommitmentOutput.md)
+ - [ZuoraSdkJs.CommitmentOutputSegmentsInner](docs/CommitmentOutputSegmentsInner.md)
+ - [ZuoraSdkJs.CommitmentSegmentAttributes](docs/CommitmentSegmentAttributes.md)
+ - [ZuoraSdkJs.CommitmentSegmentBaseAttributes](docs/CommitmentSegmentBaseAttributes.md)
+ - [ZuoraSdkJs.CommitmentSegmentInput](docs/CommitmentSegmentInput.md)
  - [ZuoraSdkJs.CommitmentType](docs/CommitmentType.md)
+ - [ZuoraSdkJs.CommitmentTypeEnum](docs/CommitmentTypeEnum.md)
  - [ZuoraSdkJs.CommonErrorResponse](docs/CommonErrorResponse.md)
  - [ZuoraSdkJs.CommonResponse](docs/CommonResponse.md)
+ - [ZuoraSdkJs.CommonRevenueAttributes](docs/CommonRevenueAttributes.md)
+ - [ZuoraSdkJs.CommonTaxationAttributes](docs/CommonTaxationAttributes.md)
  - [ZuoraSdkJs.CompareAndDeployProductCatalogTemplateRequest](docs/CompareAndDeployProductCatalogTemplateRequest.md)
  - [ZuoraSdkJs.CompareAndDeployProductCatalogTenantRequest](docs/CompareAndDeployProductCatalogTenantRequest.md)
  - [ZuoraSdkJs.CompareAndDeployTemplateRequest](docs/CompareAndDeployTemplateRequest.md)
@@ -1193,6 +1208,7 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.CustomObjectRecordsThrottledResponse](docs/CustomObjectRecordsThrottledResponse.md)
  - [ZuoraSdkJs.CustomObjectRecordsWithError](docs/CustomObjectRecordsWithError.md)
  - [ZuoraSdkJs.CustomRates](docs/CustomRates.md)
+ - [ZuoraSdkJs.CyclePeriodTypeEnum](docs/CyclePeriodTypeEnum.md)
  - [ZuoraSdkJs.DailyConsumptionRevRecRequest](docs/DailyConsumptionRevRecRequest.md)
  - [ZuoraSdkJs.DataBackfillJobStatus](docs/DataBackfillJobStatus.md)
  - [ZuoraSdkJs.DataQueryErrorResponse](docs/DataQueryErrorResponse.md)
@@ -1269,6 +1285,7 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.ExpandedAmendment](docs/ExpandedAmendment.md)
  - [ZuoraSdkJs.ExpandedBillingRun](docs/ExpandedBillingRun.md)
  - [ZuoraSdkJs.ExpandedCommitment](docs/ExpandedCommitment.md)
+ - [ZuoraSdkJs.ExpandedCommitmentCycle](docs/ExpandedCommitmentCycle.md)
  - [ZuoraSdkJs.ExpandedCommitmentSegment](docs/ExpandedCommitmentSegment.md)
  - [ZuoraSdkJs.ExpandedContact](docs/ExpandedContact.md)
  - [ZuoraSdkJs.ExpandedContactSnapshot](docs/ExpandedContactSnapshot.md)
@@ -1836,6 +1853,7 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.ProductRatePlanStatus](docs/ProductRatePlanStatus.md)
  - [ZuoraSdkJs.ProductRatePlanWithExternalId](docs/ProductRatePlanWithExternalId.md)
  - [ZuoraSdkJs.ProrationOption](docs/ProrationOption.md)
+ - [ZuoraSdkJs.ProrationOptionEnum](docs/ProrationOptionEnum.md)
  - [ZuoraSdkJs.ProxyActioncreateRequest](docs/ProxyActioncreateRequest.md)
  - [ZuoraSdkJs.ProxyActiondeleteRequest](docs/ProxyActiondeleteRequest.md)
  - [ZuoraSdkJs.ProxyActionqueryMoreRequest](docs/ProxyActionqueryMoreRequest.md)
@@ -1876,6 +1894,7 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.QueryAccountsResponse](docs/QueryAccountsResponse.md)
  - [ZuoraSdkJs.QueryAmendmentsResponse](docs/QueryAmendmentsResponse.md)
  - [ZuoraSdkJs.QueryBillingRunsResponse](docs/QueryBillingRunsResponse.md)
+ - [ZuoraSdkJs.QueryCommitmentCyclesResponse](docs/QueryCommitmentCyclesResponse.md)
  - [ZuoraSdkJs.QueryCommitmentSegmentsResponse](docs/QueryCommitmentSegmentsResponse.md)
  - [ZuoraSdkJs.QueryCommitmentsResponse](docs/QueryCommitmentsResponse.md)
  - [ZuoraSdkJs.QueryContactSnapshotsResponse](docs/QueryContactSnapshotsResponse.md)
@@ -2258,6 +2277,13 @@ Class | Method | HTTP request | Description
  - [ZuoraSdkJs.UploadRevenueFileResponseResult](docs/UploadRevenueFileResponseResult.md)
  - [ZuoraSdkJs.UploadUsageFileRequest](docs/UploadUsageFileRequest.md)
  - [ZuoraSdkJs.UploadUsageFileResponse](docs/UploadUsageFileResponse.md)
+ - [ZuoraSdkJs.UpsertCommitmentInput](docs/UpsertCommitmentInput.md)
+ - [ZuoraSdkJs.UpsertCommitmentSegmentInput](docs/UpsertCommitmentSegmentInput.md)
+ - [ZuoraSdkJs.UpsertCreateCommitmentInput](docs/UpsertCreateCommitmentInput.md)
+ - [ZuoraSdkJs.UpsertCreateCommitmentInputAllOfSegments](docs/UpsertCreateCommitmentInputAllOfSegments.md)
+ - [ZuoraSdkJs.UpsertCreateCommitmentSegmentInput](docs/UpsertCreateCommitmentSegmentInput.md)
+ - [ZuoraSdkJs.UpsertUpdateCommitmentInput](docs/UpsertUpdateCommitmentInput.md)
+ - [ZuoraSdkJs.UpsertUpdateCommitmentSegmentInput](docs/UpsertUpdateCommitmentSegmentInput.md)
  - [ZuoraSdkJs.Usage](docs/Usage.md)
  - [ZuoraSdkJs.UsageFlatFeePricingOverride](docs/UsageFlatFeePricingOverride.md)
  - [ZuoraSdkJs.UsageFlatFeePricingUpdate](docs/UsageFlatFeePricingUpdate.md)

package/dist/ZuoraClient.js

@@ -6,13 +6,18 @@ Object.defineProperty(exports, "__esModule", {
 exports["default"] = void 0;
 var _zuora_api = require("./zuora_api");
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _regeneratorValues(e) { if (null != e) { var t = e["function" == typeof Symbol && Symbol.iterator || "@@iterator"], r = 0; if (t) return t.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) return { next: function next() { return e && r >= e.length && (e = void 0), { value: e && e[r++], done: !e }; } }; } throw new TypeError(_typeof(e) + " is not iterable"); }
 function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
-function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { if (r) i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n;else { var o = function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); }; o("next", 0), o("throw", 1), o("return", 2); } }, _regeneratorDefine2(e, r, n, t); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
 function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
 function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
 function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 var baseUrls = {
@@ -31,8 +36,17 @@ var ZuoraClient = /*#__PURE__*/function () {
   function ZuoraClient(_ref) {
     var clientId = _ref.clientId,
       clientSecret = _ref.clientSecret,
-      env = _ref.env;
+      env = _ref.env,
+      _ref$refreshInterval = _ref.refreshInterval,
+      refreshInterval = _ref$refreshInterval === void 0 ? 600000 : _ref$refreshInterval,
+      _ref$maxRetries = _ref.maxRetries,
+      maxRetries = _ref$maxRetries === void 0 ? 3 : _ref$maxRetries,
+      _ref$retryBaseDelay = _ref.retryBaseDelay,
+      retryBaseDelay = _ref$retryBaseDelay === void 0 ? 1000 : _ref$retryBaseDelay,
+      _ref$autoCleanup = _ref.autoCleanup,
+      autoCleanup = _ref$autoCleanup === void 0 ? true : _ref$autoCleanup;
     _classCallCheck(this, ZuoraClient);
+    // 10 minutes default
     this.clientId = clientId;
     this.clientSecret = clientSecret;
     this.env = env;
@@ -42,25 +56,56 @@ var ZuoraClient = /*#__PURE__*/function () {
       access_token: undefined,
       expires_at: Date.now()
     };
+
+    // Auto-auth related properties
+    this.refreshInterval = refreshInterval; // milliseconds
+    this.refreshTimer = null;
+    this.isInitialized = false;
+    this.stopRefresh = false;
+    this._authInProgress = false; // Track auth in progress
+
+    // Retry configuration
+    this.maxRetries = maxRetries;
+    this.retryBaseDelay = retryBaseDelay; // milliseconds
+
+    // Auto-cleanup configuration
+    this.autoCleanup = autoCleanup;
+
+    // Track this instance
+    ZuoraClient.instances.add(this);
+
+    // Set up global event listeners once for all instances
+    if (this.autoCleanup && !ZuoraClient.globalEventListenersSetup) {
+      ZuoraClient._setupGlobalEventListeners();
+      ZuoraClient.globalEventListenersSetup = true;
+    }
   }
   return _createClass(ZuoraClient, [{
     key: "initialize",
     value: function () {
       var _initialize = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
-        var tokenRes;
         return _regenerator().w(function (_context) {
           while (1) switch (_context.n) {
             case 0:
-              _context.n = 1;
-              return this.oAuthApi.createToken(this.clientId, this.clientSecret, "client_credentials", {}).then(function (data) {
-                return data;
-              });
+              if (!this.isInitialized) {
+                _context.n = 1;
+                break;
+              }
+              return _context.a(2);
             case 1:
-              tokenRes = _context.v;
-              this.apiClient.defaultHeaders.Authorization = "Bearer ".concat(tokenRes.access_token);
-              // TODO: set interval to refetch, and reset?
-              this.token.expires_at = Date.now() + (tokenRes.expires_in - 300) * 1000;
+              if (!(!this.clientId || !this.clientSecret || !this.env)) {
+                _context.n = 2;
+                break;
+              }
+              throw new Error('clientId, clientSecret, and env are required');
             case 2:
+              _context.n = 3;
+              return this._auth();
+            case 3:
+              // Start auto-refresh timer
+              this._startRefreshTimer();
+              this.isInitialized = true;
+            case 4:
               return _context.a(2);
           }
         }, _callee, this);
@@ -70,6 +115,294 @@ var ZuoraClient = /*#__PURE__*/function () {
       }
       return initialize;
     }()
+  }, {
+    key: "_auth",
+    value: function () {
+      var _auth2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
+        var _this = this;
+        var maxRetries, baseDelay, _loop, attempt;
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
+            case 0:
+              if (!this._authInProgress) {
+                _context3.n = 1;
+                break;
+              }
+              return _context3.a(2);
+            case 1:
+              this._authInProgress = true;
+              maxRetries = this.maxRetries;
+              baseDelay = this.retryBaseDelay; // milliseconds
+              _loop = /*#__PURE__*/_regenerator().m(function _loop() {
+                var tokenRes, delay, _t;
+                return _regenerator().w(function (_context2) {
+                  while (1) switch (_context2.p = _context2.n) {
+                    case 0:
+                      _context2.p = 0;
+                      _context2.n = 1;
+                      return _this.oAuthApi.createToken(_this.clientId, _this.clientSecret, "client_credentials", {});
+                    case 1:
+                      tokenRes = _context2.v;
+                      // Update token and headers atomically
+                      _this.token.access_token = tokenRes.access_token;
+                      _this.token.expires_at = Date.now() + (tokenRes.expires_in - 300) * 1000; // 5 min buffer
+                      _this.apiClient.defaultHeaders.Authorization = "Bearer ".concat(tokenRes.access_token);
+
+                      // Success - break out of retry loop
+                      return _context2.a(2, 1);
+                    case 2:
+                      _context2.p = 2;
+                      _t = _context2.v;
+                      console.error("Authentication attempt ".concat(attempt, " failed: ").concat(_t.message));
+
+                      // If this is the last attempt, log final failure
+                      if (!(attempt === maxRetries)) {
+                        _context2.n = 3;
+                        break;
+                      }
+                      console.error("All ".concat(maxRetries, " authentication attempts failed. Last error: ").concat(_t.message));
+                      // Don't re-throw - let the application continue with expired token
+                      _context2.n = 4;
+                      break;
+                    case 3:
+                      // Calculate delay with exponential backoff: 1s, 2s, 4s
+                      delay = baseDelay * Math.pow(2, attempt - 1);
+                      console.log("Retrying authentication in ".concat(delay, "ms..."));
+                      _context2.n = 4;
+                      return new Promise(function (resolve) {
+                        return setTimeout(resolve, delay);
+                      });
+                    case 4:
+                      return _context2.a(2);
+                  }
+                }, _loop, null, [[0, 2]]);
+              });
+              attempt = 1;
+            case 2:
+              if (!(attempt <= maxRetries)) {
+                _context3.n = 5;
+                break;
+              }
+              return _context3.d(_regeneratorValues(_loop()), 3);
+            case 3:
+              if (!_context3.v) {
+                _context3.n = 4;
+                break;
+              }
+              return _context3.a(3, 5);
+            case 4:
+              attempt++;
+              _context3.n = 2;
+              break;
+            case 5:
+              this._authInProgress = false;
+            case 6:
+              return _context3.a(2);
+          }
+        }, _callee2, this);
+      }));
+      function _auth() {
+        return _auth2.apply(this, arguments);
+      }
+      return _auth;
+    }()
+  }, {
+    key: "_startRefreshTimer",
+    value: function _startRefreshTimer() {
+      var _this2 = this;
+      if (this.refreshTimer) {
+        clearInterval(this.refreshTimer);
+      }
+      this.stopRefresh = false;
+      this.refreshTimer = setInterval(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+        var _t2;
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.p = _context4.n) {
+            case 0:
+              if (!_this2.stopRefresh) {
+                _context4.n = 1;
+                break;
+              }
+              clearInterval(_this2.refreshTimer);
+              return _context4.a(2);
+            case 1:
+              _context4.p = 1;
+              _context4.n = 2;
+              return _this2._auth();
+            case 2:
+              _context4.n = 4;
+              break;
+            case 3:
+              _context4.p = 3;
+              _t2 = _context4.v;
+              console.error("Error in refresh timer: ".concat(_t2.message));
+              // Continue trying even if there's an error
+            case 4:
+              return _context4.a(2);
+          }
+        }, _callee3, null, [[1, 3]]);
+      })), this.refreshInterval);
+
+      // Store timer reference for cleanup
+      this._refreshTimerId = this.refreshTimer;
+    }
+  }, {
+    key: "stopAutoAuth",
+    value: function stopAutoAuth() {
+      this.stopRefresh = true;
+      if (this.refreshTimer) {
+        clearInterval(this.refreshTimer);
+        this.refreshTimer = null;
+        this._refreshTimerId = null;
+      }
+      this.isInitialized = false;
+    }
+  }, {
+    key: "setRefreshInterval",
+    value: function setRefreshInterval(intervalMs) {
+      if (intervalMs < 60000) {
+        // Minimum 1 minute
+        throw new Error("Refresh interval must be at least 60 seconds");
+      }
+      this.refreshInterval = intervalMs;
+
+      // Restart timer with new interval if already running
+      if (this.isInitialized) {
+        this._startRefreshTimer();
+      }
+    }
+  }, {
+    key: "getRefreshInterval",
+    value: function getRefreshInterval() {
+      return this.refreshInterval;
+    }
+  }, {
+    key: "setRetryConfig",
+    value: function setRetryConfig(maxRetries, retryBaseDelay) {
+      if (maxRetries < 1 || maxRetries > 10) {
+        throw new Error("maxRetries must be between 1 and 10");
+      }
+      if (retryBaseDelay < 100 || retryBaseDelay > 30000) {
+        throw new Error("retryBaseDelay must be between 100ms and 30s");
+      }
+      this.maxRetries = maxRetries;
+      this.retryBaseDelay = retryBaseDelay;
+    }
+  }, {
+    key: "getRetryConfig",
+    value: function getRetryConfig() {
+      return {
+        maxRetries: this.maxRetries,
+        retryBaseDelay: this.retryBaseDelay
+      };
+    }
+  }, {
+    key: "isTokenExpired",
+    value: function isTokenExpired() {
+      return Date.now() >= this.token.expires_at;
+    }
+  }, {
+    key: "refreshToken",
+    value: function () {
+      var _refreshToken = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
+            case 0:
+              _context5.n = 1;
+              return this._auth();
+            case 1:
+              return _context5.a(2);
+          }
+        }, _callee4, this);
+      }));
+      function refreshToken() {
+        return _refreshToken.apply(this, arguments);
+      }
+      return refreshToken;
+    }()
+  }, {
+    key: "getTokenInfo",
+    value: function getTokenInfo() {
+      return {
+        access_token: this.token.access_token ? "".concat(this.token.access_token.substring(0, 8), "...") : undefined,
+        expires_at: new Date(this.token.expires_at),
+        is_expired: this.isTokenExpired(),
+        refresh_interval: this.refreshInterval / 1000,
+        // Convert to seconds
+        auto_auth_active: this.isInitialized && !this.stopRefresh,
+        auto_cleanup_enabled: this.autoCleanup,
+        retry_config: this.getRetryConfig()
+      };
+    }
+  }, {
+    key: "isAutoAuthActive",
+    value: function isAutoAuthActive() {
+      return this.isInitialized && !this.stopRefresh;
+    }
+  }, {
+    key: "isAutoCleanupEnabled",
+    value: function isAutoCleanupEnabled() {
+      return this.autoCleanup;
+    }
+  }, {
+    key: "hasActiveTimers",
+    value: function hasActiveTimers() {
+      return this.refreshTimer !== null || this._refreshTimerId !== null;
+    }
+  }, {
+    key: "forceCleanup",
+    value: function forceCleanup() {
+      // Force cleanup all timers and resources
+      this.stopRefresh = true;
+      if (this.refreshTimer) {
+        clearInterval(this.refreshTimer);
+        this.refreshTimer = null;
+      }
+      if (this._refreshTimerId) {
+        clearInterval(this._refreshTimerId);
+        this._refreshTimerId = null;
+      }
+      this.isInitialized = false;
+      this._authInProgress = false;
+      console.log('ZuoraClient: All timers and resources cleaned up');
+    }
+  }, {
+    key: "isReady",
+    value: function isReady() {
+      return this.isInitialized && this.token.access_token && !this.isTokenExpired() && !this.stopRefresh;
+    }
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      this.stopAutoAuth();
+
+      // Clear any other resources if needed
+      this._authInProgress = false;
+      this.token = {
+        access_token: undefined,
+        expires_at: Date.now()
+      };
+
+      // Remove from tracking
+      ZuoraClient.instances["delete"](this);
+    }
+
+    // Static method to cleanup all client instances
+  }, {
+    key: "setAutoCleanup",
+    value:
+    // Instance method to enable/disable auto-cleanup
+    function setAutoCleanup(enabled) {
+      this.autoCleanup = enabled;
+
+      // Global event listeners are managed at class level
+      if (enabled && !ZuoraClient.globalEventListenersSetup) {
+        ZuoraClient._setupGlobalEventListeners();
+        ZuoraClient.globalEventListenersSetup = true;
+      }
+    }
+
+    // Static method to get count of active instances
   }, {
     key: "debug",
     value: function debug(enable) {
@@ -480,6 +813,94 @@ var ZuoraClient = /*#__PURE__*/function () {
     get: function get() {
       return new _zuora_api.WorkflowsApi(this.apiClient);
     }
+  }], [{
+    key: "cleanupAll",
+    value: function cleanupAll() {
+      console.log("Cleaning up ".concat(ZuoraClient.instances.size, " ZuoraClient instances..."));
+      var _iterator = _createForOfIteratorHelper(ZuoraClient.instances),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var client = _step.value;
+          client.forceCleanup();
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      ZuoraClient.instances.clear();
+      console.log('All ZuoraClient instances cleaned up');
+    }
+
+    // Static method to enable/disable auto-cleanup for all instances
+  }, {
+    key: "setAutoCleanup",
+    value: function setAutoCleanup(enabled) {
+      var _iterator2 = _createForOfIteratorHelper(ZuoraClient.instances),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var client = _step2.value;
+          client.setAutoCleanup(enabled);
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+  }, {
+    key: "getActiveInstanceCount",
+    value: function getActiveInstanceCount() {
+      return ZuoraClient.instances.size;
+    }
+
+    // Static method to set up global event listeners (called once for all instances)
+  }, {
+    key: "_setupGlobalEventListeners",
+    value: function _setupGlobalEventListeners() {
+      // Global cleanup handler that cleans up ALL instances
+      var globalCleanupHandler = function globalCleanupHandler() {
+        console.log('ZuoraClient: Global auto-cleanup triggered for all instances');
+        ZuoraClient.cleanupAll();
+      };
+
+      // Set up process event listeners (Node.js environment)
+      if (typeof process !== 'undefined' && process.on) {
+        // Handle normal exit
+        process.on('exit', globalCleanupHandler);
+
+        // Handle graceful shutdown signals
+        process.on('SIGINT', globalCleanupHandler);
+        process.on('SIGTERM', globalCleanupHandler);
+        process.on('SIGUSR1', globalCleanupHandler);
+        process.on('SIGUSR2', globalCleanupHandler);
+
+        // Handle uncaught exceptions
+        process.on('uncaughtException', function (error) {
+          console.error('ZuoraClient: Uncaught exception, cleaning up all instances...', error);
+          globalCleanupHandler();
+        });
+
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', function (reason, promise) {
+          console.error('ZuoraClient: Unhandled promise rejection, cleaning up all instances...', reason);
+          globalCleanupHandler();
+        });
+      }
+
+      // Set up window event listeners (browser environment)
+      if (typeof window !== 'undefined' && window.addEventListener) {
+        window.addEventListener('beforeunload', globalCleanupHandler);
+        window.addEventListener('pagehide', globalCleanupHandler);
+      }
+      console.log('ZuoraClient: Global auto-cleanup event listeners registered');
+    }
   }]);
 }();
+// Static property to track all client instances
+_defineProperty(ZuoraClient, "instances", new Set());
+// Static flag to ensure global event listeners are set up only once
+_defineProperty(ZuoraClient, "globalEventListenersSetup", false);
 var _default = exports["default"] = ZuoraClient;

package/dist/zuora_api/ApiClient.js

@@ -16,7 +16,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * Zuora API Reference
  * REST API reference for the Zuora Billing, Payments, and Central Platform! Check out the [REST API Overview](https://www.zuora.com/developer/api-references/api/overview/).
  *
- * The version of the OpenAPI document: 2024-05-20
+ * The version of the OpenAPI document: 2025-08-12
  * Contact: docs@zuora.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -26,7 +26,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  */
 /**
 * @module ApiClient
-* @version 3.8.0-beta.1
+* @version 3.9.0-beta.1
 */
 /**
 * Manages low level client-server communications, parameter marshalling, etc. There should not be any need for an
@@ -67,8 +67,8 @@ var ApiClient = /*#__PURE__*/function () {
      * @default {}
      */
     this.defaultHeaders = {
-      'User-Agent': 'zuora-js-sdk/3.8.0-beta.1',
-      'Zuora-Version': '2024-05-20'
+      'User-Agent': 'zuora-js-sdk/3.9.0-beta.1',
+      'Zuora-Version': '2025-08-12'
     };
 
     /**

package/dist/zuora_api/api/APIHealthApi.js

@@ -19,7 +19,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * Zuora API Reference
  * REST API reference for the Zuora Billing, Payments, and Central Platform! Check out the [REST API Overview](https://www.zuora.com/developer/api-references/api/overview/).
  *
- * The version of the OpenAPI document: 2024-05-20
+ * The version of the OpenAPI document: 2025-08-12
  * Contact: docs@zuora.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -30,7 +30,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 /**
 * APIHealth service.
 * @module api/APIHealthApi
-* @version 3.8.0-beta.1
+* @version 3.9.0-beta.1
 */
 var APIHealthApi = exports["default"] = /*#__PURE__*/function () {
   /**