migma 1.4.1 → 1.6.0

package/README.md

@@ -646,7 +646,7 @@ await migma.images.updateLogos('proj_abc123', {
 | `migma.sending` | `send` `getBatchStatus` | [Sending](https://docs.migma.ai/api-reference/sending/send-email) |
 | `migma.metrics` | `sending` | [API Reference](https://docs.migma.ai/api-reference/introduction) |
 | `migma.projects` | `list` `get` `import` `getImportStatus` `retryImport` `fieldCatalog` `importAndWait` | [Projects](https://docs.migma.ai/api-reference/projects/list-projects) |
-| `migma.emails` | `generate` `getGenerationStatus` `generateAndWait` `sendTest` `get` `edit` | [Email Generation](https://docs.migma.ai/api-reference/email/generate-email-async) |
+| `migma.emails` | `generate` `importHtml` `getGenerationStatus` `generateAndWait` `importHtmlAndWait` `sendTest` `get` `edit` | [Email Generation](https://docs.migma.ai/api-reference/email/generate-email-async) |
 | `migma.campaigns` | `list` `create` `get` `send` `schedule` `cancel` `stats` `logs` `archive` `unarchive` | [Campaigns](https://docs.migma.ai/campaigns/overview) |
 | `migma.validation` | `all` `compatibility` `links` `spelling` `deliverability` | [Validation](https://docs.migma.ai/api-reference/email-validation/run-all-validation-checks) |
 | `migma.previews` | `create` `get` `getStatus` `getDevice` `getSupportedDevices` `createAndWait` | [Previews](https://docs.migma.ai/api-reference/email-previews/create-email-preview) |
@@ -670,6 +670,7 @@ const options = {
 };
 
 await migma.emails.generateAndWait(params, options);
+await migma.emails.importHtmlAndWait(params, options);
 await migma.projects.importAndWait(params, options);
 await migma.previews.createAndWait(params, options);
 ```

package/dist/index.d.mts

@@ -605,6 +605,24 @@ interface GenerateEmailParams {
     /** Optional target email count. Omit to let Migma infer single vs series from the prompt. */
     count?: number;
 }
+interface ImportHtmlEmailFile {
+    name: string;
+    source: string;
+}
+interface ImportHtmlEmailParams {
+    projectId: string;
+    /** Single HTML or .eml source. Provide this or `htmls`, not both. */
+    html?: string;
+    /** Filename for a single `html` paste. */
+    name?: string;
+    /** Multiple HTML / .eml files (1–12). Provide this or `html`, not both. */
+    htmls?: ImportHtmlEmailFile[];
+    /** Natural-language conversion instruction (keep as-is vs apply brand). */
+    instruction?: string;
+    languages?: string[];
+    visibility?: 'private' | 'unlisted' | 'public';
+    generateMedia?: boolean;
+}
 interface GenerateEmailResponse {
     conversationId: string;
     status: 'pending';
@@ -805,6 +823,8 @@ declare class Emails {
     list(params: ListEmailsParams): Promise<MigmaResult<ListEmailsResponse>>;
     /** Start async email generation */
     generate(params: GenerateEmailParams, options?: CallOptions): Promise<MigmaResult<GenerateEmailResponse>>;
+    /** Convert existing HTML or .eml into editable emails (async). */
+    importHtml(params: ImportHtmlEmailParams, options?: CallOptions): Promise<MigmaResult<GenerateEmailResponse>>;
     /** Check email generation status */
     getGenerationStatus(conversationId: string): Promise<MigmaResult<EmailGenerationStatus>>;
     /** Fetch one generated email by email id */
@@ -816,6 +836,11 @@ declare class Emails {
      * Polls getGenerationStatus until status is 'completed' or 'failed'.
      */
     generateAndWait(params: GenerateEmailParams, options?: PollingOptions, callOptions?: CallOptions): Promise<MigmaResult<EmailGenerationStatus>>;
+    /**
+     * Import HTML and wait for completion.
+     * Polls getGenerationStatus until status is 'completed' or 'failed'.
+     */
+    importHtmlAndWait(params: ImportHtmlEmailParams, options?: PollingOptions, callOptions?: CallOptions): Promise<MigmaResult<EmailGenerationStatus>>;
     /** Send a test email from a completed conversation */
     sendTest(params: SendTestEmailParams): Promise<MigmaResult<SendTestEmailResponse>>;
     /**
@@ -1197,6 +1222,143 @@ declare class Domains {
     setup(params: SetupDomainParams): Promise<MigmaResult<SetupDomainResponse>>;
 }
 
+interface DomainPurchaseQuote {
+    rootDomain: string;
+    tld: string;
+    available?: boolean;
+    supported?: boolean;
+    premium?: boolean;
+    sellPrice?: number;
+    currency?: string;
+    [key: string]: unknown;
+}
+interface DomainPurchaseSearchParams {
+    /** Name or keyword, e.g. 'acme' or 'acme.com'. */
+    q: string;
+    /** Max quotes to return (1-20, default 8). */
+    limit?: number;
+}
+interface DomainPurchaseParams {
+    /** Domain to buy, e.g. 'acme.com'. */
+    domain: string;
+    /** Optional website the bought apex domain should redirect to. */
+    redirectUrl?: string;
+}
+interface DomainPurchaseCheckout {
+    /** Stripe checkout URL the account owner opens in a browser to pay. */
+    checkoutUrl: string;
+    checkoutSessionId?: string;
+    billingMode?: 'annual_subscription';
+    [key: string]: unknown;
+}
+type DomainRegistrationStatus = 'quoted' | 'payment_pending' | 'registering' | 'active' | 'failed' | 'refunded' | string;
+interface DomainRegistration {
+    id: string;
+    rootDomain: string;
+    status: DomainRegistrationStatus;
+    sellPrice?: number;
+    currency?: string;
+    [key: string]: unknown;
+}
+type CustomDnsRecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS';
+interface CustomDnsRecord {
+    id: string;
+    type: CustomDnsRecordType;
+    name: string;
+    content: string;
+    /** MX only. */
+    priority?: number;
+    createdAt: string;
+    [key: string]: unknown;
+}
+interface CustomDnsRecordList {
+    /** false = Migma does not host this domain's DNS zone (connected from an outside registrar). */
+    managed: boolean;
+    records: CustomDnsRecord[];
+}
+interface AddCustomDnsRecordParams {
+    /** Record name: '@' for the root, a label like 'mail', or a full name like 'mail.acme.com'. */
+    name: string;
+    /** Record value, e.g. an IP, hostname, or TXT string. */
+    content: string;
+    /** Defaults to TXT. */
+    type?: CustomDnsRecordType;
+    /** MX priority (0-65535). */
+    priority?: number;
+}
+
+declare class DomainPurchases {
+    private readonly client;
+    constructor(client: MigmaClient);
+    /** Availability and price quotes for domains you could buy. */
+    search(params: DomainPurchaseSearchParams): Promise<MigmaResult<{
+        quotes: DomainPurchaseQuote[];
+    }>>;
+    /**
+     * Start buying a domain. Returns a Stripe checkout URL the account owner
+     * opens in a browser; the domain registers after payment clears. Requires
+     * an active paid Migma subscription.
+     */
+    create(params: DomainPurchaseParams): Promise<MigmaResult<DomainPurchaseCheckout>>;
+    /** Purchase history and status: payment_pending → registering → active. */
+    registrations(params?: {
+        limit?: number;
+    }): Promise<MigmaResult<{
+        registrations: DomainRegistration[];
+    }>>;
+    /** DNS records you added to a domain bought in Migma. `managed: false` = zone not hosted by Migma. */
+    listDnsRecords(domain: string): Promise<MigmaResult<CustomDnsRecordList>>;
+    /**
+     * Add a DNS record (A, AAAA, CNAME, MX, TXT, or NS) to a domain bought in
+     * Migma. Migma's email sending records are protected and cannot be
+     * overridden; the root and www stay with domain forwarding.
+     */
+    addDnsRecord(domain: string, params: AddCustomDnsRecordParams): Promise<MigmaResult<{
+        record: CustomDnsRecord;
+    }>>;
+    /** Remove a DNS record you added earlier (never Migma's own records). */
+    removeDnsRecord(domain: string, recordId: string): Promise<MigmaResult<{
+        ok: boolean;
+    }>>;
+}
+
+interface CreditStatus {
+    currentPlan: string;
+    isExpired: boolean;
+    planExpiry?: string;
+    hasCredits: boolean;
+    emailCreditsRemainingToday: number;
+    imageCreditsRemainingToday: number;
+    monthlyCreditsRemaining: number;
+}
+type UpgradePlan = 'basic' | 'premium' | 'business' | 'basic_annual' | 'premium_annual' | 'business_annual';
+interface UpgradeLinkParams {
+    /**
+     * Target plan for Stripe Checkout. Omit to get a billing portal link
+     * (existing Stripe customers only).
+     */
+    plan?: UpgradePlan;
+}
+interface UpgradeLink {
+    /** URL the account owner opens in a browser to pay or manage billing. */
+    url: string;
+    kind: 'checkout' | 'portal';
+    sessionId?: string;
+    orderId?: string;
+}
+
+declare class Billing {
+    private readonly client;
+    constructor(client: MigmaClient);
+    /** Plan and remaining credits for the API key owner. */
+    credits(): Promise<MigmaResult<CreditStatus>>;
+    /**
+     * Mint a Stripe link the account owner opens in a browser to upgrade or
+     * manage the subscription. Nothing is charged by this call itself.
+     */
+    upgradeLink(params?: UpgradeLinkParams): Promise<MigmaResult<UpgradeLink>>;
+}
+
 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';
 interface CreateWebhookParams {
     url: string;
@@ -1552,6 +1714,8 @@ declare class Migma {
     readonly previews: Previews;
     readonly export: Export;
     readonly domains: Domains;
+    readonly domainPurchases: DomainPurchases;
+    readonly billing: Billing;
     readonly webhooks: Webhooks;
     readonly knowledgeBase: KnowledgeBase;
     readonly images: Images;
@@ -1560,4 +1724,4 @@ declare class Migma {
     constructor(apiKey: string, config?: MigmaConfig);
 }
 
-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 EmailLogsParams, type EmailLogsResponse, type EmailMetrics, type EmailMetricsCountry, type EmailMetricsSummary, type EmailMetricsTimePoint, type EmailSendLog, 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 SendingMetrics, type SendingMetricsCounts, type SendingMetricsHistoryEntry, type SendingMetricsParams, type SendingMetricsToday, 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 };
+export { type AddCustomDnsRecordParams, 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 CreditStatus, type CustomDnsRecord, type CustomDnsRecordList, type CustomDnsRecordType, type DeleteResponse, type DeliverabilityResponse, type DeviceCategoriesResponse, type DnsRecord, type Domain, type DomainAvailability, type DomainDeleteResponse, type DomainPurchaseCheckout, type DomainPurchaseParams, type DomainPurchaseQuote, type DomainPurchaseSearchParams, type DomainRegistration, type DomainRegistrationStatus, type DomainStream, type DomainVerificationResult, type EditEmailParams, type Email, type EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type EmailLogsParams, type EmailLogsResponse, type EmailMetrics, type EmailMetricsCountry, type EmailMetricsSummary, type EmailMetricsTimePoint, type EmailSendLog, 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 ImportHtmlEmailFile, type ImportHtmlEmailParams, 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 SendingMetrics, type SendingMetricsCounts, type SendingMetricsHistoryEntry, type SendingMetricsParams, type SendingMetricsToday, 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 UpgradeLink, type UpgradeLinkParams, type UpgradePlan, 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

@@ -605,6 +605,24 @@ interface GenerateEmailParams {
     /** Optional target email count. Omit to let Migma infer single vs series from the prompt. */
     count?: number;
 }
+interface ImportHtmlEmailFile {
+    name: string;
+    source: string;
+}
+interface ImportHtmlEmailParams {
+    projectId: string;
+    /** Single HTML or .eml source. Provide this or `htmls`, not both. */
+    html?: string;
+    /** Filename for a single `html` paste. */
+    name?: string;
+    /** Multiple HTML / .eml files (1–12). Provide this or `html`, not both. */
+    htmls?: ImportHtmlEmailFile[];
+    /** Natural-language conversion instruction (keep as-is vs apply brand). */
+    instruction?: string;
+    languages?: string[];
+    visibility?: 'private' | 'unlisted' | 'public';
+    generateMedia?: boolean;
+}
 interface GenerateEmailResponse {
     conversationId: string;
     status: 'pending';
@@ -805,6 +823,8 @@ declare class Emails {
     list(params: ListEmailsParams): Promise<MigmaResult<ListEmailsResponse>>;
     /** Start async email generation */
     generate(params: GenerateEmailParams, options?: CallOptions): Promise<MigmaResult<GenerateEmailResponse>>;
+    /** Convert existing HTML or .eml into editable emails (async). */
+    importHtml(params: ImportHtmlEmailParams, options?: CallOptions): Promise<MigmaResult<GenerateEmailResponse>>;
     /** Check email generation status */
     getGenerationStatus(conversationId: string): Promise<MigmaResult<EmailGenerationStatus>>;
     /** Fetch one generated email by email id */
@@ -816,6 +836,11 @@ declare class Emails {
      * Polls getGenerationStatus until status is 'completed' or 'failed'.
      */
     generateAndWait(params: GenerateEmailParams, options?: PollingOptions, callOptions?: CallOptions): Promise<MigmaResult<EmailGenerationStatus>>;
+    /**
+     * Import HTML and wait for completion.
+     * Polls getGenerationStatus until status is 'completed' or 'failed'.
+     */
+    importHtmlAndWait(params: ImportHtmlEmailParams, options?: PollingOptions, callOptions?: CallOptions): Promise<MigmaResult<EmailGenerationStatus>>;
     /** Send a test email from a completed conversation */
     sendTest(params: SendTestEmailParams): Promise<MigmaResult<SendTestEmailResponse>>;
     /**
@@ -1197,6 +1222,143 @@ declare class Domains {
     setup(params: SetupDomainParams): Promise<MigmaResult<SetupDomainResponse>>;
 }
 
+interface DomainPurchaseQuote {
+    rootDomain: string;
+    tld: string;
+    available?: boolean;
+    supported?: boolean;
+    premium?: boolean;
+    sellPrice?: number;
+    currency?: string;
+    [key: string]: unknown;
+}
+interface DomainPurchaseSearchParams {
+    /** Name or keyword, e.g. 'acme' or 'acme.com'. */
+    q: string;
+    /** Max quotes to return (1-20, default 8). */
+    limit?: number;
+}
+interface DomainPurchaseParams {
+    /** Domain to buy, e.g. 'acme.com'. */
+    domain: string;
+    /** Optional website the bought apex domain should redirect to. */
+    redirectUrl?: string;
+}
+interface DomainPurchaseCheckout {
+    /** Stripe checkout URL the account owner opens in a browser to pay. */
+    checkoutUrl: string;
+    checkoutSessionId?: string;
+    billingMode?: 'annual_subscription';
+    [key: string]: unknown;
+}
+type DomainRegistrationStatus = 'quoted' | 'payment_pending' | 'registering' | 'active' | 'failed' | 'refunded' | string;
+interface DomainRegistration {
+    id: string;
+    rootDomain: string;
+    status: DomainRegistrationStatus;
+    sellPrice?: number;
+    currency?: string;
+    [key: string]: unknown;
+}
+type CustomDnsRecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS';
+interface CustomDnsRecord {
+    id: string;
+    type: CustomDnsRecordType;
+    name: string;
+    content: string;
+    /** MX only. */
+    priority?: number;
+    createdAt: string;
+    [key: string]: unknown;
+}
+interface CustomDnsRecordList {
+    /** false = Migma does not host this domain's DNS zone (connected from an outside registrar). */
+    managed: boolean;
+    records: CustomDnsRecord[];
+}
+interface AddCustomDnsRecordParams {
+    /** Record name: '@' for the root, a label like 'mail', or a full name like 'mail.acme.com'. */
+    name: string;
+    /** Record value, e.g. an IP, hostname, or TXT string. */
+    content: string;
+    /** Defaults to TXT. */
+    type?: CustomDnsRecordType;
+    /** MX priority (0-65535). */
+    priority?: number;
+}
+
+declare class DomainPurchases {
+    private readonly client;
+    constructor(client: MigmaClient);
+    /** Availability and price quotes for domains you could buy. */
+    search(params: DomainPurchaseSearchParams): Promise<MigmaResult<{
+        quotes: DomainPurchaseQuote[];
+    }>>;
+    /**
+     * Start buying a domain. Returns a Stripe checkout URL the account owner
+     * opens in a browser; the domain registers after payment clears. Requires
+     * an active paid Migma subscription.
+     */
+    create(params: DomainPurchaseParams): Promise<MigmaResult<DomainPurchaseCheckout>>;
+    /** Purchase history and status: payment_pending → registering → active. */
+    registrations(params?: {
+        limit?: number;
+    }): Promise<MigmaResult<{
+        registrations: DomainRegistration[];
+    }>>;
+    /** DNS records you added to a domain bought in Migma. `managed: false` = zone not hosted by Migma. */
+    listDnsRecords(domain: string): Promise<MigmaResult<CustomDnsRecordList>>;
+    /**
+     * Add a DNS record (A, AAAA, CNAME, MX, TXT, or NS) to a domain bought in
+     * Migma. Migma's email sending records are protected and cannot be
+     * overridden; the root and www stay with domain forwarding.
+     */
+    addDnsRecord(domain: string, params: AddCustomDnsRecordParams): Promise<MigmaResult<{
+        record: CustomDnsRecord;
+    }>>;
+    /** Remove a DNS record you added earlier (never Migma's own records). */
+    removeDnsRecord(domain: string, recordId: string): Promise<MigmaResult<{
+        ok: boolean;
+    }>>;
+}
+
+interface CreditStatus {
+    currentPlan: string;
+    isExpired: boolean;
+    planExpiry?: string;
+    hasCredits: boolean;
+    emailCreditsRemainingToday: number;
+    imageCreditsRemainingToday: number;
+    monthlyCreditsRemaining: number;
+}
+type UpgradePlan = 'basic' | 'premium' | 'business' | 'basic_annual' | 'premium_annual' | 'business_annual';
+interface UpgradeLinkParams {
+    /**
+     * Target plan for Stripe Checkout. Omit to get a billing portal link
+     * (existing Stripe customers only).
+     */
+    plan?: UpgradePlan;
+}
+interface UpgradeLink {
+    /** URL the account owner opens in a browser to pay or manage billing. */
+    url: string;
+    kind: 'checkout' | 'portal';
+    sessionId?: string;
+    orderId?: string;
+}
+
+declare class Billing {
+    private readonly client;
+    constructor(client: MigmaClient);
+    /** Plan and remaining credits for the API key owner. */
+    credits(): Promise<MigmaResult<CreditStatus>>;
+    /**
+     * Mint a Stripe link the account owner opens in a browser to upgrade or
+     * manage the subscription. Nothing is charged by this call itself.
+     */
+    upgradeLink(params?: UpgradeLinkParams): Promise<MigmaResult<UpgradeLink>>;
+}
+
 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';
 interface CreateWebhookParams {
     url: string;
@@ -1552,6 +1714,8 @@ declare class Migma {
     readonly previews: Previews;
     readonly export: Export;
     readonly domains: Domains;
+    readonly domainPurchases: DomainPurchases;
+    readonly billing: Billing;
     readonly webhooks: Webhooks;
     readonly knowledgeBase: KnowledgeBase;
     readonly images: Images;
@@ -1560,4 +1724,4 @@ declare class Migma {
     constructor(apiKey: string, config?: MigmaConfig);
 }
 
-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 EmailLogsParams, type EmailLogsResponse, type EmailMetrics, type EmailMetricsCountry, type EmailMetricsSummary, type EmailMetricsTimePoint, type EmailSendLog, 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 SendingMetrics, type SendingMetricsCounts, type SendingMetricsHistoryEntry, type SendingMetricsParams, type SendingMetricsToday, 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 };
+export { type AddCustomDnsRecordParams, 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 CreditStatus, type CustomDnsRecord, type CustomDnsRecordList, type CustomDnsRecordType, type DeleteResponse, type DeliverabilityResponse, type DeviceCategoriesResponse, type DnsRecord, type Domain, type DomainAvailability, type DomainDeleteResponse, type DomainPurchaseCheckout, type DomainPurchaseParams, type DomainPurchaseQuote, type DomainPurchaseSearchParams, type DomainRegistration, type DomainRegistrationStatus, type DomainStream, type DomainVerificationResult, type EditEmailParams, type Email, type EmailGenerationResult, type EmailGenerationStatus, type EmailImage, type EmailLogsParams, type EmailLogsResponse, type EmailMetrics, type EmailMetricsCountry, type EmailMetricsSummary, type EmailMetricsTimePoint, type EmailSendLog, 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 ImportHtmlEmailFile, type ImportHtmlEmailParams, 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 SendingMetrics, type SendingMetricsCounts, type SendingMetricsHistoryEntry, type SendingMetricsParams, type SendingMetricsToday, 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 UpgradeLink, type UpgradeLinkParams, type UpgradePlan, 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

@@ -484,6 +484,14 @@ var Emails = class {
       options
     );
   }
+  /** Convert existing HTML or .eml into editable emails (async). */
+  async importHtml(params, options) {
+    return this.client.post(
+      "/projects/emails/import-html",
+      params,
+      options
+    );
+  }
   /** Check email generation status */
   async getGenerationStatus(conversationId) {
     return this.client.get(
@@ -517,6 +525,22 @@ var Emails = class {
       options
     );
   }
+  /**
+   * Import HTML and wait for completion.
+   * Polls getGenerationStatus until status is 'completed' or 'failed'.
+   */
+  async importHtmlAndWait(params, options, callOptions) {
+    const startResult = await this.importHtml(params, callOptions);
+    if (startResult.error) {
+      return { data: null, error: startResult.error };
+    }
+    const conversationId = startResult.data.conversationId;
+    return poll(
+      () => this.getGenerationStatus(conversationId),
+      (status) => status.status === "completed" || status.status === "failed",
+      options
+    );
+  }
   /** Send a test email from a completed conversation */
   async sendTest(params) {
     return this.client.post(
@@ -719,6 +743,76 @@ var Domains = class {
   }
 };
 
+// src/resources/domain-purchases.ts
+var DomainPurchases = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Availability and price quotes for domains you could buy. */
+  async search(params) {
+    return this.client.get("/domains/purchase/search", {
+      q: params.q,
+      limit: params.limit
+    });
+  }
+  /**
+   * Start buying a domain. Returns a Stripe checkout URL the account owner
+   * opens in a browser; the domain registers after payment clears. Requires
+   * an active paid Migma subscription.
+   */
+  async create(params) {
+    return this.client.post("/domains/purchase", params);
+  }
+  /** Purchase history and status: payment_pending → registering → active. */
+  async registrations(params) {
+    return this.client.get("/domains/purchase/registrations", {
+      limit: params?.limit
+    });
+  }
+  // DNS records live on Migma-hosted zones, which exist exactly for domains
+  // bought in Migma — hence they sit on this resource even though the API
+  // path is /domains/:domain/dns-records.
+  /** DNS records you added to a domain bought in Migma. `managed: false` = zone not hosted by Migma. */
+  async listDnsRecords(domain) {
+    return this.client.get(`/domains/${encodeURIComponent(domain)}/dns-records`);
+  }
+  /**
+   * Add a DNS record (A, AAAA, CNAME, MX, TXT, or NS) to a domain bought in
+   * Migma. Migma's email sending records are protected and cannot be
+   * overridden; the root and www stay with domain forwarding.
+   */
+  async addDnsRecord(domain, params) {
+    return this.client.post(
+      `/domains/${encodeURIComponent(domain)}/dns-records`,
+      params
+    );
+  }
+  /** Remove a DNS record you added earlier (never Migma's own records). */
+  async removeDnsRecord(domain, recordId) {
+    return this.client.delete(
+      `/domains/${encodeURIComponent(domain)}/dns-records/${encodeURIComponent(recordId)}`
+    );
+  }
+};
+
+// src/resources/billing.ts
+var Billing = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Plan and remaining credits for the API key owner. */
+  async credits() {
+    return this.client.get("/billing/credits");
+  }
+  /**
+   * Mint a Stripe link the account owner opens in a browser to upgrade or
+   * manage the subscription. Nothing is charged by this call itself.
+   */
+  async upgradeLink(params = {}) {
+    return this.client.post("/billing/upgrade-link", params);
+  }
+};
+
 // src/resources/webhooks.ts
 var Webhooks = class {
   constructor(client) {
@@ -895,6 +989,8 @@ var Migma = class {
   previews;
   export;
   domains;
+  domainPurchases;
+  billing;
   webhooks;
   knowledgeBase;
   images;
@@ -922,6 +1018,8 @@ var Migma = class {
     this.previews = new Previews(this.client);
     this.export = new Export(this.client);
     this.domains = new Domains(this.client);
+    this.domainPurchases = new DomainPurchases(this.client);
+    this.billing = new Billing(this.client);
     this.webhooks = new Webhooks(this.client);
     this.knowledgeBase = new KnowledgeBase(this.client);
     this.images = new Images(this.client);