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

package/reference.md

@@ -450,12 +450,149 @@ await client.customers.deleteByExternalId("externalId");
 </dl>
 </details>
 
+<details><summary><code>client.customers.<a href="/src/api/resources/customers/client/Client.ts">getCostsByExternalId</a>(externalId, { ...params }) -> Paid.CostTracesResponse</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.customers.getCostsByExternalId("externalId", {
+    limit: 1,
+    offset: 1,
+    startTime: "2024-01-15T09:30:00Z",
+    endTime: "2024-01-15T09:30:00Z",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string` — The external ID of the customer
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.CustomersGetCostsByExternalIdRequest`
+
+</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">getUsageByExternalId</a>(externalId, { ...params }) -> Paid.UsageSummariesResponse</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.customers.getUsageByExternalId("externalId", {
+    limit: 1,
+    offset: 1,
+    startTime: "2024-01-15T09:30:00Z",
+    endTime: "2024-01-15T09:30:00Z",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string` — The external ID of the customer
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.CustomersGetUsageByExternalIdRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Customers.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Agents
 
 <details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">list</a>() -> Paid.Agent[]</code></summary>
 <dl>
 <dd>
 
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -496,6 +633,21 @@ await client.agents.list();
 <dl>
 <dd>
 
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use POST /products instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -548,6 +700,21 @@ await client.agents.create({
 <dl>
 <dd>
 
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use GET /products/{productId} instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -581,7 +748,834 @@ await client.agents.get("agentId");
 <dl>
 <dd>
 
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">update</a>(agentId, { ...params }) -> Paid.Agent</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use PUT /products/{productId} instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.update("agentId", {
+    name: "Acme Agent (Updated)",
+    agentAttributes: [
+        {
+            name: "Emails sent signal",
+            active: true,
+            pricing: {
+                eventName: "emails_sent",
+                taxable: true,
+                chargeType: "usage",
+                pricingModel: "PerUnit",
+                billingFrequency: "monthly",
+                pricePoints: {
+                    USD: {
+                        tiers: [
+                            {
+                                minQuantity: 0,
+                                maxQuantity: 10,
+                                unitPrice: 100,
+                            },
+                            {
+                                minQuantity: 11,
+                                maxQuantity: 100,
+                                unitPrice: 90,
+                            },
+                            {
+                                minQuantity: 101,
+                                unitPrice: 80,
+                            },
+                        ],
+                    },
+                },
+            },
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**agentId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.AgentUpdate`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">delete</a>(agentId) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use DELETE /products/{productId} instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.delete("agentId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**agentId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">getByExternalId</a>(externalId) -> Paid.Agent</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use GET /products/external/{externalId} instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.getByExternalId("externalId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">updateByExternalId</a>(externalId, { ...params }) -> Paid.Agent</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use PUT /products/external/{externalId} instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.updateByExternalId("externalId", {
+    name: "Acme Agent (Updated)",
+    agentAttributes: [
+        {
+            name: "Emails sent signal",
+            active: true,
+            pricing: {
+                eventName: "emails_sent",
+                taxable: true,
+                chargeType: "usage",
+                pricingModel: "PerUnit",
+                billingFrequency: "monthly",
+                pricePoints: {
+                    USD: {
+                        unitPrice: 150,
+                    },
+                },
+            },
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.AgentUpdate`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">deleteByExternalId</a>(externalId) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+DEPRECATED: Use DELETE /products/external/{externalId} instead.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.deleteByExternalId("externalId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## Products
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">list</a>() -> Paid.Product[]</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.list();
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">create</a>({ ...params }) -> Paid.Product</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.create({
+    name: "Acme Product",
+    description: "Acme Product does amazing things.",
+    externalId: "acme-product",
+    type: "product",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Paid.ProductCreate`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">get</a>(productId) -> Paid.Product</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.get("productId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**productId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">update</a>(productId, { ...params }) -> Paid.Product</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.update("productId", {});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**productId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.ProductUpdate`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">delete</a>(productId) -> void</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.delete("productId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**productId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">getByExternalId</a>(externalId) -> Paid.Product</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.getByExternalId("externalId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">updateByExternalId</a>(externalId, { ...params }) -> Paid.Product</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.updateByExternalId("externalId", {});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.ProductUpdate`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.products.<a href="/src/api/resources/products/client/Client.ts">deleteByExternalId</a>(externalId) -> void</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.products.deleteByExternalId("externalId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**externalId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Products.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## Contacts
+
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">list</a>() -> Paid.Contact[]</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contacts.list();
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `Contacts.RequestOptions`
 
 </dd>
 </dl>
@@ -592,7 +1586,7 @@ await client.agents.get("agentId");
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">update</a>(agentId, { ...params }) -> Paid.Agent</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">create</a>({ ...params }) -> Paid.Contact</code></summary>
 <dl>
 <dd>
 
@@ -605,41 +1599,12 @@ await client.agents.get("agentId");
 <dd>
 
 ```typescript
-await client.agents.update("agentId", {
-    name: "Acme Agent (Updated)",
-    agentAttributes: [
-        {
-            name: "Emails sent signal",
-            active: true,
-            pricing: {
-                eventName: "emails_sent",
-                taxable: true,
-                chargeType: "usage",
-                pricingModel: "PerUnit",
-                billingFrequency: "monthly",
-                pricePoints: {
-                    USD: {
-                        tiers: [
-                            {
-                                minQuantity: 0,
-                                maxQuantity: 10,
-                                unitPrice: 100,
-                            },
-                            {
-                                minQuantity: 11,
-                                maxQuantity: 100,
-                                unitPrice: 90,
-                            },
-                            {
-                                minQuantity: 101,
-                                unitPrice: 80,
-                            },
-                        ],
-                    },
-                },
-            },
-        },
-    ],
+await client.contacts.create({
+    customerExternalId: "acme-inc",
+    salutation: "Mr.",
+    firstName: "John",
+    lastName: "Doe",
+    email: "john.doe@example.com",
 });
 ```
 
@@ -656,15 +1621,7 @@ await client.agents.update("agentId", {
 <dl>
 <dd>
 
-**agentId:** `string`
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Paid.AgentUpdate`
+**request:** `Paid.ContactCreate`
 
 </dd>
 </dl>
@@ -672,7 +1629,7 @@ await client.agents.update("agentId", {
 <dl>
 <dd>
 
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Contacts.RequestOptions`
 
 </dd>
 </dl>
@@ -683,7 +1640,7 @@ await client.agents.update("agentId", {
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">delete</a>(agentId) -> void</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">get</a>(contactId) -> Paid.Contact</code></summary>
 <dl>
 <dd>
 
@@ -696,7 +1653,7 @@ await client.agents.update("agentId", {
 <dd>
 
 ```typescript
-await client.agents.delete("agentId");
+await client.contacts.get("contactId");
 ```
 
 </dd>
@@ -712,7 +1669,7 @@ await client.agents.delete("agentId");
 <dl>
 <dd>
 
-**agentId:** `string`
+**contactId:** `string`
 
 </dd>
 </dl>
@@ -720,7 +1677,7 @@ await client.agents.delete("agentId");
 <dl>
 <dd>
 
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Contacts.RequestOptions`
 
 </dd>
 </dl>
@@ -731,7 +1688,7 @@ await client.agents.delete("agentId");
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">getByExternalId</a>(externalId) -> Paid.Agent</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">delete</a>(contactId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -744,7 +1701,7 @@ await client.agents.delete("agentId");
 <dd>
 
 ```typescript
-await client.agents.getByExternalId("externalId");
+await client.contacts.delete("contactId");
 ```
 
 </dd>
@@ -760,7 +1717,7 @@ await client.agents.getByExternalId("externalId");
 <dl>
 <dd>
 
-**externalId:** `string`
+**contactId:** `string`
 
 </dd>
 </dl>
@@ -768,7 +1725,7 @@ await client.agents.getByExternalId("externalId");
 <dl>
 <dd>
 
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Contacts.RequestOptions`
 
 </dd>
 </dl>
@@ -779,7 +1736,7 @@ await client.agents.getByExternalId("externalId");
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">updateByExternalId</a>(externalId, { ...params }) -> Paid.Agent</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">getByExternalId</a>(externalId) -> Paid.Contact</code></summary>
 <dl>
 <dd>
 
@@ -792,27 +1749,7 @@ await client.agents.getByExternalId("externalId");
 <dd>
 
 ```typescript
-await client.agents.updateByExternalId("externalId", {
-    name: "Acme Agent (Updated)",
-    agentAttributes: [
-        {
-            name: "Emails sent signal",
-            active: true,
-            pricing: {
-                eventName: "emails_sent",
-                taxable: true,
-                chargeType: "usage",
-                pricingModel: "PerUnit",
-                billingFrequency: "monthly",
-                pricePoints: {
-                    USD: {
-                        unitPrice: 150,
-                    },
-                },
-            },
-        },
-    ],
-});
+await client.contacts.getByExternalId("externalId");
 ```
 
 </dd>
@@ -836,15 +1773,7 @@ await client.agents.updateByExternalId("externalId", {
 <dl>
 <dd>
 
-**request:** `Paid.AgentUpdate`
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Contacts.RequestOptions`
 
 </dd>
 </dl>
@@ -855,7 +1784,7 @@ await client.agents.updateByExternalId("externalId", {
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">deleteByExternalId</a>(externalId) -> void</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">deleteByExternalId</a>(externalId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -868,7 +1797,7 @@ await client.agents.updateByExternalId("externalId", {
 <dd>
 
 ```typescript
-await client.agents.deleteByExternalId("externalId");
+await client.contacts.deleteByExternalId("externalId");
 ```
 
 </dd>
@@ -892,7 +1821,7 @@ await client.agents.deleteByExternalId("externalId");
 <dl>
 <dd>
 
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Contacts.RequestOptions`
 
 </dd>
 </dl>
@@ -903,9 +1832,9 @@ await client.agents.deleteByExternalId("externalId");
 </dl>
 </details>
 
-## Contacts
+## Orders
 
-<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">list</a>() -> Paid.Contact[]</code></summary>
+<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">list</a>() -> Paid.Order[]</code></summary>
 <dl>
 <dd>
 
@@ -918,7 +1847,7 @@ await client.agents.deleteByExternalId("externalId");
 <dd>
 
 ```typescript
-await client.contacts.list();
+await client.orders.list();
 ```
 
 </dd>
@@ -934,7 +1863,7 @@ await client.contacts.list();
 <dl>
 <dd>
 
-**requestOptions:** `Contacts.RequestOptions`
+**requestOptions:** `Orders.RequestOptions`
 
 </dd>
 </dl>
@@ -945,7 +1874,7 @@ await client.contacts.list();
 </dl>
 </details>
 
-<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">create</a>({ ...params }) -> Paid.Contact</code></summary>
+<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">create</a>({ ...params }) -> Paid.Order</code></summary>
 <dl>
 <dd>
 
@@ -958,12 +1887,13 @@ await client.contacts.list();
 <dd>
 
 ```typescript
-await client.contacts.create({
+await client.orders.create({
     customerExternalId: "acme-inc",
-    salutation: "Mr.",
-    firstName: "John",
-    lastName: "Doe",
-    email: "john.doe@example.com",
+    name: "Acme Order",
+    description: "Acme Order is an order for Acme, Inc.",
+    startDate: "2025-01-01",
+    endDate: "2026-01-01",
+    currency: "USD",
 });
 ```
 
@@ -980,7 +1910,7 @@ await client.contacts.create({
 <dl>
 <dd>
 
-**request:** `Paid.ContactCreate`
+**request:** `Paid.OrderCreate`
 
 </dd>
 </dl>
@@ -988,7 +1918,7 @@ await client.contacts.create({
 <dl>
 <dd>
 
-**requestOptions:** `Contacts.RequestOptions`
+**requestOptions:** `Orders.RequestOptions`
 
 </dd>
 </dl>
@@ -999,7 +1929,7 @@ await client.contacts.create({
 </dl>
 </details>
 
-<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">get</a>(contactId) -> Paid.Contact</code></summary>
+<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">get</a>(orderId) -> Paid.Order</code></summary>
 <dl>
 <dd>
 
@@ -1012,7 +1942,7 @@ await client.contacts.create({
 <dd>
 
 ```typescript
-await client.contacts.get("contactId");
+await client.orders.get("orderId");
 ```
 
 </dd>
@@ -1028,7 +1958,7 @@ await client.contacts.get("contactId");
 <dl>
 <dd>
 
-**contactId:** `string`
+**orderId:** `string`
 
 </dd>
 </dl>
@@ -1036,7 +1966,7 @@ await client.contacts.get("contactId");
 <dl>
 <dd>
 
-**requestOptions:** `Contacts.RequestOptions`
+**requestOptions:** `Orders.RequestOptions`
 
 </dd>
 </dl>
@@ -1047,7 +1977,7 @@ await client.contacts.get("contactId");
 </dl>
 </details>
 
-<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">delete</a>(contactId) -> void</code></summary>
+<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">delete</a>(orderId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1060,7 +1990,7 @@ await client.contacts.get("contactId");
 <dd>
 
 ```typescript
-await client.contacts.delete("contactId");
+await client.orders.delete("orderId");
 ```
 
 </dd>
@@ -1076,7 +2006,7 @@ await client.contacts.delete("contactId");
 <dl>
 <dd>
 
-**contactId:** `string`
+**orderId:** `string`
 
 </dd>
 </dl>
@@ -1084,7 +2014,7 @@ await client.contacts.delete("contactId");
 <dl>
 <dd>
 
-**requestOptions:** `Contacts.RequestOptions`
+**requestOptions:** `Orders.RequestOptions`
 
 </dd>
 </dl>
@@ -1095,7 +2025,7 @@ await client.contacts.delete("contactId");
 </dl>
 </details>
 
-<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">getByExternalId</a>(externalId) -> Paid.Contact</code></summary>
+<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">activate</a>(orderId) -> Paid.Order</code></summary>
 <dl>
 <dd>
 
@@ -1108,7 +2038,7 @@ await client.contacts.delete("contactId");
 <dd>
 
 ```typescript
-await client.contacts.getByExternalId("externalId");
+await client.orders.activate("orderId");
 ```
 
 </dd>
@@ -1124,7 +2054,7 @@ await client.contacts.getByExternalId("externalId");
 <dl>
 <dd>
 
-**externalId:** `string`
+**orderId:** `string`
 
 </dd>
 </dl>
@@ -1132,7 +2062,7 @@ await client.contacts.getByExternalId("externalId");
 <dl>
 <dd>
 
-**requestOptions:** `Contacts.RequestOptions`
+**requestOptions:** `Orders.RequestOptions`
 
 </dd>
 </dl>
@@ -1143,7 +2073,9 @@ await client.contacts.getByExternalId("externalId");
 </dl>
 </details>
 
-<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">deleteByExternalId</a>(externalId) -> void</code></summary>
+## Plans
+
+<details><summary><code>client.plans.<a href="/src/api/resources/plans/client/Client.ts">getById</a>(planId) -> Paid.Plan</code></summary>
 <dl>
 <dd>
 
@@ -1156,7 +2088,7 @@ await client.contacts.getByExternalId("externalId");
 <dd>
 
 ```typescript
-await client.contacts.deleteByExternalId("externalId");
+await client.plans.getById("planId");
 ```
 
 </dd>
@@ -1172,7 +2104,7 @@ await client.contacts.deleteByExternalId("externalId");
 <dl>
 <dd>
 
-**externalId:** `string`
+**planId:** `string` — The ID of the plan
 
 </dd>
 </dl>
@@ -1180,7 +2112,7 @@ await client.contacts.deleteByExternalId("externalId");
 <dl>
 <dd>
 
-**requestOptions:** `Contacts.RequestOptions`
+**requestOptions:** `Plans.RequestOptions`
 
 </dd>
 </dl>
@@ -1191,9 +2123,7 @@ await client.contacts.deleteByExternalId("externalId");
 </dl>
 </details>
 
-## Orders
-
-<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">list</a>() -> Paid.Order[]</code></summary>
+<details><summary><code>client.plans.<a href="/src/api/resources/plans/client/Client.ts">getUsage</a>(planId, { ...params }) -> Paid.UsageSummariesResponse</code></summary>
 <dl>
 <dd>
 
@@ -1206,7 +2136,13 @@ await client.contacts.deleteByExternalId("externalId");
 <dd>
 
 ```typescript
-await client.orders.list();
+await client.plans.getUsage("planId", {
+    externalId: "externalId",
+    limit: 1,
+    offset: 1,
+    startTime: "2024-01-15T09:30:00Z",
+    endTime: "2024-01-15T09:30:00Z",
+});
 ```
 
 </dd>
@@ -1222,7 +2158,23 @@ await client.orders.list();
 <dl>
 <dd>
 
-**requestOptions:** `Orders.RequestOptions`
+**planId:** `string` — The ID of the plan
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Paid.PlansGetUsageRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Plans.RequestOptions`
 
 </dd>
 </dl>
@@ -1233,7 +2185,7 @@ await client.orders.list();
 </dl>
 </details>
 
-<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">create</a>({ ...params }) -> Paid.Order</code></summary>
+<details><summary><code>client.plans.<a href="/src/api/resources/plans/client/Client.ts">getGroupById</a>(planGroupId) -> Paid.PlanGroup</code></summary>
 <dl>
 <dd>
 
@@ -1246,14 +2198,7 @@ await client.orders.list();
 <dd>
 
 ```typescript
-await client.orders.create({
-    customerExternalId: "acme-inc",
-    name: "Acme Order",
-    description: "Acme Order is an order for Acme, Inc.",
-    startDate: "2025-01-01",
-    endDate: "2026-01-01",
-    currency: "USD",
-});
+await client.plans.getGroupById("planGroupId");
 ```
 
 </dd>
@@ -1269,7 +2214,7 @@ await client.orders.create({
 <dl>
 <dd>
 
-**request:** `Paid.OrderCreate`
+**planGroupId:** `string` — The ID of the plan group
 
 </dd>
 </dl>
@@ -1277,7 +2222,7 @@ await client.orders.create({
 <dl>
 <dd>
 
-**requestOptions:** `Orders.RequestOptions`
+**requestOptions:** `Plans.RequestOptions`
 
 </dd>
 </dl>
@@ -1288,10 +2233,27 @@ await client.orders.create({
 </dl>
 </details>
 
-<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">get</a>(orderId) -> Paid.Order</code></summary>
+## Usage
+
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">recordBulk</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
 <dl>
 <dd>
 
+DEPRECATED: Use POST /usage/v2/signals/bulk instead for cleaner field names.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -1301,7 +2263,9 @@ await client.orders.create({
 <dd>
 
 ```typescript
-await client.orders.get("orderId");
+await client.usage.recordBulk({
+    signals: [{}, {}, {}],
+});
 ```
 
 </dd>
@@ -1317,7 +2281,7 @@ await client.orders.get("orderId");
 <dl>
 <dd>
 
-**orderId:** `string`
+**request:** `Paid.UsageRecordBulkRequest`
 
 </dd>
 </dl>
@@ -1325,7 +2289,7 @@ await client.orders.get("orderId");
 <dl>
 <dd>
 
-**requestOptions:** `Orders.RequestOptions`
+**requestOptions:** `Usage.RequestOptions`
 
 </dd>
 </dl>
@@ -1336,7 +2300,7 @@ await client.orders.get("orderId");
 </dl>
 </details>
 
-<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">delete</a>(orderId) -> void</code></summary>
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">usageRecordBulkV2</a>({ ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1349,7 +2313,29 @@ await client.orders.get("orderId");
 <dd>
 
 ```typescript
-await client.orders.delete("orderId");
+await client.usage.usageRecordBulkV2({
+    signals: [
+        {
+            event_name: "emails_sent",
+            product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
+            customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d",
+        },
+        {
+            event_name: "emails_sent",
+            external_product_id: "acme-product",
+            external_customer_id: "acme-inc",
+        },
+        {
+            event_name: "meeting_booked",
+            product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
+            external_customer_id: "acme-inc",
+            data: {
+                meeting_duration: 30,
+                meeting_type: "demo",
+            },
+        },
+    ],
+});
 ```
 
 </dd>
@@ -1365,7 +2351,7 @@ await client.orders.delete("orderId");
 <dl>
 <dd>
 
-**orderId:** `string`
+**request:** `Paid.UsageRecordBulkV2Request`
 
 </dd>
 </dl>
@@ -1373,7 +2359,7 @@ await client.orders.delete("orderId");
 <dl>
 <dd>
 
-**requestOptions:** `Orders.RequestOptions`
+**requestOptions:** `Usage.RequestOptions`
 
 </dd>
 </dl>
@@ -1384,7 +2370,7 @@ await client.orders.delete("orderId");
 </dl>
 </details>
 
-<details><summary><code>client.orders.<a href="/src/api/resources/orders/client/Client.ts">activate</a>(orderId) -> Paid.Order</code></summary>
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">checkUsage</a>({ ...params }) -> Paid.UsageCheckUsageResponse</code></summary>
 <dl>
 <dd>
 
@@ -1397,7 +2383,10 @@ await client.orders.delete("orderId");
 <dd>
 
 ```typescript
-await client.orders.activate("orderId");
+await client.usage.checkUsage({
+    externalCustomerId: "acme-inc",
+    externalProductId: "acme-agent",
+});
 ```
 
 </dd>
@@ -1413,7 +2402,7 @@ await client.orders.activate("orderId");
 <dl>
 <dd>
 
-**orderId:** `string`
+**request:** `Paid.UsageCheckUsageRequest`
 
 </dd>
 </dl>
@@ -1421,7 +2410,7 @@ await client.orders.activate("orderId");
 <dl>
 <dd>
 
-**requestOptions:** `Orders.RequestOptions`
+**requestOptions:** `Usage.RequestOptions`
 
 </dd>
 </dl>
@@ -1432,9 +2421,9 @@ await client.orders.activate("orderId");
 </dl>
 </details>
 
-## Usage
+## Traces
 
-<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">recordBulk</a>({ ...params }) -> void</code></summary>
+<details><summary><code>client.traces.<a href="/src/api/resources/traces/client/Client.ts">getTraces</a>({ ...params }) -> Paid.TracesResponse</code></summary>
 <dl>
 <dd>
 
@@ -1447,8 +2436,15 @@ await client.orders.activate("orderId");
 <dd>
 
 ```typescript
-await client.usage.recordBulk({
-    signals: [{}, {}, {}],
+await client.traces.getTraces({
+    limit: 1,
+    offset: 1,
+    startTime: "2024-01-15T09:30:00Z",
+    endTime: "2024-01-15T09:30:00Z",
+    externalCustomerId: "externalCustomerId",
+    externalProductId: "externalProductId",
+    externalAgentId: "externalAgentId",
+    metadata: "metadata",
 });
 ```
 
@@ -1465,7 +2461,7 @@ await client.usage.recordBulk({
 <dl>
 <dd>
 
-**request:** `Paid.UsageRecordBulkRequest`
+**request:** `Paid.GetTracesRequest`
 
 </dd>
 </dl>
@@ -1473,7 +2469,7 @@ await client.usage.recordBulk({
 <dl>
 <dd>
 
-**requestOptions:** `Usage.RequestOptions`
+**requestOptions:** `Traces.RequestOptions`
 
 </dd>
 </dl>
@@ -1502,12 +2498,10 @@ await client.usage.recordBulk({
 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.",
         },