@paid-ai/paid-node 1.2.1 → 1.5.0

package/dist/cjs/Client.d.ts

@@ -1,13 +1,16 @@
 import { Checkouts } from "./api/resources/checkouts/client/Client.js";
 import { Contacts } from "./api/resources/contacts/client/Client.js";
+import { Cost } from "./api/resources/cost/client/Client.js";
 import { Credits } from "./api/resources/credits/client/Client.js";
 import { CustomerPortals } from "./api/resources/customerPortals/client/Client.js";
 import { Customers } from "./api/resources/customers/client/Client.js";
 import { Invoices } from "./api/resources/invoices/client/Client.js";
 import { Orders } from "./api/resources/orders/client/Client.js";
+import { Pricing } from "./api/resources/pricing/client/Client.js";
 import { Products } from "./api/resources/products/client/Client.js";
 import { Signals } from "./api/resources/signals/client/Client.js";
 import { ValueReceipts } from "./api/resources/valueReceipts/client/Client.js";
+import { Webhooks } from "./api/resources/webhooks/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 export declare namespace PaidClient {
     interface Options extends BaseClientOptions {
@@ -27,6 +30,9 @@ export declare class PaidClient {
     protected _checkouts: Checkouts | undefined;
     protected _customerPortals: CustomerPortals | undefined;
     protected _valueReceipts: ValueReceipts | undefined;
+    protected _webhooks: Webhooks | undefined;
+    protected _pricing: Pricing | undefined;
+    protected _cost: Cost | undefined;
     constructor(_options: PaidClient.Options);
     get products(): Products;
     get customers(): Customers;
@@ -38,4 +44,7 @@ export declare class PaidClient {
     get checkouts(): Checkouts;
     get customerPortals(): CustomerPortals;
     get valueReceipts(): ValueReceipts;
+    get webhooks(): Webhooks;
+    get pricing(): Pricing;
+    get cost(): Cost;
 }

package/dist/cjs/Client.js

@@ -37,14 +37,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaidClient = void 0;
 const Client_js_1 = require("./api/resources/checkouts/client/Client.js");
 const Client_js_2 = require("./api/resources/contacts/client/Client.js");
-const Client_js_3 = require("./api/resources/credits/client/Client.js");
-const Client_js_4 = require("./api/resources/customerPortals/client/Client.js");
-const Client_js_5 = require("./api/resources/customers/client/Client.js");
-const Client_js_6 = require("./api/resources/invoices/client/Client.js");
-const Client_js_7 = require("./api/resources/orders/client/Client.js");
-const Client_js_8 = require("./api/resources/products/client/Client.js");
-const Client_js_9 = require("./api/resources/signals/client/Client.js");
-const Client_js_10 = require("./api/resources/valueReceipts/client/Client.js");
+const Client_js_3 = require("./api/resources/cost/client/Client.js");
+const Client_js_4 = require("./api/resources/credits/client/Client.js");
+const Client_js_5 = require("./api/resources/customerPortals/client/Client.js");
+const Client_js_6 = require("./api/resources/customers/client/Client.js");
+const Client_js_7 = require("./api/resources/invoices/client/Client.js");
+const Client_js_8 = require("./api/resources/orders/client/Client.js");
+const Client_js_9 = require("./api/resources/pricing/client/Client.js");
+const Client_js_10 = require("./api/resources/products/client/Client.js");
+const Client_js_11 = require("./api/resources/signals/client/Client.js");
+const Client_js_12 = require("./api/resources/valueReceipts/client/Client.js");
+const Client_js_13 = require("./api/resources/webhooks/client/Client.js");
 const headers_js_1 = require("./core/headers.js");
 const core = __importStar(require("./core/index.js"));
 class PaidClient {
@@ -52,19 +55,19 @@ class PaidClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@paid-ai/paid-node",
-                "X-Fern-SDK-Version": "1.2.1",
-                "User-Agent": "@paid-ai/paid-node/1.2.1",
+                "X-Fern-SDK-Version": "1.5.0",
+                "User-Agent": "@paid-ai/paid-node/1.5.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
     }
     get products() {
         var _a;
-        return ((_a = this._products) !== null && _a !== void 0 ? _a : (this._products = new Client_js_8.Products(this._options)));
+        return ((_a = this._products) !== null && _a !== void 0 ? _a : (this._products = new Client_js_10.Products(this._options)));
     }
     get customers() {
         var _a;
-        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_js_5.Customers(this._options)));
+        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_js_6.Customers(this._options)));
     }
     get contacts() {
         var _a;
@@ -72,19 +75,19 @@ class PaidClient {
     }
     get orders() {
         var _a;
-        return ((_a = this._orders) !== null && _a !== void 0 ? _a : (this._orders = new Client_js_7.Orders(this._options)));
+        return ((_a = this._orders) !== null && _a !== void 0 ? _a : (this._orders = new Client_js_8.Orders(this._options)));
     }
     get invoices() {
         var _a;
-        return ((_a = this._invoices) !== null && _a !== void 0 ? _a : (this._invoices = new Client_js_6.Invoices(this._options)));
+        return ((_a = this._invoices) !== null && _a !== void 0 ? _a : (this._invoices = new Client_js_7.Invoices(this._options)));
     }
     get signals() {
         var _a;
-        return ((_a = this._signals) !== null && _a !== void 0 ? _a : (this._signals = new Client_js_9.Signals(this._options)));
+        return ((_a = this._signals) !== null && _a !== void 0 ? _a : (this._signals = new Client_js_11.Signals(this._options)));
     }
     get credits() {
         var _a;
-        return ((_a = this._credits) !== null && _a !== void 0 ? _a : (this._credits = new Client_js_3.Credits(this._options)));
+        return ((_a = this._credits) !== null && _a !== void 0 ? _a : (this._credits = new Client_js_4.Credits(this._options)));
     }
     get checkouts() {
         var _a;
@@ -92,11 +95,23 @@ class PaidClient {
     }
     get customerPortals() {
         var _a;
-        return ((_a = this._customerPortals) !== null && _a !== void 0 ? _a : (this._customerPortals = new Client_js_4.CustomerPortals(this._options)));
+        return ((_a = this._customerPortals) !== null && _a !== void 0 ? _a : (this._customerPortals = new Client_js_5.CustomerPortals(this._options)));
     }
     get valueReceipts() {
         var _a;
-        return ((_a = this._valueReceipts) !== null && _a !== void 0 ? _a : (this._valueReceipts = new Client_js_10.ValueReceipts(this._options)));
+        return ((_a = this._valueReceipts) !== null && _a !== void 0 ? _a : (this._valueReceipts = new Client_js_12.ValueReceipts(this._options)));
+    }
+    get webhooks() {
+        var _a;
+        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_13.Webhooks(this._options)));
+    }
+    get pricing() {
+        var _a;
+        return ((_a = this._pricing) !== null && _a !== void 0 ? _a : (this._pricing = new Client_js_9.Pricing(this._options)));
+    }
+    get cost() {
+        var _a;
+        return ((_a = this._cost) !== null && _a !== void 0 ? _a : (this._cost = new Client_js_3.Cost(this._options)));
     }
 }
 exports.PaidClient = PaidClient;

package/dist/cjs/api/errors/ConflictError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as Paid from "../index.js";
+export declare class ConflictError extends errors.PaidError {
+    constructor(body: Paid.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/errors/ConflictError.js

@@ -0,0 +1,50 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConflictError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+class ConflictError extends errors.PaidError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ConflictError",
+            statusCode: 409,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, ConflictError.prototype);
+    }
+}
+exports.ConflictError = ConflictError;

package/dist/cjs/api/errors/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./BadRequestError.js";
+export * from "./ConflictError.js";
 export * from "./ForbiddenError.js";
 export * from "./InternalServerError.js";
 export * from "./NotFoundError.js";

package/dist/cjs/api/errors/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BadRequestError.js"), exports);
+__exportStar(require("./ConflictError.js"), exports);
 __exportStar(require("./ForbiddenError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);

package/dist/cjs/api/resources/checkouts/client/Client.d.ts

@@ -61,7 +61,7 @@ export declare class Checkouts {
      *         id: "id"
      *     })
      */
-    getCheckout(request: Paid.GetCheckoutRequest, requestOptions?: Checkouts.RequestOptions): core.HttpResponsePromise<Paid.Checkout>;
+    getCheckout(request: Paid.GetCheckoutRequest, requestOptions?: Checkouts.RequestOptions): core.HttpResponsePromise<Paid.CheckoutDetails>;
     private __getCheckout;
     /**
      * Archive a checkout by ID

package/dist/cjs/api/resources/cost/client/Client.d.ts

@@ -0,0 +1,38 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as Paid from "../../../index.js";
+export declare namespace Cost {
+    interface Options extends BaseClientOptions {
+    }
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class Cost {
+    protected readonly _options: Cost.Options;
+    constructor(_options: Cost.Options);
+    /**
+     * Ingests a batch of cost records. Each record is either a pre-computed `cost` (caller supplies amount + currency) or a `usage` record (caller supplies vendor/model/token counts and Paid prices it server-side). The batch is all-or-nothing: if any record fails validation, the entire request is rejected with a 400 and nothing is persisted. Records may carry an optional `idempotencyKey`; matches against previously ingested records are skipped and reported in the `duplicates` count.
+     *
+     * @param {Paid.CostIngestRequest} request
+     * @param {Cost.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.cost.ingestCost({
+     *         costs: [{
+     *                 type: "cost",
+     *                 customer: {
+     *                     customerId: "customerId"
+     *                 },
+     *                 amount: 1.1,
+     *                 currency: "currency"
+     *             }]
+     *     })
+     */
+    ingestCost(request: Paid.CostIngestRequest, requestOptions?: Cost.RequestOptions): core.HttpResponsePromise<Paid.CostIngestResponse>;
+    private __ingestCost;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/dist/cjs/api/resources/cost/client/Client.js

@@ -0,0 +1,139 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cost = void 0;
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const errors = __importStar(require("../../../../errors/index.js"));
+const Paid = __importStar(require("../../../index.js"));
+class Cost {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Ingests a batch of cost records. Each record is either a pre-computed `cost` (caller supplies amount + currency) or a `usage` record (caller supplies vendor/model/token counts and Paid prices it server-side). The batch is all-or-nothing: if any record fails validation, the entire request is rejected with a 400 and nothing is persisted. Records may carry an optional `idempotencyKey`; matches against previously ingested records are skipped and reported in the `duplicates` count.
+     *
+     * @param {Paid.CostIngestRequest} request
+     * @param {Cost.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.cost.ingestCost({
+     *         costs: [{
+     *                 type: "cost",
+     *                 customer: {
+     *                     customerId: "customerId"
+     *                 },
+     *                 amount: 1.1,
+     *                 currency: "currency"
+     *             }]
+     *     })
+     */
+    ingestCost(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__ingestCost(request, requestOptions));
+    }
+    __ingestCost(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Default, "cost/"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Paid.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PaidError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PaidError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling POST /cost/.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return `Bearer ${yield core.Supplier.get(this._options.token)}`;
+        });
+    }
+}
+exports.Cost = Cost;

package/dist/cjs/api/resources/cost/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/cjs/api/resources/cost/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/cost/client/requests/CostIngestRequest.d.ts

@@ -0,0 +1,17 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         costs: [{
+ *                 type: "cost",
+ *                 customer: {
+ *                     customerId: "customerId"
+ *                 },
+ *                 amount: 1.1,
+ *                 currency: "currency"
+ *             }]
+ *     }
+ */
+export interface CostIngestRequest {
+    costs: Paid.Cost[];
+}

package/dist/cjs/api/resources/cost/client/requests/CostIngestRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/cost/client/requests/index.d.ts

@@ -0,0 +1 @@
+export type { CostIngestRequest } from "./CostIngestRequest.js";

package/dist/cjs/api/resources/cost/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/cost/index.d.ts

@@ -0,0 +1 @@
+export * from "./client/index.js";

package/dist/cjs/api/resources/cost/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/api/resources/customers/client/Client.d.ts

@@ -184,5 +184,24 @@ export declare class Customers {
      */
     getCustomerCreditBalancesByExternalId(request: Paid.GetCustomerCreditBalancesByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CreditBalanceListResponse>;
     private __getCustomerCreditBalancesByExternalId;
+    /**
+     * Create or update a customer user using customer and user external IDs
+     *
+     * @param {Paid.UpsertCustomerUserRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.upsertCustomerUserByExternalId({
+     *         customerExternalId: "customerExternalId",
+     *         userExternalId: "userExternalId"
+     *     })
+     */
+    upsertCustomerUserByExternalId(request: Paid.UpsertCustomerUserRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUser>;
+    private __upsertCustomerUserByExternalId;
     protected _getAuthorizationHeader(): Promise<string>;
 }

package/dist/cjs/api/resources/customers/client/Client.js

@@ -42,6 +42,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Customers = void 0;
 const headers_js_1 = require("../../../../core/headers.js");
@@ -760,6 +771,81 @@ class Customers {
             }
         });
     }
+    /**
+     * Create or update a customer user using customer and user external IDs
+     *
+     * @param {Paid.UpsertCustomerUserRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.upsertCustomerUserByExternalId({
+     *         customerExternalId: "customerExternalId",
+     *         userExternalId: "userExternalId"
+     *     })
+     */
+    upsertCustomerUserByExternalId(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__upsertCustomerUserByExternalId(request, requestOptions));
+    }
+    __upsertCustomerUserByExternalId(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { customerExternalId, userExternalId } = request, _body = __rest(request, ["customerExternalId", "userExternalId"]);
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Default, `customers/${core.url.encodePathParam(customerExternalId)}/users/${core.url.encodePathParam(userExternalId)}`),
+                method: "PUT",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Paid.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PaidError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PaidError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling PUT /customers/{customerExternalId}/users/{userExternalId}.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             return `Bearer ${yield core.Supplier.get(this._options.token)}`;

package/dist/cjs/api/resources/customers/client/requests/UpsertCustomerUserRequest.d.ts

@@ -0,0 +1,16 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         customerExternalId: "customerExternalId",
+ *         userExternalId: "userExternalId"
+ *     }
+ */
+export interface UpsertCustomerUserRequest {
+    customerExternalId: string;
+    userExternalId: string;
+    name?: string;
+    email?: string | null;
+    metadata?: Record<string, unknown> | null;
+    status?: Paid.CustomerUserStatus;
+}

package/dist/cjs/api/resources/customers/client/requests/UpsertCustomerUserRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/customers/client/requests/index.d.ts

@@ -8,3 +8,4 @@ export type { GetCustomerCreditBalancesRequest } from "./GetCustomerCreditBalanc
 export type { ListCustomersRequest } from "./ListCustomersRequest.js";
 export type { UpdateCustomerByExternalIdRequest } from "./UpdateCustomerByExternalIdRequest.js";
 export type { UpdateCustomerByIdRequest } from "./UpdateCustomerByIdRequest.js";
+export type { UpsertCustomerUserRequest } from "./UpsertCustomerUserRequest.js";