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

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

@@ -59,6 +59,8 @@ class Agents {
         this._options = _options;
     }
     /**
+     * DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+     *
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -106,6 +108,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use POST /products instead.
+     *
      * @param {Paid.AgentCreate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -161,6 +165,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use GET /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -209,6 +215,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use PUT /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -290,6 +298,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use DELETE /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -338,6 +348,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use GET /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -386,6 +398,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use PUT /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -456,6 +470,8 @@ class Agents {
         });
     }
     /**
+     * DEPRECATED: Use DELETE /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -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/cjs/api/resources/customers/client/Client.js

@@ -516,6 +516,170 @@ 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: (0, url_join_1.default)((_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: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.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: (0, url_join_1.default)((_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: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.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/cjs/api/resources/customers/client/requests/CustomerCreate.d.ts

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

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

@@ -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/cjs/api/resources/customers/client/requests/CustomersGetUsageByExternalIdRequest.js

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

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

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

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

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

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

@@ -36,14 +36,21 @@ 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 });
-exports.usage = exports.orders = exports.contacts = exports.agents = exports.customers = void 0;
+exports.traces = exports.plans = exports.orders = exports.contacts = exports.products = exports.agents = exports.customers = exports.usage = void 0;
+exports.usage = __importStar(require("./usage/index.js"));
+__exportStar(require("./usage/types/index.js"), exports);
 exports.customers = __importStar(require("./customers/index.js"));
 exports.agents = __importStar(require("./agents/index.js"));
+exports.products = __importStar(require("./products/index.js"));
 exports.contacts = __importStar(require("./contacts/index.js"));
 exports.orders = __importStar(require("./orders/index.js"));
-exports.usage = __importStar(require("./usage/index.js"));
+exports.plans = __importStar(require("./plans/index.js"));
+exports.traces = __importStar(require("./traces/index.js"));
 __exportStar(require("./customers/client/requests/index.js"), exports);
 __exportStar(require("./agents/client/requests/index.js"), exports);
+__exportStar(require("./products/client/requests/index.js"), exports);
 __exportStar(require("./contacts/client/requests/index.js"), exports);
 __exportStar(require("./orders/client/requests/index.js"), exports);
+__exportStar(require("./plans/client/requests/index.js"), exports);
 __exportStar(require("./usage/client/requests/index.js"), exports);
+__exportStar(require("./traces/client/requests/index.js"), exports);

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

@@ -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/cjs/api/resources/orders/resources/lines/client/Client.d.ts

@@ -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/cjs/api/resources/orders/resources/lines/client/Client.js

@@ -66,11 +66,9 @@ 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/cjs/api/resources/orders/resources/lines/client/requests/LinesUpdateRequest.d.ts

@@ -6,11 +6,9 @@ import * as Paid from "../../../../../../index.js";
  * @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/cjs/api/resources/plans/client/Client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.js";
+import * as core from "../../../../core/index.js";
+import * as Paid from "../../../index.js";
+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>;
+}