@paid-ai/paid-node 1.8.0 → 2.0.0

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

@@ -303,7 +303,7 @@ class Orders {
         });
     }
     /**
-     * Update an order by ID
+     * Update an order by ID. creationState must equal the order's current state; activate a draft order with POST /orders/{id}/activate.
      *
      * @param {Paid.UpdateOrderRequest} request
      * @param {Orders.RequestOptions} requestOptions - Request-specific configuration.
@@ -832,6 +832,151 @@ class Orders {
             }
         });
     }
+    /**
+     * Creates or updates a customer, an optional contact, the products on the order, and the order with its lines, in one call. Each record is matched by its `externalId`, so you can send the same deal again after it changes in your CRM. Returns 201 Created when the order is new, and 200 OK when an existing draft order with the same `externalId` was updated. Treat both as success. Re-provisioning an order that is already active returns 409 `ORDER_ALREADY_ACTIVE`; change an active order through the amendments API instead. Amounts are whole numbers in minor currency units (cents).
+     *
+     * @param {Paid.ProvisionRequest} request
+     * @param {Orders.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.orders.upsertOrderByExternalId({
+     *         "idempotency-key": "deal_88213-2026-09-30T14:05:00Z",
+     *         externalReference: {
+     *             source: "standard",
+     *             metadata: {
+     *                 "crmDealId": "deal_88213",
+     *                 "crmAccountId": "acct_4410"
+     *             }
+     *         },
+     *         customer: {
+     *             externalId: "acct_4410",
+     *             name: "Northwind Logistics",
+     *             email: "billing@northwind.example",
+     *             billingAddress: {
+     *                 line1: "200 Harbor Way",
+     *                 city: "Seattle",
+     *                 state: "WA",
+     *                 zipCode: "98101",
+     *                 country: "US"
+     *             }
+     *         },
+     *         order: {
+     *             externalId: "deal_88213",
+     *             name: "Northwind Logistics - Growth plan",
+     *             currency: "USD",
+     *             startDate: "2026-10-01T00:00:00.000Z",
+     *             lines: [{
+     *                     externalId: "deal_88213_platform",
+     *                     startDate: "2026-10-01T00:00:00.000Z",
+     *                     product: {
+     *                         externalId: "growth_plan",
+     *                         name: "Growth plan",
+     *                         attributes: [{
+     *                                 name: "Platform fee",
+     *                                 pricing: {
+     *                                     chargeType: "recurring",
+     *                                     pricingModel: "perUnit",
+     *                                     billingFrequency: "monthly",
+     *                                     billingType: "advance",
+     *                                     pricePoints: {
+     *                                         currency: "USD",
+     *                                         unitPrice: 49900
+     *                                     }
+     *                                 }
+     *                             }]
+     *                     }
+     *                 }, {
+     *                     externalId: "deal_88213_launch_discount",
+     *                     lineType: "CREDIT",
+     *                     startDate: "2026-10-01T00:00:00.000Z",
+     *                     endDate: "2027-01-01T00:00:00.000Z",
+     *                     product: {
+     *                         externalId: "launch_discount",
+     *                         name: "Launch discount",
+     *                         attributes: [{
+     *                                 name: "Launch discount",
+     *                                 pricing: {
+     *                                     chargeType: "recurring",
+     *                                     pricingModel: "perUnit",
+     *                                     billingFrequency: "monthly",
+     *                                     billingType: "advance",
+     *                                     pricePoints: {
+     *                                         currency: "USD",
+     *                                         unitPrice: 10000
+     *                                     }
+     *                                 }
+     *                             }]
+     *                     }
+     *                 }]
+     *         }
+     *     })
+     */
+    upsertOrderByExternalId(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__upsertOrderByExternalId(request, requestOptions));
+    }
+    __upsertOrderByExternalId(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { "idempotency-key": idempotencyKey } = request, _body = __rest(request, ["idempotency-key"]);
+            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(),
+                "idempotency-key": idempotencyKey,
+            }), 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, "provision/"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Paid.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PaidError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PaidError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling POST /provision/.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             return `Bearer ${yield core.Supplier.get(this._options.token)}`;

package/dist/cjs/api/resources/orders/client/requests/CreateOrderRequest.d.ts

@@ -16,7 +16,7 @@ export interface CreateOrderRequest {
     creationState?: Paid.OrderCreationState;
     /** Day of month for billing anchor (1-31). Defaults to start date day if not provided. */
     billingAnchor?: number;
-    paymentTerms?: string;
+    paymentTerms?: CreateOrderRequest.PaymentTerms;
     externalId?: string;
     metadata?: Record<string, unknown>;
     currency?: string;
@@ -28,3 +28,14 @@ export interface CreateOrderRequest {
     /** Purchase order number printed on invoices generated from this order. */
     purchaseOrderReference?: string | null;
 }
+export declare namespace CreateOrderRequest {
+    const PaymentTerms: {
+        readonly DueOnReceipt: "DueOnReceipt";
+        readonly Net15: "Net15";
+        readonly Net30: "Net30";
+        readonly Net45: "Net45";
+        readonly Net60: "Net60";
+        readonly Net90: "Net90";
+    };
+    type PaymentTerms = (typeof PaymentTerms)[keyof typeof PaymentTerms];
+}

package/dist/cjs/api/resources/orders/client/requests/CreateOrderRequest.js

@@ -1,3 +1,15 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateOrderRequest = void 0;
+var CreateOrderRequest;
+(function (CreateOrderRequest) {
+    CreateOrderRequest.PaymentTerms = {
+        DueOnReceipt: "DueOnReceipt",
+        Net15: "Net15",
+        Net30: "Net30",
+        Net45: "Net45",
+        Net60: "Net60",
+        Net90: "Net90",
+    };
+})(CreateOrderRequest || (exports.CreateOrderRequest = CreateOrderRequest = {}));

package/dist/cjs/api/resources/orders/client/requests/ProvisionRequest.d.ts

@@ -0,0 +1,82 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         "idempotency-key": "deal_88213-2026-09-30T14:05:00Z",
+ *         externalReference: {
+ *             source: "standard",
+ *             metadata: {
+ *                 "crmDealId": "deal_88213",
+ *                 "crmAccountId": "acct_4410"
+ *             }
+ *         },
+ *         customer: {
+ *             externalId: "acct_4410",
+ *             name: "Northwind Logistics",
+ *             email: "billing@northwind.example",
+ *             billingAddress: {
+ *                 line1: "200 Harbor Way",
+ *                 city: "Seattle",
+ *                 state: "WA",
+ *                 zipCode: "98101",
+ *                 country: "US"
+ *             }
+ *         },
+ *         order: {
+ *             externalId: "deal_88213",
+ *             name: "Northwind Logistics - Growth plan",
+ *             currency: "USD",
+ *             startDate: "2026-10-01T00:00:00.000Z",
+ *             lines: [{
+ *                     externalId: "deal_88213_platform",
+ *                     startDate: "2026-10-01T00:00:00.000Z",
+ *                     product: {
+ *                         externalId: "growth_plan",
+ *                         name: "Growth plan",
+ *                         attributes: [{
+ *                                 name: "Platform fee",
+ *                                 pricing: {
+ *                                     chargeType: "recurring",
+ *                                     pricingModel: "perUnit",
+ *                                     billingFrequency: "monthly",
+ *                                     billingType: "advance",
+ *                                     pricePoints: {
+ *                                         currency: "USD",
+ *                                         unitPrice: 49900
+ *                                     }
+ *                                 }
+ *                             }]
+ *                     }
+ *                 }, {
+ *                     externalId: "deal_88213_launch_discount",
+ *                     lineType: "CREDIT",
+ *                     startDate: "2026-10-01T00:00:00.000Z",
+ *                     endDate: "2027-01-01T00:00:00.000Z",
+ *                     product: {
+ *                         externalId: "launch_discount",
+ *                         name: "Launch discount",
+ *                         attributes: [{
+ *                                 name: "Launch discount",
+ *                                 pricing: {
+ *                                     chargeType: "recurring",
+ *                                     pricingModel: "perUnit",
+ *                                     billingFrequency: "monthly",
+ *                                     billingType: "advance",
+ *                                     pricePoints: {
+ *                                         currency: "USD",
+ *                                         unitPrice: 10000
+ *                                     }
+ *                                 }
+ *                             }]
+ *                     }
+ *                 }]
+ *         }
+ *     }
+ */
+export interface ProvisionRequest {
+    "idempotency-key": string;
+    externalReference: Paid.ProvisionExternalReference;
+    customer: Paid.ProvisionCustomer;
+    contact?: Paid.ProvisionContact;
+    order: Paid.ProvisionOrder;
+}

package/dist/cjs/api/resources/orders/client/requests/ProvisionRequest.js

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

package/dist/cjs/api/resources/orders/client/requests/UpdateOrderRequest.d.ts

@@ -14,7 +14,7 @@ export interface UpdateOrderRequest {
     creationState?: Paid.OrderCreationState;
     /** Day of month for billing anchor (1-31). Defaults to start date day if not provided. */
     billingAnchor?: number;
-    paymentTerms?: string;
+    paymentTerms?: UpdateOrderRequest.PaymentTerms;
     externalId?: string;
     metadata?: Record<string, unknown>;
     billingCustomerId?: string;
@@ -25,3 +25,14 @@ export interface UpdateOrderRequest {
     /** Purchase order number printed on invoices generated from this order. */
     purchaseOrderReference?: string | null;
 }
+export declare namespace UpdateOrderRequest {
+    const PaymentTerms: {
+        readonly DueOnReceipt: "DueOnReceipt";
+        readonly Net15: "Net15";
+        readonly Net30: "Net30";
+        readonly Net45: "Net45";
+        readonly Net60: "Net60";
+        readonly Net90: "Net90";
+    };
+    type PaymentTerms = (typeof PaymentTerms)[keyof typeof PaymentTerms];
+}

package/dist/cjs/api/resources/orders/client/requests/UpdateOrderRequest.js

@@ -1,3 +1,15 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateOrderRequest = void 0;
+var UpdateOrderRequest;
+(function (UpdateOrderRequest) {
+    UpdateOrderRequest.PaymentTerms = {
+        DueOnReceipt: "DueOnReceipt",
+        Net15: "Net15",
+        Net30: "Net30",
+        Net45: "Net45",
+        Net60: "Net60",
+        Net90: "Net90",
+    };
+})(UpdateOrderRequest || (exports.UpdateOrderRequest = UpdateOrderRequest = {}));

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

@@ -6,5 +6,6 @@ export type { GetOrderByIdRequest } from "./GetOrderByIdRequest.js";
 export type { GetOrderLinesRequest } from "./GetOrderLinesRequest.js";
 export type { ListOrderSeatsRequest } from "./ListOrderSeatsRequest.js";
 export type { ListOrdersRequest } from "./ListOrdersRequest.js";
+export type { ProvisionRequest } from "./ProvisionRequest.js";
 export type { UpdateOrderRequest } from "./UpdateOrderRequest.js";
 export type { UpdateSeatAssignmentRequest } from "./UpdateSeatAssignmentRequest.js";

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

@@ -30,7 +30,7 @@ export declare class PaymentAllocations {
     listPaymentAllocations(request?: Paid.ListPaymentAllocationsRequest, requestOptions?: PaymentAllocations.RequestOptions): core.HttpResponsePromise<Paid.PaymentAllocationListResponse>;
     private __listPaymentAllocations;
     /**
-     * Allocates a payment across one or more invoice lines. When an invoice becomes fully paid, its credit entitlements are processed.
+     * Allocates a payment across one or more invoice lines of posted invoices, in the payment's currency. When an invoice becomes fully paid, its credit entitlements are processed. Returns 409 when a concurrent allocation has already spent the balance.
      *
      * @param {Paid.CreatePaymentAllocationRequest} request
      * @param {PaymentAllocations.RequestOptions} requestOptions - Request-specific configuration.
@@ -38,6 +38,7 @@ export declare class PaymentAllocations {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example

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

@@ -139,7 +139,7 @@ class PaymentAllocations {
         });
     }
     /**
-     * Allocates a payment across one or more invoice lines. When an invoice becomes fully paid, its credit entitlements are processed.
+     * Allocates a payment across one or more invoice lines of posted invoices, in the payment's currency. When an invoice becomes fully paid, its credit entitlements are processed. Returns 409 when a concurrent allocation has already spent the balance.
      *
      * @param {Paid.CreatePaymentAllocationRequest} request
      * @param {PaymentAllocations.RequestOptions} requestOptions - Request-specific configuration.
@@ -147,6 +147,7 @@ class PaymentAllocations {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -188,6 +189,8 @@ class PaymentAllocations {
                         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/payments/client/requests/CreatePaymentRequest.d.ts

@@ -14,7 +14,7 @@ export interface CreatePaymentRequest {
     externalCustomerId?: string;
     /** Payment amount in cents (minor currency units). */
     amount: number;
-    /** Three-letter ISO currency code. */
+    /** Three-letter ISO 4217 currency code. Lowercase is accepted and stored upper-cased. */
     currency: string;
     /** When the payment was made (ISO 8601). Defaults to the current time. */
     paymentDate?: string;

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

@@ -48,7 +48,25 @@ export declare class Signals {
     getSignalById(request: Paid.GetSignalByIdRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalListItem>;
     private __getSignalById;
     /**
-     * Create multiple signals (usage events) in a single request. Each signal must include a customer attribution (either customerId or externalCustomerId) and a product attribution (either productId or externalProductId).
+     * Fetch up to 500 ingested signals (usage events) by ID in one request, each with the data payload submitted at ingest. Use it to resolve the `signalId` values on a page of credit transactions, or the signals behind one run or ticket, instead of calling `GET /api/v2/signals/{id}` once per signal. Signals are returned in request order; IDs that match nothing in your organization are listed under `notFound` rather than failing the request. This is a read-only operation: it requires the `read:usage` scope and is not available to customer API keys.
+     *
+     * @param {Paid.SignalLookupRequest} request
+     * @param {Signals.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.signals.getSignalsByIds({
+     *         ids: ["6890b0e2a6f2c30012f0a1b3", "6890b0e2a6f2c30012f0a1b4"]
+     *     })
+     */
+    getSignalsByIds(request: Paid.SignalLookupRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalLookupResponse>;
+    private __getSignalsByIds;
+    /**
+     * Create multiple signals (usage events) in a single request. Each signal names its customer (`customerId` or `externalCustomerId`; an alias of the customer resolves too), its customer unit (`externalCustomerUnitId`: the unit's key, or an alias that points at a unit), or both, plus an optional product attribution (`productId` or `externalProductId`). A unit alone derives the customer from the unit. A unit sent with a customer must belong to it, else the batch is refused with `400 CUSTOMER_UNIT_MISMATCH`. A unit is never named by Paid's unit id. A key or alias that matches nothing is stored without a customer, keeping the id, so it can be pointed at a unit later. An identifier is matched as a unit key first, then a customer external id, then an alias. Unit attribution is enabled per organization: where it is not, a `customerUnit` sent next to a `customer` is accepted and ignored rather than checked, as before, while a unit named alone still derives its customer. Authenticate with your organization API key, or with a customer API key (prefixed `paid_ck_live_` or `paid_ck_test_`, created with `POST /api/v2/customers/{id}/api-keys`) so a customer's own runtime can report its usage without holding your organization key. A customer API key can call this endpoint only, and only for its own customer: if any signal names another customer, or one Paid does not know, the whole batch is refused with `403` `CUSTOMER_MISMATCH` and nothing is stored. Its idempotency keys are scoped to that customer. See [Send signals with a customer API key](/documentation/signals/send-signals-with-a-customer-api-key).
      *
      * @param {Paid.BulkSignalsRequest} request
      * @param {Signals.RequestOptions} requestOptions - Request-specific configuration.
@@ -61,14 +79,129 @@ export declare class Signals {
      * @example
      *     await client.signals.createSignals({
      *         signals: [{
-     *                 eventName: "eventName",
+     *                 eventName: "email_sent",
      *                 customer: {
-     *                     customerId: "customerId"
-     *                 }
+     *                     externalCustomerId: "acme-corp"
+     *                 },
+     *                 attribution: {
+     *                     externalProductId: "email-agent"
+     *                 },
+     *                 timestamp: "2026-01-31T23:00:00Z",
+     *                 data: {
+     *                     "recipients": 3
+     *                 },
+     *                 idempotencyKey: "email_sent_msg_8f3a2c"
+     *             }, {
+     *                 eventName: "email_sent",
+     *                 customerUnit: {
+     *                     externalCustomerUnitId: "acme-marketing"
+     *                 },
+     *                 idempotencyKey: "email_sent_msg_9b41d7"
      *             }]
      *     })
      */
     createSignals(request: Paid.BulkSignalsRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.BulkSignalsResponse>;
     private __createSignals;
+    /**
+     * Produces a usage summary file: one row per customer per month, with columns broken down by the signal payload fields you name. Choose `format` to get JSON or a wide CSV; JSON is the default. The export runs in the background, so this returns immediately with a pending export and the file appears on it once it succeeds. Give `spec` to describe the columns, or `copyFrom` with an earlier export's id to reuse that export's columns over a new window. The spec is stored on the export, so an old file can always be explained by the export that produced it. Signals are bucketed by month in UTC on their effective timestamp, the same basis billing uses, so the totals reconcile with invoices. One export runs per organization at a time.
+     *
+     * @param {Paid.CreateSignalSummaryExportRequest} request
+     * @param {Signals.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.signals.createSignalSummaryExport({
+     *         spec: {
+     *             name: "Monthly workflow usage",
+     *             signalNames: [{
+     *                     name: "workflow_run",
+     *                     group: "Workflow runs",
+     *                     slug: "runs"
+     *                 }],
+     *             dimensions: [{
+     *                     kind: "bands",
+     *                     path: "steps",
+     *                     appliesTo: ["workflow_run"],
+     *                     brackets: [{
+     *                             from: 1,
+     *                             upTo: 10,
+     *                             slug: "1_10_steps",
+     *                             group: "1-10 steps"
+     *                         }, {
+     *                             upTo: null,
+     *                             slug: "11_plus_steps",
+     *                             group: "11+ steps"
+     *                         }]
+     *                 }],
+     *             measures: [{
+     *                     fn: "count"
+     *                 }]
+     *         },
+     *         from: "2026-01-01",
+     *         to: "2026-04-01",
+     *         format: "csv"
+     *     })
+     */
+    createSignalSummaryExport(request: Paid.CreateSignalSummaryExportRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalSummaryExport>;
+    private __createSignalSummaryExport;
+    /**
+     * Returns one export with its status and the shape it ran. While it is succeeded and unexpired, each read issues a fresh short-lived download link.
+     *
+     * @param {Paid.GetSignalSummaryExportRequest} request
+     * @param {Signals.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.signals.getSignalSummaryExport({
+     *         id: "sse_5pZa1Kd8Nqx"
+     *     })
+     */
+    getSignalSummaryExport(request: Paid.GetSignalSummaryExportRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalSummaryExport>;
+    private __getSignalSummaryExport;
+    /**
+     * Counts signals into period buckets. Use it to chart signal volume over time, split by signal name or by a signal-payload key such as team_id.
+     *
+     * Signals count against their effective timestamp in UTC. This is the same basis billing uses, so these figures reconcile with an invoice.
+     *
+     * The endpoint reads a pre-aggregated hourly rollup, not the raw signals. An hour is therefore the finest interval. One request may span at most 250 periods.
+     *
+     * A grouped request keeps the 100 groups with the most signals. It sums the rest under the key "other". Each period total stays complete, but a group inside "other" loses its own figure. Read groups.truncated to learn how many groups lost it. Zero means every group kept its own figure.
+     *
+     * Results are paged with limit and cursor. A page is never truncated in silence.
+     *
+     * To download the series as a file, call this endpoint over HTTP with format=csv. It returns the same points as a text/csv table with a single header row. A CSV cannot carry a cursor, so a result that does not fit one page returns 400 rather than a file that is missing rows.
+     *
+     * For a wide per-customer spreadsheet over arbitrary payload fields, use the batch export at /signals/summary/batch instead.
+     *
+     * @param {Paid.GetSignalSummaryRequest} request
+     * @param {Signals.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.signals.getSignalSummary({
+     *         startDate: "2026-08-01",
+     *         endDate: "2026-08-31",
+     *         interval: "day",
+     *         groupBy: "signalName",
+     *         limit: 1000
+     *     })
+     */
+    getSignalSummary(request: Paid.GetSignalSummaryRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalSummaryResponse>;
+    private __getSignalSummary;
     protected _getAuthorizationHeader(): Promise<string>;
 }