@paid-ai/paid-node 1.8.0 → 2.0.0

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

@@ -222,7 +222,7 @@ 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();
@@ -248,6 +248,9 @@ class Credits {
             if (orderId != null) {
                 _queryParams.orderId = orderId;
             }
+            if (eventName != null) {
+                _queryParams.eventName = eventName;
+            }
             if (createdAtFrom != null) {
                 _queryParams.createdAtFrom = createdAtFrom;
             }
@@ -300,6 +303,107 @@ 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 = (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, "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/cjs/api/resources/credits/client/requests/GetCreditTransactionSummaryRequest.d.ts

@@ -0,0 +1,33 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @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/cjs/api/resources/credits/client/requests/ListCreditTransactionsRequest.d.ts

@@ -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/cjs/api/resources/credits/client/requests/index.d.ts

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

package/dist/cjs/api/resources/credits/types/GetCreditTransactionSummaryRequestGroupBy.d.ts

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

package/dist/cjs/api/resources/credits/types/GetCreditTransactionSummaryRequestGroupBy.js

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

package/dist/cjs/api/resources/credits/types/GetCreditTransactionSummaryRequestInterval.d.ts

@@ -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/cjs/api/resources/credits/types/GetCreditTransactionSummaryRequestInterval.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCreditTransactionSummaryRequestInterval = void 0;
+exports.GetCreditTransactionSummaryRequestInterval = {
+    Day: "day",
+    Week: "week",
+    Month: "month",
+};

package/dist/cjs/api/resources/credits/types/GetCreditTransactionSummaryRequestType.d.ts

@@ -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/cjs/api/resources/credits/types/GetCreditTransactionSummaryRequestType.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCreditTransactionSummaryRequestType = void 0;
+exports.GetCreditTransactionSummaryRequestType = {
+    Grant: "grant",
+    Spend: "spend",
+    PendingGrant: "pendingGrant",
+};

package/dist/cjs/api/resources/credits/types/index.d.ts

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

package/dist/cjs/api/resources/credits/types/index.js

@@ -14,5 +14,8 @@ 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("./GetCreditTransactionSummaryRequestGroupBy.js"), exports);
+__exportStar(require("./GetCreditTransactionSummaryRequestInterval.js"), exports);
+__exportStar(require("./GetCreditTransactionSummaryRequestType.js"), exports);
 __exportStar(require("./ListCreditCurrenciesRequestStatus.js"), exports);
 __exportStar(require("./ListCreditTransactionsRequestType.js"), exports);

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

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

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

@@ -359,7 +359,7 @@ 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.
@@ -429,7 +429,7 @@ 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.
@@ -437,6 +437,7 @@ class CustomViewsExperimental {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -475,6 +476,8 @@ class CustomViewsExperimental {
                         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:
@@ -505,7 +508,89 @@ 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, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getCustomViewCustomerUnits(request, requestOptions));
+    }
+    __getCustomViewCustomerUnits(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { displayId, limit, offset, customerId } = request;
+            const _queryParams = {};
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            if (offset != null) {
+                _queryParams.offset = offset.toString();
+            }
+            _queryParams.customerId = customerId;
+            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, `experimental/views/${core.url.encodePathParam(displayId)}/customer-units`),
+                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 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 GET /experimental/views/{displayId}/customer-units.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * ⚠️ **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.
@@ -514,6 +599,7 @@ 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}
      *
@@ -528,7 +614,7 @@ class CustomViewsExperimental {
     __getCustomViewData(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h;
-            const { displayId, customerId, periodKind, periodUnit, periodAmount, periodStart, periodEnd } = request;
+            const { displayId, customerId, periodKind, periodUnit, periodAmount, periodStart, periodEnd, includeDraft, unitMode, unitExternalId, } = request;
             const _queryParams = {};
             if (customerId != null) {
                 _queryParams.customerId = customerId;
@@ -548,6 +634,15 @@ class CustomViewsExperimental {
             if (periodEnd != null) {
                 _queryParams.periodEnd = periodEnd;
             }
+            if (includeDraft != null) {
+                _queryParams.includeDraft = includeDraft;
+            }
+            if (unitMode != null) {
+                _queryParams.unitMode = unitMode;
+            }
+            if (unitExternalId != null) {
+                _queryParams.unitExternalId = unitExternalId;
+            }
             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, `experimental/views/${core.url.encodePathParam(displayId)}/data`),
@@ -571,6 +666,8 @@ class CustomViewsExperimental {
                         throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
                     case 408:
                         throw new Paid.RequestTimeoutError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_response.error.body, _response.rawResponse);
                     case 429:
                         throw new Paid.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:

package/dist/cjs/api/resources/customViewsExperimental/client/requests/CreateCustomViewRequest.d.ts

@@ -11,6 +11,10 @@ import type * as Paid from "../../../../index.js";
  *     }
  */
 export interface CreateCustomViewRequest {
+    /** Enable customer unit navigation for a customer-scoped view. Setting true requires customer hierarchies to be enabled for your organization, and every query must support unit selection. Existing views default to false. */
+    hierarchyEnabled?: boolean;
+    /** Send the customer's unit caps to the render bundle as `context.caps`. Needs `hierarchyEnabled` on a customer-scoped view. Turn it on only for views that draw cap usage: each load then reads cap usage from billing. Caps are spend policy, so an API key also needs `read:billing` to receive them in the data (they are left out otherwise) or to mint this view's embed token. Defaults to false. */
+    capsEnabled?: boolean;
     /** Human-readable view name (shown in preview + audit log). */
     name: string;
     /** Optional longer description of what the view shows. */

package/dist/cjs/api/resources/customViewsExperimental/client/requests/GetCustomViewCustomerUnitsRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {
+ *         displayId: "displayId",
+ *         customerId: "cus_acme"
+ *     }
+ */
+export interface GetCustomViewCustomerUnitsRequest {
+    displayId: string;
+    limit?: number;
+    offset?: number;
+    /** The customer's external ID, Paid customer ID, or internal ID. */
+    customerId: string;
+}

package/dist/cjs/api/resources/customViewsExperimental/client/requests/GetCustomViewDataRequest.d.ts

@@ -19,4 +19,10 @@ export interface GetCustomViewDataRequest {
     periodStart?: string;
     /** absolute override only: inclusive end date (YYYY-MM-DD). */
     periodEnd?: string;
+    /** Pass 'true' to also serve a DRAFT view, so you can check its real data before publishing. Without it a DRAFT returns 404. End-customer embeds and share links never serve a DRAFT. */
+    includeDraft?: Paid.GetCustomViewDataRequestIncludeDraft;
+    /** Unit selection for this request. Omit both unit parameters for all customer activity. Shared links instead use their saved starting selection when omitted; pass all to reset a shared link. */
+    unitMode?: Paid.GetCustomViewDataRequestUnitMode;
+    /** The unit's external ID. Required with direct or subtree, and omitted with all. */
+    unitExternalId?: string;
 }

package/dist/cjs/api/resources/customViewsExperimental/client/requests/UpdateCustomViewRequest.d.ts

@@ -7,6 +7,10 @@ import type * as Paid from "../../../../index.js";
  */
 export interface UpdateCustomViewRequest {
     displayId: string;
+    /** Enable customer unit navigation for a customer-scoped view. Setting true requires customer hierarchies to be enabled for your organization, and every query must support unit selection. Existing views default to false. */
+    hierarchyEnabled?: boolean;
+    /** Send the customer's unit caps to the render bundle as `context.caps`. Needs `hierarchyEnabled` on a customer-scoped view. Turn it on only for views that draw cap usage: each load then reads cap usage from billing. Caps are spend policy, so an API key also needs `read:billing` to receive them in the data (they are left out otherwise) or to mint this view's embed token. Defaults to false. */
+    capsEnabled?: boolean;
     /** New human-readable view name. */
     name?: string;
     /** New description; pass null to clear it. */

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

@@ -1,4 +1,5 @@
 export type { CreateCustomViewRequest } from "./CreateCustomViewRequest.js";
+export type { GetCustomViewCustomerUnitsRequest } from "./GetCustomViewCustomerUnitsRequest.js";
 export type { GetCustomViewDataRequest } from "./GetCustomViewDataRequest.js";
 export type { GetCustomViewEmbedTokenRequest } from "./GetCustomViewEmbedTokenRequest.js";
 export type { GetCustomViewRequest } from "./GetCustomViewRequest.js";

package/dist/cjs/api/resources/customViewsExperimental/types/GetCustomViewDataRequestIncludeDraft.d.ts

@@ -0,0 +1,5 @@
+export declare const GetCustomViewDataRequestIncludeDraft: {
+    readonly True: "true";
+    readonly False: "false";
+};
+export type GetCustomViewDataRequestIncludeDraft = (typeof GetCustomViewDataRequestIncludeDraft)[keyof typeof GetCustomViewDataRequestIncludeDraft];

package/dist/cjs/api/resources/customViewsExperimental/types/GetCustomViewDataRequestIncludeDraft.js

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

package/dist/cjs/api/resources/customViewsExperimental/types/GetCustomViewDataRequestUnitMode.d.ts

@@ -0,0 +1,6 @@
+export declare const GetCustomViewDataRequestUnitMode: {
+    readonly All: "all";
+    readonly Direct: "direct";
+    readonly Subtree: "subtree";
+};
+export type GetCustomViewDataRequestUnitMode = (typeof GetCustomViewDataRequestUnitMode)[keyof typeof GetCustomViewDataRequestUnitMode];

package/dist/cjs/api/resources/customViewsExperimental/types/GetCustomViewDataRequestUnitMode.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCustomViewDataRequestUnitMode = void 0;
+exports.GetCustomViewDataRequestUnitMode = {
+    All: "all",
+    Direct: "direct",
+    Subtree: "subtree",
+};

package/dist/cjs/api/resources/customViewsExperimental/types/index.d.ts

@@ -1,2 +1,4 @@
+export * from "./GetCustomViewDataRequestIncludeDraft.js";
 export * from "./GetCustomViewDataRequestPeriodKind.js";
 export * from "./GetCustomViewDataRequestPeriodUnit.js";
+export * from "./GetCustomViewDataRequestUnitMode.js";

package/dist/cjs/api/resources/customViewsExperimental/types/index.js

@@ -14,5 +14,7 @@ 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("./GetCustomViewDataRequestIncludeDraft.js"), exports);
 __exportStar(require("./GetCustomViewDataRequestPeriodKind.js"), exports);
 __exportStar(require("./GetCustomViewDataRequestPeriodUnit.js"), exports);
+__exportStar(require("./GetCustomViewDataRequestUnitMode.js"), exports);

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

@@ -11,7 +11,7 @@ export declare class CustomerPortals {
     protected readonly _options: CustomerPortals.Options;
     constructor(_options: CustomerPortals.Options);
     /**
-     * Creates a portal session for the customer. Returns a short-lived URL to the customer portal.
+     * Deprecated — the customer portal is being retired, and this endpoint will be removed in a future release. It keeps working for existing integrations meanwhile: it creates a portal session for the customer and returns a short-lived URL to the customer portal. Contact Paid before building anything new on it.
      *
      * @param {Paid.CreateCustomerPortalRequest} request
      * @param {CustomerPortals.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -54,7 +54,7 @@ class CustomerPortals {
         this._options = _options;
     }
     /**
-     * Creates a portal session for the customer. Returns a short-lived URL to the customer portal.
+     * Deprecated — the customer portal is being retired, and this endpoint will be removed in a future release. It keeps working for existing integrations meanwhile: it creates a portal session for the customer and returns a short-lived URL to the customer portal. Contact Paid before building anything new on it.
      *
      * @param {Paid.CreateCustomerPortalRequest} request
      * @param {CustomerPortals.RequestOptions} requestOptions - Request-specific configuration.