@paid-ai/paid-node 1.7.1 → 2.0.0

package/dist/cjs/api/resources/plans/client/requests/GetPlanByIdRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface GetPlanByIdRequest {
+    id: string;
+}

package/dist/cjs/api/resources/plans/client/requests/GetPlanByIdRequest.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/plans/client/requests/ListPlansRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListPlansRequest {
+    limit?: number;
+    offset?: number;
+    productId?: string;
+    externalProductId?: string;
+    /** Whether to include archived plans in the response. Defaults to true. */
+    includeArchived?: boolean;
+}

package/dist/cjs/api/resources/plans/client/requests/ListPlansRequest.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/plans/client/requests/UpdatePlanByExternalIdRequest.d.ts

@@ -0,0 +1,12 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         externalId: "externalId",
+ *         body: {}
+ *     }
+ */
+export interface UpdatePlanByExternalIdRequest {
+    externalId: string;
+    body: Paid.UpdatePlanRequest;
+}

package/dist/cjs/api/resources/plans/client/requests/UpdatePlanByExternalIdRequest.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/plans/client/requests/UpdatePlanByIdRequest.d.ts

@@ -0,0 +1,12 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id",
+ *         body: {}
+ *     }
+ */
+export interface UpdatePlanByIdRequest {
+    id: string;
+    body: Paid.UpdatePlanRequest;
+}

package/dist/cjs/api/resources/plans/client/requests/UpdatePlanByIdRequest.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/plans/client/requests/UpdatePlanUpgradePathRequest.d.ts

@@ -0,0 +1,15 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         productId: "productId",
+ *         groups: [{
+ *                 planIds: ["planIds"]
+ *             }]
+ *     }
+ */
+export interface UpdatePlanUpgradePathRequest {
+    /** Paid product ID, for example `prod_abc123` */
+    productId: string;
+    groups: Paid.PlanUpgradePathGroup[];
+}

package/dist/cjs/api/resources/plans/client/requests/UpdatePlanUpgradePathRequest.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/plans/client/requests/index.d.ts

@@ -0,0 +1,7 @@
+export type { CreatePlanRequest } from "./CreatePlanRequest.js";
+export type { GetPlanByExternalIdRequest } from "./GetPlanByExternalIdRequest.js";
+export type { GetPlanByIdRequest } from "./GetPlanByIdRequest.js";
+export type { ListPlansRequest } from "./ListPlansRequest.js";
+export type { UpdatePlanByExternalIdRequest } from "./UpdatePlanByExternalIdRequest.js";
+export type { UpdatePlanByIdRequest } from "./UpdatePlanByIdRequest.js";
+export type { UpdatePlanUpgradePathRequest } from "./UpdatePlanUpgradePathRequest.js";

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

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

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

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

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

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

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

@@ -43,7 +43,7 @@ export declare class Pricing {
     getPricing(request: Paid.GetPricingRequest, requestOptions?: Pricing.RequestOptions): core.HttpResponsePromise<Paid.PricingResponse>;
     private __getPricing;
     /**
-     * Updates pricing on an existing product attribute. If creditBenefits is provided, it fully replaces existing benefits. If omitted, existing benefits are preserved.
+     * Updates pricing on an existing product attribute. To create a new attribute, use the update product endpoint (updateProductById), which upserts productAttributes. If creditBenefits is provided, it fully replaces existing benefits. If omitted, existing benefits are preserved.
      *
      * @param {Paid.UpdatePricingRequest} request
      * @param {Pricing.RequestOptions} requestOptions - Request-specific configuration.
@@ -60,7 +60,7 @@ export declare class Pricing {
      *             billingFrequency: "Monthly",
      *             pricePoints: [{
      *                     currency: "currency",
-     *                     unitPrice: 1.1
+     *                     unitPrice: 1
      *                 }]
      *         }
      *     })

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

@@ -197,7 +197,7 @@ class Pricing {
         });
     }
     /**
-     * Updates pricing on an existing product attribute. If creditBenefits is provided, it fully replaces existing benefits. If omitted, existing benefits are preserved.
+     * Updates pricing on an existing product attribute. To create a new attribute, use the update product endpoint (updateProductById), which upserts productAttributes. If creditBenefits is provided, it fully replaces existing benefits. If omitted, existing benefits are preserved.
      *
      * @param {Paid.UpdatePricingRequest} request
      * @param {Pricing.RequestOptions} requestOptions - Request-specific configuration.
@@ -214,7 +214,7 @@ class Pricing {
      *             billingFrequency: "Monthly",
      *             pricePoints: [{
      *                     currency: "currency",
-     *                     unitPrice: 1.1
+     *                     unitPrice: 1
      *                 }]
      *         }
      *     })

package/dist/cjs/api/resources/pricing/client/requests/UpdatePricingRequest.d.ts

@@ -8,7 +8,7 @@ import type * as Paid from "../../../../index.js";
  *             billingFrequency: "Monthly",
  *             pricePoints: [{
  *                     currency: "currency",
- *                     unitPrice: 1.1
+ *                     unitPrice: 1
  *                 }]
  *         }
  *     }

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

@@ -26,7 +26,7 @@ export declare class Products {
     listProducts(request?: Paid.ListProductsRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.ProductListResponse>;
     private __listProducts;
     /**
-     * Creates a new product for the organization
+     * Creates a new product for the organization. Products are created without pricing: to create product attributes and set their pricing, call the update product endpoint (updateProductById / updateProductByExternalId), which upserts productAttributes.
      *
      * @param {Paid.CreateProductRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -43,7 +43,7 @@ export declare class Products {
     createProduct(request: Paid.CreateProductRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.Product>;
     private __createProduct;
     /**
-     * Get a product by ID
+     * Get a product by ID, including its product attributes with pricing details
      *
      * @param {Paid.GetProductByIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -57,10 +57,10 @@ export declare class Products {
      *         id: "id"
      *     })
      */
-    getProductById(request: Paid.GetProductByIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.Product>;
+    getProductById(request: Paid.GetProductByIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.ProductDetail>;
     private __getProductById;
     /**
-     * Update a product by ID
+     * Update a product by ID. Also creates and edits product attributes: productAttributes upserts attributes and sets their pricing (metering event, price points, credit brackets). This is the endpoint to use to add pricing to a product created without any.
      *
      * @param {Paid.UpdateProductByIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -76,10 +76,10 @@ export declare class Products {
      *         body: {}
      *     })
      */
-    updateProductById(request: Paid.UpdateProductByIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.Product>;
+    updateProductById(request: Paid.UpdateProductByIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.ProductDetail>;
     private __updateProductById;
     /**
-     * Get a product by external ID
+     * Get a product by external ID, including its product attributes with pricing details
      *
      * @param {Paid.GetProductByExternalIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -93,10 +93,10 @@ export declare class Products {
      *         externalId: "externalId"
      *     })
      */
-    getProductByExternalId(request: Paid.GetProductByExternalIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.Product>;
+    getProductByExternalId(request: Paid.GetProductByExternalIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.ProductDetail>;
     private __getProductByExternalId;
     /**
-     * Update a product by external ID
+     * Update a product by external ID. Also creates and edits product attributes: productAttributes upserts attributes and sets their pricing (metering event, price points, credit brackets). This is the endpoint to use to add pricing to a product created without any.
      *
      * @param {Paid.UpdateProductByExternalIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -112,7 +112,7 @@ export declare class Products {
      *         body: {}
      *     })
      */
-    updateProductByExternalId(request: Paid.UpdateProductByExternalIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.Product>;
+    updateProductByExternalId(request: Paid.UpdateProductByExternalIdRequest, requestOptions?: Products.RequestOptions): core.HttpResponsePromise<Paid.ProductDetail>;
     private __updateProductByExternalId;
     protected _getAuthorizationHeader(): Promise<string>;
 }

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

@@ -72,7 +72,7 @@ class Products {
     __listProducts() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h;
-            const { limit, offset } = request;
+            const { limit, offset, name, active, archived } = request;
             const _queryParams = {};
             if (limit != null) {
                 _queryParams.limit = limit.toString();
@@ -80,6 +80,15 @@ class Products {
             if (offset != null) {
                 _queryParams.offset = offset.toString();
             }
+            if (name != null) {
+                _queryParams.name = name;
+            }
+            if (active != null) {
+                _queryParams.active = active.toString();
+            }
+            if (archived != null) {
+                _queryParams.archived = archived.toString();
+            }
             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, "products/"),
@@ -127,7 +136,7 @@ class Products {
         });
     }
     /**
-     * Creates a new product for the organization
+     * Creates a new product for the organization. Products are created without pricing: to create product attributes and set their pricing, call the update product endpoint (updateProductById / updateProductByExternalId), which upserts productAttributes.
      *
      * @param {Paid.CreateProductRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -197,7 +206,7 @@ class Products {
         });
     }
     /**
-     * Get a product by ID
+     * Get a product by ID, including its product attributes with pricing details
      *
      * @param {Paid.GetProductByIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -265,7 +274,7 @@ class Products {
         });
     }
     /**
-     * Update a product by ID
+     * Update a product by ID. Also creates and edits product attributes: productAttributes upserts attributes and sets their pricing (metering event, price points, credit brackets). This is the endpoint to use to add pricing to a product created without any.
      *
      * @param {Paid.UpdateProductByIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -340,7 +349,7 @@ class Products {
         });
     }
     /**
-     * Get a product by external ID
+     * Get a product by external ID, including its product attributes with pricing details
      *
      * @param {Paid.GetProductByExternalIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.
@@ -408,7 +417,7 @@ class Products {
         });
     }
     /**
-     * Update a product by external ID
+     * Update a product by external ID. Also creates and edits product attributes: productAttributes upserts attributes and sets their pricing (metering event, price points, credit brackets). This is the endpoint to use to add pricing to a product created without any.
      *
      * @param {Paid.UpdateProductByExternalIdRequest} request
      * @param {Products.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/products/client/requests/ListProductsRequest.d.ts

@@ -5,4 +5,10 @@
 export interface ListProductsRequest {
     limit?: number;
     offset?: number;
+    /** Search by product name (case-insensitive, matches anywhere in the name). */
+    name?: string;
+    /** Filter by the product's active flag: true or false. */
+    active?: boolean;
+    /** Filter by archived state: true returns only archived products, false only non-archived. Omit to include both. */
+    archived?: boolean;
 }

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

@@ -11,26 +11,197 @@ export declare class Signals {
     protected readonly _options: Signals.Options;
     constructor(_options: Signals.Options);
     /**
-     * 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).
+     * Returns ingested signals (usage events) for your organization, newest first. Filter by signal name, customer, product, and creation date range.
+     *
+     * @param {Paid.ListSignalsRequest} request
+     * @param {Signals.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.signals.listSignals()
+     */
+    listSignals(request?: Paid.ListSignalsRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalListResponse>;
+    private __listSignals;
+    /**
+     * Get a single ingested signal (usage event) by its ID, including the data payload submitted at ingest.
+     *
+     * @param {Paid.GetSignalByIdRequest} 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.getSignalById({
+     *         id: "6890b0e2a6f2c30012f0a1b3"
+     *     })
+     */
+    getSignalById(request: Paid.GetSignalByIdRequest, requestOptions?: Signals.RequestOptions): core.HttpResponsePromise<Paid.SignalListItem>;
+    private __getSignalById;
+    /**
+     * 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.
      *
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.TooManyRequestsError}
      * @throws {@link Paid.InternalServerError}
      *
      * @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>;
 }