@voltade/envoy-sdk 1.2.16 → 1.3.1

package/README.md

@@ -11,39 +11,34 @@ npm install @voltade/envoy-sdk
 ## Quick Start
 
 ```typescript
-import { EnvoyClient } from '@voltade/envoy-sdk';
+import { EnvoyClient } from "@voltade/envoy-sdk";
 
-// Initialize the client
 const client = new EnvoyClient({
-  apiKey: 'your-api-key',
-  accountId: 'your-account-id',
-  baseUrl: 'https://envoy-crm.voltade.com', // optional, defaults to this
+  apiKey: "your-api-key",
+  accountId: "your-account-id",
+  baseUrl: "https://envoy-crm.voltade.com", // optional
 });
 
-// Create and send a message to a conversation
+// Send a message
 const message = await client.conversations.createMessage(123, {
-  content: 'Hello, how can I help you?',
-  message_type: 'outgoing',
-  private: false
+  content: "Hello, how can I help you?",
+  message_type: "outgoing",
+  private: false,
 });
 
-// Escalate a conversation to a human agent
+// Escalate to human
 const result = await client.conversations.escalateToHuman(123);
-console.log(`Escalated: ${result.success}`);
 ```
 
 ## Features
 
 - **Type-safe**: Full TypeScript support with comprehensive type definitions
-- **Resource-based**: Organized API methods by resource (conversations, messages, etc.)
+- **Resource-based**: Organized API methods by resource (conversations, contacts, companies, etc.)
 - **Error handling**: Structured error types for different API failures
-- **Easy to use**: Simple, intuitive API design
-
-## API Reference
+- **Zod schemas**: Runtime validation with exported schemas
+- **Webhook support**: Parse and validate incoming webhook events
 
-### EnvoyClient
-
-#### Configuration
+## Configuration
 
 ```typescript
 const client = new EnvoyClient({
@@ -54,24 +49,56 @@ const client = new EnvoyClient({
 });
 ```
 
+---
+
+## API Reference
+
 ### Conversations
 
-#### Create Message
+#### `createMessage(conversationId, params)`
+
+Create and send a message to a conversation. Supports text messages, WhatsApp templates, and file attachments.
 
 ```typescript
-const message = await client.conversations.createMessage(conversationId, {
-  content: 'Your message',
-  message_type: 'outgoing',
+// Simple text message
+const message = await client.conversations.createMessage(123, {
+  content: "Hello, how can I help you?",
+  message_type: "outgoing",
   private: false,
-  content_type: 'text',
-  content_attributes: {}
+});
+
+// WhatsApp template message
+const templateMessage = await client.conversations.createMessage(123, {
+  content: "Template message",
+  template_params: {
+    name: "order_confirmation",
+    category: "MARKETING",
+    language: "en",
+    processed_params: {
+      body: { "1": "121212" },
+      header: {
+        media_url: "https://example.com/image.jpg",
+        media_type: "image",
+      },
+    },
+  },
+});
+
+// Message with file attachments
+const file = new File([blob], "document.pdf", { type: "application/pdf" });
+const messageWithAttachment = await client.conversations.createMessage(123, {
+  content: "Here is your document",
+  message_type: "outgoing",
+  file_attachments: [file],
 });
 ```
 
-#### Escalate to Human
+#### `escalateToHuman(conversationId)`
+
+Escalate a conversation to a human agent.
 
 ```typescript
-const result = await client.conversations.escalateToHuman(conversationId);
+const result = await client.conversations.escalateToHuman(123);
 
 if (result.success) {
   console.log(`Escalated to ${result.escalation_type}`);
@@ -81,6 +108,336 @@ if (result.success) {
 }
 ```
 
+#### `get(conversationId)`
+
+Get a conversation by ID.
+
+```typescript
+const conversation = await client.conversations.get(123);
+console.log(conversation.status); // 'open' | 'resolved' | 'pending' | 'snoozed'
+```
+
+#### `getMessages(conversationId)`
+
+Get all messages for a conversation.
+
+```typescript
+const response = await client.conversations.getMessages(123);
+console.log(response.payload); // Array of messages
+console.log(response.meta); // Metadata including labels, assignee
+```
+
+---
+
+### Contacts
+
+#### `create(params)`
+
+Create a new contact.
+
+```typescript
+const contact = await client.contacts.create({
+  inbox_id: 1,
+  name: "John Doe",
+  email: "john@example.com",
+  phone_number: "+1234567890",
+  custom_attributes: { plan: "enterprise" },
+});
+```
+
+#### `update(contactId, params)`
+
+Update an existing contact.
+
+```typescript
+const contact = await client.contacts.update(123, {
+  name: "Jane Doe",
+  email: "jane@example.com",
+  custom_attributes: { plan: "pro" },
+});
+```
+
+#### `get(contactId)`
+
+Get a contact by ID.
+
+```typescript
+const contact = await client.contacts.get(123);
+console.log(contact.name, contact.email);
+```
+
+#### `delete(contactId)`
+
+Delete a contact.
+
+```typescript
+await client.contacts.delete(123);
+```
+
+#### `list(params?)`
+
+List all contacts with pagination.
+
+```typescript
+const response = await client.contacts.list({ page: 1 });
+console.log(response.payload); // Array of contacts
+console.log(response.meta); // Pagination metadata
+```
+
+#### `search(params)`
+
+Search contacts by name, identifier, email, or phone number.
+
+```typescript
+const response = await client.contacts.search({
+  q: "john@example.com",
+  page: 1,
+});
+console.log(response.payload);
+```
+
+---
+
+### Companies
+
+#### `list(params?)`
+
+List all companies with pagination.
+
+```typescript
+const companies = await client.companies.list();
+
+// With pagination
+const companies = await client.companies.list({ page: 2, per_page: 50 });
+```
+
+#### `create(params)`
+
+Create a new company.
+
+```typescript
+const company = await client.companies.create({
+  name: "Acme Corp",
+});
+```
+
+#### `get(companyId)`
+
+Get a company by ID.
+
+```typescript
+const company = await client.companies.get(456);
+```
+
+#### `update(companyId, params)`
+
+Update an existing company.
+
+```typescript
+const company = await client.companies.update(456, {
+  name: "Acme Corp Updated",
+});
+```
+
+#### `search(query, params?)`
+
+Search companies by name.
+
+```typescript
+const response = await client.companies.search("Acme");
+
+// With pagination
+const response = await client.companies.search("Acme", {
+  page: 2,
+  per_page: 50,
+});
+console.log(response.payload); // Array of matching companies
+console.log(response.meta); // { count, current_page }
+```
+
+#### `delete(companyId)`
+
+Delete a company.
+
+```typescript
+await client.companies.delete(456);
+```
+
+---
+
+### Company Members
+
+Manage contacts within a company via `client.companies.members`.
+
+#### `list(companyId)`
+
+List all members (contacts) of a company.
+
+```typescript
+const members = await client.companies.members.list(456);
+```
+
+#### `add(companyId, params)`
+
+Add contacts to a company.
+
+```typescript
+const members = await client.companies.members.add(456, {
+  contact_ids: [101, 102, 103],
+});
+```
+
+#### `remove(companyId, params)`
+
+Remove contacts from a company.
+
+```typescript
+await client.companies.members.remove(456, {
+  contact_ids: [101, 102],
+});
+```
+
+---
+
+### Inboxes
+
+#### `searchPortals(inboxId, params)`
+
+Search the knowledge base portals for articles.
+
+```typescript
+const articles = await client.inboxes.searchPortals(1, {
+  queries: ["shipping", "policy"],
+});
+
+articles.forEach((article) => {
+  console.log(article.title, article.content);
+});
+```
+
+#### `uploadWhatsappMedia(inboxId, params)`
+
+Upload media file for WhatsApp messages.
+
+```typescript
+// Upload an image
+const file = new File([imageBlob], "photo.jpg", { type: "image/jpeg" });
+const result = await client.inboxes.uploadWhatsappMedia(123, {
+  file: file,
+  type: "image/jpeg",
+  filename: "photo.jpg",
+  for_template: false,
+});
+console.log("Media ID:", result.media_id);
+
+// Upload a document for template
+const docFile = new File([pdfBlob], "invoice.pdf", { type: "application/pdf" });
+const docResult = await client.inboxes.uploadWhatsappMedia(123, {
+  file: docFile,
+  type: "application/pdf",
+  filename: "invoice.pdf",
+  for_template: true,
+});
+```
+
+---
+
+### Orders
+
+#### `list(params?)`
+
+List all orders with pagination and filtering.
+
+```typescript
+// List with default pagination
+const response = await client.orders.list();
+console.log(response.data); // Array of orders
+console.log(response.meta); // Pagination metadata
+
+// With date filtering
+const response = await client.orders.list({
+  page: 1,
+  per_page: 50,
+  since: "2024-01-01",
+  until: "2024-12-31",
+  sort: "-created_at",
+});
+
+// With advanced filtering
+const response = await client.orders.list({
+  payload: [{ field: "financial_status", operator: "eq", value: "paid" }],
+});
+```
+
+#### `upsert(params)`
+
+Create or update an order based on `source` and `source_id`. If an order with the same source and source_id exists, it will be updated.
+
+```typescript
+const result = await client.orders.upsert({
+  name: "ORD-12345",
+  company_id: 101,
+  total_amount: 150,
+  currency_code: "USD",
+  financial_status: "paid",
+  fulfillment_status: "fulfilled",
+  source: "shopify",
+  source_id: "789456123",
+  order_url: "https://mystore.myshopify.com/admin/orders/789456123",
+  notes: "Customer requested gift wrapping",
+  metadata: {
+    line_items: [
+      {
+        part_number: "SKU-001",
+        quantity: 2,
+        description: "Widget",
+        line_total: 75,
+      },
+    ],
+  },
+});
+console.log(result.payload); // The created/updated order
+```
+
+---
+
+### Webhooks
+
+Parse and validate incoming webhook events using the `webhookEvent` utility.
+
+```typescript
+import { webhookEvent } from "@voltade/envoy-sdk";
+
+// In your webhook handler
+app.post("/webhook", (req, res) => {
+  // Throws ZodError if invalid
+  const event = webhookEvent.parse(req.body);
+
+  if (event.event === "message_created") {
+    console.log("New message:", event.content);
+    console.log("Conversation:", event.conversation.id);
+    console.log("Sender:", event.sender.name);
+  }
+
+  res.sendStatus(200);
+});
+
+// Or use safeParse for graceful handling
+const event = webhookEvent.safeParse(req.body);
+if (event) {
+  // Handle valid event
+} else {
+  // Invalid payload
+}
+```
+
+**Supported webhook events:**
+
+- `message_created` - New message in a conversation
+- `message_updated` - Message was updated
+
+---
+
 ## Error Handling
 
 The SDK provides structured error types:
@@ -93,85 +450,200 @@ import {
   NotFoundError,
   RateLimitError,
   ServerError,
-  NetworkError
-} from '@voltade/envoy-sdk';
+  NetworkError,
+  ValidationError,
+} from "@voltade/envoy-sdk";
 
 try {
-  await client.conversations.createMessage(123, { content: 'Hello' });
+  await client.conversations.createMessage(123, { content: "Hello" });
 } catch (error) {
   if (error instanceof AuthenticationError) {
-    console.error('Invalid API key');
+    console.error("Invalid API key");
   } else if (error instanceof NotFoundError) {
-    console.error('Conversation not found');
+    console.error("Conversation not found");
   } else if (error instanceof RateLimitError) {
-    console.error('Rate limit exceeded');
+    console.error("Rate limit exceeded, retry after:", error.retryAfter);
+  } else if (error instanceof BadRequestError) {
+    console.error("Bad request:", error.response);
+  } else if (error instanceof ValidationError) {
+    console.error("Validation failed:", error.errors);
+  } else if (error instanceof ServerError) {
+    console.error("Server error:", error.statusCode);
+  } else if (error instanceof NetworkError) {
+    console.error("Network error:", error.originalError);
   }
 }
 ```
 
+---
+
 ## Types
 
-All TypeScript types are exported and available for use:
+All TypeScript types are exported:
 
 ```typescript
 import type {
+  // Conversations
   Message,
   Conversation,
+  ConversationStatus,
   CreateMessageParams,
   EscalationResponse,
+  EscalationType,
   MessageType,
   ContentType,
-  ConversationStatus
-} from '@voltade/envoy-sdk';
+  MessagesResponse,
+  MessagesResponseMeta,
+  TemplateParams,
+  Agent,
+  Assignee,
+  Team,
+  Priority,
+  Contact,
+  ContactInbox,
+  ConversationMeta,
+
+  // Contacts
+  ContactCreateParams,
+  ContactUpdateParams,
+  ListContactsParams,
+  ListContactsResponse,
+  SearchContactsParams,
+
+  // Companies
+  Company,
+  CreateCompanyParams,
+  CreateCompanyResponse,
+  GetCompanyResponse,
+  ListCompaniesParams,
+  ListCompaniesResponse,
+  UpdateCompanyParams,
+  UpdateCompanyResponse,
+  SearchCompaniesResponse,
+
+  // Company Members
+  AddCompanyMembersParams,
+  AddCompanyMembersResponse,
+  ListCompanyMembersResponse,
+  RemoveCompanyMembersParams,
+
+  // Inboxes
+  Article,
+  SearchParams,
+  SearchResponse,
+  UploadWhatsappMediaParams,
+  UploadWhatsappMediaResponse,
+
+  // Orders
+  Order,
+  OrdersMeta,
+  ListOrdersParams,
+  ListOrdersResponse,
+  UpsertOrderParams,
+  UpsertOrderRequest,
+  UpsertOrderResponse,
+  UpsertOrderResponsePayload,
+
+  // Webhooks
+  WebhookEvent,
+  MessageCreatedEvent,
+  MessageUpdatedEvent,
+  WebhookConversation,
+  WebhookMessage,
+  WebhookSender,
+
+  // Client
+  EnvoyClientConfig,
+} from "@voltade/envoy-sdk";
 ```
 
+---
+
 ## Zod Schemas
 
 The SDK exposes Zod schemas for runtime validation. All types are derived from these schemas using `z.infer`:
 
 ```typescript
 import {
+  // Conversations
   MessageSchema,
+  ConversationSchema,
+  ConversationStatusSchema,
   CreateMessageParamsSchema,
   EscalationResponseSchema,
-  ConversationSchema
-} from '@voltade/envoy-sdk';
+  EscalationTypeSchema,
+  MessageTypeSchema,
+  ContentTypeSchema,
+  MessagesResponseSchema,
+  MessagesResponseMetaSchema,
+  TemplateParamsSchema,
+  AgentSchema,
+  AssigneeSchema,
+  TeamSchema,
+  PrioritySchema,
+  ContactSchema,
+  ContactInboxSchema,
+  ConversationMetaSchema,
+
+  // Contacts
+  ContactCreateParamsSchema,
+  ContactUpdateParamsSchema,
+  ListContactsParamsSchema,
+  ListContactsResponseSchema,
+  SearchContactsParamsSchema,
+
+  // Companies
+  CompanySchema,
+  CreateCompanyParamsSchema,
+  CreateCompanyResponseSchema,
+  GetCompanyResponseSchema,
+  ListCompaniesParamsSchema,
+  ListCompaniesResponseSchema,
+  UpdateCompanyParamsSchema,
+  UpdateCompanyResponseSchema,
+  SearchCompaniesResponseSchema,
+
+  // Company Members
+  AddCompanyMembersParamsSchema,
+  AddCompanyMembersResponseSchema,
+  ListCompanyMembersResponseSchema,
+  RemoveCompanyMembersParamsSchema,
+
+  // Inboxes
+  ArticleSchema,
+  SearchParamsSchema,
+  SearchResponseSchema,
+  UploadWhatsappMediaParamsSchema,
+  UploadWhatsappMediaResponseSchema,
+
+  // Orders
+  OrderSchema,
+  OrdersMetaSchema,
+  ListOrdersParamsSchema,
+  ListOrdersResponseSchema,
+  UpsertOrderParamsSchema,
+  UpsertOrderRequestSchema,
+  UpsertOrderResponseSchema,
+  UpsertOrderResponsePayloadSchema,
+
+  // Webhooks
+  WebhookEventSchema,
+  MessageCreatedEventSchema,
+  MessageUpdatedEventSchema,
+  WebhookConversationSchema,
+  WebhookMessageSchema,
+  WebhookSenderSchema,
+} from "@voltade/envoy-sdk";
 
 // Validate data at runtime
-const messageData = {
-  id: 123,
-  content: 'Hello',
-  message_type: 'outgoing',
-  // ... other fields
-};
-
 const validatedMessage = MessageSchema.parse(messageData);
 
 // Validate user input
-const userInput = {
-  content: 'Hello, world!',
-  message_type: 'outgoing',
-  private: false
-};
-
 const validatedParams = CreateMessageParamsSchema.parse(userInput);
 await client.conversations.createMessage(123, validatedParams);
 ```
 
-### Available Schemas
-
-All schemas are exported from the SDK:
-- `MessageTypeSchema`
-- `ContentTypeSchema`
-- `CreateMessageParamsSchema`
-- `MessageSchema`
-- `EscalationTypeSchema`
-- `PrioritySchema`
-- `TeamSchema`
-- `AgentSchema`
-- `EscalationResponseSchema`
-- `ConversationStatusSchema`
-- `ConversationSchema`
+---
 
 ## Development
 

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from "./http-client.js";
-import { Companies, Conversations, Inboxes, Orders } from "./resources/index.js";
+import { Companies, Contacts, Conversations, Inboxes, Orders } from "./resources/index.js";
 /**
  * Configuration options for EnvoyClient
  */
@@ -43,6 +43,10 @@ export declare class EnvoyClient {
      * Companies resource for managing companies
      */
     readonly companies: Companies;
+    /**
+     * Contacts resource for managing contacts
+     */
+    readonly contacts: Contacts;
     /**
      * Conversations resource for managing conversations and messages
      */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,aAAa,EACb,OAAO,EACP,MAAM,EACP,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;OAEG;IACH,SAAgB,SAAS,EAAE,SAAS,CAAC;IAErC;;OAEG;IACH,SAAgB,aAAa,EAAE,aAAa,CAAC;IAE7C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,iBAAiB;IAcrC;;;OAGG;IACH,aAAa,IAAI,UAAU;CAG5B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,OAAO,EACP,MAAM,EACP,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;OAEG;IACH,SAAgB,SAAS,EAAE,SAAS,CAAC;IAErC;;OAEG;IACH,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC;;OAEG;IACH,SAAgB,aAAa,EAAE,aAAa,CAAC;IAE7C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,iBAAiB;IAerC;;;OAGG;IACH,aAAa,IAAI,UAAU;CAG5B"}

package/dist/client.js

@@ -1,5 +1,5 @@
 import { HttpClient } from "./http-client.js";
-import { Companies, Conversations, Inboxes, Orders, } from "./resources/index.js";
+import { Companies, Contacts, Conversations, Inboxes, Orders, } from "./resources/index.js";
 /**
  * Envoy API Client
  * A comprehensive SDK for interacting with the Envoy API
@@ -36,6 +36,7 @@ export class EnvoyClient {
         this.httpClient = new HttpClient(httpConfig);
         // Initialize resources
         this.companies = new Companies(this.httpClient);
+        this.contacts = new Contacts(this.httpClient);
         this.conversations = new Conversations(this.httpClient);
         this.inboxes = new Inboxes(this.httpClient);
         this.orders = new Orders(this.httpClient);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,aAAa,EACb,OAAO,EACP,MAAM,GACP,MAAM,sBAAsB,CAAC;AAY9B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,WAAW;IAuBtB,YAAY,MAAyB;QACnC,MAAM,UAAU,GAAqB;YACnC,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAE7C,uBAAuB;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,OAAO,EACP,MAAM,GACP,MAAM,sBAAsB,CAAC;AAY9B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,WAAW;IA4BtB,YAAY,MAAyB;QACnC,MAAM,UAAU,GAAqB;YACnC,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAE7C,uBAAuB;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/resources/contacts/index.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Contacts resource module
+ * Provides functionality for managing contacts in Envoy
+ */
+import type { HttpClient } from "../../http-client.js";
+import type { Contact } from "../conversations/types.js";
+import type { ContactCreateParams, ContactUpdateParams, ListContactsParams, ListContactsResponse, SearchContactsParams } from "./types.js";
+/**
+ * Base resource class that all resource classes extend from
+ */
+declare abstract class BaseResource {
+    protected readonly client: HttpClient;
+    constructor(client: HttpClient);
+}
+/**
+ * Contacts resource class for managing contact-related operations
+ */
+export declare class Contacts extends BaseResource {
+    /**
+     * Create a new contact
+     * @param params - Contact creation parameters (inbox_id is required)
+     * @returns The created contact
+     *
+     * @example
+     * ```typescript
+     * const contact = await client.contacts.create({
+     *   inbox_id: 1,
+     *   name: 'John Doe',
+     *   email: 'john@example.com',
+     *   phone_number: '+1234567890',
+     *   custom_attributes: { plan: 'enterprise' }
+     * });
+     * console.log(contact.id);
+     * ```
+     */
+    create(params: ContactCreateParams): Promise<Contact>;
+    /**
+     * Update an existing contact
+     * @param contactId - ID of the contact to update
+     * @param params - Contact update parameters
+     * @returns The updated contact
+     *
+     * @example
+     * ```typescript
+     * const contact = await client.contacts.update(123, {
+     *   name: 'Jane Doe',
+     *   email: 'jane@example.com',
+     *   custom_attributes: { plan: 'pro' }
+     * });
+     * ```
+     */
+    update(contactId: number, params: ContactUpdateParams): Promise<Contact>;
+    /**
+     * Get a contact by ID
+     * @param contactId - ID of the contact
+     * @returns The contact details
+     *
+     * @example
+     * ```typescript
+     * const contact = await client.contacts.get(123);
+     * console.log(contact.name, contact.email);
+     * ```
+     */
+    get(contactId: number): Promise<Contact>;
+    /**
+     * Delete a contact
+     * @param contactId - ID of the contact to delete
+     *
+     * @example
+     * ```typescript
+     * await client.contacts.delete(123);
+     * ```
+     */
+    delete(contactId: number): Promise<void>;
+    /**
+     * List all contacts with pagination
+     * @param params - Query parameters for pagination and sorting
+     * @returns Paginated list of contacts
+     *
+     * @example
+     * ```typescript
+     * const response = await client.contacts.list({ page: 1 });
+     * console.log(response.payload); // Array of contacts
+     * ```
+     */
+    list(params?: ListContactsParams): Promise<ListContactsResponse>;
+    /**
+     * Search contacts by name, identifier, email, or phone number
+     * @param params - Search query and pagination parameters
+     * @returns Matching contacts
+     *
+     * @example
+     * ```typescript
+     * const response = await client.contacts.search({
+     *   q: 'john@example.com',
+     *   page: 1
+     * });
+     * console.log(response.payload);
+     * ```
+     */
+    search(params: SearchContactsParams): Promise<ListContactsResponse>;
+}
+export type { ContactCreateParams, ContactUpdateParams, ListContactsParams, ListContactsResponse, SearchContactsParams, } from "./types.js";
+export { ContactCreateParamsSchema, ContactUpdateParamsSchema, ListContactsParamsSchema, ListContactsResponseSchema, SearchContactsParamsSchema, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/contacts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../resources/contacts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,uBAAe,YAAY;IACb,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;CAClD;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D;;;;;;;;;;;;;;OAcG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;;;OAUG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;;;;;;;OAQG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;;;;;;;;OAUG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAetE;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAgB1E;AAGD,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/resources/contacts/index.js

@@ -0,0 +1,135 @@
+/**
+ * Contacts resource module
+ * Provides functionality for managing contacts in Envoy
+ */
+/**
+ * Base resource class that all resource classes extend from
+ */
+class BaseResource {
+    constructor(client) {
+        this.client = client;
+    }
+}
+/**
+ * Contacts resource class for managing contact-related operations
+ */
+export class Contacts extends BaseResource {
+    /**
+     * Create a new contact
+     * @param params - Contact creation parameters (inbox_id is required)
+     * @returns The created contact
+     *
+     * @example
+     * ```typescript
+     * const contact = await client.contacts.create({
+     *   inbox_id: 1,
+     *   name: 'John Doe',
+     *   email: 'john@example.com',
+     *   phone_number: '+1234567890',
+     *   custom_attributes: { plan: 'enterprise' }
+     * });
+     * console.log(contact.id);
+     * ```
+     */
+    async create(params) {
+        return await this.client.post("/contacts", params);
+    }
+    /**
+     * Update an existing contact
+     * @param contactId - ID of the contact to update
+     * @param params - Contact update parameters
+     * @returns The updated contact
+     *
+     * @example
+     * ```typescript
+     * const contact = await client.contacts.update(123, {
+     *   name: 'Jane Doe',
+     *   email: 'jane@example.com',
+     *   custom_attributes: { plan: 'pro' }
+     * });
+     * ```
+     */
+    async update(contactId, params) {
+        return await this.client.put(`/contacts/${contactId}`, params);
+    }
+    /**
+     * Get a contact by ID
+     * @param contactId - ID of the contact
+     * @returns The contact details
+     *
+     * @example
+     * ```typescript
+     * const contact = await client.contacts.get(123);
+     * console.log(contact.name, contact.email);
+     * ```
+     */
+    async get(contactId) {
+        return await this.client.get(`/contacts/${contactId}`);
+    }
+    /**
+     * Delete a contact
+     * @param contactId - ID of the contact to delete
+     *
+     * @example
+     * ```typescript
+     * await client.contacts.delete(123);
+     * ```
+     */
+    async delete(contactId) {
+        await this.client.delete(`/contacts/${contactId}`);
+    }
+    /**
+     * List all contacts with pagination
+     * @param params - Query parameters for pagination and sorting
+     * @returns Paginated list of contacts
+     *
+     * @example
+     * ```typescript
+     * const response = await client.contacts.list({ page: 1 });
+     * console.log(response.payload); // Array of contacts
+     * ```
+     */
+    async list(params) {
+        const queryParams = {};
+        if (params?.page !== undefined) {
+            queryParams.page = params.page;
+        }
+        if (params?.sort) {
+            queryParams.sort = params.sort;
+        }
+        return await this.client.get("/contacts", {
+            params: queryParams,
+        });
+    }
+    /**
+     * Search contacts by name, identifier, email, or phone number
+     * @param params - Search query and pagination parameters
+     * @returns Matching contacts
+     *
+     * @example
+     * ```typescript
+     * const response = await client.contacts.search({
+     *   q: 'john@example.com',
+     *   page: 1
+     * });
+     * console.log(response.payload);
+     * ```
+     */
+    async search(params) {
+        const queryParams = {
+            q: params.q,
+        };
+        if (params.page !== undefined) {
+            queryParams.page = params.page;
+        }
+        if (params.sort) {
+            queryParams.sort = params.sort;
+        }
+        return await this.client.get("/contacts/search", {
+            params: queryParams,
+        });
+    }
+}
+// Re-export Zod schemas
+export { ContactCreateParamsSchema, ContactUpdateParamsSchema, ListContactsParamsSchema, ListContactsResponseSchema, SearchContactsParamsSchema, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/resources/contacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../resources/contacts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;GAEG;AACH,MAAe,YAAY;IACzB,YAA+B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACxC;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAU,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,MAA2B;QAE3B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAU,aAAa,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAU,aAAa,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,CAAC,MAA2B;QACpC,MAAM,WAAW,GAAoC,EAAE,CAAC;QAExD,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YACjB,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAuB,WAAW,EAAE;YAC9D,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,MAAM,WAAW,GAAoC;YACnD,CAAC,EAAE,MAAM,CAAC,CAAC;SACZ,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAuB,kBAAkB,EAAE;YACrE,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;CACF;AAWD,wBAAwB;AACxB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/resources/contacts/types.d.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+import { ContactSchema, ContactInboxSchema, type Contact, type ContactInbox } from "../conversations/types.js";
+/**
+ * Zod Schemas for Contacts
+ */
+export declare const ContactCreateParamsSchema: z.ZodObject<{
+    inbox_id: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone_number: z.ZodOptional<z.ZodString>;
+    avatar_url: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodOptional<z.ZodString>;
+    custom_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    inbox_id: number;
+    name?: string | undefined;
+    email?: string | undefined;
+    avatar_url?: string | undefined;
+    phone_number?: string | undefined;
+    identifier?: string | undefined;
+    custom_attributes?: Record<string, unknown> | undefined;
+}, {
+    inbox_id: number;
+    name?: string | undefined;
+    email?: string | undefined;
+    avatar_url?: string | undefined;
+    phone_number?: string | undefined;
+    identifier?: string | undefined;
+    custom_attributes?: Record<string, unknown> | undefined;
+}>;
+export declare const ContactUpdateParamsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone_number: z.ZodOptional<z.ZodString>;
+    avatar_url: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodOptional<z.ZodString>;
+    custom_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    email?: string | undefined;
+    avatar_url?: string | undefined;
+    phone_number?: string | undefined;
+    identifier?: string | undefined;
+    custom_attributes?: Record<string, unknown> | undefined;
+}, {
+    name?: string | undefined;
+    email?: string | undefined;
+    avatar_url?: string | undefined;
+    phone_number?: string | undefined;
+    identifier?: string | undefined;
+    custom_attributes?: Record<string, unknown> | undefined;
+}>;
+export declare const ListContactsParamsSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sort: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    sort?: string | undefined;
+}, {
+    sort?: string | undefined;
+    page?: number | undefined;
+}>;
+export declare const ListContactsResponseSchema: z.ZodObject<{
+    payload: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        phone_number: z.ZodNullable<z.ZodString>;
+        thumbnail: z.ZodString;
+        identifier: z.ZodNullable<z.ZodString>;
+        additional_attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        custom_attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        blocked: z.ZodBoolean;
+        customer_stage: z.ZodString;
+        customer_stage_explanation: z.ZodNullable<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string | null;
+        id: number;
+        email: string | null;
+        thumbnail: string;
+        phone_number: string | null;
+        identifier: string | null;
+        additional_attributes: Record<string, unknown>;
+        custom_attributes: Record<string, unknown>;
+        blocked: boolean;
+        customer_stage: string;
+        customer_stage_explanation: string | null;
+        type?: string | undefined;
+    }, {
+        name: string | null;
+        id: number;
+        email: string | null;
+        thumbnail: string;
+        phone_number: string | null;
+        identifier: string | null;
+        additional_attributes: Record<string, unknown>;
+        custom_attributes: Record<string, unknown>;
+        blocked: boolean;
+        customer_stage: string;
+        customer_stage_explanation: string | null;
+        type?: string | undefined;
+    }>, "many">;
+    meta: z.ZodOptional<z.ZodObject<{
+        count: z.ZodOptional<z.ZodNumber>;
+        current_page: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        count?: number | undefined;
+        current_page?: number | undefined;
+    }, {
+        count?: number | undefined;
+        current_page?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    payload: {
+        name: string | null;
+        id: number;
+        email: string | null;
+        thumbnail: string;
+        phone_number: string | null;
+        identifier: string | null;
+        additional_attributes: Record<string, unknown>;
+        custom_attributes: Record<string, unknown>;
+        blocked: boolean;
+        customer_stage: string;
+        customer_stage_explanation: string | null;
+        type?: string | undefined;
+    }[];
+    meta?: {
+        count?: number | undefined;
+        current_page?: number | undefined;
+    } | undefined;
+}, {
+    payload: {
+        name: string | null;
+        id: number;
+        email: string | null;
+        thumbnail: string;
+        phone_number: string | null;
+        identifier: string | null;
+        additional_attributes: Record<string, unknown>;
+        custom_attributes: Record<string, unknown>;
+        blocked: boolean;
+        customer_stage: string;
+        customer_stage_explanation: string | null;
+        type?: string | undefined;
+    }[];
+    meta?: {
+        count?: number | undefined;
+        current_page?: number | undefined;
+    } | undefined;
+}>;
+export declare const SearchContactsParamsSchema: z.ZodObject<{
+    q: z.ZodString;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sort: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    q: string;
+    sort?: string | undefined;
+}, {
+    q: string;
+    sort?: string | undefined;
+    page?: number | undefined;
+}>;
+/**
+ * TypeScript Types (inferred from Zod schemas)
+ */
+export type ContactCreateParams = z.infer<typeof ContactCreateParamsSchema>;
+export type ContactUpdateParams = z.infer<typeof ContactUpdateParamsSchema>;
+export type ListContactsParams = z.infer<typeof ListContactsParamsSchema>;
+export type ListContactsResponse = z.infer<typeof ListContactsResponseSchema>;
+export type SearchContactsParams = z.infer<typeof SearchContactsParamsSchema>;
+export { ContactSchema, ContactInboxSchema };
+export type { Contact, ContactInbox };
+//# sourceMappingURL=types.d.ts.map

package/dist/resources/contacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../resources/contacts/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AAGH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAkBpC,CAAC;AAGH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAiBpC,CAAC;AAGH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQrC,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/resources/contacts/types.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { ContactSchema, ContactInboxSchema, } from "../conversations/types.js";
+/**
+ * Zod Schemas for Contacts
+ */
+// Contact create parameters schema
+export const ContactCreateParamsSchema = z.object({
+    inbox_id: z.number().describe("ID of the inbox"),
+    name: z.string().optional().describe("Name of the contact"),
+    email: z.string().email().optional().describe("Email of the contact"),
+    phone_number: z.string().optional().describe("Phone number of the contact"),
+    avatar_url: z
+        .string()
+        .url()
+        .optional()
+        .describe("URL to a jpeg, png file for the contact avatar"),
+    identifier: z
+        .string()
+        .optional()
+        .describe("A unique identifier for the contact in external system"),
+    custom_attributes: z
+        .record(z.unknown())
+        .optional()
+        .describe("Custom attributes for the contact"),
+});
+// Contact update parameters schema
+export const ContactUpdateParamsSchema = z.object({
+    name: z.string().optional().describe("Name of the contact"),
+    email: z.string().email().optional().describe("Email of the contact"),
+    phone_number: z.string().optional().describe("Phone number of the contact"),
+    avatar_url: z
+        .string()
+        .url()
+        .optional()
+        .describe("URL to a jpeg, png file for the contact avatar"),
+    identifier: z
+        .string()
+        .optional()
+        .describe("A unique identifier for the contact in external system"),
+    custom_attributes: z
+        .record(z.unknown())
+        .optional()
+        .describe("Custom attributes for the contact"),
+});
+// List contacts parameters schema
+export const ListContactsParamsSchema = z.object({
+    page: z.number().int().positive().optional().default(1),
+    sort: z.string().optional().describe("Sort order for contacts"),
+});
+// List contacts response schema
+export const ListContactsResponseSchema = z.object({
+    payload: z.array(ContactSchema),
+    meta: z
+        .object({
+        count: z.number().optional(),
+        current_page: z.number().optional(),
+    })
+        .optional(),
+});
+// Search contacts parameters schema
+export const SearchContactsParamsSchema = z.object({
+    q: z.string().describe("Search query (name, identifier, email, or phone)"),
+    page: z.number().int().positive().optional().default(1),
+    sort: z.string().optional().describe("Sort order for contacts"),
+});
+// Re-export from conversations for convenience
+export { ContactSchema, ContactInboxSchema };
+//# sourceMappingURL=types.js.map

package/dist/resources/contacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../resources/contacts/types.ts"],"names":[],"mappings":"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"}

package/dist/resources/index.d.ts

@@ -4,6 +4,7 @@
  */
 export * from "./companies/index.js";
 export * from "./company-members/index.js";
+export * from "./contacts/index.js";
 export * from "./conversations/index.js";
 export * from "./inboxes/index.js";
 export * from "./orders/index.js";

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/resources/index.js

@@ -4,6 +4,7 @@
  */
 export * from "./companies/index.js";
 export * from "./company-members/index.js";
+export * from "./contacts/index.js";
 export * from "./conversations/index.js";
 export * from "./inboxes/index.js";
 export * from "./orders/index.js";

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltade/envoy-sdk",
-  "version": "1.2.16",
+  "version": "1.3.1",
   "type": "module",
   "description": "A comprehensive TypeScript SDK for the Envoy API with built-in error handling and resource-based architecture",
   "main": "./dist/index.js",