@paid-ai/paid-node 1.8.0 → 2.0.0

package/dist/esm/api/resources/checkouts/client/requests/CreateCheckoutRequest.d.mts

@@ -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/esm/api/resources/contacts/client/Client.d.mts

@@ -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/esm/api/resources/contacts/client/Client.mjs

@@ -230,7 +230,7 @@ export 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.
@@ -305,13 +305,14 @@ export 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
@@ -345,6 +346,8 @@ export 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:
@@ -441,7 +444,7 @@ export 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.
@@ -516,13 +519,14 @@ export 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
@@ -556,6 +560,8 @@ export 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/esm/api/resources/credits/client/Client.d.mts

@@ -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.
      *

package/dist/esm/api/resources/credits/client/Client.mjs

@@ -186,7 +186,7 @@ export class Credits {
     __listCreditTransactions() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h;
-            const { limit, offset, customerId, externalCustomerId, creditsCurrencyId, creditCurrencyKey, type: type_, orderId, createdAtFrom, createdAtTo, } = request;
+            const { limit, offset, customerId, externalCustomerId, creditsCurrencyId, creditCurrencyKey, type: type_, orderId, eventName, createdAtFrom, createdAtTo, } = request;
             const _queryParams = {};
             if (limit != null) {
                 _queryParams.limit = limit.toString();
@@ -212,6 +212,9 @@ export class Credits {
             if (orderId != null) {
                 _queryParams.orderId = orderId;
             }
+            if (eventName != null) {
+                _queryParams.eventName = eventName;
+            }
             if (createdAtFrom != null) {
                 _queryParams.createdAtFrom = createdAtFrom;
             }
@@ -264,6 +267,107 @@ export class Credits {
             }
         });
     }
+    /**
+     * 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, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getCreditTransactionSummary(request, requestOptions));
+    }
+    __getCreditTransactionSummary(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { customerId, externalCustomerId, creditsCurrencyId, creditCurrencyKey, type: type_, orderId, eventName, createdAtFrom, createdAtTo, groupBy, interval, } = request;
+            const _queryParams = {};
+            if (customerId != null) {
+                _queryParams.customerId = customerId;
+            }
+            if (externalCustomerId != null) {
+                _queryParams.externalCustomerId = externalCustomerId;
+            }
+            if (creditsCurrencyId != null) {
+                _queryParams.creditsCurrencyId = creditsCurrencyId;
+            }
+            if (creditCurrencyKey != null) {
+                _queryParams.creditCurrencyKey = creditCurrencyKey;
+            }
+            if (type_ != null) {
+                _queryParams.type = type_;
+            }
+            if (orderId != null) {
+                _queryParams.orderId = orderId;
+            }
+            if (eventName != null) {
+                _queryParams.eventName = eventName;
+            }
+            _queryParams.createdAtFrom = createdAtFrom;
+            if (createdAtTo != null) {
+                _queryParams.createdAtTo = createdAtTo;
+            }
+            _queryParams.groupBy = groupBy;
+            _queryParams.interval = interval;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, "credits/transactions/summary"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                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 GET /credits/transactions/summary.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Update a credit currency description or set its active/archive status.
      *

package/dist/esm/api/resources/credits/client/requests/GetCreditTransactionSummaryRequest.d.mts

@@ -0,0 +1,33 @@
+import type * as Paid from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         createdAtFrom: "createdAtFrom",
+ *         groupBy: "eventName",
+ *         interval: "day"
+ *     }
+ */
+export interface GetCreditTransactionSummaryRequest {
+    /** Filter by customer ID. */
+    customerId?: string;
+    /** Filter by customer external ID. */
+    externalCustomerId?: string;
+    /** Filter by credit currency ID. */
+    creditsCurrencyId?: string;
+    /** Filter by the stable machine-readable key of the credit currency. */
+    creditCurrencyKey?: string;
+    /** Ledger type to summarize. Each call summarizes exactly one type, so a spend chart never nets grants against spends. Defaults to `spend`. */
+    type?: Paid.GetCreditTransactionSummaryRequestType;
+    /** Filter by the order this transaction is linked to. */
+    orderId?: string;
+    /** Filter by the usage event that produced the transaction (exact match, untrimmed). Transactions with no event (grants, invoice-void clawbacks, manual adjustments) never match. */
+    eventName?: string;
+    /** Start of the window (inclusive). Required: the window may span at most 92 days. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
+    createdAtFrom: string;
+    /** End of the window (inclusive). Defaults to now. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
+    createdAtTo?: string;
+    /** Dimension to group buckets by. `eventName` groups signal-driven spends by the usage event that produced them; transactions without one (grants, invoice-void clawbacks, manual adjustments) share a bucket whose `groupKey` is null. */
+    groupBy: Paid.GetCreditTransactionSummaryRequestGroupBy;
+    /** Period bucket size. Buckets align to UTC calendar days, ISO weeks (Monday start), or calendar months; the first and last bucket's published bounds are clipped to the requested window. */
+    interval: Paid.GetCreditTransactionSummaryRequestInterval;
+}

package/dist/esm/api/resources/credits/client/requests/ListCreditTransactionsRequest.d.mts

@@ -18,6 +18,8 @@ export interface ListCreditTransactionsRequest {
     type?: Paid.ListCreditTransactionsRequestType;
     /** Filter by the order this transaction is linked to. */
     orderId?: string;
+    /** Filter by the usage event that produced the transaction (exact match, untrimmed). Transactions with no event (grants, invoice-void clawbacks, manual adjustments) never match. */
+    eventName?: string;
     /** Only transactions recorded on or after this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
     createdAtFrom?: string;
     /** Only transactions recorded on or before this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */

package/dist/esm/api/resources/credits/client/requests/index.d.mts

@@ -1,4 +1,5 @@
 export type { CreateCreditCurrencyRequest } from "./CreateCreditCurrencyRequest.mjs";
+export type { GetCreditTransactionSummaryRequest } from "./GetCreditTransactionSummaryRequest.mjs";
 export type { ListCreditCurrenciesRequest } from "./ListCreditCurrenciesRequest.mjs";
 export type { ListCreditTransactionsRequest } from "./ListCreditTransactionsRequest.mjs";
 export type { UpdateCreditCurrencyRequest } from "./UpdateCreditCurrencyRequest.mjs";

package/dist/esm/api/resources/credits/types/GetCreditTransactionSummaryRequestGroupBy.d.mts

@@ -0,0 +1,4 @@
+export declare const GetCreditTransactionSummaryRequestGroupBy: {
+    readonly EventName: "eventName";
+};
+export type GetCreditTransactionSummaryRequestGroupBy = (typeof GetCreditTransactionSummaryRequestGroupBy)[keyof typeof GetCreditTransactionSummaryRequestGroupBy];

package/dist/esm/api/resources/credits/types/GetCreditTransactionSummaryRequestGroupBy.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetCreditTransactionSummaryRequestGroupBy = {
+    EventName: "eventName",
+};

package/dist/esm/api/resources/credits/types/GetCreditTransactionSummaryRequestInterval.d.mts

@@ -0,0 +1,6 @@
+export declare const GetCreditTransactionSummaryRequestInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+export type GetCreditTransactionSummaryRequestInterval = (typeof GetCreditTransactionSummaryRequestInterval)[keyof typeof GetCreditTransactionSummaryRequestInterval];

package/dist/esm/api/resources/credits/types/GetCreditTransactionSummaryRequestInterval.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetCreditTransactionSummaryRequestInterval = {
+    Day: "day",
+    Week: "week",
+    Month: "month",
+};

package/dist/esm/api/resources/credits/types/GetCreditTransactionSummaryRequestType.d.mts

@@ -0,0 +1,6 @@
+export declare const GetCreditTransactionSummaryRequestType: {
+    readonly Grant: "grant";
+    readonly Spend: "spend";
+    readonly PendingGrant: "pendingGrant";
+};
+export type GetCreditTransactionSummaryRequestType = (typeof GetCreditTransactionSummaryRequestType)[keyof typeof GetCreditTransactionSummaryRequestType];

package/dist/esm/api/resources/credits/types/GetCreditTransactionSummaryRequestType.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetCreditTransactionSummaryRequestType = {
+    Grant: "grant",
+    Spend: "spend",
+    PendingGrant: "pendingGrant",
+};

package/dist/esm/api/resources/credits/types/index.d.mts

@@ -1,2 +1,5 @@
+export * from "./GetCreditTransactionSummaryRequestGroupBy.mjs";
+export * from "./GetCreditTransactionSummaryRequestInterval.mjs";
+export * from "./GetCreditTransactionSummaryRequestType.mjs";
 export * from "./ListCreditCurrenciesRequestStatus.mjs";
 export * from "./ListCreditTransactionsRequestType.mjs";

package/dist/esm/api/resources/credits/types/index.mjs

@@ -1,2 +1,5 @@
+export * from "./GetCreditTransactionSummaryRequestGroupBy.mjs";
+export * from "./GetCreditTransactionSummaryRequestInterval.mjs";
+export * from "./GetCreditTransactionSummaryRequestType.mjs";
 export * from "./ListCreditCurrenciesRequestStatus.mjs";
 export * from "./ListCreditTransactionsRequestType.mjs";

package/dist/esm/api/resources/customViewsExperimental/client/Client.d.mts

@@ -94,7 +94,7 @@ export declare class CustomViewsExperimental {
     /**
      * ⚠️ **Experimental** — this endpoint may change or be removed without notice and is not subject to v2 backwards-compatibility guarantees. Do not build production-critical integrations against it yet.
      *
-     * Returns the view's name, status, query ids, and the author render bundle for the owning organization (DRAFT or PUBLISHED). Used by the trusted preview/embed frame to render the sandbox; the per-customer data is fetched separately via /:displayId/data.
+     * Returns the view's name, status, query ids, and the author render bundle for the owning organization. Only PUBLISHED views are returned; a DRAFT returns 404 (use getCustomViewAuthoring to read a DRAFT). Used by the trusted preview/embed frame to render the sandbox; the per-customer data is fetched separately via /:displayId/data.
      *
      * @param {Paid.GetCustomViewRequest} request
      * @param {CustomViewsExperimental.RequestOptions} requestOptions - Request-specific configuration.
@@ -113,7 +113,7 @@ export declare class CustomViewsExperimental {
     /**
      * ⚠️ **Experimental** — this endpoint may change or be removed without notice and is not subject to v2 backwards-compatibility guarantees. Do not build production-critical integrations against it yet.
      *
-     * Partially updates a view. Omitted fields are left unchanged. For REVISIONS, prefer the incremental fields — `bundleEdits` (exact search-and-replace on the stored render bundle) and `queryUpserts`/`queryRemovals` (per-query changes) — so you transmit only what changed instead of re-sending the whole payload. The full-replacement fields remain for rewrites: `renderBundle`, and `queries` (a FULL replacement of the query list — never drop queries the user didn't ask to remove). Replacement and incremental forms of the same aspect cannot be combined. The resulting SQL and bundle pass the same validation as createCustomView (SELECT-only, size cap, self-contained, paid:data listener). Works on DRAFT or PUBLISHED views — published embeds pick the change up on their next load.
+     * Partially updates a view. Omitted fields are left unchanged. For REVISIONS, prefer the incremental fields — `bundleEdits` (exact search-and-replace on the stored render bundle) and `queryUpserts`/`queryRemovals` (per-query changes) — so you transmit only what changed instead of re-sending the whole payload. The full-replacement fields remain for rewrites: `renderBundle`, and `queries` (a FULL replacement of the query list — never drop queries the user didn't ask to remove). Replacement and incremental forms of the same aspect cannot be combined. The resulting SQL and bundle pass the same validation as createCustomView (SELECT-only, size cap, self-contained, paid:data listener). Works on DRAFT or PUBLISHED views — published embeds pick the change up on their next load. If the queries or hierarchy setting change during validation, returns 409 CUSTOM_VIEW_UPDATE_CONFLICT; fetch the current authoring definition and reapply your changes before retrying.
      *
      * @param {Paid.UpdateCustomViewRequest} request
      * @param {CustomViewsExperimental.RequestOptions} requestOptions - Request-specific configuration.
@@ -121,6 +121,7 @@ export declare class CustomViewsExperimental {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -133,7 +134,28 @@ export declare class CustomViewsExperimental {
     /**
      * ⚠️ **Experimental** — this endpoint may change or be removed without notice and is not subject to v2 backwards-compatibility guarantees. Do not build production-critical integrations against it yet.
      *
-     * Runs every stored query of the view on the read-only analytics database and returns the result sets keyed by query id. For a customer-scoped view (the default), the query is scoped to the caller's organization AND the given `customerId` (both enforced as ClickHouse row filters) — `customerId` is required. For an organization-scoped view, the data is org-wide (scoped only to the caller's organization) and `customerId` is ignored. The scope is enforced by the database — it cannot be widened by the stored SQL. If the view declares filters, pass per-request values as `filter_<name>` query parameters (e.g. `filter_region=eu`); undeclared names or disallowed values are rejected with 400. Filters narrow data within the scope — never widen it.
+     * Lists active customer units for a published customer-scoped view with hierarchyEnabled set to true. Hierarchy eligibility is independent of the requested page or usage; requires credit hierarchies to be enabled for the organization.
+     *
+     * @param {Paid.GetCustomViewCustomerUnitsRequest} request
+     * @param {CustomViewsExperimental.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customViewsExperimental.getCustomViewCustomerUnits({
+     *         displayId: "displayId",
+     *         customerId: "cus_acme"
+     *     })
+     */
+    getCustomViewCustomerUnits(request: Paid.GetCustomViewCustomerUnitsRequest, requestOptions?: CustomViewsExperimental.RequestOptions): core.HttpResponsePromise<Paid.ViewCustomerUnitsResponse>;
+    private __getCustomViewCustomerUnits;
+    /**
+     * ⚠️ **Experimental** — this endpoint may change or be removed without notice and is not subject to v2 backwards-compatibility guarantees. Do not build production-critical integrations against it yet.
+     *
+     * Runs every stored query of the view on the read-only analytics database and returns the result sets keyed by query id. For a customer-scoped view (the default), the query is scoped to the caller's organization AND the given `customerId` (both enforced as ClickHouse row filters) — `customerId` is required. For an organization-scoped view, the data is org-wide (scoped only to the caller's organization) and `customerId` is ignored. The scope is enforced by the database — it cannot be widened by the stored SQL. If the view declares filters, pass per-request values as `filter_<name>` query parameters (e.g. `filter_region=eu`); undeclared names or disallowed values are rejected with 400. Filters narrow data within the scope — never widen it. Only PUBLISHED views are served by default; a DRAFT returns 404. To check a saved DRAFT's real data before publishing, pass `includeDraft=true`. Embeds and share links never serve a DRAFT.
      *
      * @param {Paid.GetCustomViewDataRequest} request
      * @param {CustomViewsExperimental.RequestOptions} requestOptions - Request-specific configuration.
@@ -142,6 +164,7 @@ export declare class CustomViewsExperimental {
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
      * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.TooManyRequestsError}
      * @throws {@link Paid.InternalServerError}
      *