emailr 1.3.3 → 1.4.0

package/dist/index.d.mts

@@ -34,6 +34,81 @@ interface PaginatedResponse<T> {
 interface SuccessResponse {
     success: boolean;
 }
+interface Inbox {
+    id: string;
+    organization_id: string;
+    name: string;
+    username: string;
+    domain: string;
+    from_address: string;
+    inbound_address: string;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateInboxRequest {
+    name: string;
+    username: string;
+    domain: string;
+}
+interface UpdateInboxRequest {
+    name?: string;
+}
+interface ListInboxesParams {
+}
+interface Thread {
+    thread_id: string;
+    subject: string | null;
+    latest_email_id: string;
+    from_email: string;
+    to_email: string;
+    preview: string | null;
+    labels: string[];
+    message_count: number;
+    participants: string[];
+    has_attachments: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface ThreadMessage {
+    id: string;
+    from_email: string;
+    to_email: string;
+    cc_emails: string[] | null;
+    bcc_emails: string[] | null;
+    subject: string | null;
+    html_content: string | null;
+    text_content: string | null;
+    status: string;
+    labels: string[];
+    attachments: unknown[] | null;
+    created_at: string;
+    sent_at: string | null;
+}
+interface ThreadDetail {
+    thread_id: string;
+    subject: string | null;
+    labels: string[];
+    messages: ThreadMessage[];
+}
+interface ListThreadsParams {
+    label?: string;
+    page?: number;
+    limit?: number;
+    search?: string;
+    inbox_id?: string;
+}
+interface UpdateLabelsRequest {
+    add?: string[];
+    remove?: string[];
+}
+interface UpdateLabelsResponse {
+    success: boolean;
+    labels: string[];
+}
+interface UpdateThreadLabelsResponse {
+    success: boolean;
+    updated: number;
+}
 interface Attachment {
     filename: string;
     content: string;
@@ -99,6 +174,12 @@ interface Email {
 interface ListEmailsParams {
     page?: number;
     limit?: number;
+    status?: string;
+    email?: string;
+    domain?: string;
+    broadcast_id?: string;
+    email_id?: string;
+    template_id?: string;
 }
 interface ForwardEmailRequest {
     email_id: string;
@@ -183,6 +264,7 @@ interface Template {
     reply_to: string | null;
     preview_text: string | null;
     created_by: string | null;
+    inbox_id: string | null;
     created_at: string;
     updated_at: string;
 }
@@ -197,6 +279,7 @@ interface CreateTemplateRequest {
     from_name?: string;
     reply_to?: string;
     preview_text?: string;
+    inbox_id?: string;
 }
 interface UpdateTemplateRequest {
     name?: string;
@@ -209,6 +292,7 @@ interface UpdateTemplateRequest {
     from_name?: string;
     reply_to?: string;
     preview_text?: string;
+    inbox_id?: string;
 }
 interface ListTemplatesParams {
     page?: number;
@@ -322,6 +406,8 @@ interface Broadcast {
     subject: string;
     from_email: string;
     from_name: string | null;
+    reply_to: string | null;
+    preview_text: string | null;
     template_id: string | null;
     segment_id: string | null;
     status: string;
@@ -337,30 +423,37 @@ interface Broadcast {
     tags?: string[];
     created_by: string | null;
     created_at: string;
+    inbox_id: string | null;
 }
 interface CreateBroadcastRequest {
     name: string;
     subject: string;
     from_email: string;
     from_name?: string;
+    reply_to?: string;
+    preview_text?: string;
     template_id?: string;
     segment_id?: string;
     html_content?: string;
     text_content?: string;
     scheduled_at?: string;
     tags?: string[];
+    inbox_id?: string;
 }
 interface UpdateBroadcastRequest {
     name?: string;
     subject?: string;
     from_email?: string;
     from_name?: string;
+    reply_to?: string;
+    preview_text?: string;
     template_id?: string;
     segment_id?: string;
     html_content?: string;
     text_content?: string;
     scheduled_at?: string;
     tags?: string[];
+    inbox_id?: string;
 }
 interface SendBroadcastResponse {
     success: boolean;
@@ -503,6 +596,31 @@ interface EmailMetrics {
     complained: number;
 }
 
+declare class InboxesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new inbox
+     */
+    create(data: CreateInboxRequest): Promise<Inbox>;
+    /**
+     * List all inboxes for the organization
+     */
+    list(): Promise<Inbox[]>;
+    /**
+     * Get inbox by ID
+     */
+    get(id: string): Promise<Inbox>;
+    /**
+     * Update an inbox
+     */
+    update(id: string, data: UpdateInboxRequest): Promise<Inbox>;
+    /**
+     * Delete an inbox
+     */
+    delete(id: string): Promise<SuccessResponse>;
+}
+
 declare class EmailsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -884,6 +1002,27 @@ declare class ForwardingRulesResource {
     delete(id: string): Promise<SuccessResponse>;
 }
 
+declare class ThreadsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List email threads with optional filtering by label, search, and inbox
+     */
+    list(params?: ListThreadsParams): Promise<PaginatedResponse<Thread>>;
+    /**
+     * Get thread detail with all messages
+     */
+    get(threadId: string): Promise<ThreadDetail>;
+    /**
+     * Add or remove labels from all emails in a thread
+     */
+    updateLabels(threadId: string, data: UpdateLabelsRequest): Promise<UpdateThreadLabelsResponse>;
+    /**
+     * Add or remove labels from a single email
+     */
+    updateEmailLabels(emailId: string, data: UpdateLabelsRequest): Promise<UpdateLabelsResponse>;
+}
+
 /**
  * Configuration options for the Emailr client
  */
@@ -971,6 +1110,14 @@ declare class Emailr {
      * Email forwarding rules
      */
     readonly forwardingRules: ForwardingRulesResource;
+    /**
+     * Inbox management
+     */
+    readonly inboxes: InboxesResource;
+    /**
+     * Thread and label management
+     */
+    readonly threads: ThreadsResource;
     private readonly http;
     constructor(config: EmailrConfig);
 }
@@ -1018,4 +1165,4 @@ declare class ValidationError extends EmailrError {
     constructor(message: string, details?: Record<string, unknown>, requestId?: string);
 }
 
-export { type AddDomainRequest, type ApiKey, type Attachment, AuthenticationError, type Broadcast, type BulkCreateContactsRequest, type BulkCreateContactsResponse, type Contact, type ContactListResponse, type CreateApiKeyRequest, type CreateBroadcastRequest, type CreateContactRequest, type CreateForwardingRuleRequest, type CreateSegmentRequest, type CreateTemplateRequest, type CreateWebhookRequest, type DnsRecord, type DnsVerificationStatus, type Domain, type DomainDnsRecords, type DomainVerificationStatus, type Email, Emailr, Emailr as EmailrClient, type EmailrConfig, EmailrError, type FetchTemplateOptions, type ForwardEmailRequest, type ForwardingRule, type ListApiKeysParams, type ListBroadcastsParams, type ListContactsParams, type ListEmailsParams, type ListSegmentsParams, type ListTemplatesParams, type ListWebhooksParams, NetworkError, NotFoundError, type PaginatedResponse, type PushPreviewResponse, RateLimitError, type ReplyTo, type Segment, type SendBroadcastResponse, type SendEmailRequest, type SendEmailResponse, type SuccessResponse, type Template, type UpdateBroadcastRequest, type UpdateContactRequest, type UpdateDomainRequest, type UpdateSegmentRequest, type UpdateTemplateRequest, type UpdateWebhookRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookToggleResponse };
+export { type AddDomainRequest, type ApiKey, type Attachment, AuthenticationError, type Broadcast, type BulkCreateContactsRequest, type BulkCreateContactsResponse, type Contact, type ContactListResponse, type CreateApiKeyRequest, type CreateBroadcastRequest, type CreateContactRequest, type CreateForwardingRuleRequest, type CreateInboxRequest, type CreateSegmentRequest, type CreateTemplateRequest, type CreateWebhookRequest, type DnsRecord, type DnsVerificationStatus, type Domain, type DomainDnsRecords, type DomainVerificationStatus, type Email, Emailr, Emailr as EmailrClient, type EmailrConfig, EmailrError, type FetchTemplateOptions, type ForwardEmailRequest, type ForwardingRule, type Inbox, type ListApiKeysParams, type ListBroadcastsParams, type ListContactsParams, type ListEmailsParams, type ListInboxesParams, type ListSegmentsParams, type ListTemplatesParams, type ListThreadsParams, type ListWebhooksParams, NetworkError, NotFoundError, type PaginatedResponse, type PushPreviewResponse, RateLimitError, type ReplyTo, type Segment, type SendBroadcastResponse, type SendEmailRequest, type SendEmailResponse, type SuccessResponse, type Template, type Thread, type ThreadDetail, type ThreadMessage, type UpdateBroadcastRequest, type UpdateContactRequest, type UpdateDomainRequest, type UpdateInboxRequest, type UpdateLabelsRequest, type UpdateLabelsResponse, type UpdateSegmentRequest, type UpdateTemplateRequest, type UpdateThreadLabelsResponse, type UpdateWebhookRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookToggleResponse };

package/dist/index.d.ts

@@ -34,6 +34,81 @@ interface PaginatedResponse<T> {
 interface SuccessResponse {
     success: boolean;
 }
+interface Inbox {
+    id: string;
+    organization_id: string;
+    name: string;
+    username: string;
+    domain: string;
+    from_address: string;
+    inbound_address: string;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateInboxRequest {
+    name: string;
+    username: string;
+    domain: string;
+}
+interface UpdateInboxRequest {
+    name?: string;
+}
+interface ListInboxesParams {
+}
+interface Thread {
+    thread_id: string;
+    subject: string | null;
+    latest_email_id: string;
+    from_email: string;
+    to_email: string;
+    preview: string | null;
+    labels: string[];
+    message_count: number;
+    participants: string[];
+    has_attachments: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface ThreadMessage {
+    id: string;
+    from_email: string;
+    to_email: string;
+    cc_emails: string[] | null;
+    bcc_emails: string[] | null;
+    subject: string | null;
+    html_content: string | null;
+    text_content: string | null;
+    status: string;
+    labels: string[];
+    attachments: unknown[] | null;
+    created_at: string;
+    sent_at: string | null;
+}
+interface ThreadDetail {
+    thread_id: string;
+    subject: string | null;
+    labels: string[];
+    messages: ThreadMessage[];
+}
+interface ListThreadsParams {
+    label?: string;
+    page?: number;
+    limit?: number;
+    search?: string;
+    inbox_id?: string;
+}
+interface UpdateLabelsRequest {
+    add?: string[];
+    remove?: string[];
+}
+interface UpdateLabelsResponse {
+    success: boolean;
+    labels: string[];
+}
+interface UpdateThreadLabelsResponse {
+    success: boolean;
+    updated: number;
+}
 interface Attachment {
     filename: string;
     content: string;
@@ -99,6 +174,12 @@ interface Email {
 interface ListEmailsParams {
     page?: number;
     limit?: number;
+    status?: string;
+    email?: string;
+    domain?: string;
+    broadcast_id?: string;
+    email_id?: string;
+    template_id?: string;
 }
 interface ForwardEmailRequest {
     email_id: string;
@@ -183,6 +264,7 @@ interface Template {
     reply_to: string | null;
     preview_text: string | null;
     created_by: string | null;
+    inbox_id: string | null;
     created_at: string;
     updated_at: string;
 }
@@ -197,6 +279,7 @@ interface CreateTemplateRequest {
     from_name?: string;
     reply_to?: string;
     preview_text?: string;
+    inbox_id?: string;
 }
 interface UpdateTemplateRequest {
     name?: string;
@@ -209,6 +292,7 @@ interface UpdateTemplateRequest {
     from_name?: string;
     reply_to?: string;
     preview_text?: string;
+    inbox_id?: string;
 }
 interface ListTemplatesParams {
     page?: number;
@@ -322,6 +406,8 @@ interface Broadcast {
     subject: string;
     from_email: string;
     from_name: string | null;
+    reply_to: string | null;
+    preview_text: string | null;
     template_id: string | null;
     segment_id: string | null;
     status: string;
@@ -337,30 +423,37 @@ interface Broadcast {
     tags?: string[];
     created_by: string | null;
     created_at: string;
+    inbox_id: string | null;
 }
 interface CreateBroadcastRequest {
     name: string;
     subject: string;
     from_email: string;
     from_name?: string;
+    reply_to?: string;
+    preview_text?: string;
     template_id?: string;
     segment_id?: string;
     html_content?: string;
     text_content?: string;
     scheduled_at?: string;
     tags?: string[];
+    inbox_id?: string;
 }
 interface UpdateBroadcastRequest {
     name?: string;
     subject?: string;
     from_email?: string;
     from_name?: string;
+    reply_to?: string;
+    preview_text?: string;
     template_id?: string;
     segment_id?: string;
     html_content?: string;
     text_content?: string;
     scheduled_at?: string;
     tags?: string[];
+    inbox_id?: string;
 }
 interface SendBroadcastResponse {
     success: boolean;
@@ -503,6 +596,31 @@ interface EmailMetrics {
     complained: number;
 }
 
+declare class InboxesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new inbox
+     */
+    create(data: CreateInboxRequest): Promise<Inbox>;
+    /**
+     * List all inboxes for the organization
+     */
+    list(): Promise<Inbox[]>;
+    /**
+     * Get inbox by ID
+     */
+    get(id: string): Promise<Inbox>;
+    /**
+     * Update an inbox
+     */
+    update(id: string, data: UpdateInboxRequest): Promise<Inbox>;
+    /**
+     * Delete an inbox
+     */
+    delete(id: string): Promise<SuccessResponse>;
+}
+
 declare class EmailsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -884,6 +1002,27 @@ declare class ForwardingRulesResource {
     delete(id: string): Promise<SuccessResponse>;
 }
 
+declare class ThreadsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List email threads with optional filtering by label, search, and inbox
+     */
+    list(params?: ListThreadsParams): Promise<PaginatedResponse<Thread>>;
+    /**
+     * Get thread detail with all messages
+     */
+    get(threadId: string): Promise<ThreadDetail>;
+    /**
+     * Add or remove labels from all emails in a thread
+     */
+    updateLabels(threadId: string, data: UpdateLabelsRequest): Promise<UpdateThreadLabelsResponse>;
+    /**
+     * Add or remove labels from a single email
+     */
+    updateEmailLabels(emailId: string, data: UpdateLabelsRequest): Promise<UpdateLabelsResponse>;
+}
+
 /**
  * Configuration options for the Emailr client
  */
@@ -971,6 +1110,14 @@ declare class Emailr {
      * Email forwarding rules
      */
     readonly forwardingRules: ForwardingRulesResource;
+    /**
+     * Inbox management
+     */
+    readonly inboxes: InboxesResource;
+    /**
+     * Thread and label management
+     */
+    readonly threads: ThreadsResource;
     private readonly http;
     constructor(config: EmailrConfig);
 }
@@ -1018,4 +1165,4 @@ declare class ValidationError extends EmailrError {
     constructor(message: string, details?: Record<string, unknown>, requestId?: string);
 }
 
-export { type AddDomainRequest, type ApiKey, type Attachment, AuthenticationError, type Broadcast, type BulkCreateContactsRequest, type BulkCreateContactsResponse, type Contact, type ContactListResponse, type CreateApiKeyRequest, type CreateBroadcastRequest, type CreateContactRequest, type CreateForwardingRuleRequest, type CreateSegmentRequest, type CreateTemplateRequest, type CreateWebhookRequest, type DnsRecord, type DnsVerificationStatus, type Domain, type DomainDnsRecords, type DomainVerificationStatus, type Email, Emailr, Emailr as EmailrClient, type EmailrConfig, EmailrError, type FetchTemplateOptions, type ForwardEmailRequest, type ForwardingRule, type ListApiKeysParams, type ListBroadcastsParams, type ListContactsParams, type ListEmailsParams, type ListSegmentsParams, type ListTemplatesParams, type ListWebhooksParams, NetworkError, NotFoundError, type PaginatedResponse, type PushPreviewResponse, RateLimitError, type ReplyTo, type Segment, type SendBroadcastResponse, type SendEmailRequest, type SendEmailResponse, type SuccessResponse, type Template, type UpdateBroadcastRequest, type UpdateContactRequest, type UpdateDomainRequest, type UpdateSegmentRequest, type UpdateTemplateRequest, type UpdateWebhookRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookToggleResponse };
+export { type AddDomainRequest, type ApiKey, type Attachment, AuthenticationError, type Broadcast, type BulkCreateContactsRequest, type BulkCreateContactsResponse, type Contact, type ContactListResponse, type CreateApiKeyRequest, type CreateBroadcastRequest, type CreateContactRequest, type CreateForwardingRuleRequest, type CreateInboxRequest, type CreateSegmentRequest, type CreateTemplateRequest, type CreateWebhookRequest, type DnsRecord, type DnsVerificationStatus, type Domain, type DomainDnsRecords, type DomainVerificationStatus, type Email, Emailr, Emailr as EmailrClient, type EmailrConfig, EmailrError, type FetchTemplateOptions, type ForwardEmailRequest, type ForwardingRule, type Inbox, type ListApiKeysParams, type ListBroadcastsParams, type ListContactsParams, type ListEmailsParams, type ListInboxesParams, type ListSegmentsParams, type ListTemplatesParams, type ListThreadsParams, type ListWebhooksParams, NetworkError, NotFoundError, type PaginatedResponse, type PushPreviewResponse, RateLimitError, type ReplyTo, type Segment, type SendBroadcastResponse, type SendEmailRequest, type SendEmailResponse, type SuccessResponse, type Template, type Thread, type ThreadDetail, type ThreadMessage, type UpdateBroadcastRequest, type UpdateContactRequest, type UpdateDomainRequest, type UpdateInboxRequest, type UpdateLabelsRequest, type UpdateLabelsResponse, type UpdateSegmentRequest, type UpdateTemplateRequest, type UpdateThreadLabelsResponse, type UpdateWebhookRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookToggleResponse };

package/dist/index.js

@@ -179,6 +179,43 @@ var HttpClient = class {
   }
 };
 
+// src/resources/inboxes.ts
+var InboxesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Create a new inbox
+   */
+  async create(data) {
+    return this.http.post("/v1/inboxes", data);
+  }
+  /**
+   * List all inboxes for the organization
+   */
+  async list() {
+    return this.http.get("/v1/inboxes");
+  }
+  /**
+   * Get inbox by ID
+   */
+  async get(id) {
+    return this.http.get(`/v1/inboxes/${id}`);
+  }
+  /**
+   * Update an inbox
+   */
+  async update(id, data) {
+    return this.http.put(`/v1/inboxes/${id}`, data);
+  }
+  /**
+   * Delete an inbox
+   */
+  async delete(id) {
+    return this.http.delete(`/v1/inboxes/${id}`);
+  }
+};
+
 // src/resources/emails.ts
 var EmailsResource = class {
   constructor(http) {
@@ -705,6 +742,39 @@ var ForwardingRulesResource = class {
   }
 };
 
+// src/resources/threads.ts
+var ThreadsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List email threads with optional filtering by label, search, and inbox
+   */
+  async list(params) {
+    return this.http.get("/v1/threads", {
+      params
+    });
+  }
+  /**
+   * Get thread detail with all messages
+   */
+  async get(threadId) {
+    return this.http.get(`/v1/threads/${threadId}`);
+  }
+  /**
+   * Add or remove labels from all emails in a thread
+   */
+  async updateLabels(threadId, data) {
+    return this.http.patch(`/v1/threads/${threadId}/labels`, data);
+  }
+  /**
+   * Add or remove labels from a single email
+   */
+  async updateEmailLabels(emailId, data) {
+    return this.http.patch(`/v1/threads/emails/${emailId}/labels`, data);
+  }
+};
+
 // src/client.ts
 var Emailr = class {
   constructor(config) {
@@ -728,6 +798,8 @@ var Emailr = class {
     this.settings = new SettingsResource(this.http);
     this.metrics = new MetricsResource(this.http);
     this.forwardingRules = new ForwardingRulesResource(this.http);
+    this.inboxes = new InboxesResource(this.http);
+    this.threads = new ThreadsResource(this.http);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -146,6 +146,43 @@ var HttpClient = class {
   }
 };
 
+// src/resources/inboxes.ts
+var InboxesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Create a new inbox
+   */
+  async create(data) {
+    return this.http.post("/v1/inboxes", data);
+  }
+  /**
+   * List all inboxes for the organization
+   */
+  async list() {
+    return this.http.get("/v1/inboxes");
+  }
+  /**
+   * Get inbox by ID
+   */
+  async get(id) {
+    return this.http.get(`/v1/inboxes/${id}`);
+  }
+  /**
+   * Update an inbox
+   */
+  async update(id, data) {
+    return this.http.put(`/v1/inboxes/${id}`, data);
+  }
+  /**
+   * Delete an inbox
+   */
+  async delete(id) {
+    return this.http.delete(`/v1/inboxes/${id}`);
+  }
+};
+
 // src/resources/emails.ts
 var EmailsResource = class {
   constructor(http) {
@@ -672,6 +709,39 @@ var ForwardingRulesResource = class {
   }
 };
 
+// src/resources/threads.ts
+var ThreadsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List email threads with optional filtering by label, search, and inbox
+   */
+  async list(params) {
+    return this.http.get("/v1/threads", {
+      params
+    });
+  }
+  /**
+   * Get thread detail with all messages
+   */
+  async get(threadId) {
+    return this.http.get(`/v1/threads/${threadId}`);
+  }
+  /**
+   * Add or remove labels from all emails in a thread
+   */
+  async updateLabels(threadId, data) {
+    return this.http.patch(`/v1/threads/${threadId}/labels`, data);
+  }
+  /**
+   * Add or remove labels from a single email
+   */
+  async updateEmailLabels(emailId, data) {
+    return this.http.patch(`/v1/threads/emails/${emailId}/labels`, data);
+  }
+};
+
 // src/client.ts
 var Emailr = class {
   constructor(config) {
@@ -695,6 +765,8 @@ var Emailr = class {
     this.settings = new SettingsResource(this.http);
     this.metrics = new MetricsResource(this.http);
     this.forwardingRules = new ForwardingRulesResource(this.http);
+    this.inboxes = new InboxesResource(this.http);
+    this.threads = new ThreadsResource(this.http);
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emailr",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "Official Emailr API SDK for TypeScript/JavaScript",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",