orb-billing 1.19.2 → 1.20.0

package/dist/sdk/credit.js

@@ -103,18 +103,110 @@ var Credit = /** @class */ (function () {
     }
     /**
      * Create ledger entry by external ID
+     *
+     * @remarks
+     * This endpoint allows you to create a new ledger entry for a specified customer's balance. This can be used to
+     * increment balance, deduct credits, and change the expiry date of existing credits.
+     *
+     * ## Effects of adding a ledger entry
+     * 1. After calling this endpoint, [Fetch Credit Balance](fetch-customer-credits) will return a credit block that
+     *   represents the changes (i.e. balance changes or transfers).
+     * 2. A ledger entry will be added to the credits ledger for this customer, and therefore returned in the
+     *   [View Credits Ledger](fetch-customer-credits) response as well as serialized in the response to this request. In
+     *   the case of deductions without a specified block, multiple ledger entries may be created if the deduction spans
+     *   credit blocks.
+     * 3. If `invoice_settings` is specified, an invoice will be created that reflects the cost of the credits (based on
+     *   `amount` and `per_unit_cost_basis`).
+     *
+     * ## Adding credits
+     *   Adding credits is done by creating an entry of type `increment`. This requires the caller to specify a number of
+     *   credits as well as an optional expiry date in `YYYY-MM-DD` format. Orb also recommends specifying a description
+     *   to assist with auditing. When adding credits, the caller can also specify a cost basis per-credit, to indicate
+     *   how much in USD a customer paid for a single credit in a block. This can later be used for revenue recognition.
+     *
+     * The following snippet illustrates a sample request body to increment credits which will expire in January of 2022.
+     *
+     * ```json
+     * {
+     *   "entry_type": "increment",
+     *   "amount": 100,
+     *   "expiry_date": "2022-12-28",
+     *   "per_unit_cost_basis": "0.20",
+     *   "description": "Purchased 100 credits"
+     * }
+     * ```
+     *
+     * Note that by default, Orb will always first increment any _negative_ balance in existing blocks before adding the
+     * remaining amount to the desired credit block.
+     *
+     * ### Invoicing for credits
+     * By default, Orb manipulates the credit ledger but does not charge for credits. However, if you pass
+     * `invoice_settings` in the body of this request, Orb will also generate a one-off invoice for the customer for the
+     * credits pre-purchase. Note that you _must_ provide the `per_unit_cost_basis`, since the total charges on the
+     * invoice are calculated by multiplying the cost basis with the number of credit units added.
+     *
+     * ## Deducting Credits
+     * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. Orb matches the
+     * algorithm for automatic deductions for determining which credit blocks to decrement from. In the case that the
+     * deduction leads to multiple ledger entries, the response from this endpoint will be the final deduction. Orb also
+     * optionally allows specifying a description to assist with auditing.
+     *
+     * The following snippet illustrates a sample request body to decrement credits.
+     *
+     * ```json
+     * {
+     *   "entry_type": "decrement",
+     *   "amount": 20,
+     *   "description": "Removing excess credits"
+     * }
+     * ```
+     *
+     * ## Changing credits expiry
+     * If you'd like to change when existing credits expire, you should create a ledger entry of type `expiration_change`.
+     * For this entry, the required parameter `expiry_date` identifies the _originating_ block, and the required parameter
+     * `target_expiry_date` identifies when the transferred credits should now expire. A new credit block will be created
+     * with expiry date `target_expiry_date`, with the same cost basis data as the original credit block, if present.
+     *
+     * Note that the balance of the block with the given `expiry_date` must be at least equal to the desired transfer
+     * amount determined by the `amount` parameter.
+     *
+     * The following snippet illustrates a sample request body to extend the expiration date of credits by one year:
+     *
+     * ```json
+     * {
+     *   "entry_type": "expiration_change",
+     *   "amount": 10,
+     *   "expiry_date": "2022-12-28",
+     *   "block_id": "UiUhFWeLHPrBY4Ad",
+     *   "target_expiry_date": "2023-12-28",
+     *   "description": "Extending credit validity"
+     * }
+     * ```
+     *
+     * ## Voiding credits
+     *
+     * If you'd like to void a credit block, create a ledger entry of type `void`. For this entry, `block_id` is required
+     * to identify the block, and `amount` indicates how many credits to void, up to the block's initial balance. Pass
+     * in a `void_reason` of `refund` if the void is due to a refund.
+     *
+     * ## Amendment
+     *
+     * If you'd like to undo a decrement on a credit block, create a ledger entry of type `amendment`. For this entry, `block_id`
+     * is required to identify the block that was originally decremented from, and `amount` indicates how many credits to return
+     * to the customer, up to the block's initial balance.
      */
-    Credit.prototype.addByExternalId = function (req, config) {
+    Credit.prototype.addByExternalId = function (externalCustomerId, requestBody, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.CreateLedgerEntryExternalIdRequest(req);
-                        }
+                        req = new operations.CreateLedgerEntryExternalIdRequest({
+                            externalCustomerId: externalCustomerId,
+                            requestBody: requestBody,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/external_customer_id/{external_customer_id}/credits/ledger_entry", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];
@@ -227,18 +319,110 @@ var Credit = /** @class */ (function () {
     };
     /**
      * Create ledger entry
+     *
+     * @remarks
+     * This endpoint allows you to create a new ledger entry for a specified customer's balance. This can be used to
+     * increment balance, deduct credits, and change the expiry date of existing credits.
+     *
+     * ## Effects of adding a ledger entry
+     * 1. After calling this endpoint, [Fetch Credit Balance](fetch-customer-credits) will return a credit block that
+     *   represents the changes (i.e. balance changes or transfers).
+     * 2. A ledger entry will be added to the credits ledger for this customer, and therefore returned in the
+     *   [View Credits Ledger](fetch-customer-credits) response as well as serialized in the response to this request. In
+     *   the case of deductions without a specified block, multiple ledger entries may be created if the deduction spans
+     *   credit blocks.
+     * 3. If `invoice_settings` is specified, an invoice will be created that reflects the cost of the credits (based on
+     *   `amount` and `per_unit_cost_basis`).
+     *
+     * ## Adding credits
+     *   Adding credits is done by creating an entry of type `increment`. This requires the caller to specify a number of
+     *   credits as well as an optional expiry date in `YYYY-MM-DD` format. Orb also recommends specifying a description
+     *   to assist with auditing. When adding credits, the caller can also specify a cost basis per-credit, to indicate
+     *   how much in USD a customer paid for a single credit in a block. This can later be used for revenue recognition.
+     *
+     * The following snippet illustrates a sample request body to increment credits which will expire in January of 2022.
+     *
+     * ```json
+     * {
+     *   "entry_type": "increment",
+     *   "amount": 100,
+     *   "expiry_date": "2022-12-28",
+     *   "per_unit_cost_basis": "0.20",
+     *   "description": "Purchased 100 credits"
+     * }
+     * ```
+     *
+     * Note that by default, Orb will always first increment any _negative_ balance in existing blocks before adding the
+     * remaining amount to the desired credit block.
+     *
+     * ### Invoicing for credits
+     * By default, Orb manipulates the credit ledger but does not charge for credits. However, if you pass
+     * `invoice_settings` in the body of this request, Orb will also generate a one-off invoice for the customer for the
+     * credits pre-purchase. Note that you _must_ provide the `per_unit_cost_basis`, since the total charges on the
+     * invoice are calculated by multiplying the cost basis with the number of credit units added.
+     *
+     * ## Deducting Credits
+     * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. Orb matches the
+     * algorithm for automatic deductions for determining which credit blocks to decrement from. In the case that the
+     * deduction leads to multiple ledger entries, the response from this endpoint will be the final deduction. Orb also
+     * optionally allows specifying a description to assist with auditing.
+     *
+     * The following snippet illustrates a sample request body to decrement credits.
+     *
+     * ```json
+     * {
+     *   "entry_type": "decrement",
+     *   "amount": 20,
+     *   "description": "Removing excess credits"
+     * }
+     * ```
+     *
+     * ## Changing credits expiry
+     * If you'd like to change when existing credits expire, you should create a ledger entry of type `expiration_change`.
+     * For this entry, the required parameter `expiry_date` identifies the _originating_ block, and the required parameter
+     * `target_expiry_date` identifies when the transferred credits should now expire. A new credit block will be created
+     * with expiry date `target_expiry_date`, with the same cost basis data as the original credit block, if present.
+     *
+     * Note that the balance of the block with the given `expiry_date` must be at least equal to the desired transfer
+     * amount determined by the `amount` parameter.
+     *
+     * The following snippet illustrates a sample request body to extend the expiration date of credits by one year:
+     *
+     * ```json
+     * {
+     *   "entry_type": "expiration_change",
+     *   "amount": 10,
+     *   "expiry_date": "2022-12-28",
+     *   "block_id": "UiUhFWeLHPrBY4Ad",
+     *   "target_expiry_date": "2023-12-28",
+     *   "description": "Extending credit validity"
+     * }
+     * ```
+     *
+     * ## Voiding credits
+     *
+     * If you'd like to void a credit block, create a ledger entry of type `void`. For this entry, `block_id` is required
+     * to identify the block, and `amount` indicates how many credits to void, up to the block's initial balance. Pass
+     * in a `void_reason` of `refund` if the void is due to a refund.
+     *
+     * ## Amendment
+     *
+     * If you'd like to undo a decrement on a credit block, create a ledger entry of type `amendment`. For this entry, `block_id`
+     * is required to identify the block that was originally decremented from, and `amount` indicates how many credits to return
+     * to the customer, up to the block's initial balance.
      */
-    Credit.prototype.create = function (req, config) {
+    Credit.prototype.create = function (customerId, requestBody, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.CreateLedgerEntryRequest(req);
-                        }
+                        req = new operations.CreateLedgerEntryRequest({
+                            customerId: customerId,
+                            requestBody: requestBody,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}/credits/ledger_entry", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];
@@ -355,16 +539,18 @@ var Credit = /** @class */ (function () {
      * @remarks
      * Returns a paginated list of unexpired, non-zero credit blocks for a customer.
      */
-    Credit.prototype.fetchBalance = function (req, config) {
+    Credit.prototype.fetchBalance = function (customerId, cursor, limit, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.FetchCustomerCreditsRequest(req);
-                        }
+                        req = new operations.FetchCustomerCreditsRequest({
+                            customerId: customerId,
+                            cursor: cursor,
+                            limit: limit,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}/credits", req);
                         client = this.sdkConfiguration.defaultClient;
@@ -473,16 +659,18 @@ var Credit = /** @class */ (function () {
      * @remarks
      * Returns a paginated list of unexpired, non-zero credit blocks for a customer.
      */
-    Credit.prototype.fetchBalanceByExternalId = function (req, config) {
+    Credit.prototype.fetchBalanceByExternalId = function (externalCustomerId, cursor, limit, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.FetchCustomerCreditsExternalIdRequest(req);
-                        }
+                        req = new operations.FetchCustomerCreditsExternalIdRequest({
+                            externalCustomerId: externalCustomerId,
+                            cursor: cursor,
+                            limit: limit,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/external_customer_id/{external_customer_id}/credits", req);
                         client = this.sdkConfiguration.defaultClient;

package/dist/sdk/creditnote.d.ts

@@ -16,7 +16,7 @@ export declare class CreditNote {
      * @remarks
      * This endpoint is used to fetch a single [`Credit Note`](../guides/invoicing/credit-notes) given an identifier.
      */
-    fetch(req: operations.FetchCreditNoteRequest, config?: AxiosRequestConfig): Promise<operations.FetchCreditNoteResponse>;
+    fetch(creditNoteId: string, config?: AxiosRequestConfig): Promise<operations.FetchCreditNoteResponse>;
     /**
      * List credit notes
      *
@@ -25,5 +25,5 @@ export declare class CreditNote {
      * customer_id, subscription_id, or external_customer_id. The credit notes will be returned
      * in reverse chronological order by `creation_time`.
      */
-    list(req: operations.ListCreditNotesRequest, config?: AxiosRequestConfig): Promise<operations.ListCreditNotesResponse>;
+    list(cursor?: string, limit?: number, config?: AxiosRequestConfig): Promise<operations.ListCreditNotesResponse>;
 }

package/dist/sdk/creditnote.js

@@ -94,16 +94,16 @@ var CreditNote = /** @class */ (function () {
      * @remarks
      * This endpoint is used to fetch a single [`Credit Note`](../guides/invoicing/credit-notes) given an identifier.
      */
-    CreditNote.prototype.fetch = function (req, config) {
+    CreditNote.prototype.fetch = function (creditNoteId, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.FetchCreditNoteRequest(req);
-                        }
+                        req = new operations.FetchCreditNoteRequest({
+                            creditNoteId: creditNoteId,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/credit_notes/{credit_note_id}", req);
                         client = this.sdkConfiguration.defaultClient;
@@ -213,16 +213,17 @@ var CreditNote = /** @class */ (function () {
      * customer_id, subscription_id, or external_customer_id. The credit notes will be returned
      * in reverse chronological order by `creation_time`.
      */
-    CreditNote.prototype.list = function (req, config) {
+    CreditNote.prototype.list = function (cursor, limit, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.ListCreditNotesRequest(req);
-                        }
+                        req = new operations.ListCreditNotesRequest({
+                            cursor: cursor,
+                            limit: limit,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = baseURL.replace(/\/$/, "") + "/credit_notes";
                         client = this.sdkConfiguration.defaultClient;

package/dist/sdk/customer.d.ts

@@ -104,7 +104,7 @@ export declare class Customer {
      * In order to overwrite timeframes with a very large number of events, we suggest using multiple calls with small adjacent
      * (e.g. every hour) timeframes.
      */
-    amend(req: operations.AmendUsageRequest, config?: AxiosRequestConfig): Promise<operations.AmendUsageResponse>;
+    amend(customerId: string, updateEvent?: shared.UpdateEvent, timeframeEnd?: Date, timeframeStart?: Date, config?: AxiosRequestConfig): Promise<operations.AmendUsageResponse>;
     /**
      * Amend usage by external ID
      *
@@ -186,7 +186,7 @@ export declare class Customer {
      * In order to overwrite timeframes with a very large number of events, we suggest using multiple calls with small adjacent
      * (e.g. every hour) timeframes.
      */
-    amendByExternalId(req: operations.AmendUsageExternalCustomerIdRequest, config?: AxiosRequestConfig): Promise<operations.AmendUsageExternalCustomerIdResponse>;
+    amendByExternalId(externalCustomerId: string, updateEvent?: shared.UpdateEvent, timeframeEnd?: Date, timeframeStart?: Date, config?: AxiosRequestConfig): Promise<operations.AmendUsageExternalCustomerIdResponse>;
     /**
      * Create customer
      *
@@ -210,7 +210,7 @@ export declare class Customer {
      * Creates an immutable balance transaction that updates the customer's balance and returns back the newly created
      * transaction.
      */
-    createBalanceTransaction(req: operations.CreateCustomerBalanceTransactionRequest, config?: AxiosRequestConfig): Promise<operations.CreateCustomerBalanceTransactionResponse>;
+    createBalanceTransaction(customerId: string, newCustomerBalanceTransaction?: shared.NewCustomerBalanceTransaction, config?: AxiosRequestConfig): Promise<operations.CreateCustomerBalanceTransactionResponse>;
     /**
      * Delete customer
      *
@@ -229,7 +229,7 @@ export declare class Customer {
      *
      * On successful processing, this returns an empty dictionary (`{}`) in the API.
      */
-    delete(req: operations.DeleteCustomerRequest, config?: AxiosRequestConfig): Promise<operations.DeleteCustomerResponse>;
+    delete(customerId: string, config?: AxiosRequestConfig): Promise<operations.DeleteCustomerResponse>;
     /**
      * Fetch customer
      *
@@ -239,7 +239,7 @@ export declare class Customer {
      *
      * See the [Customer resource](../guides/core-concepts.mdx#customer) for a full discussion of the Customer model.
      */
-    fetch(req: operations.FetchCustomerRequest, config?: AxiosRequestConfig): Promise<operations.FetchCustomerResponse>;
+    fetch(customerId: string, config?: AxiosRequestConfig): Promise<operations.FetchCustomerResponse>;
     /**
      * Fetch customer by external ID
      *
@@ -249,7 +249,7 @@ export declare class Customer {
      *
      * Note that the resource and semantics of this endpoint exactly mirror [Get Customer](fetch-customer).
      */
-    fetchByExternalId(req: operations.FetchCustomerExternalIdRequest, config?: AxiosRequestConfig): Promise<operations.FetchCustomerExternalIdResponse>;
+    fetchByExternalId(externalCustomerId: string, config?: AxiosRequestConfig): Promise<operations.FetchCustomerExternalIdResponse>;
     /**
      * Fetch customer costs
      *
@@ -516,7 +516,7 @@ export declare class Customer {
      * Note that the resource and semantics of this
      * endpoint exactly mirror [Update Customer](update-customer).
      */
-    updateByExternalId(req: operations.UpdateCustomerExternalIdRequest, config?: AxiosRequestConfig): Promise<operations.UpdateCustomerExternalIdResponse>;
+    updateByExternalId(externalCustomerId: string, editCustomer?: shared.EditCustomer, config?: AxiosRequestConfig): Promise<operations.UpdateCustomerExternalIdResponse>;
     /**
      * Update customer
      *
@@ -525,5 +525,5 @@ export declare class Customer {
      * `auto_collection`, `metadata`, `shipping_address`, `billing_address`, and `additional_emails` of an existing customer.
      * "Other fields on a customer are currently immutable.
      */
-    updateCustomer(req: operations.UpdateCustomerRequest, config?: AxiosRequestConfig): Promise<operations.UpdateCustomerResponse>;
+    updateCustomer(customerId: string, editCustomer?: shared.EditCustomer, config?: AxiosRequestConfig): Promise<operations.UpdateCustomerResponse>;
 }

package/dist/sdk/customer.js

@@ -197,17 +197,20 @@ var Customer = /** @class */ (function () {
      * In order to overwrite timeframes with a very large number of events, we suggest using multiple calls with small adjacent
      * (e.g. every hour) timeframes.
      */
-    Customer.prototype.amend = function (req, config) {
+    Customer.prototype.amend = function (customerId, updateEvent, timeframeEnd, timeframeStart, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.AmendUsageRequest(req);
-                        }
+                        req = new operations.AmendUsageRequest({
+                            customerId: customerId,
+                            updateEvent: updateEvent,
+                            timeframeEnd: timeframeEnd,
+                            timeframeStart: timeframeStart,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}/usage", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];
@@ -400,17 +403,20 @@ var Customer = /** @class */ (function () {
      * In order to overwrite timeframes with a very large number of events, we suggest using multiple calls with small adjacent
      * (e.g. every hour) timeframes.
      */
-    Customer.prototype.amendByExternalId = function (req, config) {
+    Customer.prototype.amendByExternalId = function (externalCustomerId, updateEvent, timeframeEnd, timeframeStart, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, queryParams, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.AmendUsageExternalCustomerIdRequest(req);
-                        }
+                        req = new operations.AmendUsageExternalCustomerIdRequest({
+                            externalCustomerId: externalCustomerId,
+                            updateEvent: updateEvent,
+                            timeframeEnd: timeframeEnd,
+                            timeframeStart: timeframeStart,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/external_customer_id/{external_customer_id}/usage", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];
@@ -665,17 +671,18 @@ var Customer = /** @class */ (function () {
      * Creates an immutable balance transaction that updates the customer's balance and returns back the newly created
      * transaction.
      */
-    Customer.prototype.createBalanceTransaction = function (req, config) {
+    Customer.prototype.createBalanceTransaction = function (customerId, newCustomerBalanceTransaction, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.CreateCustomerBalanceTransactionRequest(req);
-                        }
+                        req = new operations.CreateCustomerBalanceTransactionRequest({
+                            customerId: customerId,
+                            newCustomerBalanceTransaction: newCustomerBalanceTransaction,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}/balance_transactions", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];
@@ -804,16 +811,16 @@ var Customer = /** @class */ (function () {
      *
      * On successful processing, this returns an empty dictionary (`{}`) in the API.
      */
-    Customer.prototype.delete = function (req, config) {
+    Customer.prototype.delete = function (customerId, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.DeleteCustomerRequest(req);
-                        }
+                        req = new operations.DeleteCustomerRequest({
+                            customerId: customerId,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}", req);
                         client = this.sdkConfiguration.defaultClient;
@@ -924,16 +931,16 @@ var Customer = /** @class */ (function () {
      *
      * See the [Customer resource](../guides/core-concepts.mdx#customer) for a full discussion of the Customer model.
      */
-    Customer.prototype.fetch = function (req, config) {
+    Customer.prototype.fetch = function (customerId, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.FetchCustomerRequest(req);
-                        }
+                        req = new operations.FetchCustomerRequest({
+                            customerId: customerId,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}", req);
                         client = this.sdkConfiguration.defaultClient;
@@ -1044,16 +1051,16 @@ var Customer = /** @class */ (function () {
      *
      * Note that the resource and semantics of this endpoint exactly mirror [Get Customer](fetch-customer).
      */
-    Customer.prototype.fetchByExternalId = function (req, config) {
+    Customer.prototype.fetchByExternalId = function (externalCustomerId, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.FetchCustomerExternalIdRequest(req);
-                        }
+                        req = new operations.FetchCustomerExternalIdRequest({
+                            externalCustomerId: externalCustomerId,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/external_customer_id/{external_customer_id}", req);
                         client = this.sdkConfiguration.defaultClient;
@@ -1865,17 +1872,18 @@ var Customer = /** @class */ (function () {
      * Note that the resource and semantics of this
      * endpoint exactly mirror [Update Customer](update-customer).
      */
-    Customer.prototype.updateByExternalId = function (req, config) {
+    Customer.prototype.updateByExternalId = function (externalCustomerId, editCustomer, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.UpdateCustomerExternalIdRequest(req);
-                        }
+                        req = new operations.UpdateCustomerExternalIdRequest({
+                            externalCustomerId: externalCustomerId,
+                            editCustomer: editCustomer,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/external_customer_id/{external_customer_id}", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];
@@ -1994,17 +2002,18 @@ var Customer = /** @class */ (function () {
      * `auto_collection`, `metadata`, `shipping_address`, `billing_address`, and `additional_emails` of an existing customer.
      * "Other fields on a customer are currently immutable.
      */
-    Customer.prototype.updateCustomer = function (req, config) {
+    Customer.prototype.updateCustomer = function (customerId, editCustomer, config) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
+            var req, baseURL, url, _c, reqBodyHeaders, reqBody, client, globalSecurity, properties, headers, httpRes, contentType, res, decodedRes;
             var _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        if (!(req instanceof utils.SpeakeasyBase)) {
-                            req = new operations.UpdateCustomerRequest(req);
-                        }
+                        req = new operations.UpdateCustomerRequest({
+                            customerId: customerId,
+                            editCustomer: editCustomer,
+                        });
                         baseURL = utils.templateUrl(this.sdkConfiguration.serverURL, this.sdkConfiguration.serverDefaults);
                         url = utils.generateURL(baseURL, "/customers/{customer_id}", req);
                         _c = __read([{}, null], 2), reqBodyHeaders = _c[0], reqBody = _c[1];