migma 1.3.2 → 1.3.4

package/dist/index.js

@@ -1,5 +1,22 @@
 'use strict';
 
+// src/agent-identity.ts
+var AGENT_ID_PATTERN = /^ai:[a-z0-9][a-z0-9._-]{0,62}$/;
+var HOST_AGENT_ENV = [
+  { env: "CLAUDECODE", id: "ai:claude-code" },
+  { env: "CURSOR_TRACE_ID", id: "ai:cursor" },
+  { env: "CODEX_HOME", id: "ai:codex" }
+];
+function detectAgentId() {
+  if (typeof process === "undefined" || !process.env) return null;
+  const explicit = (process.env.MIGMA_AGENT_ID || "").trim().toLowerCase();
+  if (AGENT_ID_PATTERN.test(explicit)) return explicit;
+  for (const { env, id } of HOST_AGENT_ENV) {
+    if (process.env[env]) return id;
+  }
+  return null;
+}
+
 // src/errors.ts
 var MigmaErrorCode = /* @__PURE__ */ ((MigmaErrorCode2) => {
   MigmaErrorCode2["VALIDATION_ERROR"] = "validation_error";
@@ -56,9 +73,19 @@ var MigmaError = class _MigmaError extends Error {
 var MigmaClient = class {
   apiKey;
   config;
+  headers;
   constructor(apiKey, config) {
     this.apiKey = apiKey;
     this.config = config;
+    this.headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      "User-Agent": "migma-node/1.0.0"
+    };
+    const agentId = detectAgentId();
+    if (agentId) {
+      this.headers["X-Agent-Id"] = agentId;
+    }
   }
   async request(options) {
     const url = this.buildUrl(options.path, options.query);
@@ -68,11 +95,7 @@ var MigmaClient = class {
       try {
         const response = await fetch(url, {
           method: options.method,
-          headers: {
-            Authorization: `Bearer ${this.apiKey}`,
-            "Content-Type": "application/json",
-            "User-Agent": "migma-node/1.0.0"
-          },
+          headers: { ...this.headers, ...options.headers },
           body: options.body ? JSON.stringify(options.body) : void 0
         });
         const json = await response.json();
@@ -115,11 +138,7 @@ var MigmaClient = class {
     try {
       const response = await fetch(url, {
         method: options.method,
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json",
-          "User-Agent": "migma-node/1.0.0"
-        },
+        headers: { ...this.headers, ...options.headers },
         body: options.body ? JSON.stringify(options.body) : void 0
       });
       const json = await response.json();
@@ -153,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}`);
@@ -194,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;
@@ -211,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);
   }
 };
 
@@ -325,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}`);
@@ -404,6 +433,15 @@ var Projects = class {
       `/projects/import/${projectId}/retry`
     );
   }
+  async fieldCatalog(projectId, params) {
+    return this.client.get(
+      `/projects/${projectId}/field-catalog`,
+      {
+        segmentId: params?.segmentId,
+        tag: params?.tag
+      }
+    );
+  }
   /**
    * Import a project and wait for completion.
    * Polls getImportStatus until status is 'active' or 'error'.
@@ -439,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 */
@@ -451,30 +490,23 @@ var Emails = class {
       `/projects/emails/${conversationId}/status`
     );
   }
-  /** Fetch one generated email by artifact id */
-  async get(artifactId) {
-    return this.client.get(`/emails/${artifactId}`);
-  }
-  /** Replace one generated email's Migma Email source and persist compiled HTML */
-  async update(artifactId, params) {
-    return this.client.patch(
-      `/emails/${artifactId}`,
-      params
-    );
+  /** Fetch one generated email by email id */
+  async get(emailId) {
+    return this.client.get(`/emails/${emailId}`);
   }
-  /** Compile an email artifact's source without persisting */
-  async compile(artifactId, params) {
+  /** Prompt Migma to edit one generated email */
+  async edit(emailId, params) {
     return this.client.post(
-      `/emails/${artifactId}/compile`,
-      params || {}
+      `/emails/${emailId}/edit`,
+      params
     );
   }
   /**
    * 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 };
     }
@@ -652,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
@@ -760,28 +808,47 @@ var Campaigns = class {
     this.client = client;
   }
   async list(params) {
-    const { projectId, status, page, limit } = params;
+    const { projectId, status, page, limit, archived } = params;
     return this.client.get("/campaigns", {
       projectId,
       status,
       page,
-      limit
+      limit,
+      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, options) {
+    return this.client.post(`/campaigns/${id}/schedule`, params, options);
+  }
+  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 schedule(id, params) {
-    return this.client.post(`/campaigns/${id}/schedule`, params);
+  async archive(id) {
+    return this.client.post(`/campaigns/${id}/archive`);
   }
-  async cancel(id) {
-    return this.client.post(`/campaigns/${id}/cancel`);
+  async unarchive(id) {
+    return this.client.post(`/campaigns/${id}/unarchive`);
   }
 };