migma 1.3.0 → 1.3.2

package/README.md

@@ -27,7 +27,7 @@ const { data: project } = await migma.projects.importAndWait({
   urls: ['https://yourcompany.com'],
 });
 
-// Generate an email design with AI — returns the finished HTML directly
+// Generate an email design with AI — returns the finished HTML directly.
 const { data: email } = await migma.emails.generateAndWait({
   projectId: project.projectId,
   prompt: 'Create a welcome email for new subscribers',
@@ -35,7 +35,8 @@ const { data: email } = await migma.emails.generateAndWait({
 
 if (email?.status === 'completed') {
   console.log('Subject:', email.result.subject);
-  console.log('HTML:', email.result.html); // production-ready HTML
+  console.log('HTML:', email.result.html); // primary email HTML
+  console.log('Artifact:', email.result.emails[0].artifactId);
 }
 ```
 
@@ -63,15 +64,22 @@ const { data: email } = await migma.emails.generateAndWait({
   prompt: 'Create a summer sale email with 30% off everything',
 });
 
-// 3. Send it — conversationId resolves the template and project automatically
+if (!email?.result) throw new Error('Email generation failed');
+
+// 3. Send it — artifactId works for single emails and series slots
+const selectedEmail = email.result.emails[0];
+if (!selectedEmail.artifactId) throw new Error('No artifactId returned');
 await migma.sending.send({
   recipientType: 'email',
   recipientEmail: 'sarah@example.com',
   from: 'hello@yourcompany.migma.email',
   fromName: 'Your Company',
-  subject: email.result.subject,
-  conversationId: email.conversationId,
+  subject: selectedEmail.subject,
+  artifactId: selectedEmail.artifactId,
 });
+
+// conversationId also works for single-email conversations.
+// For multi-slot emails or series, use result.emails[].artifactId.
 ```
 
 [Full OpenClaw tutorial](https://docs.migma.ai/tutorials/send-emails-from-openclaw)
@@ -89,7 +97,7 @@ await migma.sending.send({
 
 ## Features
 
-- Full coverage of all Migma API v1 endpoints (80+ methods across 14 resources)
+- Full coverage of all Migma API v1 endpoints (80+ methods across 15 resources)
 - TypeScript-first with complete type definitions
 - `{ data, error }` return pattern — methods never throw
 - Automatic retries with exponential backoff on 5xx/429
@@ -220,7 +228,17 @@ const { data: result } = await migma.contacts.bulkImport({
 Send to a single recipient, segment, tag, or full audience.
 
 ```typescript
-// Send using a conversationId (template + project resolved automatically)
+// Send a generated email by artifactId
+await migma.sending.send({
+  recipientType: 'email',
+  recipientEmail: 'user@example.com',
+  from: 'hello@yourdomain.com',
+  fromName: 'Your Company',
+  subject: 'Welcome!',
+  artifactId: 'artifact_abc123',
+});
+
+// Single-email conversations can also be sent by conversationId.
 await migma.sending.send({
   recipientType: 'email',
   recipientEmail: 'user@example.com',
@@ -237,7 +255,7 @@ await migma.sending.send({
   from: 'hello@yourdomain.com',
   fromName: 'Your Company',
   subject: 'Big Announcement',
-  conversationId: 'conv_abc123',
+  artifactId: 'artifact_abc123',
 });
 
 // Single sends are automatically transactional — no flag needed
@@ -248,14 +266,40 @@ await migma.sending.send({
   from: 'noreply@yourdomain.com',
   fromName: 'Your Company',
   subject: 'Your subscription renews tomorrow',
-  template: '<html>Your plan renews on March 1.</html>',
-  projectId: 'proj_abc123',
+  artifactId: 'artifact_abc123',
   transactional: true,
 });
 ```
 
 [Sending API Reference](https://docs.migma.ai/api-reference/sending/send-email)
 
+### Generated Series and Editing
+
+Generate a series with `count`, then use each email's `artifactId` to fetch, compile, update, or send one slot.
+
+```typescript
+const { data: series } = await migma.emails.generateAndWait({
+  projectId: 'proj_abc123',
+  prompt: 'Create a three-email onboarding series',
+  count: 3,
+});
+
+for (const generated of series?.result?.emails ?? []) {
+  console.log(generated.slot, generated.artifactId, generated.html);
+}
+
+const { data: email } = await migma.emails.get('artifact_abc123');
+if (!email?.source) throw new Error('Editable source unavailable');
+
+await migma.emails.compile('artifact_abc123', {
+  source: email.source.replace('Start now', 'Start your trial'),
+});
+
+await migma.emails.update('artifact_abc123', {
+  source: email.source.replace('Start now', 'Start your trial'),
+});
+```
+
 ### Email Validation
 
 Run preflight checks — compatibility, links, spelling, and deliverability.

package/dist/index.d.mts

@@ -243,7 +243,6 @@ declare class Tags {
 
 interface SegmentFilters {
     tags?: string[];
-    excludeTags?: string[];
     status?: 'subscribed' | 'unsubscribed' | 'non-subscribed' | 'bounced';
     customFields?: Record<string, string[]>;
 }
@@ -353,13 +352,22 @@ interface SendEmailParams {
     replyTo?: string;
     bcc?: string[];
     subject: string;
-    /** Email template HTML. Required unless conversationId is provided. */
+    /** Email template source. Required unless conversationId or artifactId is provided. */
     template?: string;
     variables?: Record<string, unknown>;
     providerType?: ProviderType;
-    /** Required unless conversationId is provided. */
+    /** Required unless conversationId or artifactId is provided. */
     projectId?: string;
-    /** When provided, template and projectId are resolved automatically from the conversation. */
+    /**
+     * Slot-precise email artifact id. Use this for a selected email inside a
+     * multi-slot conversation or series. Resolves template, projectId, and parent
+     * conversation automatically.
+     */
+    artifactId?: string;
+    /**
+     * Conversation id. Works for single-email conversations. For multi-slot
+     * conversations, also provide artifactId so API knows which email to send.
+     */
     conversationId?: string;
     /** Defaults to true for single sends, false for batch sends. Set explicitly to override. Transactional emails bypass subscription status and topic filters, and omit List-Unsubscribe headers. */
     transactional?: boolean;
@@ -468,24 +476,6 @@ interface RetryImportResponse {
     status: string;
     message: string;
 }
-type FieldCatalogValueType = 'string' | 'number' | 'boolean' | 'date' | 'url' | 'unknown';
-interface FieldCatalogEntry {
-    key: string;
-    label: string;
-    type: FieldCatalogValueType;
-    fillRate: number;
-    sample: string[];
-    auto: boolean;
-}
-interface FieldCatalogResponse {
-    entries: FieldCatalogEntry[];
-    totalSubscribers: number;
-    computedAt: string;
-}
-interface FieldCatalogParams {
-    segmentId?: string;
-    tag?: string;
-}
 
 interface PollingOptions {
     /** Polling interval in ms. Default: 2000 */
@@ -512,12 +502,6 @@ declare class Projects {
     import(params: ImportProjectParams): Promise<MigmaResult<ImportProjectResponse>>;
     getImportStatus(projectId: string): Promise<MigmaResult<ImportStatusResponse>>;
     retryImport(projectId: string): Promise<MigmaResult<RetryImportResponse>>;
-    /**
-     * Get the project's subscriber field catalog: which fields exist, how often
-     * each is populated, example values, and whether it's auto-filled at send
-     * time. Optionally scope by segment or tag.
-     */
-    fieldCatalog(projectId: string, params?: FieldCatalogParams): Promise<MigmaResult<FieldCatalogResponse>>;
     /**
      * Import a project and wait for completion.
      * Polls getImportStatus until status is 'active' or 'error'.
@@ -540,17 +524,28 @@ interface GenerateEmailParams {
     languages?: string[];
     visibility?: 'private' | 'unlisted' | 'public';
     referenceId?: string;
+    /** Optional target email count. Omit to let Migma infer single vs series from the prompt. */
+    count?: number;
 }
 interface GenerateEmailResponse {
     conversationId: string;
     status: 'pending';
     message: string;
     link: string;
+    count?: number;
+    referenceId?: string;
 }
 interface EmailGenerationResult {
     subject: string;
     previewText: string;
     html: string;
+    source?: string;
+    emails: GeneratedEmailArtifact[];
+    seriesPlan?: {
+        name?: string;
+        count?: number;
+        themeId?: string;
+    };
     screenshotUrl: string | null;
     screenshotFullUrl: string | null;
     stats: {
@@ -560,6 +555,22 @@ interface EmailGenerationResult {
         colors: string[];
     };
     languages: string[];
+    templateVariables?: unknown[];
+}
+interface GeneratedEmailArtifact {
+    artifactId: string | null;
+    conversationId: string;
+    messageId: string | null;
+    slotIdx: number;
+    slot: number;
+    subject: string;
+    preheader: string;
+    html: string;
+    source?: string;
+    sendOffsetDays?: number;
+    status: 'ready' | 'processing' | 'failed';
+    thumbnailUrl?: string | null;
+    templateVariables?: unknown[];
 }
 interface EmailGenerationStatus {
     conversationId: string;
@@ -606,6 +617,40 @@ interface SendTestEmailResponse {
     sentAt: string;
     subject: string;
 }
+interface EmailArtifact {
+    artifactId: string;
+    conversationId: string;
+    messageId: string | null;
+    slotIdx: number;
+    slotUuid: string | null;
+    status: string;
+    engine: 'zinn' | 'react-email';
+    subject: string;
+    preheader: string;
+    html: string;
+    source?: string;
+    templateVariables: unknown[];
+    warnings: string[];
+    thumbnailUrl: string | null;
+    updatedAt: string;
+}
+interface UpdateEmailArtifactParams {
+    source: string;
+    vars?: Record<string, unknown>;
+    lang?: string;
+    label?: string;
+}
+interface CompileEmailArtifactParams {
+    source?: string;
+    vars?: Record<string, unknown>;
+    lang?: string;
+}
+interface CompileEmailArtifactResponse {
+    artifactId: string;
+    html: string;
+    warnings: string[];
+    metadata?: Record<string, unknown>;
+}
 
 declare class Emails {
     private readonly client;
@@ -616,6 +661,12 @@ declare class Emails {
     generate(params: GenerateEmailParams): Promise<MigmaResult<GenerateEmailResponse>>;
     /** Check email generation status */
     getGenerationStatus(conversationId: string): Promise<MigmaResult<EmailGenerationStatus>>;
+    /** Fetch one generated email by artifact id */
+    get(artifactId: string): Promise<MigmaResult<EmailArtifact>>;
+    /** Replace one generated email's Migma Email source and persist compiled HTML */
+    update(artifactId: string, params: UpdateEmailArtifactParams): Promise<MigmaResult<EmailArtifact>>;
+    /** Compile an email artifact's source without persisting */
+    compile(artifactId: string, params?: CompileEmailArtifactParams): Promise<MigmaResult<CompileEmailArtifactResponse>>;
     /**
      * Generate an email and wait for completion.
      * Polls getGenerationStatus until status is 'completed' or 'failed'.
@@ -1127,8 +1178,6 @@ interface Campaign {
     sentAt?: string | null;
     completedAt?: string | null;
     error?: string | null;
-    archived?: boolean;
-    archivedAt?: string | null;
     triggeredBy?: 'manual' | 'api' | 'automation';
     createdAt: string;
     updatedAt: string;
@@ -1153,7 +1202,6 @@ interface ListCampaignsParams {
     status?: CampaignStatus;
     page?: number;
     limit?: number;
-    archived?: boolean;
 }
 interface ListCampaignsResponse {
     campaigns: Campaign[];
@@ -1173,8 +1221,6 @@ declare class Campaigns {
     send(id: string): Promise<MigmaResult<Campaign>>;
     schedule(id: string, params: ScheduleCampaignParams): Promise<MigmaResult<Campaign>>;
     cancel(id: string): Promise<MigmaResult<Campaign>>;
-    archive(id: string): Promise<MigmaResult<Campaign>>;
-    unarchive(id: string): Promise<MigmaResult<Campaign>>;
 }
 
 interface MigmaConfig {
@@ -1205,4 +1251,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 EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type ExportFile, type ExportFormat, type ExportFormatsResponse, type ExportResult, type ExportStatusResponse, type FieldCatalogEntry, type FieldCatalogParams, type FieldCatalogResponse, type FieldCatalogValueType, type GenerateEmailParams, type GenerateEmailResponse, 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 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 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 CompileEmailArtifactParams, type CompileEmailArtifactResponse, 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 EmailArtifact, type EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type ExportFile, type ExportFormat, type ExportFormatsResponse, type ExportResult, type ExportStatusResponse, type GenerateEmailParams, type GenerateEmailResponse, type GeneratedEmailArtifact, 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 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 UpdateEmailArtifactParams, 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.d.ts

@@ -243,7 +243,6 @@ declare class Tags {
 
 interface SegmentFilters {
     tags?: string[];
-    excludeTags?: string[];
     status?: 'subscribed' | 'unsubscribed' | 'non-subscribed' | 'bounced';
     customFields?: Record<string, string[]>;
 }
@@ -353,13 +352,22 @@ interface SendEmailParams {
     replyTo?: string;
     bcc?: string[];
     subject: string;
-    /** Email template HTML. Required unless conversationId is provided. */
+    /** Email template source. Required unless conversationId or artifactId is provided. */
     template?: string;
     variables?: Record<string, unknown>;
     providerType?: ProviderType;
-    /** Required unless conversationId is provided. */
+    /** Required unless conversationId or artifactId is provided. */
     projectId?: string;
-    /** When provided, template and projectId are resolved automatically from the conversation. */
+    /**
+     * Slot-precise email artifact id. Use this for a selected email inside a
+     * multi-slot conversation or series. Resolves template, projectId, and parent
+     * conversation automatically.
+     */
+    artifactId?: string;
+    /**
+     * Conversation id. Works for single-email conversations. For multi-slot
+     * conversations, also provide artifactId so API knows which email to send.
+     */
     conversationId?: string;
     /** Defaults to true for single sends, false for batch sends. Set explicitly to override. Transactional emails bypass subscription status and topic filters, and omit List-Unsubscribe headers. */
     transactional?: boolean;
@@ -468,24 +476,6 @@ interface RetryImportResponse {
     status: string;
     message: string;
 }
-type FieldCatalogValueType = 'string' | 'number' | 'boolean' | 'date' | 'url' | 'unknown';
-interface FieldCatalogEntry {
-    key: string;
-    label: string;
-    type: FieldCatalogValueType;
-    fillRate: number;
-    sample: string[];
-    auto: boolean;
-}
-interface FieldCatalogResponse {
-    entries: FieldCatalogEntry[];
-    totalSubscribers: number;
-    computedAt: string;
-}
-interface FieldCatalogParams {
-    segmentId?: string;
-    tag?: string;
-}
 
 interface PollingOptions {
     /** Polling interval in ms. Default: 2000 */
@@ -512,12 +502,6 @@ declare class Projects {
     import(params: ImportProjectParams): Promise<MigmaResult<ImportProjectResponse>>;
     getImportStatus(projectId: string): Promise<MigmaResult<ImportStatusResponse>>;
     retryImport(projectId: string): Promise<MigmaResult<RetryImportResponse>>;
-    /**
-     * Get the project's subscriber field catalog: which fields exist, how often
-     * each is populated, example values, and whether it's auto-filled at send
-     * time. Optionally scope by segment or tag.
-     */
-    fieldCatalog(projectId: string, params?: FieldCatalogParams): Promise<MigmaResult<FieldCatalogResponse>>;
     /**
      * Import a project and wait for completion.
      * Polls getImportStatus until status is 'active' or 'error'.
@@ -540,17 +524,28 @@ interface GenerateEmailParams {
     languages?: string[];
     visibility?: 'private' | 'unlisted' | 'public';
     referenceId?: string;
+    /** Optional target email count. Omit to let Migma infer single vs series from the prompt. */
+    count?: number;
 }
 interface GenerateEmailResponse {
     conversationId: string;
     status: 'pending';
     message: string;
     link: string;
+    count?: number;
+    referenceId?: string;
 }
 interface EmailGenerationResult {
     subject: string;
     previewText: string;
     html: string;
+    source?: string;
+    emails: GeneratedEmailArtifact[];
+    seriesPlan?: {
+        name?: string;
+        count?: number;
+        themeId?: string;
+    };
     screenshotUrl: string | null;
     screenshotFullUrl: string | null;
     stats: {
@@ -560,6 +555,22 @@ interface EmailGenerationResult {
         colors: string[];
     };
     languages: string[];
+    templateVariables?: unknown[];
+}
+interface GeneratedEmailArtifact {
+    artifactId: string | null;
+    conversationId: string;
+    messageId: string | null;
+    slotIdx: number;
+    slot: number;
+    subject: string;
+    preheader: string;
+    html: string;
+    source?: string;
+    sendOffsetDays?: number;
+    status: 'ready' | 'processing' | 'failed';
+    thumbnailUrl?: string | null;
+    templateVariables?: unknown[];
 }
 interface EmailGenerationStatus {
     conversationId: string;
@@ -606,6 +617,40 @@ interface SendTestEmailResponse {
     sentAt: string;
     subject: string;
 }
+interface EmailArtifact {
+    artifactId: string;
+    conversationId: string;
+    messageId: string | null;
+    slotIdx: number;
+    slotUuid: string | null;
+    status: string;
+    engine: 'zinn' | 'react-email';
+    subject: string;
+    preheader: string;
+    html: string;
+    source?: string;
+    templateVariables: unknown[];
+    warnings: string[];
+    thumbnailUrl: string | null;
+    updatedAt: string;
+}
+interface UpdateEmailArtifactParams {
+    source: string;
+    vars?: Record<string, unknown>;
+    lang?: string;
+    label?: string;
+}
+interface CompileEmailArtifactParams {
+    source?: string;
+    vars?: Record<string, unknown>;
+    lang?: string;
+}
+interface CompileEmailArtifactResponse {
+    artifactId: string;
+    html: string;
+    warnings: string[];
+    metadata?: Record<string, unknown>;
+}
 
 declare class Emails {
     private readonly client;
@@ -616,6 +661,12 @@ declare class Emails {
     generate(params: GenerateEmailParams): Promise<MigmaResult<GenerateEmailResponse>>;
     /** Check email generation status */
     getGenerationStatus(conversationId: string): Promise<MigmaResult<EmailGenerationStatus>>;
+    /** Fetch one generated email by artifact id */
+    get(artifactId: string): Promise<MigmaResult<EmailArtifact>>;
+    /** Replace one generated email's Migma Email source and persist compiled HTML */
+    update(artifactId: string, params: UpdateEmailArtifactParams): Promise<MigmaResult<EmailArtifact>>;
+    /** Compile an email artifact's source without persisting */
+    compile(artifactId: string, params?: CompileEmailArtifactParams): Promise<MigmaResult<CompileEmailArtifactResponse>>;
     /**
      * Generate an email and wait for completion.
      * Polls getGenerationStatus until status is 'completed' or 'failed'.
@@ -1127,8 +1178,6 @@ interface Campaign {
     sentAt?: string | null;
     completedAt?: string | null;
     error?: string | null;
-    archived?: boolean;
-    archivedAt?: string | null;
     triggeredBy?: 'manual' | 'api' | 'automation';
     createdAt: string;
     updatedAt: string;
@@ -1153,7 +1202,6 @@ interface ListCampaignsParams {
     status?: CampaignStatus;
     page?: number;
     limit?: number;
-    archived?: boolean;
 }
 interface ListCampaignsResponse {
     campaigns: Campaign[];
@@ -1173,8 +1221,6 @@ declare class Campaigns {
     send(id: string): Promise<MigmaResult<Campaign>>;
     schedule(id: string, params: ScheduleCampaignParams): Promise<MigmaResult<Campaign>>;
     cancel(id: string): Promise<MigmaResult<Campaign>>;
-    archive(id: string): Promise<MigmaResult<Campaign>>;
-    unarchive(id: string): Promise<MigmaResult<Campaign>>;
 }
 
 interface MigmaConfig {
@@ -1205,4 +1251,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 EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type ExportFile, type ExportFormat, type ExportFormatsResponse, type ExportResult, type ExportStatusResponse, type FieldCatalogEntry, type FieldCatalogParams, type FieldCatalogResponse, type FieldCatalogValueType, type GenerateEmailParams, type GenerateEmailResponse, 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 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 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 CompileEmailArtifactParams, type CompileEmailArtifactResponse, 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 EmailArtifact, type EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type ExportFile, type ExportFormat, type ExportFormatsResponse, type ExportResult, type ExportStatusResponse, type GenerateEmailParams, type GenerateEmailResponse, type GeneratedEmailArtifact, 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 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 UpdateEmailArtifactParams, 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

@@ -71,7 +71,7 @@ var MigmaClient = class {
           headers: {
             Authorization: `Bearer ${this.apiKey}`,
             "Content-Type": "application/json",
-            "User-Agent": "migma-node/1.1.0"
+            "User-Agent": "migma-node/1.0.0"
           },
           body: options.body ? JSON.stringify(options.body) : void 0
         });
@@ -404,20 +404,6 @@ var Projects = class {
       `/projects/import/${projectId}/retry`
     );
   }
-  /**
-   * Get the project's subscriber field catalog: which fields exist, how often
-   * each is populated, example values, and whether it's auto-filled at send
-   * time. Optionally scope by segment or tag.
-   */
-  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'.
@@ -465,6 +451,24 @@ 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
+    );
+  }
+  /** Compile an email artifact's source without persisting */
+  async compile(artifactId, params) {
+    return this.client.post(
+      `/emails/${artifactId}/compile`,
+      params || {}
+    );
+  }
   /**
    * Generate an email and wait for completion.
    * Polls getGenerationStatus until status is 'completed' or 'failed'.
@@ -756,13 +760,12 @@ var Campaigns = class {
     this.client = client;
   }
   async list(params) {
-    const { projectId, status, page, limit, archived } = params;
+    const { projectId, status, page, limit } = params;
     return this.client.get("/campaigns", {
       projectId,
       status,
       page,
-      limit,
-      archived
+      limit
     });
   }
   async create(params) {
@@ -780,12 +783,6 @@ var Campaigns = class {
   async cancel(id) {
     return this.client.post(`/campaigns/${id}/cancel`);
   }
-  async archive(id) {
-    return this.client.post(`/campaigns/${id}/archive`);
-  }
-  async unarchive(id) {
-    return this.client.post(`/campaigns/${id}/unarchive`);
-  }
 };
 
 // src/migma.ts