@easybits.cloud/mailmask 0.4.8 → 0.4.10

package/dist/index.d.ts

@@ -1,1189 +1,4 @@
-interface MailMaskConfig {
-    apiKey: string;
-    baseUrl?: string;
-    /**
-     * `fetch` alterno. Sirve para poner un timeout por llamada
-     * (`AbortSignal.timeout`), reintentos o un proxy, y para probar el SDK
-     * contra el servidor en proceso sin levantar un puerto.
-     */
-    fetch?: typeof fetch;
-}
-interface Domain {
-    id: string;
-    domain: string;
-    /** Último valor medido. Si `verifiedStatus` es "unknown", no lo afirmes: confírmalo con `domains.health`. */
-    verified: boolean;
-    /** Último valor medido. Si `mxStatus` es "unknown", no lo afirmes: confírmalo con `domains.health`. */
-    mxConfigured: boolean;
-    registeredViaMailmask: boolean;
-    createdAt: string;
-    /** Cuándo se midieron `verified` y `mxConfigured` en vivo (health, verify o el servidor). null = nunca. */
-    checkedAt?: string | null;
-    /** "unknown" si la revisión tiene más de 24 h o nunca se hizo. */
-    mxStatus?: "ok" | "missing" | "unknown";
-    /** "unknown" si la revisión tiene más de 24 h o nunca se hizo. */
-    verifiedStatus?: "ok" | "missing" | "unknown";
-    /** Presente cuando algún estado es "unknown": qué hacer para confirmarlo. */
-    statusNote?: string;
-    /** Sólo en `domains.list`: reenvíos del mes en curso. */
-    monthlyForwards?: number;
-    /** Sólo en `domains.list`: tope de reenvíos por hora del plan. */
-    forwardPerHour?: number;
-}
-interface DnsRecord {
-    type: "MX" | "TXT" | "CNAME";
-    name: string;
-    value: string;
-    priority?: number;
-}
-/** Respuesta de `domains.create`: el dominio y los registros DNS que hay que poner. */
-interface DomainCreated {
-    domain: Domain;
-    /** true si es el 2.º dominio sin activar: se guarda pero no reenvía hasta activarlo ($99/mes). */
-    requiereActivacion: boolean;
-    dnsRecords: {
-        mx: DnsRecord;
-        verification: DnsRecord;
-        dkim: DnsRecord[];
-        spf: DnsRecord;
-    };
-}
-/** Respuesta de `domains.verify`. */
-interface DomainVerification {
-    domain: string;
-    verified: boolean;
-    dkimVerified: boolean;
-    /** Si el MX apunta al inbound de SES, medido en la misma llamada; null si el DNS no respondió. */
-    mxConfigured?: boolean | null;
-    /** true cuando no se pudo consultar a SES: los campos son el último estado conocido. */
-    stale?: boolean;
-    error?: string;
-}
-/** Nombre público de `Alias` desde la 0.4.5. */
-type Address = Alias;
-/** Nombre público de `AliasCreated` desde la 0.4.5. */
-type AddressCreated = AliasCreated;
-/** Nombre público de `CreateAliasInput` desde la 0.4.5. */
-type CreateAddressInput = CreateAliasInput;
-/** Nombre público de `UpdateAliasInput` desde la 0.4.5. */
-type UpdateAddressInput = UpdateAliasInput;
-interface Alias {
-    alias: string;
-    domainId: string;
-    destinations: string[];
-    enabled: boolean;
-    forwardCount: number;
-    lastFrom?: string | null;
-    lastAt?: string | null;
-    createdAt: string;
-    /** true si la máscara guarda el correo en un buzón IMAP. */
-    mailboxEnabled?: boolean;
-}
-/** Credenciales de un buzón IMAP recién creado. La contraseña se muestra una sola vez. */
-interface MailboxCreated {
-    email: string;
-    password: string;
-    quotaBytes: number;
-    imap: {
-        host: string;
-        port: number;
-        security: string;
-    };
-    smtp: {
-        host: string;
-        port: number;
-        security: string;
-    };
-}
-/** `aliases.create`: el alias, y si pediste buzón, sus credenciales o por qué no se creó. */
-interface AliasCreated extends Alias {
-    buzon?: MailboxCreated | null;
-    errorBuzon?: string | null;
-}
-interface CreateAliasInput {
-    /** Parte local, sin el dominio: "hola" para hola@tudominio.com. `*` para catch-all. */
-    alias: string;
-    /** Adónde reenviar. Puede ir vacío sólo si `mailbox` es true. */
-    destinations?: string[];
-    /** Crear también un buzón IMAP (requiere dominio activado). */
-    mailbox?: boolean;
-}
-interface UpdateAliasInput {
-    enabled?: boolean;
-    destinations?: string[];
-}
-type RuleField = "to" | "from" | "subject";
-type RuleMatch = "contains" | "equals" | "regex";
-/** `forward` y `webhook` requieren `target`; `discard` no. */
-type RuleAction = "forward" | "webhook" | "discard";
-interface Rule {
-    id: string;
-    domainId: string;
-    field: RuleField;
-    match: RuleMatch;
-    value: string;
-    action: RuleAction;
-    target: string;
-    priority: number;
-    enabled: boolean;
-    createdAt: string;
-}
-interface CreateRuleInput {
-    field: RuleField;
-    /** Los patrones `regex` se validan al guardar: uno peligroso responde 400. */
-    match: RuleMatch;
-    value: string;
-    action: RuleAction;
-    /** Destino del `forward` o URL del `webhook`. Se ignora con `discard`. */
-    target?: string;
-    priority?: number;
-    enabled?: boolean;
-}
-interface UpdateRuleInput {
-    field?: RuleField;
-    match?: RuleMatch;
-    value?: string;
-    action?: RuleAction;
-    target?: string;
-    priority?: number;
-    enabled?: boolean;
-}
-interface EmailLog {
-    id: string;
-    domainId: string;
-    timestamp: string;
-    from: string;
-    to: string;
-    subject: string;
-    /** Entrantes: forwarded, discarded, failed, rule_matched. Salientes: sent → delivered | bounced | complained. */
-    status: "forwarded" | "discarded" | "failed" | "rule_matched" | "sent" | "delivered" | "bounced" | "complained";
-    forwardedTo: string;
-    sizeBytes: number;
-    error?: string;
-    /** Id interno de SES; cruza el log con los eventos de entrega. Sólo en salientes. */
-    sesMessageId?: string;
-}
-interface SendEmailInput {
-    to: string;
-    subject: string;
-    /** Al menos uno de `html`, `body` o `markdown`. Con html y body se manda multipart. HTML máx. 100 KB. */
-    html?: string;
-    body?: string;
-    markdown?: string;
-    replyTo?: string;
-    /**
-     * Parte local de un alias **activo** del dominio. Sin esto el correo sale
-     * desde `noreply@tudominio.com`.
-     */
-    from?: string;
-    /** Nombre visible del remitente: `Libretas <hola@tudominio.com>`. */
-    fromName?: string;
-    /** Copias visibles. Máx. 20; también pasan por la lista de supresión. */
-    cc?: string[];
-    /** Copias ocultas. Máx. 20. */
-    bcc?: string[];
-    /** `Message-ID` del correo al que se responde, para que el cliente lo enhebre. */
-    inReplyTo?: string;
-    /** Cadena `References` del hilo. */
-    references?: string;
-    /** Archivos subidos antes con `attachments.upload`. Se borran de S3 al enviarse. */
-    attachments?: AttachmentRef[];
-}
-/** Lo que devuelve `attachments.upload`; se pasa tal cual en `SendEmailInput.attachments`. */
-interface AttachmentRef {
-    key: string;
-    filename: string;
-    contentType?: string;
-}
-interface UploadAttachmentInput {
-    filename: string;
-    contentType: string;
-    data: Uint8Array | Blob;
-}
-interface UploadedAttachment {
-    ok: boolean;
-    key: string;
-    filename: string;
-    size: number;
-}
-interface SendOptions {
-    /**
-     * Reintentar con la misma clave (máx. 128 caracteres) devuelve la respuesta
-     * original sin volver a enviar ni consumir cuota, durante 24 h.
-     */
-    idempotencyKey?: string;
-}
-interface Suppression {
-    email: string;
-    /** `bounce:Permanent`, `complaint` o `manual`. */
-    reason: string;
-    createdAt: string;
-}
-type WebhookEvent = "email.received" | "email.sent" | "email.delivered" | "email.bounced" | "email.complained";
-interface Webhook {
-    id: string;
-    domainId: string;
-    url: string;
-    events: WebhookEvent[];
-    enabled: boolean;
-    createdAt: string;
-}
-/** Lo que devuelve `webhooks.create`. El `secret` se muestra una sola vez. */
-interface WebhookCreated extends Webhook {
-    secret: string;
-}
-interface CreateWebhookInput {
-    /** Debe ser https y pública. */
-    url: string;
-    events: WebhookEvent[];
-}
-interface UpdateWebhookInput {
-    url?: string;
-    events?: WebhookEvent[];
-    enabled?: boolean;
-}
-interface WebhookDelivery {
-    id: string;
-    webhookId: string;
-    event: WebhookEvent | "ping";
-    attempts: number;
-    status: "pending" | "delivered" | "failed";
-    nextAt: string;
-    lastError: string | null;
-    lastStatusCode: number | null;
-    createdAt: string;
-}
-/** Cuerpo que recibe tu endpoint. `data` depende del evento. */
-interface WebhookPayload<T = Record<string, unknown>> {
-    event: WebhookEvent | "ping";
-    domainId: string;
-    timestamp: string;
-    data: T;
-}
-interface BulkSendInput {
-    recipients: string[];
-    subject: string;
-    html: string;
-    /** Alias activo del dominio; por omisión `noreply`. */
-    from?: string;
-}
-/** Lo que devuelve `bulkSend`: el job se encola, todavía no hay estado que leer. */
-interface BulkJobCreated {
-    ok: boolean;
-    jobId: string;
-}
-interface BulkJob {
-    id: string;
-    domainId: string;
-    recipients: string[];
-    subject: string;
-    html: string;
-    from: string;
-    status: string;
-    totalRecipients: number;
-    sent: number;
-    failed: number;
-    /** Destinatarios saltados por bounce o queja previa: total = sent + failed + skippedSuppressed. */
-    skippedSuppressed: number;
-    lastError?: string | null;
-    createdAt: string;
-    completedAt?: string | null;
-    expiresAt: string;
-}
-interface SmtpCredential {
-    id: string;
-    domainId: string;
-    label: string;
-    iamUsername: string;
-    createdAt: string;
-}
-/**
- * Lo que devuelve `smtp.create`. La contraseña se muestra **una sola vez**: no
- * se puede volver a consultar, sólo revocar la credencial y crear otra.
- */
-interface SmtpCredentialCreated {
-    id: string;
-    label: string;
-    server: string;
-    port: number;
-    encryption: string;
-    username: string;
-    password: string;
-    createdAt: string;
-}
-interface ApiKey {
-    id: string;
-    name: string;
-    /** Primeros caracteres de la llave, para identificarla en listados. */
-    keyPrefix: string;
-    lastUsedAt?: string;
-    createdAt: string;
-}
-type DnsRecordType = "A" | "AAAA" | "CNAME" | "TXT" | "MX" | "NS" | "CAA" | "SRV";
-/**
- * Un conjunto de registros con el mismo nombre y tipo. El DNS trabaja así, no con registros
- * sueltos: `values` es la lista completa y al escribirla reemplaza lo que hubiera.
- */
-interface DnsRRSet {
-    name: string;
-    type: DnsRecordType;
-    ttl: number;
-    values: string[];
-}
-interface DnsRRSetAnotado extends DnsRRSet {
-    /** Lo pone MailMask para que el correo funcione. */
-    managed: boolean;
-    editable: boolean;
-    managedReason?: string;
-    /** Valores que hay que conservar aunque el registro sea editable (el SPF). */
-    protectedValues?: string[];
-}
-interface DnsZoneState {
-    status: "none" | "pending_delegation" | "active";
-    hostedZoneId?: string;
-    nameservers?: string[];
-    delegated?: boolean;
-}
-interface DnsListResponse {
-    zone: DnsZoneState;
-    records: DnsRRSetAnotado[];
-    /** Presente cuando todavía no hay zona: dice qué hacer. */
-    hint?: string;
-}
-interface DnsZoneCreated {
-    hostedZoneId: string;
-    nameservers: string[];
-    /** Lo que copiamos de tu proveedor anterior. Revísalo: puede faltar algo. */
-    imported: DnsRRSet[];
-    importWarning: string;
-}
-interface DnsDelegation {
-    delegated: boolean;
-    observed: string[];
-    expected: string[];
-}
-interface DnsImportResult {
-    found: DnsRRSet[];
-    nameservers: string[];
-    warning: string;
-}
-interface DnsChangeResult {
-    record?: DnsRRSet;
-    records?: DnsRRSet[];
-    changeId: string;
-    propagacion: string;
-}
-type DnsPreset = "vercel" | "netlify" | "github-pages" | "cloudflare-pages" | "render" | "fly" | "redirect-a-www" | "dmarc";
-interface DnsSetupRecord {
-    id: string;
-    type: "MX" | "TXT" | "CNAME";
-    /** Relativo al dominio, como lo piden casi todos los paneles ('@', '_amazonses'). */
-    name: string;
-    fqdn: string;
-    value: string;
-    /** Sólo MX, para paneles con campo de prioridad aparte (entonces el valor es `host`). */
-    priority?: number;
-    host?: string;
-    level: "requerido" | "recomendado" | "opcional";
-    purpose: string;
-    benefit?: string;
-    /** Ayuda en texto con **negritas** estilo markdown. */
-    hints: string[];
-    /** Sólo con `live`: si el DNS público ya lo tiene; null = no se pudo consultar. */
-    ok?: boolean | null;
-    observed?: string[];
-    /** SPF: valor fusionado cuando ya existe otro SPF (se edita ése, no se crea otro). */
-    suggestedValue?: string;
-}
-interface DnsSetup {
-    domain: string;
-    records: DnsSetupRecord[];
-    live: boolean;
-    nameservers?: string[];
-    /** Panel donde se pegan, deducido de los nameservers. */
-    registrarHint?: {
-        provider: string;
-        label: string;
-        note: string;
-    } | null;
-    summary?: string;
-}
-interface BillingStatus {
-    subscription: {
-        plan: string;
-        status: string;
-        currentPeriodEnd?: string;
-        [k: string]: unknown;
-    };
-}
-interface Addon {
-    id: string;
-    kind: string;
-    /** Dominio al que aplica; sin él es un add-on legado de toda la cuenta. */
-    domainId?: string;
-    status: "pending" | "active" | "cancelled" | "expired";
-    priceCents: number;
-    currentPeriodEnd?: string;
-    createdAt: string;
-    cancelledAt?: string;
-    source: "purchase" | "courtesy" | "migration";
-}
-interface AddonsResponse {
-    catalog: Record<string, {
-        price: number;
-        label: string;
-    }>;
-    forSale: string[];
-    mine: Addon[];
-}
-/** Liga de pago de MercadoPago. Nada cambia hasta que el usuario la abre y paga. */
-interface CheckoutLink {
-    init_point: string;
-    addonId: string;
-}
-interface DomainSearchResult {
-    available: boolean;
-    domain: string;
-    tld: string;
-    /** Centavos MXN por año. */
-    price: number;
-    currency: "MXN";
-}
-interface TldPrice {
-    tld: string;
-    /** Centavos MXN. */
-    price: number;
-    renewPrice: number;
-    transferPrice: number;
-    popular: boolean;
-}
-interface DomainRegistrationCreated {
-    /** Liga de pago de MercadoPago; el registro arranca al pagar. */
-    initPoint: string;
-    registrationId: string;
-}
-interface DomainRegistration {
-    id: string;
-    domainId: string | null;
-    domainName: string;
-    kind: "register" | "transfer";
-    status: string;
-    expiresAt: string | null;
-    priceCents: number;
-    renewalStatus: string;
-    renewalPriceCents: number | null;
-    nextChargeAt: string | null;
-    dnsImportStatus: string;
-    transferAuthCodeHint: string | null;
-    /** Candado de transferencia (`clientTransferProhibited`); null si aún no se ha leído de AWS. */
-    transferLock: boolean | null;
-    /** Mientras está quitado: cuándo se vuelve a poner solo. */
-    transferUnlockedUntil: string | null;
-    /** Desde cuándo puede cambiar de registrador (regla de 60 días de ICANN). */
-    transferEligibleAt: string;
-    lastError: string | null;
-    createdAt: string;
-    [k: string]: unknown;
-}
-interface TransferRequirement {
-    texto: string;
-    ok: boolean | null;
-    ayuda?: string;
-}
-interface TransferCheck {
-    domain: string;
-    /** Centavos MXN; incluye un año de renovación. */
-    price: number;
-    currency: "MXN";
-    requisitos: TransferRequirement[];
-    dns: {
-        found: unknown[];
-        nameservers?: string[];
-        warning?: string;
-        truncado?: boolean;
-    };
-    [k: string]: unknown;
-}
-interface TransferDnsInventory {
-    records: unknown[];
-    status: string;
-    takenAt: string | null;
-}
-interface RenewalLink {
-    init_point: string;
-    nextChargeAt: string;
-}
-interface DomainMember {
-    id: string;
-    domainId: string;
-    email: string;
-    name: string;
-    role: "admin" | "agent";
-    createdAt: string;
-    /** Del perfil de su cuenta de MailMask, si lo llenó. */
-    displayName?: string | null;
-    avatarUrl?: string | null;
-}
-interface DomainInvite {
-    token: string;
-    email: string;
-    name: string;
-    role: "admin" | "agent";
-    expiresAt: string;
-    inviteUrl: string;
-}
-interface CannedReply {
-    id: string;
-    domainId: string;
-    title: string;
-    /** Markdown. */
-    body: string;
-    createdAt: string;
-}
-/** Perfil de la cuenta de MailMask (el usuario, no una máscara). */
-interface AccountProfile {
-    email: string;
-    displayName: string | null;
-    /** Ruta relativa al host de MailMask (`/api/avatar/...`), o null sin foto. */
-    avatarUrl: string | null;
-}
-/** Derechos y uso de UN dominio, dentro de `AccountMe.porDominio`. */
-interface AccountMeDomainUsage {
-    id: string;
-    domain: string;
-    /** Límites del dominio (sends, aliases, dominios, etc.), por plan y add-ons. */
-    derechos: Record<string, unknown>;
-    addons: Addon[];
-    uso: {
-        aliases: {
-            current: number;
-            limit: number;
-        };
-        rules: {
-            current: number;
-            limit: number;
-        };
-        sends: {
-            current: number;
-            limit: number;
-        };
-        forwards: {
-            current: number;
-            limit: number;
-        };
-        mailboxBytes: {
-            current: number;
-            limit: number;
-        };
-    };
-}
-/** Respuesta de `account.me()`: identidad de la cuenta y su uso, por dominio y total. */
-interface AccountMe extends AccountProfile {
-    isAdmin: boolean;
-    assistant: boolean;
-    domainsCount: number;
-    emailVerified: boolean;
-    forwards: {
-        current: number;
-        limit: number;
-    };
-    subscription: {
-        plan: string;
-        status: string;
-        currentPeriodEnd: string | null;
-        planLabel: string;
-        [k: string]: unknown;
-    };
-    porDominio: AccountMeDomainUsage[];
-    addons: Addon[];
-    planPriceCents: number | null;
-    addonCatalog: Record<string, {
-        price: number;
-        label: string;
-    }>;
-    addonsForSale: string[];
-    lastOrder: Order | null;
-    usage: {
-        domains: {
-            current: number;
-            limit: number | null;
-        };
-        aliasesPerDomain: unknown[];
-        rulesPerDomain: unknown[];
-        sendsPerDomain: unknown[];
-    };
-    referralSlug?: string | null;
-    referralStats: ReferralStats;
-}
-/** Respuesta de `account.export()`: todo el dato del usuario, listo para descargar. */
-interface AccountExport {
-    email: string;
-    exportedAt: string;
-    domains: {
-        domain: string;
-        domainId: string;
-        verified: boolean;
-        aliases: Alias[];
-        rules: Rule[];
-        logs: EmailLog[];
-    }[];
-}
-/** Respuesta de `domains.uploadImage()`. */
-interface UploadedEmailImage {
-    ok: boolean;
-    /** Efímera: se borra tras enviarse (o la barre el aseo diario si nunca se usó). */
-    url: string;
-}
-type InboxStatus = "open" | "snoozed" | "closed";
-interface InboxConversation {
-    id: string;
-    domainId: string;
-    /** El contacto externo (en un hilo que inició el dominio, el destinatario). */
-    from: string;
-    /** La máscara del dominio por la que va el hilo (`ventas@tudominio.com`). */
-    to: string;
-    subject: string;
-    status: InboxStatus;
-    assignedTo?: string;
-    priority: "normal" | "urgent";
-    lastMessageAt: string;
-    messageCount: number;
-    tags: string[];
-    deletedAt?: string;
-    snoozedUntil?: string;
-    /** Para quien pregunta: hay mensajes que no ha visto. */
-    unread?: boolean;
-    /** Sólo en búsqueda: fragmento con la coincidencia. */
-    snippet?: string;
-    [k: string]: unknown;
-}
-interface InboxListOptions {
-    /** `open`, `snoozed`, `closed`, `unread` (de quien pregunta) o `deleted` (papelera). */
-    status?: InboxStatus | "unread" | "deleted";
-    /** Dirección completa de la máscara (`ventas@tudominio.com`). */
-    to?: string;
-    assignedTo?: string;
-    /** Búsqueda en asunto, remitente y cuerpo. Con `q` no hay paginación (tope 50). */
-    q?: string;
-    /** Máx. 100. */
-    limit?: number;
-    cursor?: string;
-}
-interface InboxPage {
-    items: InboxConversation[];
-    nextCursor: string | null;
-    /** Máscaras con conversaciones (sólo en la primera página). */
-    aliases?: string[];
-    mode: "list" | "search" | "search-degraded";
-    unreadCount?: number;
-    [k: string]: unknown;
-}
-interface InboxAttachment {
-    index: number;
-    filename: string;
-    contentType: string;
-    size: number;
-}
-interface InboxMessage {
-    id: string;
-    conversationId: string;
-    from: string;
-    /** Texto plano. */
-    body?: string;
-    html?: string;
-    direction: "inbound" | "outbound";
-    createdAt: string;
-    messageId?: string;
-    deliveryStatus?: "sent" | "delivered" | "bounced" | "complained";
-    attachments?: InboxAttachment[];
-    /** El original ya no está (retención de 90 días o pérdida): `body` puede venir del índice. */
-    bodyDegraded?: string;
-}
-interface InboxNote {
-    id: string;
-    conversationId: string;
-    author: string;
-    body: string;
-    createdAt: string;
-}
-interface InboxConversationDetail extends InboxConversation {
-    messages: InboxMessage[];
-    notes: InboxNote[];
-    totalMessages: number;
-    hasMore: boolean;
-}
-interface InboxComposeInput {
-    /** Parte local (o dirección completa) de una máscara activa del dominio. */
-    fromAlias: string;
-    to: string;
-    subject: string;
-    markdown?: string;
-    html?: string;
-    body?: string;
-    cc?: string[];
-    bcc?: string[];
-    attachments?: AttachmentRef[];
-}
-interface InboxReplyInput {
-    markdown?: string;
-    html?: string;
-    body?: string;
-    cc?: string[];
-    bcc?: string[];
-    /** Cita el último mensaje recibido (por omisión true; sólo con markdown). */
-    quote?: boolean;
-    attachments?: AttachmentRef[];
-}
-interface InboxUpdateInput {
-    status?: InboxStatus;
-    /** ISO, futura y a menos de 90 días. Obligatoria con `status: "snoozed"`. */
-    snoozedUntil?: string;
-    tags?: string[];
-    priority?: "normal" | "urgent";
-}
-interface Order {
-    id: string;
-    number: string;
-    date: string;
-    kind: string;
-    concept: string;
-    subject: string | null;
-    amountCents: number;
-    listPriceCents: number | null;
-    currency: string;
-    periodStart: string | null;
-    periodEnd: string | null;
-    failureReason: string | null;
-    note: string | null;
-    reference: string | null;
-}
-interface OrdersPage {
-    orders: Order[];
-    nextCursor: string | null;
-    invoiceNote: string;
-}
-interface ReferralStats {
-    slug?: string | null;
-    referrals: unknown[];
-    [k: string]: unknown;
-}
-
-declare class MailMaskError extends Error {
-    status: number;
-    constructor(status: number, message: string);
-}
-declare class MailMask {
-    private baseUrl;
-    private apiKey;
-    domains: DomainsResource;
-    /** Las direcciones del dominio (máscaras), con reenvío, buzón o ambos. */
-    addresses: AliasesResource;
-    /** @deprecated Usa `addresses`; es el mismo recurso y no se va a retirar. */
-    aliases: AliasesResource;
-    rules: RulesResource;
-    logs: LogsResource;
-    send: SendResource;
-    attachments: AttachmentsResource;
-    suppressions: SuppressionsResource;
-    webhooks: WebhooksResource;
-    smtp: SmtpResource;
-    apiKeys: ApiKeysResource;
-    dns: DnsResource;
-    billing: BillingResource;
-    registrations: RegistrationsResource;
-    transfers: TransfersResource;
-    members: MembersResource;
-    signature: SignatureResource;
-    canned: CannedResource;
-    account: AccountResource;
-    inbox: InboxResource;
-    referrals: ReferralsResource;
-    constructor(config: MailMaskConfig);
-}
-type Req = <T>(path: string, opts?: RequestInit) => Promise<T>;
-declare class DomainsResource {
-    private req;
-    constructor(req: Req);
-    list(): Promise<Domain[]>;
-    get(id: string): Promise<Domain>;
-    create(domain: string): Promise<DomainCreated>;
-    delete(id: string): Promise<{
-        ok: boolean;
-    }>;
-    health(id: string): Promise<Record<string, unknown>>;
-    verify(id: string): Promise<DomainVerification>;
-    /** Registros a pegar en el registrador. Con `live` los compara con el DNS público y deduce el panel. */
-    dnsSetup(id: string, opts?: {
-        live?: boolean;
-    }): Promise<DnsSetup>;
-    /** Logo de la firma (PNG, JPG o WebP; máx. 500 KB). Se ve en todo correo en markdown. */
-    setLogo(id: string, file: Blob, filename?: string): Promise<{
-        ok: boolean;
-        logoUrl: string;
-    }>;
-    /** Logo desde un adjunto del chat del asistente (URL firmada de `/api/asistente/files/*`). */
-    setLogoFromUrl(id: string, url: string): Promise<{
-        ok: boolean;
-        logoUrl: string;
-    }>;
-    removeLogo(id: string): Promise<{
-        ok: boolean;
-    }>;
-    /** Imagen para incrustar en un correo saliente (PNG, JPG, GIF o WebP; máx. 2 MB). Efímera: se borra tras enviarse o por el barrido diario. */
-    uploadImage(id: string, file: Blob, filename?: string): Promise<UploadedEmailImage>;
-}
-declare class DnsResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<DnsListResponse>;
-    createZone(domainId: string): Promise<DnsZoneCreated>;
-    delegation(domainId: string): Promise<DnsDelegation>;
-    import(domainId: string): Promise<DnsImportResult>;
-    /** Reemplaza el conjunto: `values` sustituye por completo lo que hubiera en ese nombre y tipo. */
-    upsert(domainId: string, record: {
-        name: string;
-        type: DnsRecordType;
-        values: string[];
-        ttl?: number;
-    }): Promise<DnsChangeResult>;
-    delete(domainId: string, name: string, type: DnsRecordType): Promise<{
-        ok: boolean;
-        changeId: string;
-    }>;
-    preset(domainId: string, preset: DnsPreset, target?: string, subdomain?: string): Promise<DnsChangeResult>;
-}
-declare class AliasesResource {
-    private req;
-    private raw;
-    constructor(req: Req, raw: (path: string) => Promise<Response>);
-    /** Perfil de configuración de Apple Mail (plist) para el buzón de una máscara. */
-    appleProfile(domainId: string, alias: string): Promise<string>;
-    /** Exporta el buzón en formato mbox. Devuelve la respuesta en streaming: un buzón puede pesar GB. */
-    exportMbox(domainId: string, alias: string): Promise<Response>;
-    list(domainId: string): Promise<Alias[]>;
-    create(domainId: string, input: CreateAliasInput): Promise<AliasCreated>;
-    /** Crea un buzón IMAP para una máscara existente. La contraseña sólo se devuelve aquí. */
-    createMailbox(domainId: string, alias: string): Promise<MailboxCreated>;
-    /** Borra el buzón Y SU CORREO. La máscara debe conservar al menos un destino. */
-    deleteMailbox(domainId: string, alias: string): Promise<{
-        ok: boolean;
-    }>;
-    /** Genera una contraseña nueva para el buzón. Sólo se devuelve aquí; no se guarda. */
-    resetMailboxPassword(domainId: string, alias: string): Promise<{
-        password: string;
-    }>;
-    update(domainId: string, alias: string, input: UpdateAliasInput): Promise<Alias>;
-    delete(domainId: string, alias: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class RulesResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<Rule[]>;
-    create(domainId: string, input: CreateRuleInput): Promise<Rule>;
-    update(domainId: string, ruleId: string, input: UpdateRuleInput): Promise<Rule>;
-    delete(domainId: string, ruleId: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class LogsResource {
-    private req;
-    constructor(req: Req);
-    /** `limit` por omisión 50, máximo 100. */
-    list(domainId: string, opts?: {
-        limit?: number;
-    }): Promise<EmailLog[]>;
-}
-declare class SendResource {
-    private req;
-    constructor(req: Req);
-    send(domainId: string, input: SendEmailInput, opts?: SendOptions): Promise<{
-        ok: boolean;
-        messageId: string;
-        sesMessageId: string;
-    }>;
-    bulkSend(domainId: string, input: BulkSendInput): Promise<BulkJobCreated>;
-    bulkStatus(domainId: string, jobId: string): Promise<BulkJob>;
-}
-declare class AttachmentsResource {
-    private req;
-    constructor(req: Req);
-    /** Máx. 5 MB. Ejecutables bloqueados (415). La llave vale hasta que se envía. */
-    upload(domainId: string, input: UploadAttachmentInput): Promise<UploadedAttachment>;
-    /** Desde un adjunto del chat del asistente (URL firmada de `/api/asistente/files/*`). */
-    uploadFromUrl(domainId: string, url: string, filename?: string): Promise<UploadedAttachment>;
-}
-declare class SuppressionsResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<Suppression[]>;
-    add(domainId: string, email: string): Promise<Suppression>;
-    remove(domainId: string, email: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class WebhooksResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<Webhook[]>;
-    create(domainId: string, input: CreateWebhookInput): Promise<WebhookCreated>;
-    update(domainId: string, webhookId: string, input: UpdateWebhookInput): Promise<Webhook>;
-    delete(domainId: string, webhookId: string): Promise<{
-        ok: boolean;
-    }>;
-    /** Encola un `ping`; llega en el siguiente minuto. */
-    test(domainId: string, webhookId: string): Promise<{
-        ok: boolean;
-        deliveryId: string;
-    }>;
-    deliveries(domainId: string, webhookId: string): Promise<WebhookDelivery[]>;
-}
-declare class SmtpResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<SmtpCredential[]>;
-    create(domainId: string, label: string): Promise<SmtpCredentialCreated>;
-    revoke(domainId: string, credId: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class ApiKeysResource {
-    private req;
-    constructor(req: Req);
-    list(): Promise<ApiKey[]>;
-    create(name: string): Promise<ApiKey & {
-        key: string;
-    }>;
-    revoke(id: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class BillingResource {
-    private req;
-    constructor(req: Req);
-    status(): Promise<BillingStatus>;
-    addons(): Promise<AddonsResponse>;
-    /**
-     * Liga de MercadoPago para un add-on de un dominio (`domain` = activarlo, $99/mes).
-     * El usuario la abre y paga; hasta entonces no cambia nada.
-     */
-    checkout(domainId: string, kind?: "domain" | "storage50" | "sends100", opts?: {
-        payerEmail?: string;
-        period?: "monthly" | "annual";
-    }): Promise<CheckoutLink>;
-    /** Cancela la suscripción de un add-on; el cupo sigue hasta el fin del periodo pagado. */
-    cancelAddon(addonId: string): Promise<{
-        ok: boolean;
-        activeUntil: string | null;
-    }>;
-    /** Historial de cobros, cortesías y cancelaciones (más reciente primero). */
-    orders(opts?: {
-        limit?: number;
-        before?: string;
-    }): Promise<OrdersPage>;
-}
-declare class RegistrationsResource {
-    private req;
-    constructor(req: Req);
-    search(domain: string): Promise<DomainSearchResult>;
-    tlds(): Promise<TldPrice[]>;
-    /** Crea el registro pendiente y devuelve la liga de pago; el dominio se registra al pagar. */
-    register(domain: string): Promise<DomainRegistrationCreated>;
-    list(): Promise<DomainRegistration[]>;
-    /** Pide el traslado a otro registrador. El código EPP llega por correo al dueño, nunca en la respuesta. */
-    transferOut(regId: string): Promise<{
-        ok: boolean;
-        aviso: string;
-    }>;
-    /** Liga de MercadoPago para la suscripción de renovación anual. */
-    renewal(regId: string, opts?: {
-        payerEmail?: string;
-    }): Promise<RenewalLink>;
-    /** Deja de cobrar la renovación anual. El dominio sigue vigente hasta su vencimiento. */
-    cancelRenewal(regId: string): Promise<{
-        ok: boolean;
-        aviso: string;
-    }>;
-    /**
-     * Pone el candado de transferencia. Quitarlo no está en el SDK a propósito: sólo se hace
-     * desde el panel, con la sesión del dueño y confirmando por correo.
-     */
-    lock(regId: string): Promise<{
-        ok: boolean;
-        transferLock: boolean;
-        transferUnlockedUntil: null;
-    }>;
-}
-declare class TransfersResource {
-    private req;
-    constructor(req: Req);
-    /** Requisitos, precio e inventario del DNS actual. No cobra ni crea nada. */
-    check(domain: string): Promise<TransferCheck>;
-    dns(regId: string): Promise<TransferDnsInventory>;
-    /** Reemplaza el inventario completo (RRSets). Vuelve a quedar pendiente de aprobar. */
-    setDns(regId: string, records: {
-        name: string;
-        type: string;
-        ttl?: number;
-        values: string[];
-    }[]): Promise<{
-        records: unknown[];
-    }>;
-    approveDns(regId: string): Promise<{
-        ok: boolean;
-    }>;
-    resendEmail(regId: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class MembersResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<{
-        members: DomainMember[];
-        invites: DomainInvite[];
-    }>;
-    invite(domainId: string, input: {
-        email: string;
-        name: string;
-        role?: "admin" | "agent";
-    }): Promise<{
-        ok: boolean;
-        inviteUrl: string;
-    }>;
-    remove(domainId: string, memberId: string): Promise<{
-        ok: boolean;
-    }>;
-    cancelInvite(domainId: string, token: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class SignatureResource {
-    private req;
-    constructor(req: Req);
-    get(domainId: string): Promise<{
-        signature: string | null;
-    }>;
-    /** Markdown, máx. 2000 caracteres. Cadena vacía la borra. */
-    set(domainId: string, signature: string): Promise<{
-        ok: boolean;
-        signature: string | null;
-    }>;
-}
-declare class CannedResource {
-    private req;
-    constructor(req: Req);
-    list(domainId: string): Promise<CannedReply[]>;
-    create(domainId: string, input: {
-        title: string;
-        body: string;
-    }): Promise<CannedReply>;
-    delete(domainId: string, cannedId: string): Promise<{
-        ok: boolean;
-    }>;
-}
-declare class AccountResource {
-    private req;
-    constructor(req: Req);
-    /**
-     * Identidad y uso de la cuenta: dominios, derechos por dominio, add-ons y cuotas.
-     * Sustituto de `whoami` mientras no exista un endpoint de identidad más chico — ver
-     * `docs/agents/mailmask-cli.md`.
-     */
-    me(): Promise<AccountMe>;
-    /** Todo tu dato (alias, reglas y logs de cada dominio) como JSON exportable. */
-    export(): Promise<AccountExport>;
-    getProfile(): Promise<AccountProfile>;
-    /** Nombre visible (máx. 60 caracteres). Cadena vacía lo borra. */
-    updateProfile(input: {
-        displayName: string | null;
-    }): Promise<AccountProfile>;
-    /** Foto desde un adjunto que el usuario subió al asistente (URL firmada de `/api/asistente/files/*`). */
-    setAvatarFromUrl(url: string): Promise<AccountProfile & {
-        ok: boolean;
-    }>;
-    /** Foto desde bytes (PNG, JPG o WebP; máx. 2 MB). */
-    setAvatar(file: Blob, filename?: string): Promise<AccountProfile & {
-        ok: boolean;
-    }>;
-    removeAvatar(): Promise<AccountProfile & {
-        ok: boolean;
-    }>;
-}
-/**
- * La Bandeja: conversaciones del dominio. Todo pasa por los mismos permisos que la app
- * (dueño, admin o agente invitado) y los mismos topes de envío.
- */
-declare class InboxResource {
-    private req;
-    private raw;
-    constructor(req: Req, raw: (path: string) => Promise<Response>);
-    list(domainId: string, opts?: InboxListOptions): Promise<InboxPage>;
-    /** Conversación con sus mensajes (los 30 más recientes, o anteriores a `before`). Abrirla la marca leída. */
-    get(domainId: string, conversationId: string, opts?: {
-        before?: string;
-    }): Promise<InboxConversationDetail>;
-    /** Un correo nuevo desde una máscara: abre un hilo. Gasta cuota de envío (dominio activado). */
-    compose(domainId: string, input: InboxComposeInput): Promise<{
-        ok: boolean;
-        conversationId: string;
-        messageId: string;
-    }>;
-    /** Responde en el hilo desde la máscara del hilo. No gasta cuota de envío. */
-    reply(domainId: string, conversationId: string, input: InboxReplyInput): Promise<{
-        ok: boolean;
-        messageId: string;
-    }>;
-    update(domainId: string, conversationId: string, input: InboxUpdateInput): Promise<InboxConversation>;
-    markRead(domainId: string, conversationId: string): Promise<{
-        ok: boolean;
-        unreadCount: number;
-    }>;
-    /** Sin `assignedTo` la deja sin asignar. */
-    assign(domainId: string, conversationId: string, assignedTo?: string): Promise<InboxConversation>;
-    /** Nota interna: la ve el equipo, nunca el contacto. */
-    addNote(domainId: string, conversationId: string, body: string): Promise<InboxNote>;
-    /** A la papelera (se puede restaurar). Máx. 200 por llamada. */
-    delete(domainId: string, conversationIds: string[]): Promise<{
-        ok: boolean;
-        deleted: number;
-    }>;
-    restore(domainId: string, conversationId: string): Promise<{
-        ok: boolean;
-    }>;
-    metrics(domainId: string, opts?: {
-        days?: number;
-    }): Promise<Record<string, unknown>>;
-    /** Bytes de un adjunto de un mensaje (id del mensaje e índice de `attachments`). */
-    attachment(domainId: string, conversationId: string, messageId: string, index: number): Promise<Response>;
-}
-declare class ReferralsResource {
-    private req;
-    constructor(req: Req);
-    get(): Promise<ReferralStats>;
-    /** 3-30 caracteres: minúsculas, números y guiones. */
-    setSlug(slug: string): Promise<{
-        ok: boolean;
-        slug: string;
-    }>;
-    /** Nombre que ven los invitados (2-40 caracteres). */
-    setName(name: string): Promise<{
-        ok: boolean;
-    }>;
-}
-
-interface WebhookSignatureHeaders {
-    /** Header `X-MailMask-Signature`, con forma `sha256=<hex>`. */
-    signature: string;
-    /** Header `X-MailMask-Timestamp`, milisegundos Unix. */
-    timestamp: string;
-}
-/**
- * Comprueba que `rawBody` (el cuerpo tal cual llegó, sin parsear) fue firmado
- * con `secret`. Rechaza timestamps con más de `toleranceMs` de diferencia para
- * frenar repeticiones.
- */
-declare function verifyWebhookSignature(secret: string, headers: WebhookSignatureHeaders, rawBody: string, toleranceMs?: number): Promise<boolean>;
-
-export { type AccountExport, type AccountMe, type AccountMeDomainUsage, type AccountProfile, type Addon, type AddonsResponse, type Address, type AddressCreated, type Alias, type AliasCreated, type ApiKey, type AttachmentRef, type BillingStatus, type BulkJob, type BulkJobCreated, type BulkSendInput, type CannedReply, type CheckoutLink, type CreateAddressInput, type CreateAliasInput, type CreateRuleInput, type CreateWebhookInput, type DnsChangeResult, type DnsDelegation, type DnsImportResult, type DnsListResponse, type DnsPreset, type DnsRRSet, type DnsRRSetAnotado, type DnsRecord, type DnsRecordType, type DnsSetup, type DnsSetupRecord, type DnsZoneCreated, type DnsZoneState, type Domain, type DomainCreated, type DomainInvite, type DomainMember, type DomainRegistration, type DomainRegistrationCreated, type DomainSearchResult, type DomainVerification, type EmailLog, type InboxAttachment, type InboxComposeInput, type InboxConversation, type InboxConversationDetail, type InboxListOptions, type InboxMessage, type InboxNote, type InboxPage, type InboxReplyInput, type InboxStatus, type InboxUpdateInput, MailMask, type MailMaskConfig, MailMaskError, type MailboxCreated, type Order, type OrdersPage, type ReferralStats, type RenewalLink, type Rule, type RuleAction, type RuleField, type RuleMatch, type SendEmailInput, type SendOptions, type SmtpCredential, type SmtpCredentialCreated, type Suppression, type TldPrice, type TransferCheck, type TransferDnsInventory, type TransferRequirement, type UpdateAddressInput, type UpdateAliasInput, type UpdateRuleInput, type UpdateWebhookInput, type UploadAttachmentInput, type UploadedAttachment, type UploadedEmailImage, type Webhook, type WebhookCreated, type WebhookDelivery, type WebhookEvent, type WebhookPayload, type WebhookSignatureHeaders, verifyWebhookSignature };
+export { MailMask, MailMaskError } from "./client.js";
+export { verifyWebhookSignature } from "./verify.js";
+export type { WebhookSignatureHeaders } from "./verify.js";
+export * from "./types.js";