@paid-ai/paid-node 1.8.0 → 2.0.0

package/dist/cjs/Client.d.ts

@@ -5,10 +5,10 @@ import { Checkouts } from "./api/resources/checkouts/client/Client.js";
 import { Contacts } from "./api/resources/contacts/client/Client.js";
 import { Costs } from "./api/resources/costs/client/Client.js";
 import { Credits } from "./api/resources/credits/client/Client.js";
-import { CustomerGroups } from "./api/resources/customerGroups/client/Client.js";
 import { CustomerPortals } from "./api/resources/customerPortals/client/Client.js";
 import { Customers } from "./api/resources/customers/client/Client.js";
 import { CustomViewsExperimental } from "./api/resources/customViewsExperimental/client/Client.js";
+import { DeliveredValue } from "./api/resources/deliveredValue/client/Client.js";
 import { Invoices } from "./api/resources/invoices/client/Client.js";
 import { Orders } from "./api/resources/orders/client/Client.js";
 import { PaymentAllocations } from "./api/resources/paymentAllocations/client/Client.js";
@@ -42,6 +42,7 @@ export declare class PaidClient {
     protected _checkouts: Checkouts | undefined;
     protected _customerPortals: CustomerPortals | undefined;
     protected _valueReceipts: ValueReceipts | undefined;
+    protected _deliveredValue: DeliveredValue | undefined;
     protected _webhooks: Webhooks | undefined;
     protected _pricing: Pricing | undefined;
     protected _costs: Costs | undefined;
@@ -49,7 +50,6 @@ export declare class PaidClient {
     protected _customViewsExperimental: CustomViewsExperimental | undefined;
     protected _valueModels: ValueModels | undefined;
     protected _valueMetrics: ValueMetrics | undefined;
-    protected _customerGroups: CustomerGroups | undefined;
     protected _paymentMethods: PaymentMethods | undefined;
     protected _payments: Payments | undefined;
     protected _paymentAllocations: PaymentAllocations | undefined;
@@ -67,6 +67,7 @@ export declare class PaidClient {
     get checkouts(): Checkouts;
     get customerPortals(): CustomerPortals;
     get valueReceipts(): ValueReceipts;
+    get deliveredValue(): DeliveredValue;
     get webhooks(): Webhooks;
     get pricing(): Pricing;
     get costs(): Costs;
@@ -74,7 +75,6 @@ export declare class PaidClient {
     get customViewsExperimental(): CustomViewsExperimental;
     get valueModels(): ValueModels;
     get valueMetrics(): ValueMetrics;
-    get customerGroups(): CustomerGroups;
     get paymentMethods(): PaymentMethods;
     get payments(): Payments;
     get paymentAllocations(): PaymentAllocations;

package/dist/cjs/Client.js

@@ -42,10 +42,10 @@ const Client_js_4 = require("./api/resources/checkouts/client/Client.js");
 const Client_js_5 = require("./api/resources/contacts/client/Client.js");
 const Client_js_6 = require("./api/resources/costs/client/Client.js");
 const Client_js_7 = require("./api/resources/credits/client/Client.js");
-const Client_js_8 = require("./api/resources/customerGroups/client/Client.js");
-const Client_js_9 = require("./api/resources/customerPortals/client/Client.js");
-const Client_js_10 = require("./api/resources/customers/client/Client.js");
-const Client_js_11 = require("./api/resources/customViewsExperimental/client/Client.js");
+const Client_js_8 = require("./api/resources/customerPortals/client/Client.js");
+const Client_js_9 = require("./api/resources/customers/client/Client.js");
+const Client_js_10 = require("./api/resources/customViewsExperimental/client/Client.js");
+const Client_js_11 = require("./api/resources/deliveredValue/client/Client.js");
 const Client_js_12 = require("./api/resources/invoices/client/Client.js");
 const Client_js_13 = require("./api/resources/orders/client/Client.js");
 const Client_js_14 = require("./api/resources/paymentAllocations/client/Client.js");
@@ -66,8 +66,8 @@ 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.8.0",
-                "User-Agent": "@paid-ai/paid-node/1.8.0",
+                "X-Fern-SDK-Version": "2.0.0",
+                "User-Agent": "@paid-ai/paid-node/2.0.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -82,7 +82,7 @@ class PaidClient {
     }
     get customers() {
         var _a;
-        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_js_10.Customers(this._options)));
+        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_js_9.Customers(this._options)));
     }
     get contacts() {
         var _a;
@@ -110,12 +110,16 @@ class PaidClient {
     }
     get customerPortals() {
         var _a;
-        return ((_a = this._customerPortals) !== null && _a !== void 0 ? _a : (this._customerPortals = new Client_js_9.CustomerPortals(this._options)));
+        return ((_a = this._customerPortals) !== null && _a !== void 0 ? _a : (this._customerPortals = new Client_js_8.CustomerPortals(this._options)));
     }
     get valueReceipts() {
         var _a;
         return ((_a = this._valueReceipts) !== null && _a !== void 0 ? _a : (this._valueReceipts = new Client_js_23.ValueReceipts(this._options)));
     }
+    get deliveredValue() {
+        var _a;
+        return ((_a = this._deliveredValue) !== null && _a !== void 0 ? _a : (this._deliveredValue = new Client_js_11.DeliveredValue(this._options)));
+    }
     get webhooks() {
         var _a;
         return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_24.Webhooks(this._options)));
@@ -134,7 +138,7 @@ class PaidClient {
     }
     get customViewsExperimental() {
         var _a;
-        return ((_a = this._customViewsExperimental) !== null && _a !== void 0 ? _a : (this._customViewsExperimental = new Client_js_11.CustomViewsExperimental(this._options)));
+        return ((_a = this._customViewsExperimental) !== null && _a !== void 0 ? _a : (this._customViewsExperimental = new Client_js_10.CustomViewsExperimental(this._options)));
     }
     get valueModels() {
         var _a;
@@ -144,10 +148,6 @@ class PaidClient {
         var _a;
         return ((_a = this._valueMetrics) !== null && _a !== void 0 ? _a : (this._valueMetrics = new Client_js_21.ValueMetrics(this._options)));
     }
-    get customerGroups() {
-        var _a;
-        return ((_a = this._customerGroups) !== null && _a !== void 0 ? _a : (this._customerGroups = new Client_js_8.CustomerGroups(this._options)));
-    }
     get paymentMethods() {
         var _a;
         return ((_a = this._paymentMethods) !== null && _a !== void 0 ? _a : (this._paymentMethods = new Client_js_15.PaymentMethods(this._options)));

package/dist/cjs/api/errors/UnprocessableEntityError.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 UnprocessableEntityError extends errors.PaidError {
+    constructor(body: Paid.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/errors/UnprocessableEntityError.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.UnprocessableEntityError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+class UnprocessableEntityError extends errors.PaidError {
+    constructor(body, rawResponse) {
+        super({
+            message: "UnprocessableEntityError",
+            statusCode: 422,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, UnprocessableEntityError.prototype);
+    }
+}
+exports.UnprocessableEntityError = UnprocessableEntityError;

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

@@ -5,3 +5,4 @@ export * from "./InternalServerError.js";
 export * from "./NotFoundError.js";
 export * from "./RequestTimeoutError.js";
 export * from "./TooManyRequestsError.js";
+export * from "./UnprocessableEntityError.js";

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

@@ -21,3 +21,4 @@ __exportStar(require("./InternalServerError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);
 __exportStar(require("./RequestTimeoutError.js"), exports);
 __exportStar(require("./TooManyRequestsError.js"), exports);
+__exportStar(require("./UnprocessableEntityError.js"), exports);

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

@@ -15,7 +15,7 @@ export declare class Analytics {
      *
      * Conventions: monetary amounts are minor units (cents — divide by 100 for the major unit); most are integers, but `fact_cost.cost_amount` is fractional cents (Decimal) since a single AI call usually costs less than a cent; 64-bit integers (counts, ids, amounts) are returned as JSON strings to preserve precision, so parse them client-side; Decimal columns (fractional cents, and credit amounts, which are counts of credits rather than cents and are never divided by 100) come back as JSON numbers instead, so a value beyond 2^53 is already rounded — select toString(col) when you need its exact digits. Query signal payloads via JSON paths, e.g. `SELECT data.country::String AS country, count() FROM fact_signal GROUP BY country`.
      *
-     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
+     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Queries exceeding the 4 GB memory allowance return HTTP 422 with code `QUERY_MEMORY_LIMIT_EXCEEDED`. Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
      *
      * @param {Paid.AnalyticsQueryRequest} request
      * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.
@@ -23,6 +23,7 @@ export declare class Analytics {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.UnprocessableEntityError}
      * @throws {@link Paid.TooManyRequestsError}
      * @throws {@link Paid.InternalServerError}
      *
@@ -46,7 +47,7 @@ export declare class Analytics {
     getAnalyticsSchema(requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<Paid.AnalyticsSchemaResponse>;
     private __getAnalyticsSchema;
     /**
-     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`.
+     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`. Keys declared as grouping dimensions are marked `declared` with their `slot` and listed first. Where available, each path also carries `firstSeen`, `lastSeen` and a `signals` count; these span all time, and the window only selects which paths and types are returned.
      *
      * @param {Paid.GetSignalsMetadataRequest} request
      * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -58,7 +58,7 @@ class Analytics {
      *
      * Conventions: monetary amounts are minor units (cents — divide by 100 for the major unit); most are integers, but `fact_cost.cost_amount` is fractional cents (Decimal) since a single AI call usually costs less than a cent; 64-bit integers (counts, ids, amounts) are returned as JSON strings to preserve precision, so parse them client-side; Decimal columns (fractional cents, and credit amounts, which are counts of credits rather than cents and are never divided by 100) come back as JSON numbers instead, so a value beyond 2^53 is already rounded — select toString(col) when you need its exact digits. Query signal payloads via JSON paths, e.g. `SELECT data.country::String AS country, count() FROM fact_signal GROUP BY country`.
      *
-     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
+     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Queries exceeding the 4 GB memory allowance return HTTP 422 with code `QUERY_MEMORY_LIMIT_EXCEEDED`. Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
      *
      * @param {Paid.AnalyticsQueryRequest} request
      * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.
@@ -66,6 +66,7 @@ class Analytics {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.UnprocessableEntityError}
      * @throws {@link Paid.TooManyRequestsError}
      * @throws {@link Paid.InternalServerError}
      *
@@ -104,6 +105,8 @@ class Analytics {
                         throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 408:
                         throw new Paid.RequestTimeoutError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Paid.UnprocessableEntityError(_response.error.body, _response.rawResponse);
                     case 429:
                         throw new Paid.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
@@ -192,7 +195,7 @@ class Analytics {
         });
     }
     /**
-     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`.
+     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`. Keys declared as grouping dimensions are marked `declared` with their `slot` and listed first. Where available, each path also carries `firstSeen`, `lastSeen` and a `signals` count; these span all time, and the window only selects which paths and types are returned.
      *
      * @param {Paid.GetSignalsMetadataRequest} request
      * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -17,7 +17,7 @@ export declare class AnalyticsExperimental {
      *
      * Conventions: monetary amounts are minor units (cents — divide by 100 for the major unit); most are integers, but `fact_cost.cost_amount` is fractional cents (Decimal) since a single AI call usually costs less than a cent; 64-bit integers (counts, ids, amounts) are returned as JSON strings to preserve precision, so parse them client-side; Decimal columns (fractional cents, and credit amounts, which are counts of credits rather than cents and are never divided by 100) come back as JSON numbers instead, so a value beyond 2^53 is already rounded — select toString(col) when you need its exact digits. Query signal payloads via JSON paths, e.g. `SELECT data.country::String AS country, count() FROM fact_signal GROUP BY country`.
      *
-     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
+     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Queries exceeding the 4 GB memory allowance return HTTP 422 with code `QUERY_MEMORY_LIMIT_EXCEEDED`. Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
      *
      * @param {Paid.AnalyticsQueryRequest} request
      * @param {AnalyticsExperimental.RequestOptions} requestOptions - Request-specific configuration.
@@ -25,6 +25,7 @@ export declare class AnalyticsExperimental {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.UnprocessableEntityError}
      * @throws {@link Paid.TooManyRequestsError}
      * @throws {@link Paid.InternalServerError}
      *
@@ -52,7 +53,7 @@ export declare class AnalyticsExperimental {
     /**
      * This experimental path is deprecated and is not supported for new integrations. Use `GET /api/v2/analytics/signals/metadata` instead; the old path remains available for existing integrations.
      *
-     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`.
+     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`. Keys declared as grouping dimensions are marked `declared` with their `slot` and listed first. Where available, each path also carries `firstSeen`, `lastSeen` and a `signals` count; these span all time, and the window only selects which paths and types are returned.
      *
      * @param {Paid.GetExperimentalSignalsMetadataRequest} request
      * @param {AnalyticsExperimental.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -60,7 +60,7 @@ class AnalyticsExperimental {
      *
      * Conventions: monetary amounts are minor units (cents — divide by 100 for the major unit); most are integers, but `fact_cost.cost_amount` is fractional cents (Decimal) since a single AI call usually costs less than a cent; 64-bit integers (counts, ids, amounts) are returned as JSON strings to preserve precision, so parse them client-side; Decimal columns (fractional cents, and credit amounts, which are counts of credits rather than cents and are never divided by 100) come back as JSON numbers instead, so a value beyond 2^53 is already rounded — select toString(col) when you need its exact digits. Query signal payloads via JSON paths, e.g. `SELECT data.country::String AS country, count() FROM fact_signal GROUP BY country`.
      *
-     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
+     * Limits: 30 seconds of execution time and 10,000 result rows (truncation is flagged via `meta.truncated`). Queries exceeding the 4 GB memory allowance return HTTP 422 with code `QUERY_MEMORY_LIMIT_EXCEEDED`. Prefer aggregates and a `created_at` date filter on large tables — this endpoint is for interactive analytics, not bulk export.
      *
      * @param {Paid.AnalyticsQueryRequest} request
      * @param {AnalyticsExperimental.RequestOptions} requestOptions - Request-specific configuration.
@@ -68,6 +68,7 @@ class AnalyticsExperimental {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.UnprocessableEntityError}
      * @throws {@link Paid.TooManyRequestsError}
      * @throws {@link Paid.InternalServerError}
      *
@@ -106,6 +107,8 @@ class AnalyticsExperimental {
                         throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 408:
                         throw new Paid.RequestTimeoutError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Paid.UnprocessableEntityError(_response.error.body, _response.rawResponse);
                     case 429:
                         throw new Paid.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
@@ -198,7 +201,7 @@ class AnalyticsExperimental {
     /**
      * This experimental path is deprecated and is not supported for new integrations. Use `GET /api/v2/analytics/signals/metadata` instead; the old path remains available for existing integrations.
      *
-     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`.
+     * Lists the JSON paths (and their observed types) present in the `data` payload of your signals within a time window (default: last 30 days), grouped by signal name. Use the returned paths in queries against `fact_signal`, e.g. `WHERE data.<path>::String = '...'`. Keys declared as grouping dimensions are marked `declared` with their `slot` and listed first. Where available, each path also carries `firstSeen`, `lastSeen` and a `signals` count; these span all time, and the window only selects which paths and types are returned.
      *
      * @param {Paid.GetExperimentalSignalsMetadataRequest} request
      * @param {AnalyticsExperimental.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -64,13 +64,14 @@ export declare class Checkouts {
     getCheckout(request: Paid.GetCheckoutRequest, requestOptions?: Checkouts.RequestOptions): core.HttpResponsePromise<Paid.CheckoutDetails>;
     private __getCheckout;
     /**
-     * Archive a checkout by ID
+     * Archive a checkout by ID so it can no longer be paid. A completed (paid) checkout can't be archived and returns 409.
      *
      * @param {Paid.ArchiveCheckoutRequest} request
      * @param {Checkouts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example

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

@@ -274,13 +274,14 @@ class Checkouts {
         });
     }
     /**
-     * Archive a checkout by ID
+     * Archive a checkout by ID so it can no longer be paid. A completed (paid) checkout can't be archived and returns 409.
      *
      * @param {Paid.ArchiveCheckoutRequest} request
      * @param {Checkouts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -314,6 +315,8 @@ class Checkouts {
                         throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/cjs/api/resources/checkouts/client/requests/CreateCheckoutRequest.d.ts

@@ -15,10 +15,15 @@ export interface CreateCheckoutRequest {
     externalCustomerId?: string;
     successUrl: string;
     cancelUrl?: string;
+    /** When the checkout link expires. Must be in the future. Defaults to 24 hours after creation. */
     expiresAt?: string;
     metadata?: Record<string, unknown>;
     collectAddress?: boolean;
     collectPhone?: boolean;
+    /** Heading on the confirmation screen the customer sees after completing checkout, shown instead of "Payment successful". Plain text, up to 80 characters. Omit it to keep the default. */
+    successTitle?: string;
+    /** Text under the heading on the confirmation screen, shown instead of "Thank you for your purchase!". Plain text, up to 500 characters. Omit it to keep the default. Right after checkout, the page still adds "You will be redirected shortly." before sending the customer to `successUrl`. */
+    successMessage?: string;
     singleUse?: boolean;
     /** Lock checkout to a specific currency. Omit to allow all currencies supported by the selected plans. If the checkout is for a customer with an active subscription, the currency must match that subscription's currency — subscriptions cannot change currency. */
     currency?: string;

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

@@ -61,7 +61,7 @@ export declare class Contacts {
     getContactById(request: Paid.GetContactByIdRequest, requestOptions?: Contacts.RequestOptions): core.HttpResponsePromise<Paid.Contact>;
     private __getContactById;
     /**
-     * Update a contact by its ID
+     * Update a contact by its ID. A contact can move to another customer only if no orders or invoices reference it; otherwise a different `customerId` returns 400 `CONTACT_CUSTOMER_IMMUTABLE`.
      *
      * @param {Paid.UpdateContactByIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
@@ -80,13 +80,14 @@ export declare class Contacts {
     updateContactById(request: Paid.UpdateContactByIdRequest, requestOptions?: Contacts.RequestOptions): core.HttpResponsePromise<Paid.Contact>;
     private __updateContactById;
     /**
-     * Delete a contact by its ID
+     * Delete a contact by its ID. A contact referenced by an order or an unsettled invoice cannot be deleted (409 `CONTACT_HAS_ASSOCIATIONS`). Posted paid invoices, voided invoices and canceled invoices do not block deletion.
      *
      * @param {Paid.DeleteContactByIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -114,7 +115,7 @@ export declare class Contacts {
     getContactByExternalId(request: Paid.GetContactByExternalIdRequest, requestOptions?: Contacts.RequestOptions): core.HttpResponsePromise<Paid.Contact>;
     private __getContactByExternalId;
     /**
-     * Update a contact by its external ID
+     * Update a contact by its external ID. A contact can move to another customer only if no orders or invoices reference it; otherwise a different `customerId` returns 400 `CONTACT_CUSTOMER_IMMUTABLE`.
      *
      * @param {Paid.UpdateContactByExternalIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
@@ -133,13 +134,14 @@ export declare class Contacts {
     updateContactByExternalId(request: Paid.UpdateContactByExternalIdRequest, requestOptions?: Contacts.RequestOptions): core.HttpResponsePromise<Paid.Contact>;
     private __updateContactByExternalId;
     /**
-     * Delete a contact by its external ID
+     * Delete a contact by its external ID. A contact referenced by an order or an unsettled invoice cannot be deleted (409 `CONTACT_HAS_ASSOCIATIONS`). Posted paid invoices, voided invoices and canceled invoices do not block deletion.
      *
      * @param {Paid.DeleteContactByExternalIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example

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

@@ -266,7 +266,7 @@ class Contacts {
         });
     }
     /**
-     * Update a contact by its ID
+     * Update a contact by its ID. A contact can move to another customer only if no orders or invoices reference it; otherwise a different `customerId` returns 400 `CONTACT_CUSTOMER_IMMUTABLE`.
      *
      * @param {Paid.UpdateContactByIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
@@ -341,13 +341,14 @@ class Contacts {
         });
     }
     /**
-     * Delete a contact by its ID
+     * Delete a contact by its ID. A contact referenced by an order or an unsettled invoice cannot be deleted (409 `CONTACT_HAS_ASSOCIATIONS`). Posted paid invoices, voided invoices and canceled invoices do not block deletion.
      *
      * @param {Paid.DeleteContactByIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -381,6 +382,8 @@ class Contacts {
                         throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
                     default:
@@ -477,7 +480,7 @@ class Contacts {
         });
     }
     /**
-     * Update a contact by its external ID
+     * Update a contact by its external ID. A contact can move to another customer only if no orders or invoices reference it; otherwise a different `customerId` returns 400 `CONTACT_CUSTOMER_IMMUTABLE`.
      *
      * @param {Paid.UpdateContactByExternalIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
@@ -552,13 +555,14 @@ class Contacts {
         });
     }
     /**
-     * Delete a contact by its external ID
+     * Delete a contact by its external ID. A contact referenced by an order or an unsettled invoice cannot be deleted (409 `CONTACT_HAS_ASSOCIATIONS`). Posted paid invoices, voided invoices and canceled invoices do not block deletion.
      *
      * @param {Paid.DeleteContactByExternalIdRequest} request
      * @param {Contacts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -592,6 +596,8 @@ class Contacts {
                         throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

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

@@ -58,6 +58,25 @@ export declare class Credits {
      */
     listCreditTransactions(request?: Paid.ListCreditTransactionsRequest, requestOptions?: Credits.RequestOptions): core.HttpResponsePromise<Paid.CreditTransactionListResponse>;
     private __listCreditTransactions;
+    /**
+     * Aggregate credit ledger transactions of one type into period buckets grouped by a dimension, for charting credit consumption over time. Accepts the same filters as the transaction list and reads the same ledger, so bucket totals always match summing that list over the same filters and the same `type` — pass this endpoint's effective `type` (it defaults to `spend`) to the list, which has no default and otherwise returns every type.
+     *
+     * @param {Paid.GetCreditTransactionSummaryRequest} request
+     * @param {Credits.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.credits.getCreditTransactionSummary({
+     *         createdAtFrom: "createdAtFrom",
+     *         groupBy: "eventName",
+     *         interval: "day"
+     *     })
+     */
+    getCreditTransactionSummary(request: Paid.GetCreditTransactionSummaryRequest, requestOptions?: Credits.RequestOptions): core.HttpResponsePromise<Paid.CreditTransactionSummaryResponse>;
+    private __getCreditTransactionSummary;
     /**
      * Update a credit currency description or set its active/archive status.
      *