@heymantle/core-api-client 0.1.26 → 0.1.27

package/dist/index.mjs

@@ -2634,6 +2634,167 @@ var MeetingsResource = class extends BaseResource {
   }
 };
 
+// src/resources/synced-emails.ts
+var SyncedEmailsResource = class extends BaseResource {
+  /**
+   * List synced email threads with optional filters and pagination
+   *
+   * @param params - Filter and pagination parameters
+   * @returns Paginated list of synced email threads
+   *
+   * @example
+   * ```typescript
+   * // List all synced emails
+   * const { syncedEmails } = await client.syncedEmails.list();
+   *
+   * // List synced emails for a specific customer
+   * const { syncedEmails } = await client.syncedEmails.list({ customerId: 'cust_123' });
+   *
+   * // List Gmail synced emails
+   * const { syncedEmails } = await client.syncedEmails.list({ source: 'gmail' });
+   * ```
+   */
+  async list(params) {
+    const response = await this.get("/synced_emails", params);
+    return {
+      syncedEmails: response.syncedEmails || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      page: response.page,
+      totalPages: response.totalPages
+    };
+  }
+  /**
+   * Retrieve a single synced email thread by ID with all messages
+   *
+   * @param syncedEmailId - The synced email thread ID
+   * @returns The synced email with all messages
+   *
+   * @example
+   * ```typescript
+   * const syncedEmail = await client.syncedEmails.retrieve('se_123');
+   * console.log(syncedEmail.messages?.length);
+   * ```
+   */
+  async retrieve(syncedEmailId) {
+    return this.get(`/synced_emails/${syncedEmailId}`);
+  }
+  /**
+   * Create or sync a synced email thread
+   *
+   * If `emailData.externalId` is provided, performs an upsert: updates the
+   * existing thread and adds new messages if a thread with that externalId
+   * already exists. Otherwise creates a new thread.
+   *
+   * @param data - Email thread and messages data
+   * @returns The created or updated synced email thread
+   *
+   * @example
+   * ```typescript
+   * // Create a new thread (or upsert if externalId matches)
+   * const syncedEmail = await client.syncedEmails.create({
+   *   emailData: {
+   *     externalId: 'gmail-thread-123',
+   *     subject: 'Sales Discussion',
+   *     source: 'gmail',
+   *   },
+   *   messages: [
+   *     {
+   *       externalId: 'msg-1',
+   *       fromEmail: 'prospect@example.com',
+   *       subject: 'Sales Discussion',
+   *       bodyText: 'Interested in your product...',
+   *       date: new Date().toISOString(),
+   *       isInbound: true,
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  async create(data) {
+    return this.post("/synced_emails", data);
+  }
+  /**
+   * Update synced email thread metadata
+   *
+   * @param syncedEmailId - The synced email thread ID
+   * @param data - Fields to update
+   * @returns The updated synced email thread
+   *
+   * @example
+   * ```typescript
+   * // Link email to a deal
+   * const syncedEmail = await client.syncedEmails.update('se_123', {
+   *   dealId: 'deal_456',
+   * });
+   * ```
+   */
+  async update(syncedEmailId, data) {
+    return this.put(`/synced_emails/${syncedEmailId}`, data);
+  }
+  /**
+   * Archive (soft delete) a synced email thread
+   *
+   * @param syncedEmailId - The synced email thread ID
+   * @returns Success response
+   *
+   * @example
+   * ```typescript
+   * await client.syncedEmails.del('se_123');
+   * ```
+   */
+  async del(syncedEmailId) {
+    return this._delete(`/synced_emails/${syncedEmailId}`);
+  }
+  /**
+   * Add messages to an existing synced email thread
+   *
+   * @param syncedEmailId - The synced email thread ID
+   * @param data - Messages to add
+   * @returns The synced email thread with all messages
+   *
+   * @example
+   * ```typescript
+   * const syncedEmail = await client.syncedEmails.addMessages('se_123', {
+   *   messages: [
+   *     {
+   *       externalId: 'msg-2',
+   *       fromEmail: 'you@company.com',
+   *       toEmails: ['prospect@example.com'],
+   *       subject: 'Re: Sales Discussion',
+   *       bodyText: 'Thanks for your interest...',
+   *       date: new Date().toISOString(),
+   *       isInbound: false,
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  async addMessages(syncedEmailId, data) {
+    return this.post(
+      `/synced_emails/${syncedEmailId}/messages`,
+      data
+    );
+  }
+  /**
+   * Get messages for a synced email thread
+   *
+   * @param syncedEmailId - The synced email thread ID
+   * @returns List of messages in the thread
+   *
+   * @example
+   * ```typescript
+   * const { messages } = await client.syncedEmails.getMessages('se_123');
+   * ```
+   */
+  async getMessages(syncedEmailId) {
+    return this.get(
+      `/synced_emails/${syncedEmailId}/messages`
+    );
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -2693,6 +2854,7 @@ var MantleCoreClient = class {
     this.flowExtensions = new FlowExtensionsResource(this);
     this.aiAgentRuns = new AiAgentRunsResource(this);
     this.meetings = new MeetingsResource(this);
+    this.syncedEmails = new SyncedEmailsResource(this);
   }
   /**
    * Register a middleware function
@@ -3133,6 +3295,7 @@ export {
   MiddlewareManager,
   OrganizationResource,
   SubscriptionsResource,
+  SyncedEmailsResource,
   TasksResource,
   TicketsResource,
   TransactionsResource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heymantle/core-api-client",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "TypeScript SDK for the Mantle Core API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",