@paid-ai/paid-node 0.2.0 → 0.3.0

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

@@ -12,6 +12,16 @@ import * as Paid from "../../../../index.mjs";
  *         endDate: "2026-01-01",
  *         currency: "USD"
  *     }
+ *
+ * @example
+ *     {
+ *         customerExternalId: "acme-inc",
+ *         name: "Acme Order with Custom Pricing",
+ *         description: "Order with customized attribute pricing",
+ *         startDate: "2025-01-01",
+ *         endDate: "2026-01-01",
+ *         currency: "USD"
+ *     }
  */
 export interface OrderCreate {
     customerId?: string;

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

@@ -9,7 +9,7 @@ export declare namespace Lines {
         environment?: core.Supplier<environments.PaidEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -26,7 +26,7 @@ export declare namespace Lines {
 }
 export declare class Lines {
     protected readonly _options: Lines.Options;
-    constructor(_options: Lines.Options);
+    constructor(_options?: Lines.Options);
     /**
      * @param {string} orderId
      * @param {Paid.orders.LinesUpdateRequest} request
@@ -47,5 +47,5 @@ export declare class Lines {
      */
     update(orderId: string, request?: Paid.orders.LinesUpdateRequest, requestOptions?: Lines.RequestOptions): core.HttpResponsePromise<Paid.Order>;
     private __update;
-    protected _getAuthorizationHeader(): Promise<string>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -16,7 +16,7 @@ import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../../../core/he
 import urlJoin from "url-join";
 import * as errors from "../../../../../../errors/index.mjs";
 export class Lines {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -83,7 +83,11 @@ export class Lines {
     }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
-            return `Bearer ${yield core.Supplier.get(this._options.token)}`;
+            const bearer = yield core.Supplier.get(this._options.token);
+            if (bearer != null) {
+                return `Bearer ${bearer}`;
+            }
+            return undefined;
         });
     }
 }

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

@@ -9,7 +9,7 @@ export declare namespace Usage {
         environment?: core.Supplier<environments.PaidEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -26,7 +26,7 @@ export declare namespace Usage {
 }
 export declare class Usage {
     protected readonly _options: Usage.Options;
-    constructor(_options: Usage.Options);
+    constructor(_options?: Usage.Options);
     /**
      * @param {Paid.UsageRecordBulkRequest} request
      * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
@@ -38,5 +38,5 @@ export declare class Usage {
      */
     recordBulk(request?: Paid.UsageRecordBulkRequest, requestOptions?: Usage.RequestOptions): core.HttpResponsePromise<void>;
     private __recordBulk;
-    protected _getAuthorizationHeader(): Promise<string>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -16,7 +16,7 @@ import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.
 import urlJoin from "url-join";
 import * as errors from "../../../../errors/index.mjs";
 export class Usage {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -74,7 +74,11 @@ export class Usage {
     }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
-            return `Bearer ${yield core.Supplier.get(this._options.token)}`;
+            const bearer = yield core.Supplier.get(this._options.token);
+            if (bearer != null) {
+                return `Bearer ${bearer}`;
+            }
+            return undefined;
         });
     }
 }

package/dist/esm/api/types/EntitlementUsage.d.mts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Tracks the usage of an entitlement for a customer
+ */
+export interface EntitlementUsage {
+    id: string;
+    createdAt?: string;
+    updatedAt?: string;
+    organizationId: string;
+    productId: string;
+    entitlementId: string;
+    customerId: string;
+    startDate: string;
+    endDate?: string;
+    /** Total entitlement amount */
+    total: number;
+    /** Available entitlement amount */
+    available: number;
+    /** Used entitlement amount */
+    used: number;
+}

package/dist/esm/api/types/EntitlementUsage.mjs

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

package/dist/esm/api/types/OrderLineAttributeCreate.d.mts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Paid from "../index.mjs";
+export interface OrderLineAttributeCreate {
+    /** The name of the agent attribute to override (e.g., "api_call", "call_placed") */
+    agentAttributeName: string;
+    /** Quantity for this attribute (defaults to 0) */
+    quantity?: number;
+    /** Custom pricing configuration for this attribute */
+    pricing: Paid.OrderLineAttributePricing;
+}

package/dist/esm/api/types/OrderLineAttributeCreate.mjs

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

package/dist/esm/api/types/OrderLineCreate.d.mts

@@ -1,9 +1,16 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Paid from "../index.mjs";
 export interface OrderLineCreate {
+    /** Paid's internal ID for the agent/product */
     agentId?: string;
+    /** 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[];
 }

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

@@ -22,6 +22,8 @@ export * from "./OrderLineAttributePricing.mjs";
 export * from "./PricePoint.mjs";
 export * from "./Tier.mjs";
 export * from "./OrderLineCreate.mjs";
+export * from "./OrderLineAttributeCreate.mjs";
 export * from "./Signal.mjs";
 export * from "./Error_.mjs";
 export * from "./ApiError.mjs";
+export * from "./EntitlementUsage.mjs";

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

@@ -22,6 +22,8 @@ export * from "./OrderLineAttributePricing.mjs";
 export * from "./PricePoint.mjs";
 export * from "./Tier.mjs";
 export * from "./OrderLineCreate.mjs";
+export * from "./OrderLineAttributeCreate.mjs";
 export * from "./Signal.mjs";
 export * from "./Error_.mjs";
 export * from "./ApiError.mjs";
+export * from "./EntitlementUsage.mjs";

package/dist/esm/index.d.mts

@@ -1,4 +1,4 @@
 export * as Paid from "./api/index.mjs";
 export { PaidClient } from "./Client.mjs";
-export { PaidError, PaidTimeoutError } from "./errors/index.mjs";
 export { PaidEnvironment } from "./environments.mjs";
+export { PaidError, PaidTimeoutError } from "./errors/index.mjs";

package/dist/esm/index.mjs

@@ -1,4 +1,4 @@
 export * as Paid from "./api/index.mjs";
 export { PaidClient } from "./Client.mjs";
-export { PaidError, PaidTimeoutError } from "./errors/index.mjs";
 export { PaidEnvironment } from "./environments.mjs";
+export { PaidError, PaidTimeoutError } from "./errors/index.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.0";
+export declare const SDK_VERSION = "0.3.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.2.0";
+export const SDK_VERSION = "0.3.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@paid-ai/paid-node",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "private": false,
     "repository": "https://github.com/paid-ai/paid-node",
     "type": "commonjs",

package/reference.md

@@ -250,6 +250,54 @@ await client.customers.delete("customerId");
 </dl>
 </details>
 
+<details><summary><code>client.customers.<a href="/src/api/resources/customers/client/Client.ts">getEntitlements</a>(customerId) -> Paid.EntitlementUsage[]</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.customers.getEntitlements("customerId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**customerId:** `string` — The customer ID
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Customers.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.customers.<a href="/src/api/resources/customers/client/Client.ts">getByExternalId</a>(externalId) -> Paid.Customer</code></summary>
 <dl>
 <dd>