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

package/dist/cjs/api/types/CostTrace.d.ts

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * A single cost trace record
+ */
+export interface CostTrace {
+    /** The name/type of the operation (e.g., "trace.openai.agents.on_agent") */
+    name: string;
+    /** The vendor/provider (e.g., "openai", "anthropic", "mistral") */
+    vendor: string;
+    /** The model used for the operation (e.g., "gpt-4o-mini", "claude-3-sonnet") */
+    model?: string;
+    cost: Paid.CostAmount;
+    /** Unix timestamp in nanoseconds when the operation started */
+    startTimeUnixNano: string;
+    /** Unix timestamp in nanoseconds when the operation completed */
+    endTimeUnixNano: string;
+    /** Additional metadata about the trace (e.g., tokens, etc.) */
+    attributes: Record<string, unknown>;
+}

package/dist/cjs/api/types/CostTrace.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/types/CostTracesResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * Response containing cost traces and pagination metadata
+ */
+export interface CostTracesResponse {
+    traces: Paid.CostTrace[];
+    meta: Paid.PaginationMeta;
+}

package/dist/cjs/api/types/CostTracesResponse.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/types/Customer.d.ts

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

package/dist/cjs/api/types/CustomerUpdate.d.ts

@@ -12,4 +12,6 @@ export interface CustomerUpdate {
     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/types/OrderLineAttributeCreateOne.d.ts

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type OrderLineAttributeCreateOne = unknown;

package/dist/cjs/api/types/OrderLineAttributeCreateOne.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/types/OrderLineCreate.d.ts

@@ -3,14 +3,20 @@
  */
 import * as Paid from "../index.js";
 export interface OrderLineCreate {
-    /** Paid's internal ID for the agent/product */
+    /** Paid's internal ID for the product */
+    productId?: string;
+    /** The external ID of the product i.e. the id within your system */
+    productExternalId?: string;
+    /** DEPRECATED: Use productId instead. Paid's internal ID for the agent/product */
     agentId?: string;
-    /** The external ID of the agent/product i.e. the id within your system */
+    /** DEPRECATED: Use productExternalId instead. The external ID of the agent/product i.e. the id within your system */
     agentExternalId?: string;
     /** Name of the order line */
     name?: string;
     /** Description of the order line */
     description?: string;
-    /** Optional array of custom agent attributes to override default pricing, allowing per customer pricing. If not provided, attributes will be auto-generated from the product definition. */
-    agentAttributes?: Paid.OrderLineAttributeCreate[];
+    /** Optional array of custom product attributes to override default pricing, allowing per customer pricing. If not provided, attributes will be auto-generated from the product definition. */
+    ProductAttribute?: (Paid.OrderLineAttributeCreateOne | undefined)[];
+    /** DEPRECATED: Use ProductAttribute instead. Optional array of custom agent attributes to override default pricing, allowing per customer pricing. If not provided, attributes will be auto-generated from the product definition. */
+    agentAttributes?: (Paid.OrderLineAttributeCreateOne | undefined)[];
 }

package/dist/cjs/api/types/PaginationMeta.d.ts

@@ -0,0 +1,28 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Pagination metadata for cost traces
+ */
+export interface PaginationMeta {
+    /** The requested limit */
+    limit: number;
+    /** The requested offset */
+    offset: number;
+    /** Number of items returned in this response */
+    count: number;
+    /** Whether there are more results available */
+    hasMore: boolean;
+    /** The startTime filter that was applied (if any) */
+    startTime?: string;
+    /** The endTime filter that was applied (if any) */
+    endTime?: string;
+    /** The externalCustomerId filter that was applied (if any) */
+    externalCustomerId?: string;
+    /** The externalProductId filter that was applied (if any) */
+    externalProductId?: string;
+    /** DEPRECATED: Use externalProductId instead. The externalAgentId filter that was applied (if any) */
+    externalAgentId?: string;
+    /** The metadata filter that was applied (if any) */
+    metadata?: string;
+}

package/dist/cjs/api/types/PaginationMeta.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/types/Plan.d.ts

@@ -0,0 +1,58 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A plan containing products and their attributes
+ */
+export interface Plan {
+    /** The unique identifier of the plan */
+    id: string;
+    /** The organization ID that owns this plan */
+    organizationId: string;
+    /** The plan group ID this plan belongs to */
+    planGroupId: string;
+    /** The name of the plan */
+    name: string;
+    /** The description of the plan */
+    description?: string;
+    /** The ID of the next plan in the sequence */
+    nextPlanId?: string;
+    /** The ID of the previous plan in the sequence */
+    prevPlanId?: string;
+    /** When the plan was created */
+    createdAt: string;
+    /** When the plan was last updated */
+    updatedAt: string;
+    /** The products included in this plan */
+    planProducts?: Plan.PlanProducts.Item[];
+}
+export declare namespace Plan {
+    type PlanProducts = PlanProducts.Item[];
+    namespace PlanProducts {
+        interface Item {
+            id?: string;
+            organizationId?: string;
+            planId?: string;
+            productId?: string;
+            createdAt?: string;
+            updatedAt?: string;
+            /** The product attributes with pricing for this plan */
+            planProductAttribute?: Item.PlanProductAttribute.Item[];
+        }
+        namespace Item {
+            type PlanProductAttribute = PlanProductAttribute.Item[];
+            namespace PlanProductAttribute {
+                interface Item {
+                    id?: string;
+                    organizationId?: string;
+                    planProductId?: string;
+                    productAttributeId?: string;
+                    /** The pricing configuration for this attribute */
+                    pricing?: Record<string, unknown>;
+                    createdAt?: string;
+                    updatedAt?: string;
+                }
+            }
+        }
+    }
+}

package/dist/cjs/api/types/Plan.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/types/PlanGroup.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * A plan group containing multiple plans
+ */
+export interface PlanGroup {
+    /** The unique identifier of the plan group */
+    id: string;
+    /** The organization ID that owns this plan group */
+    organizationId: string;
+    /** The name of the plan group */
+    name: string;
+    /** The description of the plan group */
+    description?: string;
+    /** When the plan group was created */
+    createdAt: string;
+    /** When the plan group was last updated */
+    updatedAt: string;
+    /** The plans included in this plan group */
+    plans?: Paid.Plan[];
+}

package/dist/cjs/api/types/PlanGroup.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/types/Product.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * A product in the Paid system (previously called Agent)
+ */
+export interface Product {
+    id: string;
+    externalId?: string;
+    /** Human-readable display ID */
+    displayId?: string;
+    organizationId: string;
+    name: string;
+    description?: string;
+    /** The type of product */
+    type: Product.Type;
+    active: boolean;
+    productCode?: string;
+    /** Pricing attributes for this product */
+    ProductAttribute?: Paid.AgentAttribute[];
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export declare namespace Product {
+    /**
+     * The type of product
+     */
+    type Type = "agent" | "product" | "prepaidCreditBundle";
+    const Type: {
+        readonly Agent: "agent";
+        readonly Product: "product";
+        readonly PrepaidCreditBundle: "prepaidCreditBundle";
+    };
+}

package/dist/cjs/api/types/Product.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Product = void 0;
+var Product;
+(function (Product) {
+    Product.Type = {
+        Agent: "agent",
+        Product: "product",
+        PrepaidCreditBundle: "prepaidCreditBundle",
+    };
+})(Product || (exports.Product = Product = {}));

package/dist/cjs/api/types/ProductUpdate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+export interface ProductUpdate {
+    name?: string;
+    description?: string;
+    externalId?: string;
+    type?: ProductUpdate.Type;
+    active?: boolean;
+    productCode?: string;
+    /** Pricing attributes for this product */
+    ProductAttribute?: Paid.AgentAttribute[];
+    metadata?: Record<string, unknown>;
+}
+export declare namespace ProductUpdate {
+    type Type = "agent" | "product" | "prepaidCreditBundle";
+    const Type: {
+        readonly Agent: "agent";
+        readonly Product: "product";
+        readonly PrepaidCreditBundle: "prepaidCreditBundle";
+    };
+}

package/dist/cjs/api/types/ProductUpdate.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductUpdate = void 0;
+var ProductUpdate;
+(function (ProductUpdate) {
+    ProductUpdate.Type = {
+        Agent: "agent",
+        Product: "product",
+        PrepaidCreditBundle: "prepaidCreditBundle",
+    };
+})(ProductUpdate || (exports.ProductUpdate = ProductUpdate = {}));

package/dist/cjs/api/types/Signal.d.ts

@@ -1,16 +1,21 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+/**
+ * DEPRECATED: Use SignalV2 instead for cleaner field names.
+ */
 export interface Signal {
     event_name?: string;
+    /** DEPRECATED: Use product_id in SignalV2 instead. */
     agent_id?: string;
+    /** DEPRECATED: Use external_product_id in SignalV2 instead. */
     external_agent_id?: string;
-    /** Deprecated. The external customer id. Use `external_customer_id` or `internal_customer_id` instead. */
+    /** DEPRECATED: The external customer id. Use `external_customer_id` or `internal_customer_id` instead. */
     customer_id?: string;
     data?: Record<string, unknown>;
     /** A unique key to ensure idempotent signal processing */
     idempotency_key?: string;
-    /** Paid's internal customer ID */
+    /** DEPRECATED: Use customer_id in SignalV2 instead. This was Paid's internal customer ID. */
     internal_customer_id?: string;
     /** Your system's customer ID */
     external_customer_id?: string;

package/dist/cjs/api/types/SignalV2.d.ts

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * V2 signal schema with clean field names. Use either internal IDs (product_id, customer_id) or external IDs (external_product_id, external_customer_id).
+ */
+export interface SignalV2 {
+    /** The name of the event being tracked */
+    event_name: string;
+    /** Paid's internal product ID. Use either this OR external_product_id. */
+    product_id?: string;
+    /** Your system's product ID. Use either this OR product_id. */
+    external_product_id?: string;
+    /** Paid's internal customer ID. Use either this OR external_customer_id. */
+    customer_id?: string;
+    /** Your system's customer ID. Use either this OR customer_id. */
+    external_customer_id?: string;
+    /** Optional additional data/metadata for the signal */
+    data?: Record<string, unknown>;
+    /** A unique key to ensure idempotent signal processing */
+    idempotency_key?: string;
+}

package/dist/cjs/api/types/SignalV2.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/types/Trace.d.ts

@@ -0,0 +1,26 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * A single cost trace record with customer and product info
+ */
+export interface Trace {
+    /** The name/type of the operation (e.g., "trace.openai.agents.on_agent") */
+    name: string;
+    /** The vendor/provider (e.g., "openai", "anthropic", "mistral") */
+    vendor: string;
+    /** The model used for the operation (e.g., "gpt-4o-mini", "claude-3-sonnet") */
+    model: string;
+    cost: Paid.CostAmount;
+    /** Unix timestamp in nanoseconds when the operation started */
+    startTimeUnixNano: string;
+    /** Unix timestamp in nanoseconds when the operation completed */
+    endTimeUnixNano: string;
+    /** Additional metadata about the trace (e.g., tokens, etc.) */
+    attributes: Record<string, unknown>;
+    /** The internal customer ID associated with this trace */
+    customerId?: string;
+    /** The product/agent ID associated with this trace (optional) */
+    productId?: string;
+}

package/dist/cjs/api/types/Trace.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/types/TracesResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * Response containing cost traces and pagination metadata
+ */
+export interface TracesResponse {
+    traces: Paid.Trace[];
+    meta: Paid.PaginationMeta;
+}

package/dist/cjs/api/types/TracesResponse.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/types/UsagePaginationMeta.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Pagination metadata for usage summaries
+ */
+export interface UsagePaginationMeta {
+    /** The requested limit */
+    limit: number;
+    /** The requested offset */
+    offset: number;
+    /** Total number of usage summaries available */
+    total: number;
+    /** Whether there are more results available */
+    hasMore: boolean;
+}

package/dist/cjs/api/types/UsagePaginationMeta.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/types/UsageSummariesResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.js";
+/**
+ * Response containing usage summaries and pagination metadata
+ */
+export interface UsageSummariesResponse {
+    data: Paid.UsageSummary[];
+    pagination: Paid.UsagePaginationMeta;
+}

package/dist/cjs/api/types/UsageSummariesResponse.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/types/UsageSummary.d.ts

@@ -0,0 +1,58 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A single usage summary record
+ */
+export interface UsageSummary {
+    /** The unique identifier of the usage summary */
+    id: string;
+    /** The name of the event being tracked */
+    eventName: string;
+    /** The quantity of events in this usage period */
+    eventsQuantity: number;
+    /** The start date of the usage period */
+    startDate: string;
+    /** The end date of the usage period */
+    endDate: string;
+    /** The subtotal amount in the smallest currency unit (e.g., cents) */
+    subtotal: number;
+    /** The next billing date for this usage */
+    nextBillingDate: string;
+    /** The internal customer ID */
+    customerId: string;
+    /** The order ID associated with this usage */
+    orderId: string;
+    /** The order line ID associated with this usage */
+    orderLineId: string;
+    /** The order line attribute ID associated with this usage */
+    orderLineAttributeId: string;
+    /** The invoice ID if this usage has been invoiced */
+    invoiceId?: string;
+    /** The invoice line ID if this usage has been invoiced */
+    invoiceLineId?: string;
+    /** When the usage summary was created */
+    createdAt: string;
+    /** When the usage summary was last updated */
+    updatedAt: string;
+    /** Associated order information */
+    order?: UsageSummary.Order;
+    /** Associated order line information */
+    orderLine?: UsageSummary.OrderLine;
+}
+export declare namespace UsageSummary {
+    /**
+     * Associated order information
+     */
+    interface Order {
+        id?: string;
+        displayId?: string;
+    }
+    /**
+     * Associated order line information
+     */
+    interface OrderLine {
+        id?: string;
+        displayId?: string;
+    }
+}

package/dist/cjs/api/types/UsageSummary.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/types/index.d.ts

@@ -22,8 +22,22 @@ export * from "./OrderLineAttributePricing.js";
 export * from "./PricePoint.js";
 export * from "./Tier.js";
 export * from "./OrderLineCreate.js";
-export * from "./OrderLineAttributeCreate.js";
+export * from "./OrderLineAttributeCreateOne.js";
 export * from "./Signal.js";
+export * from "./SignalV2.js";
+export * from "./Product.js";
+export * from "./ProductUpdate.js";
 export * from "./Error_.js";
 export * from "./ApiError.js";
 export * from "./EntitlementUsage.js";
+export * from "./CostTracesResponse.js";
+export * from "./TracesResponse.js";
+export * from "./CostTrace.js";
+export * from "./Trace.js";
+export * from "./CostAmount.js";
+export * from "./PaginationMeta.js";
+export * from "./UsageSummariesResponse.js";
+export * from "./UsageSummary.js";
+export * from "./UsagePaginationMeta.js";
+export * from "./PlanGroup.js";
+export * from "./Plan.js";

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

@@ -38,8 +38,22 @@ __exportStar(require("./OrderLineAttributePricing.js"), exports);
 __exportStar(require("./PricePoint.js"), exports);
 __exportStar(require("./Tier.js"), exports);
 __exportStar(require("./OrderLineCreate.js"), exports);
-__exportStar(require("./OrderLineAttributeCreate.js"), exports);
+__exportStar(require("./OrderLineAttributeCreateOne.js"), exports);
 __exportStar(require("./Signal.js"), exports);
+__exportStar(require("./SignalV2.js"), exports);
+__exportStar(require("./Product.js"), exports);
+__exportStar(require("./ProductUpdate.js"), exports);
 __exportStar(require("./Error_.js"), exports);
 __exportStar(require("./ApiError.js"), exports);
 __exportStar(require("./EntitlementUsage.js"), exports);
+__exportStar(require("./CostTracesResponse.js"), exports);
+__exportStar(require("./TracesResponse.js"), exports);
+__exportStar(require("./CostTrace.js"), exports);
+__exportStar(require("./Trace.js"), exports);
+__exportStar(require("./CostAmount.js"), exports);
+__exportStar(require("./PaginationMeta.js"), exports);
+__exportStar(require("./UsageSummariesResponse.js"), exports);
+__exportStar(require("./UsageSummary.js"), exports);
+__exportStar(require("./UsagePaginationMeta.js"), exports);
+__exportStar(require("./PlanGroup.js"), exports);
+__exportStar(require("./Plan.js"), exports);

package/dist/cjs/index.d.ts

@@ -3,3 +3,4 @@ export { PaidClient } from "./Client.js";
 export { PaidEnvironment } from "./environments.js";
 export { PaidError, PaidTimeoutError } from "./errors/index.js";
 export * as PaidIntegrations from "./integrations/index.js";
+export * from "./tracing/index.js";

package/dist/cjs/index.js

@@ -32,6 +32,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+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.PaidIntegrations = exports.PaidTimeoutError = exports.PaidError = exports.PaidEnvironment = exports.PaidClient = exports.Paid = void 0;
 exports.Paid = __importStar(require("./api/index.js"));
@@ -43,3 +46,4 @@ var index_js_1 = require("./errors/index.js");
 Object.defineProperty(exports, "PaidError", { enumerable: true, get: function () { return index_js_1.PaidError; } });
 Object.defineProperty(exports, "PaidTimeoutError", { enumerable: true, get: function () { return index_js_1.PaidTimeoutError; } });
 exports.PaidIntegrations = __importStar(require("./integrations/index.js"));
+__exportStar(require("./tracing/index.js"), exports);

package/dist/cjs/integrations/adapters/expressjs/base-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ExpressJS adapter for Paid SDK
+ * Converts Express Request/Response to framework-agnostic format
+ */
+import { Request, Response } from "express";
+/**
+ * Handles Express Request/Response conversion to base handler format
+ */
+export declare const expressjsAdapter: (innerHandler: Function) => (req: Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>, context?: any, config?: any) => Promise<any>;
+/**
+ * Create response context for ExpressJS
+ * This converts the base handler response methods to ExpressJS/Express format
+ */
+export declare function createExpressJSResponseContext(res: Response): {
+    json: (data: any, status?: number) => Response<any, Record<string, any>>;
+    error: (message: string, status: number) => Response<any, Record<string, any>>;
+};