@paid-ai/paid-node 0.5.0-alpha3 → 0.5.0

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

@@ -28,6 +28,8 @@ export declare class Agents {
     protected readonly _options: Agents.Options;
     constructor(_options?: Agents.Options);
     /**
+     * DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+     *
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -36,6 +38,8 @@ export declare class Agents {
     list(requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent[]>;
     private __list;
     /**
+     * DEPRECATED: Use POST /products instead.
+     *
      * @param {Paid.AgentCreate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -49,6 +53,8 @@ export declare class Agents {
     create(request: Paid.AgentCreate, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __create;
     /**
+     * DEPRECATED: Use GET /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -58,6 +64,8 @@ export declare class Agents {
     get(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __get;
     /**
+     * DEPRECATED: Use PUT /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -97,6 +105,8 @@ export declare class Agents {
     update(agentId: string, request: Paid.AgentUpdate, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __update;
     /**
+     * DEPRECATED: Use DELETE /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -106,6 +116,8 @@ export declare class Agents {
     delete(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
+     * DEPRECATED: Use GET /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -115,6 +127,8 @@ export declare class Agents {
     getByExternalId(externalId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __getByExternalId;
     /**
+     * DEPRECATED: Use PUT /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -143,6 +157,8 @@ export declare class Agents {
     updateByExternalId(externalId: string, request: Paid.AgentUpdate, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __updateByExternalId;
     /**
+     * DEPRECATED: Use DELETE /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -20,6 +20,8 @@ export class Agents {
         this._options = _options;
     }
     /**
+     * DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+     *
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -67,6 +69,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use POST /products instead.
+     *
      * @param {Paid.AgentCreate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -122,6 +126,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use GET /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -170,6 +176,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use PUT /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -251,6 +259,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use DELETE /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -299,6 +309,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use GET /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -347,6 +359,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use PUT /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -417,6 +431,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use DELETE /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -119,5 +119,43 @@ export declare class Customers {
      */
     deleteByExternalId(externalId: string, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteByExternalId;
+    /**
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersGetCostsByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.getCostsByExternalId("externalId", {
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getCostsByExternalId(externalId: string, request?: Paid.CustomersGetCostsByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CostTracesResponse>;
+    private __getCostsByExternalId;
+    /**
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersGetUsageByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.getUsageByExternalId("externalId", {
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getUsageByExternalId(externalId: string, request?: Paid.CustomersGetUsageByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.UsageSummariesResponse>;
+    private __getUsageByExternalId;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -477,6 +477,170 @@ export class Customers {
             }
         });
     }
+    /**
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersGetCostsByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.getCostsByExternalId("externalId", {
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getCostsByExternalId(externalId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getCostsByExternalId(externalId, request, requestOptions));
+    }
+    __getCostsByExternalId(externalId_1) {
+        return __awaiter(this, arguments, void 0, function* (externalId, request = {}, requestOptions) {
+            var _a, _b, _c;
+            const { limit, offset, startTime, endTime } = request;
+            const _queryParams = {};
+            if (limit != null) {
+                _queryParams["limit"] = limit.toString();
+            }
+            if (offset != null) {
+                _queryParams["offset"] = offset.toString();
+            }
+            if (startTime != null) {
+                _queryParams["startTime"] = startTime;
+            }
+            if (endTime != null) {
+                _queryParams["endTime"] = endTime;
+            }
+            const _response = yield core.fetcher({
+                url: urlJoin((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.PaidEnvironment.Production, `customers/external/${encodeURIComponent(externalId)}/costs`),
+                method: "GET",
+                headers: mergeHeaders((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                queryParameters: _queryParams,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.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);
+                    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 /customers/external/{externalId}/costs.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersGetUsageByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.getUsageByExternalId("externalId", {
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getUsageByExternalId(externalId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getUsageByExternalId(externalId, request, requestOptions));
+    }
+    __getUsageByExternalId(externalId_1) {
+        return __awaiter(this, arguments, void 0, function* (externalId, request = {}, requestOptions) {
+            var _a, _b, _c;
+            const { limit, offset, startTime, endTime } = request;
+            const _queryParams = {};
+            if (limit != null) {
+                _queryParams["limit"] = limit.toString();
+            }
+            if (offset != null) {
+                _queryParams["offset"] = offset.toString();
+            }
+            if (startTime != null) {
+                _queryParams["startTime"] = startTime;
+            }
+            if (endTime != null) {
+                _queryParams["endTime"] = endTime;
+            }
+            const _response = yield core.fetcher({
+                url: urlJoin((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.PaidEnvironment.Production, `customers/external/${encodeURIComponent(externalId)}/usage`),
+                method: "GET",
+                headers: mergeHeaders((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                queryParameters: _queryParams,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.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);
+                    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 /customers/external/{externalId}/usage.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             const bearer = yield core.Supplier.get(this._options.token);

package/dist/esm/api/resources/customers/client/requests/CustomerCreate.d.mts

@@ -19,4 +19,6 @@ export interface CustomerCreate {
     creationSource?: Paid.CreationSource;
     website?: string;
     billingAddress?: Paid.Address;
+    /** Flexible JSON field for storing custom metadata about the customer */
+    metadata?: Record<string, unknown>;
 }

package/dist/esm/api/resources/customers/client/requests/CustomersGetCostsByExternalIdRequest.d.mts

@@ -0,0 +1,30 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         limit: 1,
+ *         offset: 1,
+ *         startTime: "2024-01-15T09:30:00Z",
+ *         endTime: "2024-01-15T09:30:00Z"
+ *     }
+ */
+export interface CustomersGetCostsByExternalIdRequest {
+    /**
+     * Maximum number of traces to return (1-1000)
+     */
+    limit?: number;
+    /**
+     * Number of traces to skip for pagination
+     */
+    offset?: number;
+    /**
+     * Filter traces starting from this time (ISO 8601 format)
+     */
+    startTime?: string;
+    /**
+     * Filter traces up to this time (ISO 8601 format)
+     */
+    endTime?: string;
+}

package/dist/esm/api/resources/customers/client/requests/CustomersGetUsageByExternalIdRequest.d.mts

@@ -0,0 +1,30 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         limit: 1,
+ *         offset: 1,
+ *         startTime: "2024-01-15T09:30:00Z",
+ *         endTime: "2024-01-15T09:30:00Z"
+ *     }
+ */
+export interface CustomersGetUsageByExternalIdRequest {
+    /**
+     * Maximum number of usage summaries to return (1-1000)
+     */
+    limit?: number;
+    /**
+     * Number of usage summaries to skip for pagination
+     */
+    offset?: number;
+    /**
+     * Filter usage summaries starting from this time (ISO 8601 format). Returns summaries that overlap with the time range.
+     */
+    startTime?: string;
+    /**
+     * Filter usage summaries up to this time (ISO 8601 format). Returns summaries that overlap with the time range.
+     */
+    endTime?: string;
+}

package/dist/esm/api/resources/customers/client/requests/CustomersGetUsageByExternalIdRequest.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

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

@@ -1 +1,3 @@
 export { type CustomerCreate } from "./CustomerCreate.mjs";
+export { type CustomersGetCostsByExternalIdRequest } from "./CustomersGetCostsByExternalIdRequest.mjs";
+export { type CustomersGetUsageByExternalIdRequest } from "./CustomersGetUsageByExternalIdRequest.mjs";

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

@@ -1,10 +1,17 @@
+export * as usage from "./usage/index.mjs";
+export * from "./usage/types/index.mjs";
 export * as customers from "./customers/index.mjs";
 export * as agents from "./agents/index.mjs";
+export * as products from "./products/index.mjs";
 export * as contacts from "./contacts/index.mjs";
 export * as orders from "./orders/index.mjs";
-export * as usage from "./usage/index.mjs";
+export * as plans from "./plans/index.mjs";
+export * as traces from "./traces/index.mjs";
 export * from "./customers/client/requests/index.mjs";
 export * from "./agents/client/requests/index.mjs";
+export * from "./products/client/requests/index.mjs";
 export * from "./contacts/client/requests/index.mjs";
 export * from "./orders/client/requests/index.mjs";
+export * from "./plans/client/requests/index.mjs";
 export * from "./usage/client/requests/index.mjs";
+export * from "./traces/client/requests/index.mjs";

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

@@ -1,10 +1,17 @@
+export * as usage from "./usage/index.mjs";
+export * from "./usage/types/index.mjs";
 export * as customers from "./customers/index.mjs";
 export * as agents from "./agents/index.mjs";
+export * as products from "./products/index.mjs";
 export * as contacts from "./contacts/index.mjs";
 export * as orders from "./orders/index.mjs";
-export * as usage from "./usage/index.mjs";
+export * as plans from "./plans/index.mjs";
+export * as traces from "./traces/index.mjs";
 export * from "./customers/client/requests/index.mjs";
 export * from "./agents/client/requests/index.mjs";
+export * from "./products/client/requests/index.mjs";
 export * from "./contacts/client/requests/index.mjs";
 export * from "./orders/client/requests/index.mjs";
+export * from "./plans/client/requests/index.mjs";
 export * from "./usage/client/requests/index.mjs";
+export * from "./traces/client/requests/index.mjs";

package/dist/esm/api/resources/orders/client/requests/OrderCreate.d.mts

@@ -32,5 +32,7 @@ export interface OrderCreate {
     startDate: string;
     endDate?: string;
     currency: string;
+    /** Optional plan ID to associate with this order */
+    planId?: string;
     orderLines?: Paid.OrderLineCreate[];
 }

package/dist/esm/api/resources/orders/resources/lines/client/Client.d.mts

@@ -35,11 +35,9 @@ export declare class Lines {
      * @example
      *     await client.orders.lines.update("orderId", {
      *         lines: [{
-     *                 agentExternalId: "acme-agent",
      *                 name: "Order Line One",
      *                 description: "Order Line One is an order line for Acme, Inc."
      *             }, {
-     *                 agentExternalId: "acme-agent-2",
      *                 name: "Order Line Two",
      *                 description: "Order Line Two is an order line for Acme, Inc."
      *             }]

package/dist/esm/api/resources/orders/resources/lines/client/Client.mjs

@@ -27,11 +27,9 @@ export class Lines {
      * @example
      *     await client.orders.lines.update("orderId", {
      *         lines: [{
-     *                 agentExternalId: "acme-agent",
      *                 name: "Order Line One",
      *                 description: "Order Line One is an order line for Acme, Inc."
      *             }, {
-     *                 agentExternalId: "acme-agent-2",
      *                 name: "Order Line Two",
      *                 description: "Order Line Two is an order line for Acme, Inc."
      *             }]

package/dist/esm/api/resources/orders/resources/lines/client/requests/LinesUpdateRequest.d.mts

@@ -6,11 +6,9 @@ import * as Paid from "../../../../../../index.mjs";
  * @example
  *     {
  *         lines: [{
- *                 agentExternalId: "acme-agent",
  *                 name: "Order Line One",
  *                 description: "Order Line One is an order line for Acme, Inc."
  *             }, {
- *                 agentExternalId: "acme-agent-2",
  *                 name: "Order Line Two",
  *                 description: "Order Line Two is an order line for Acme, Inc."
  *             }]

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

@@ -0,0 +1,75 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Paid from "../../../index.mjs";
+export declare namespace Plans {
+    interface Options {
+        environment?: core.Supplier<environments.PaidEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token?: core.Supplier<core.BearerToken | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class Plans {
+    protected readonly _options: Plans.Options;
+    constructor(_options?: Plans.Options);
+    /**
+     * @param {string} planId - The ID of the plan
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.getById("planId")
+     */
+    getById(planId: string, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.Plan>;
+    private __getById;
+    /**
+     * @param {string} planId - The ID of the plan
+     * @param {Paid.PlansGetUsageRequest} request
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.getUsage("planId", {
+     *         externalId: "externalId",
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getUsage(planId: string, request: Paid.PlansGetUsageRequest, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.UsageSummariesResponse>;
+    private __getUsage;
+    /**
+     * @param {string} planGroupId - The ID of the plan group
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.getGroupById("planGroupId")
+     */
+    getGroupById(planGroupId: string, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.PlanGroup>;
+    private __getGroupById;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}