migma 1.3.3 → 1.3.4

package/dist/index.d.ts

@@ -60,6 +60,16 @@ interface RequestOptions {
     path: string;
     body?: Record<string, unknown>;
     query?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+}
+/** Per-call options for write methods (POST/PATCH/DELETE). */
+interface CallOptions {
+    /**
+     * Optional Idempotency-Key (max 100 chars). Same key + same body within 24h
+     * replays the original response; a different body returns 409 IDEMPOTENCY_CONFLICT.
+     * Reused across the SDK's own automatic retries so a retried call never duplicates.
+     */
+    idempotencyKey?: string;
 }
 declare class MigmaClient {
     private readonly apiKey;
@@ -80,16 +90,17 @@ declare class MigmaClient {
         data: T;
         count: number;
     }>>;
-    post<T>(path: string, body?: Record<string, unknown>): Promise<MigmaResult<T>>;
-    patch<T>(path: string, body?: Record<string, unknown>): Promise<MigmaResult<T>>;
+    post<T>(path: string, body?: Record<string, unknown>, options?: CallOptions): Promise<MigmaResult<T>>;
+    patch<T>(path: string, body?: Record<string, unknown>, options?: CallOptions): Promise<MigmaResult<T>>;
     put<T>(path: string, body?: Record<string, unknown>): Promise<MigmaResult<T>>;
-    delete<T>(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<MigmaResult<T>>;
+    delete<T>(path: string, query?: Record<string, string | number | boolean | undefined>, options?: CallOptions): Promise<MigmaResult<T>>;
+    private callHeaders;
     private buildUrl;
     private parseRetryAfter;
     private sleep;
 }
 
-type ContactStatus = 'active' | 'unsubscribed' | 'bounced' | 'complained';
+type ContactStatus = 'subscribed' | 'unsubscribed' | 'bounced' | 'non-subscribed';
 interface Contact {
     id: string;
     email: string;
@@ -116,6 +127,7 @@ interface CreateContactParams {
     language?: string;
     tags?: string[];
     customFields?: Record<string, unknown>;
+    status?: ContactStatus;
     projectId: string;
 }
 interface UpdateContactParams {
@@ -150,6 +162,7 @@ interface BulkImportContactItem {
     language?: string;
     tags?: string[];
     customFields?: Record<string, unknown>;
+    status?: ContactStatus;
 }
 interface BulkImportParams {
     subscribers: BulkImportContactItem[];
@@ -178,6 +191,17 @@ interface BulkImportJobStatus {
     createdAt: string;
     completedAt: string | null;
 }
+interface BatchDeleteContactsParams {
+    /** Email addresses to delete (1-1000 per request). */
+    emails: string[];
+    projectId: string;
+}
+interface BatchDeleteResponse {
+    /** Number of contacts actually deleted. */
+    deleted: number;
+    /** Submitted emails with no matching contact (not an error). */
+    notFound: string[];
+}
 interface ChangeStatusParams {
     email: string;
     status: 'subscribed' | 'unsubscribed' | 'bounced' | 'non-subscribed';
@@ -189,14 +213,16 @@ interface ChangeStatusParams {
 declare class Contacts {
     private readonly client;
     constructor(client: MigmaClient);
-    create(params: CreateContactParams): Promise<MigmaResult<Contact>>;
+    create(params: CreateContactParams, options?: CallOptions): Promise<MigmaResult<Contact>>;
     list(params: ListContactsParams): Promise<MigmaResult<ListContactsResponse>>;
     get(id: string, projectId: string): Promise<MigmaResult<Contact>>;
-    update(id: string, params: UpdateContactParams): Promise<MigmaResult<Contact>>;
-    remove(id: string, projectId: string): Promise<MigmaResult<DeleteResponse>>;
-    bulkImport(params: BulkImportParams): Promise<MigmaResult<BulkImportResponse>>;
+    update(id: string, params: UpdateContactParams, options?: CallOptions): Promise<MigmaResult<Contact>>;
+    remove(id: string, projectId: string, options?: CallOptions): Promise<MigmaResult<DeleteResponse>>;
+    bulkImport(params: BulkImportParams, options?: CallOptions): Promise<MigmaResult<BulkImportResponse>>;
     getBulkImportStatus(jobId: string): Promise<MigmaResult<BulkImportJobStatus>>;
-    changeStatus(params: ChangeStatusParams): Promise<MigmaResult<{
+    /** Batch delete contacts by email (up to 1000). Emails with no match come back in `notFound`. */
+    bulkDeleteByEmail(params: BatchDeleteContactsParams, options?: CallOptions): Promise<MigmaResult<BatchDeleteResponse>>;
+    changeStatus(params: ChangeStatusParams, options?: CallOptions): Promise<MigmaResult<{
         success: boolean;
     }>>;
 }
@@ -248,11 +274,15 @@ declare class Tags {
 
 interface SegmentFieldFilter {
     key: string;
-    mode?: 'is' | 'is_not';
+    /** Exact match (is/is_not) or pattern match (starts_with/ends_with/contains/not_contains,
+     *  compiled to anchored case-insensitive regex). Pattern modes keep a value group
+     *  like "email ends_with .vc" accurate as new contacts arrive. */
+    mode?: 'is' | 'is_not' | 'starts_with' | 'ends_with' | 'contains' | 'not_contains';
     values: string[];
 }
 interface SegmentActivityFilter {
     action: 'sent' | 'opened' | 'clicked';
+    channel?: 'email';
     mode: 'within' | 'before' | 'never' | 'between';
     unit?: 'hours' | 'days';
     amount?: number;
@@ -430,7 +460,7 @@ interface BatchStatus {
 declare class Sending {
     private readonly client;
     constructor(client: MigmaClient);
-    send(params: SendEmailParams): Promise<MigmaResult<SendEmailResponse>>;
+    send(params: SendEmailParams, options?: CallOptions): Promise<MigmaResult<SendEmailResponse>>;
     getBatchStatus(batchId: string): Promise<MigmaResult<BatchStatus>>;
 }
 
@@ -684,7 +714,7 @@ declare class Emails {
     /** List emails for a project */
     list(params: ListEmailsParams): Promise<MigmaResult<ListEmailsResponse>>;
     /** Start async email generation */
-    generate(params: GenerateEmailParams): Promise<MigmaResult<GenerateEmailResponse>>;
+    generate(params: GenerateEmailParams, options?: CallOptions): Promise<MigmaResult<GenerateEmailResponse>>;
     /** Check email generation status */
     getGenerationStatus(conversationId: string): Promise<MigmaResult<EmailGenerationStatus>>;
     /** Fetch one generated email by email id */
@@ -695,7 +725,7 @@ declare class Emails {
      * Generate an email and wait for completion.
      * Polls getGenerationStatus until status is 'completed' or 'failed'.
      */
-    generateAndWait(params: GenerateEmailParams, options?: PollingOptions): Promise<MigmaResult<EmailGenerationStatus>>;
+    generateAndWait(params: GenerateEmailParams, options?: PollingOptions, callOptions?: CallOptions): Promise<MigmaResult<EmailGenerationStatus>>;
     /** Send a test email from a completed conversation */
     sendTest(params: SendTestEmailParams): Promise<MigmaResult<SendTestEmailResponse>>;
 }
@@ -1011,6 +1041,34 @@ interface CreateManagedDomainParams {
     prefix: string;
     region?: string;
 }
+type DomainStream = 'transactional' | 'marketing';
+interface ProvisionStreamParams {
+    /** Apex domain you own, e.g. 'acme.com'. */
+    rootDomain: string;
+    /** 'transactional' provisions notify.<rootDomain>; 'marketing' provisions send.<rootDomain>. */
+    stream: DomainStream;
+    region?: 'us-east-1' | 'eu-west-1';
+    /** Show the apex domain in the From header when its DMARC passes. */
+    vanityRootFrom?: boolean;
+}
+interface SetupDomainParams {
+    /** Apex domain you own, e.g. 'acme.com'. */
+    rootDomain: string;
+    region?: 'us-east-1' | 'eu-west-1';
+    /** Default From display name applied to both provisioned streams. */
+    fromName?: string;
+    /** Associate the provisioned streams with a project. */
+    projectId?: string;
+    /** Show the apex domain in the From header when its DMARC passes. Defaults to true. */
+    vanityRootFrom?: boolean;
+}
+/** Both stream identities provisioned for a root domain by `domains.setup`. */
+interface SetupDomainResponse {
+    /** send.<rootDomain> marketing stream identity. */
+    marketing: Domain;
+    /** notify.<rootDomain> transactional stream identity. */
+    transactional: Domain;
+}
 interface DomainDeleteResponse {
     domain: string;
     deleted: boolean;
@@ -1029,6 +1087,18 @@ declare class Domains {
     listManaged(): Promise<MigmaResult<Domain[]>>;
     createManaged(params: CreateManagedDomainParams): Promise<MigmaResult<Domain>>;
     removeManaged(domain: string): Promise<MigmaResult<DomainDeleteResponse>>;
+    /**
+     * Provision a transactional or marketing stream identity on a domain you own.
+     * Creates notify.<rootDomain> (transactional) or send.<rootDomain> (marketing)
+     * to isolate transactional reputation from marketing. Returns DNS records to publish.
+     */
+    provisionStream(params: ProvisionStreamParams): Promise<MigmaResult<Domain>>;
+    /**
+     * Provision BOTH stream identities for a domain you own in one call:
+     * send.<rootDomain> (marketing) and notify.<rootDomain> (transactional).
+     * Idempotent. Returns both domains with DNS records to publish.
+     */
+    setup(params: SetupDomainParams): Promise<MigmaResult<SetupDomainResponse>>;
 }
 
 type WebhookEventType = 'email.generation.started' | 'email.generation.completed' | 'email.generation.failed' | 'email.test.sent' | 'project.import.started' | 'project.import.processing' | 'project.import.completed' | 'project.import.failed' | 'export.completed' | 'export.failed' | 'subscriber.added' | 'subscriber.updated' | 'subscriber.unsubscribed' | 'subscriber.bulk_imported' | 'api_key.created' | 'api_key.revoked';
@@ -1050,10 +1120,19 @@ interface Webhook {
     url: string;
     events: WebhookEventType[];
     active: boolean;
-    secret: string;
+    /** Whether a signing secret is configured. Returned by create and get. */
+    secretConfigured?: boolean;
     description?: string;
     createdAt: string;
 }
+interface CreateWebhookResponse extends Webhook {
+    /**
+     * The signing secret, returned ONCE at creation. Store it now — GET and list
+     * never return it. To rotate, delete and recreate the webhook.
+     */
+    secret: string;
+    secretConfigured: boolean;
+}
 interface WebhookDetail extends Webhook {
     customHeaders?: Record<string, string>;
     successCount: number;
@@ -1098,7 +1177,7 @@ declare class Webhooks {
     private readonly client;
     constructor(client: MigmaClient);
     list(): Promise<MigmaResult<ListWebhooksResponse>>;
-    create(params: CreateWebhookParams): Promise<MigmaResult<Webhook>>;
+    create(params: CreateWebhookParams): Promise<MigmaResult<CreateWebhookResponse>>;
     get(webhookId: string): Promise<MigmaResult<WebhookDetail>>;
     update(webhookId: string, params: UpdateWebhookParams): Promise<MigmaResult<{
         updated: boolean;
@@ -1241,16 +1320,84 @@ interface ScheduleCampaignParams {
     scheduledAt: string;
     scheduledTimezone?: string;
 }
+/**
+ * Aggregated engagement metrics for a campaign.
+ *
+ * Sourced from the email tracking worker and cached on the campaign, so values
+ * may be slightly stale. `botOpens`, `botClicks`, and `mppOpens` are present
+ * when Apple Mail Privacy Protection / bot detection data is available.
+ */
+interface CampaignStats {
+    totalSent: number;
+    totalDelivered: number;
+    uniqueOpens: number;
+    totalOpens: number;
+    uniqueClicks: number;
+    totalClicks: number;
+    unsubscribes: number;
+    bounces: number;
+    /** 0-100 */
+    openRate: number;
+    /** 0-100 */
+    clickRate: number;
+    /** ISO 8601 timestamp of when these stats were last refreshed. */
+    lastUpdated: string;
+    botOpens?: number;
+    botClicks?: number;
+    mppOpens?: number;
+}
+/**
+ * A single per-recipient email log row for a campaign. Returned directly from
+ * the tracking worker's D1 `emails` table, so the field names are snake_case
+ * (unlike the rest of the API).
+ */
+interface CampaignLog {
+    id: number;
+    tracking_id: string;
+    user_id: string;
+    domain: string;
+    from_email: string;
+    to_email: string;
+    subscriber_id: string | null;
+    subject: string | null;
+    /** Delivery status, e.g. 'sent', 'delivered', 'bounced', 'suppressed'. */
+    status: string;
+    opened_at: string | null;
+    clicked_at: string | null;
+    open_count: number;
+    click_count: number;
+    bounce_type: string | null;
+    complaint_type: string | null;
+    suppression_type: string | null;
+    suppression_reason: string | null;
+    conversation_id: string | null;
+    campaign_id: string | null;
+    created_at: string;
+}
+interface CampaignLogsParams {
+    limit?: number;
+    cursor?: string;
+    status?: 'delivered' | 'opened' | 'clicked' | 'bounced' | 'spam_report';
+}
+interface CampaignLogsResponse {
+    emails: CampaignLog[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
 
 declare class Campaigns {
     private readonly client;
     constructor(client: MigmaClient);
     list(params: ListCampaignsParams): Promise<MigmaResult<ListCampaignsResponse>>;
-    create(params: CreateCampaignParams): Promise<MigmaResult<Campaign>>;
+    create(params: CreateCampaignParams, options?: CallOptions): Promise<MigmaResult<Campaign>>;
     get(id: string): Promise<MigmaResult<Campaign>>;
-    send(id: string): Promise<MigmaResult<Campaign>>;
-    schedule(id: string, params: ScheduleCampaignParams): Promise<MigmaResult<Campaign>>;
-    cancel(id: string): Promise<MigmaResult<Campaign>>;
+    send(id: string, options?: CallOptions): Promise<MigmaResult<Campaign>>;
+    schedule(id: string, params: ScheduleCampaignParams, options?: CallOptions): Promise<MigmaResult<Campaign>>;
+    cancel(id: string, options?: CallOptions): Promise<MigmaResult<Campaign>>;
+    /** Aggregated engagement metrics for a campaign (cached, may be slightly stale). */
+    stats(id: string): Promise<MigmaResult<CampaignStats>>;
+    /** Per-recipient email logs for a campaign (cursor-paginated). */
+    logs(id: string, params?: CampaignLogsParams): Promise<MigmaResult<CampaignLogsResponse>>;
     archive(id: string): Promise<MigmaResult<Campaign>>;
     unarchive(id: string): Promise<MigmaResult<Campaign>>;
 }
@@ -1283,4 +1430,4 @@ declare class Migma {
     constructor(apiKey: string, config?: MigmaConfig);
 }
 
-export { type AddImageParams, type AddKnowledgeBaseParams, type AnalyzeDeliverabilityParams, type AnalyzeLinksParams, type ApiResponse, type BatchStatus, type BulkImportAsyncResponse, type BulkImportContactItem, type BulkImportJobStatus, type BulkImportParams, type BulkImportResponse, type BulkImportSyncResponse, type Campaign, type CampaignStatus, type ChangeStatusParams, type CheckCompatibilityParams, type CheckSpellingParams, type CheckedLink, type ClientConfig, type CompatibilityResponse, type Contact, type ContactStatus, type CreateCampaignParams, type CreateContactParams, type CreateDomainParams, type CreateManagedDomainParams, type CreatePreviewParams, type CreatePreviewResponse, type CreateSegmentParams, type CreateTagParams, type CreateTopicParams, type CreateWebhookParams, type DeleteResponse, type DeliverabilityResponse, type DeviceCategoriesResponse, type DnsRecord, type Domain, type DomainAvailability, type DomainDeleteResponse, type DomainVerificationResult, type EditEmailParams, type Email, type EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type ExportFile, type ExportFormat, type ExportFormatsResponse, type ExportResult, type ExportStatusResponse, type FieldCatalogEntry, type FieldCatalogEntryType, type FieldCatalogParams, type FieldCatalogResponse, type GenerateEmailParams, type GenerateEmailResponse, type GeneratedEmail, type GetDevicePreviewResponse, type GetPreviewResponse, type GetPreviewStatusResponse, type GetSupportedDevicesResponse, type HubspotExportParams, type ImportProjectParams, type ImportProjectResponse, type ImportStatusResponse, type KnowledgeBaseEntry, type KnowledgeBaseListResponse, type LinkAnalysisResponse, type ListCampaignsParams, type ListCampaignsResponse, type ListContactsParams, type ListContactsResponse, type ListEmailsEmail, type ListEmailsParams, type ListEmailsResponse, type ListProjectsParams, type ListProjectsResponse, type ListSegmentsResponse, type ListTagsParams, type ListTagsResponse, type ListTopicsParams, type ListTopicsResponse, type ListWebhooksResponse, type LogosResponse, type MessageResponse, Migma, MigmaClient, type MigmaConfig, MigmaError, MigmaErrorCode, type MigmaResult, type PollingOptions, type PreviewDevice, type PreviewDeviceCategory, type PreviewDeviceStatus, type PreviewMetadata, type PreviewStatus, type Project, type ProjectImage, type ProviderType, type RecipientType, type RetryImportResponse, type ScheduleCampaignParams, type Segment, type SegmentActivityFilter, type SegmentFieldFilter, type SegmentFilters, type SendEmailParams, type SendEmailResponse, type SendTestEmailParams, type SendTestEmailResponse, type SpellingResponse, type SupportedDevice, type Tag, type Topic, type TopicSubscriptionParams, type TopicSubscriptionResponse, type UpdateContactParams, type UpdateDomainParams, type UpdateImageParams, type UpdateKnowledgeBaseParams, type UpdateLogosParams, type UpdateSegmentParams, type UpdateTagParams, type UpdateTopicParams, type UpdateWebhookParams, type ValidateAllParams, type ValidateAllResponse, type Webhook, type WebhookDeliveriesResponse, type WebhookDelivery, type WebhookDetail, type WebhookEvent, type WebhookEventType, type WebhookEventsResponse, type WebhookTestResult, poll };
+export { type AddImageParams, type AddKnowledgeBaseParams, type AnalyzeDeliverabilityParams, type AnalyzeLinksParams, type ApiResponse, type BatchDeleteContactsParams, type BatchDeleteResponse, type BatchStatus, type BulkImportAsyncResponse, type BulkImportContactItem, type BulkImportJobStatus, type BulkImportParams, type BulkImportResponse, type BulkImportSyncResponse, type Campaign, type CampaignLog, type CampaignLogsParams, type CampaignLogsResponse, type CampaignStats, type CampaignStatus, type ChangeStatusParams, type CheckCompatibilityParams, type CheckSpellingParams, type CheckedLink, type ClientConfig, type CompatibilityResponse, type Contact, type ContactStatus, type CreateCampaignParams, type CreateContactParams, type CreateDomainParams, type CreateManagedDomainParams, type CreatePreviewParams, type CreatePreviewResponse, type CreateSegmentParams, type CreateTagParams, type CreateTopicParams, type CreateWebhookParams, type CreateWebhookResponse, type DeleteResponse, type DeliverabilityResponse, type DeviceCategoriesResponse, type DnsRecord, type Domain, type DomainAvailability, type DomainDeleteResponse, type DomainStream, type DomainVerificationResult, type EditEmailParams, type Email, type EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type ExportFile, type ExportFormat, type ExportFormatsResponse, type ExportResult, type ExportStatusResponse, type FieldCatalogEntry, type FieldCatalogEntryType, type FieldCatalogParams, type FieldCatalogResponse, type GenerateEmailParams, type GenerateEmailResponse, type GeneratedEmail, type GetDevicePreviewResponse, type GetPreviewResponse, type GetPreviewStatusResponse, type GetSupportedDevicesResponse, type HubspotExportParams, type ImportProjectParams, type ImportProjectResponse, type ImportStatusResponse, type KnowledgeBaseEntry, type KnowledgeBaseListResponse, type LinkAnalysisResponse, type ListCampaignsParams, type ListCampaignsResponse, type ListContactsParams, type ListContactsResponse, type ListEmailsEmail, type ListEmailsParams, type ListEmailsResponse, type ListProjectsParams, type ListProjectsResponse, type ListSegmentsResponse, type ListTagsParams, type ListTagsResponse, type ListTopicsParams, type ListTopicsResponse, type ListWebhooksResponse, type LogosResponse, type MessageResponse, Migma, MigmaClient, type MigmaConfig, MigmaError, MigmaErrorCode, type MigmaResult, type PollingOptions, type PreviewDevice, type PreviewDeviceCategory, type PreviewDeviceStatus, type PreviewMetadata, type PreviewStatus, type Project, type ProjectImage, type ProviderType, type ProvisionStreamParams, type RecipientType, type RetryImportResponse, type ScheduleCampaignParams, type Segment, type SegmentActivityFilter, type SegmentFieldFilter, type SegmentFilters, type SendEmailParams, type SendEmailResponse, type SendTestEmailParams, type SendTestEmailResponse, type SetupDomainParams, type SetupDomainResponse, type SpellingResponse, type SupportedDevice, type Tag, type Topic, type TopicSubscriptionParams, type TopicSubscriptionResponse, type UpdateContactParams, type UpdateDomainParams, type UpdateImageParams, type UpdateKnowledgeBaseParams, type UpdateLogosParams, type UpdateSegmentParams, type UpdateTagParams, type UpdateTopicParams, type UpdateWebhookParams, type ValidateAllParams, type ValidateAllResponse, type Webhook, type WebhookDeliveriesResponse, type WebhookDelivery, type WebhookDetail, type WebhookEvent, type WebhookEventType, type WebhookEventsResponse, type WebhookTestResult, poll };

package/dist/index.js

@@ -95,7 +95,7 @@ var MigmaClient = class {
       try {
         const response = await fetch(url, {
           method: options.method,
-          headers: this.headers,
+          headers: { ...this.headers, ...options.headers },
           body: options.body ? JSON.stringify(options.body) : void 0
         });
         const json = await response.json();
@@ -138,7 +138,7 @@ var MigmaClient = class {
     try {
       const response = await fetch(url, {
         method: options.method,
-        headers: this.headers,
+        headers: { ...this.headers, ...options.headers },
         body: options.body ? JSON.stringify(options.body) : void 0
       });
       const json = await response.json();
@@ -172,17 +172,23 @@ var MigmaClient = class {
   async getWithCount(path, query) {
     return this.requestWithCount({ method: "GET", path, query });
   }
-  async post(path, body) {
-    return this.request({ method: "POST", path, body });
+  async post(path, body, options) {
+    return this.request({ method: "POST", path, body, headers: this.callHeaders(options) });
   }
-  async patch(path, body) {
-    return this.request({ method: "PATCH", path, body });
+  async patch(path, body, options) {
+    return this.request({ method: "PATCH", path, body, headers: this.callHeaders(options) });
   }
   async put(path, body) {
     return this.request({ method: "PUT", path, body });
   }
-  async delete(path, query) {
-    return this.request({ method: "DELETE", path, query });
+  async delete(path, query, options) {
+    return this.request({ method: "DELETE", path, query, headers: this.callHeaders(options) });
+  }
+  callHeaders(options) {
+    if (options?.idempotencyKey) {
+      return { "Idempotency-Key": options.idempotencyKey };
+    }
+    return void 0;
   }
   buildUrl(path, query) {
     const url = new URL(`${this.config.baseUrl}${path}`);
@@ -213,8 +219,8 @@ var Contacts = class {
   constructor(client) {
     this.client = client;
   }
-  async create(params) {
-    return this.client.post("/contacts", params);
+  async create(params, options) {
+    return this.client.post("/contacts", params, options);
   }
   async list(params) {
     const { projectId, page, limit, tags, status, search } = params;
@@ -230,20 +236,24 @@ var Contacts = class {
   async get(id, projectId) {
     return this.client.get(`/contacts/${id}`, { projectId });
   }
-  async update(id, params) {
-    return this.client.patch(`/contacts/${id}`, params);
+  async update(id, params, options) {
+    return this.client.patch(`/contacts/${id}`, params, options);
   }
-  async remove(id, projectId) {
-    return this.client.delete(`/contacts/${id}`, { projectId });
+  async remove(id, projectId, options) {
+    return this.client.delete(`/contacts/${id}`, { projectId }, options);
   }
-  async bulkImport(params) {
-    return this.client.post("/contacts/bulk", params);
+  async bulkImport(params, options) {
+    return this.client.post("/contacts/bulk", params, options);
   }
   async getBulkImportStatus(jobId) {
     return this.client.get(`/contacts/bulk/${jobId}`);
   }
-  async changeStatus(params) {
-    return this.client.post("/contacts/status", params);
+  /** Batch delete contacts by email (up to 1000). Emails with no match come back in `notFound`. */
+  async bulkDeleteByEmail(params, options) {
+    return this.client.post("/contacts/bulk-delete", params, options);
+  }
+  async changeStatus(params, options) {
+    return this.client.post("/contacts/status", params, options);
   }
 };
 
@@ -344,8 +354,8 @@ var Sending = class {
   constructor(client) {
     this.client = client;
   }
-  async send(params) {
-    return this.client.post("/sending", params);
+  async send(params, options) {
+    return this.client.post("/sending", params, options);
   }
   async getBatchStatus(batchId) {
     return this.client.get(`/sending/batches/${batchId}`);
@@ -467,10 +477,11 @@ var Emails = class {
     });
   }
   /** Start async email generation */
-  async generate(params) {
+  async generate(params, options) {
     return this.client.post(
       "/projects/emails/generate",
-      params
+      params,
+      options
     );
   }
   /** Check email generation status */
@@ -494,8 +505,8 @@ var Emails = class {
    * Generate an email and wait for completion.
    * Polls getGenerationStatus until status is 'completed' or 'failed'.
    */
-  async generateAndWait(params, options) {
-    const startResult = await this.generate(params);
+  async generateAndWait(params, options, callOptions) {
+    const startResult = await this.generate(params, callOptions);
     if (startResult.error) {
       return { data: null, error: startResult.error };
     }
@@ -673,6 +684,22 @@ var Domains = class {
   async removeManaged(domain) {
     return this.client.delete(`/domains/managed/${domain}`);
   }
+  /**
+   * Provision a transactional or marketing stream identity on a domain you own.
+   * Creates notify.<rootDomain> (transactional) or send.<rootDomain> (marketing)
+   * to isolate transactional reputation from marketing. Returns DNS records to publish.
+   */
+  async provisionStream(params) {
+    return this.client.post("/domains/streams", params);
+  }
+  /**
+   * Provision BOTH stream identities for a domain you own in one call:
+   * send.<rootDomain> (marketing) and notify.<rootDomain> (transactional).
+   * Idempotent. Returns both domains with DNS records to publish.
+   */
+  async setup(params) {
+    return this.client.post("/domains/setup", params);
+  }
 };
 
 // src/resources/webhooks.ts
@@ -790,20 +817,32 @@ var Campaigns = class {
       archived
     });
   }
-  async create(params) {
-    return this.client.post("/campaigns", params);
+  async create(params, options) {
+    return this.client.post("/campaigns", params, options);
   }
   async get(id) {
     return this.client.get(`/campaigns/${id}`);
   }
-  async send(id) {
-    return this.client.post(`/campaigns/${id}/send`);
+  async send(id, options) {
+    return this.client.post(`/campaigns/${id}/send`, void 0, options);
   }
-  async schedule(id, params) {
-    return this.client.post(`/campaigns/${id}/schedule`, params);
+  async schedule(id, params, options) {
+    return this.client.post(`/campaigns/${id}/schedule`, params, options);
   }
-  async cancel(id) {
-    return this.client.post(`/campaigns/${id}/cancel`);
+  async cancel(id, options) {
+    return this.client.post(`/campaigns/${id}/cancel`, void 0, options);
+  }
+  /** Aggregated engagement metrics for a campaign (cached, may be slightly stale). */
+  async stats(id) {
+    return this.client.get(`/campaigns/${id}/stats`);
+  }
+  /** Per-recipient email logs for a campaign (cursor-paginated). */
+  async logs(id, params) {
+    return this.client.get(`/campaigns/${id}/logs`, {
+      limit: params?.limit,
+      cursor: params?.cursor,
+      status: params?.status
+    });
   }
   async archive(id) {
     return this.client.post(`/campaigns/${id}/archive`);