@easybits.cloud/mailmask 0.4.2 → 0.4.4

package/dist/index.cjs

@@ -75,6 +75,9 @@ var MailMask = class {
     this.members = new MembersResource(req);
     this.signature = new SignatureResource(req);
     this.canned = new CannedResource(req);
+    this.account = new AccountResource(req);
+    this.inbox = new InboxResource(req, (path) => requestRaw(this.baseUrl, this.apiKey, path, doFetch));
+    this.referrals = new ReferralsResource(req);
   }
 };
 var DomainsResource = class {
@@ -103,6 +106,19 @@ var DomainsResource = class {
   dnsSetup(id, opts) {
     return this.req(`/api/domains/${id}/dns-setup${opts?.live ? "?live=1" : ""}`);
   }
+  /** Logo de la firma (PNG, JPG o WebP; máx. 500 KB). Se ve en todo correo en markdown. */
+  setLogo(id, file, filename = "logo") {
+    const form = new FormData();
+    form.append("file", file, filename);
+    return this.req(`/api/domains/${id}/logo`, { method: "POST", body: form });
+  }
+  /** Logo desde un adjunto del chat del asistente (URL firmada de `/api/asistente/files/*`). */
+  setLogoFromUrl(id, url) {
+    return this.req(`/api/domains/${id}/logo`, { method: "POST", body: JSON.stringify({ fromUrl: url }) });
+  }
+  removeLogo(id) {
+    return this.req(`/api/domains/${id}/logo`, { method: "DELETE" });
+  }
 };
 var DnsResource = class {
   constructor(req) {
@@ -223,6 +239,10 @@ var AttachmentsResource = class {
     form.append("file", blob, input.filename);
     return this.req(`/api/domains/${domainId}/attachments`, { method: "POST", body: form });
   }
+  /** Desde un adjunto del chat del asistente (URL firmada de `/api/asistente/files/*`). */
+  uploadFromUrl(domainId, url, filename) {
+    return this.req(`/api/domains/${domainId}/attachments`, { method: "POST", body: JSON.stringify({ fromUrl: url, filename }) });
+  }
 };
 var SuppressionsResource = class {
   constructor(req) {
@@ -305,7 +325,19 @@ var BillingResource = class {
    * El usuario la abre y paga; hasta entonces no cambia nada.
    */
   checkout(domainId, kind = "domain", opts) {
-    return this.req("/api/addons/checkout", { method: "POST", body: JSON.stringify({ kind, domainId, payerEmail: opts?.payerEmail }) });
+    return this.req("/api/addons/checkout", { method: "POST", body: JSON.stringify({ kind, domainId, payerEmail: opts?.payerEmail, period: opts?.period }) });
+  }
+  /** Cancela la suscripción de un add-on; el cupo sigue hasta el fin del periodo pagado. */
+  cancelAddon(addonId) {
+    return this.req(`/api/addons/${addonId}/cancel`, { method: "POST" });
+  }
+  /** Historial de cobros, cortesías y cancelaciones (más reciente primero). */
+  orders(opts) {
+    const qs = new URLSearchParams();
+    if (opts?.limit) qs.set("limit", String(opts.limit));
+    if (opts?.before) qs.set("before", opts.before);
+    const q = qs.toString();
+    return this.req(`/api/billing/orders${q ? `?${q}` : ""}`);
   }
 };
 var RegistrationsResource = class {
@@ -333,6 +365,10 @@ var RegistrationsResource = class {
   renewal(regId, opts) {
     return this.req(`/api/domains/registrations/${regId}/renewal`, { method: "POST", body: JSON.stringify({ payerEmail: opts?.payerEmail }) });
   }
+  /** Deja de cobrar la renovación anual. El dominio sigue vigente hasta su vencimiento. */
+  cancelRenewal(regId) {
+    return this.req(`/api/domains/registrations/${regId}/renewal/cancel`, { method: "POST" });
+  }
 };
 var TransfersResource = class {
   constructor(req) {
@@ -400,6 +436,102 @@ var CannedResource = class {
     return this.req(`/api/domains/${domainId}/canned/${cannedId}`, { method: "DELETE" });
   }
 };
+var AccountResource = class {
+  constructor(req) {
+    this.req = req;
+  }
+  getProfile() {
+    return this.req("/api/profile");
+  }
+  /** Nombre visible (máx. 60 caracteres). Cadena vacía lo borra. */
+  updateProfile(input) {
+    return this.req("/api/profile", { method: "PUT", body: JSON.stringify(input) });
+  }
+  /** Foto desde un adjunto que el usuario subió al asistente (URL firmada de `/api/asistente/files/*`). */
+  setAvatarFromUrl(url) {
+    return this.req("/api/profile/avatar", { method: "POST", body: JSON.stringify({ fromUrl: url }) });
+  }
+  /** Foto desde bytes (PNG, JPG o WebP; máx. 2 MB). */
+  setAvatar(file, filename = "avatar") {
+    const form = new FormData();
+    form.append("file", file, filename);
+    return this.req("/api/profile/avatar", { method: "POST", body: form });
+  }
+  removeAvatar() {
+    return this.req("/api/profile/avatar", { method: "DELETE" });
+  }
+};
+var InboxResource = class {
+  constructor(req, raw) {
+    this.req = req;
+    this.raw = raw;
+  }
+  list(domainId, opts) {
+    const qs = new URLSearchParams({ domainId });
+    for (const [k, v] of Object.entries(opts ?? {})) if (v !== void 0 && v !== "") qs.set(k, String(v));
+    return this.req(`/api/bandeja/conversations?${qs}`);
+  }
+  /** Conversación con sus mensajes (los 30 más recientes, o anteriores a `before`). Abrirla la marca leída. */
+  get(domainId, conversationId, opts) {
+    const qs = new URLSearchParams({ domainId });
+    if (opts?.before) qs.set("before", opts.before);
+    return this.req(`/api/bandeja/conversations/${conversationId}?${qs}`);
+  }
+  /** Un correo nuevo desde una máscara: abre un hilo. Gasta cuota de envío (dominio activado). */
+  compose(domainId, input) {
+    return this.req("/api/bandeja/conversations", { method: "POST", body: JSON.stringify({ ...input, domainId }) });
+  }
+  /** Responde en el hilo desde la máscara del hilo. No gasta cuota de envío. */
+  reply(domainId, conversationId, input) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/reply`, { method: "POST", body: JSON.stringify({ ...input, domainId }) });
+  }
+  update(domainId, conversationId, input) {
+    return this.req(`/api/bandeja/conversations/${conversationId}`, { method: "PATCH", body: JSON.stringify({ ...input, domainId }) });
+  }
+  markRead(domainId, conversationId) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/read`, { method: "POST", body: JSON.stringify({ domainId }) });
+  }
+  /** Sin `assignedTo` la deja sin asignar. */
+  assign(domainId, conversationId, assignedTo) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/assign`, { method: "POST", body: JSON.stringify({ domainId, assignedTo }) });
+  }
+  /** Nota interna: la ve el equipo, nunca el contacto. */
+  addNote(domainId, conversationId, body) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/note`, { method: "POST", body: JSON.stringify({ domainId, body }) });
+  }
+  /** A la papelera (se puede restaurar). Máx. 200 por llamada. */
+  delete(domainId, conversationIds) {
+    return this.req("/api/bandeja/conversations/bulk-delete", { method: "POST", body: JSON.stringify({ domainId, ids: conversationIds }) });
+  }
+  restore(domainId, conversationId) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/restore`, { method: "POST", body: JSON.stringify({ domainId }) });
+  }
+  metrics(domainId, opts) {
+    const qs = new URLSearchParams({ domainId });
+    if (opts?.days) qs.set("days", String(opts.days));
+    return this.req(`/api/bandeja/metrics?${qs}`);
+  }
+  /** Bytes de un adjunto de un mensaje (id del mensaje e índice de `attachments`). */
+  attachment(domainId, conversationId, messageId, index) {
+    return this.raw(`/api/bandeja/conversations/${conversationId}/attachments/${messageId}/${index}?domainId=${encodeURIComponent(domainId)}`);
+  }
+};
+var ReferralsResource = class {
+  constructor(req) {
+    this.req = req;
+  }
+  get() {
+    return this.req("/api/referrals");
+  }
+  /** 3-30 caracteres: minúsculas, números y guiones. */
+  setSlug(slug) {
+    return this.req("/api/referrals/slug", { method: "PUT", body: JSON.stringify({ slug }) });
+  }
+  /** Nombre que ven los invitados (2-40 caracteres). */
+  setName(name) {
+    return this.req("/api/referrals/name", { method: "PUT", body: JSON.stringify({ name }) });
+  }
+};
 
 // src/verify.ts
 function hex(buf) {

package/dist/index.d.cts

@@ -494,6 +494,9 @@ interface DomainMember {
     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;
@@ -511,6 +514,146 @@ interface CannedReply {
     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;
+}
+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;
@@ -536,6 +679,9 @@ declare class MailMask {
     members: MembersResource;
     signature: SignatureResource;
     canned: CannedResource;
+    account: AccountResource;
+    inbox: InboxResource;
+    referrals: ReferralsResource;
     constructor(config: MailMaskConfig);
 }
 type Req = <T>(path: string, opts?: RequestInit) => Promise<T>;
@@ -554,6 +700,19 @@ declare class DomainsResource {
     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;
+    }>;
 }
 declare class DnsResource {
     private req;
@@ -634,6 +793,8 @@ declare class AttachmentsResource {
     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;
@@ -691,7 +852,18 @@ declare class BillingResource {
      */
     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;
@@ -710,6 +882,11 @@ declare class RegistrationsResource {
     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;
+    }>;
 }
 declare class TransfersResource {
     private req;
@@ -779,6 +956,87 @@ declare class CannedResource {
         ok: boolean;
     }>;
 }
+declare class AccountResource {
+    private req;
+    constructor(req: Req);
+    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>`. */
@@ -793,4 +1051,4 @@ interface WebhookSignatureHeaders {
  */
 declare function verifyWebhookSignature(secret: string, headers: WebhookSignatureHeaders, rawBody: string, toleranceMs?: number): Promise<boolean>;
 
-export { type Addon, type AddonsResponse, type Alias, type AliasCreated, type ApiKey, type AttachmentRef, type BillingStatus, type BulkJob, type BulkJobCreated, type BulkSendInput, type CannedReply, type CheckoutLink, 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, MailMask, type MailMaskConfig, MailMaskError, type MailboxCreated, 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 UpdateAliasInput, type UpdateRuleInput, type UpdateWebhookInput, type UploadAttachmentInput, type UploadedAttachment, type Webhook, type WebhookCreated, type WebhookDelivery, type WebhookEvent, type WebhookPayload, type WebhookSignatureHeaders, verifyWebhookSignature };
+export { type AccountProfile, type Addon, type AddonsResponse, type Alias, type AliasCreated, type ApiKey, type AttachmentRef, type BillingStatus, type BulkJob, type BulkJobCreated, type BulkSendInput, type CannedReply, type CheckoutLink, 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 UpdateAliasInput, type UpdateRuleInput, type UpdateWebhookInput, type UploadAttachmentInput, type UploadedAttachment, type Webhook, type WebhookCreated, type WebhookDelivery, type WebhookEvent, type WebhookPayload, type WebhookSignatureHeaders, verifyWebhookSignature };

package/dist/index.d.ts

@@ -494,6 +494,9 @@ interface DomainMember {
     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;
@@ -511,6 +514,146 @@ interface CannedReply {
     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;
+}
+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;
@@ -536,6 +679,9 @@ declare class MailMask {
     members: MembersResource;
     signature: SignatureResource;
     canned: CannedResource;
+    account: AccountResource;
+    inbox: InboxResource;
+    referrals: ReferralsResource;
     constructor(config: MailMaskConfig);
 }
 type Req = <T>(path: string, opts?: RequestInit) => Promise<T>;
@@ -554,6 +700,19 @@ declare class DomainsResource {
     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;
+    }>;
 }
 declare class DnsResource {
     private req;
@@ -634,6 +793,8 @@ declare class AttachmentsResource {
     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;
@@ -691,7 +852,18 @@ declare class BillingResource {
      */
     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;
@@ -710,6 +882,11 @@ declare class RegistrationsResource {
     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;
+    }>;
 }
 declare class TransfersResource {
     private req;
@@ -779,6 +956,87 @@ declare class CannedResource {
         ok: boolean;
     }>;
 }
+declare class AccountResource {
+    private req;
+    constructor(req: Req);
+    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>`. */
@@ -793,4 +1051,4 @@ interface WebhookSignatureHeaders {
  */
 declare function verifyWebhookSignature(secret: string, headers: WebhookSignatureHeaders, rawBody: string, toleranceMs?: number): Promise<boolean>;
 
-export { type Addon, type AddonsResponse, type Alias, type AliasCreated, type ApiKey, type AttachmentRef, type BillingStatus, type BulkJob, type BulkJobCreated, type BulkSendInput, type CannedReply, type CheckoutLink, 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, MailMask, type MailMaskConfig, MailMaskError, type MailboxCreated, 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 UpdateAliasInput, type UpdateRuleInput, type UpdateWebhookInput, type UploadAttachmentInput, type UploadedAttachment, type Webhook, type WebhookCreated, type WebhookDelivery, type WebhookEvent, type WebhookPayload, type WebhookSignatureHeaders, verifyWebhookSignature };
+export { type AccountProfile, type Addon, type AddonsResponse, type Alias, type AliasCreated, type ApiKey, type AttachmentRef, type BillingStatus, type BulkJob, type BulkJobCreated, type BulkSendInput, type CannedReply, type CheckoutLink, 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 UpdateAliasInput, type UpdateRuleInput, type UpdateWebhookInput, type UploadAttachmentInput, type UploadedAttachment, type Webhook, type WebhookCreated, type WebhookDelivery, type WebhookEvent, type WebhookPayload, type WebhookSignatureHeaders, verifyWebhookSignature };

package/dist/index.js

@@ -47,6 +47,9 @@ var MailMask = class {
     this.members = new MembersResource(req);
     this.signature = new SignatureResource(req);
     this.canned = new CannedResource(req);
+    this.account = new AccountResource(req);
+    this.inbox = new InboxResource(req, (path) => requestRaw(this.baseUrl, this.apiKey, path, doFetch));
+    this.referrals = new ReferralsResource(req);
   }
 };
 var DomainsResource = class {
@@ -75,6 +78,19 @@ var DomainsResource = class {
   dnsSetup(id, opts) {
     return this.req(`/api/domains/${id}/dns-setup${opts?.live ? "?live=1" : ""}`);
   }
+  /** Logo de la firma (PNG, JPG o WebP; máx. 500 KB). Se ve en todo correo en markdown. */
+  setLogo(id, file, filename = "logo") {
+    const form = new FormData();
+    form.append("file", file, filename);
+    return this.req(`/api/domains/${id}/logo`, { method: "POST", body: form });
+  }
+  /** Logo desde un adjunto del chat del asistente (URL firmada de `/api/asistente/files/*`). */
+  setLogoFromUrl(id, url) {
+    return this.req(`/api/domains/${id}/logo`, { method: "POST", body: JSON.stringify({ fromUrl: url }) });
+  }
+  removeLogo(id) {
+    return this.req(`/api/domains/${id}/logo`, { method: "DELETE" });
+  }
 };
 var DnsResource = class {
   constructor(req) {
@@ -195,6 +211,10 @@ var AttachmentsResource = class {
     form.append("file", blob, input.filename);
     return this.req(`/api/domains/${domainId}/attachments`, { method: "POST", body: form });
   }
+  /** Desde un adjunto del chat del asistente (URL firmada de `/api/asistente/files/*`). */
+  uploadFromUrl(domainId, url, filename) {
+    return this.req(`/api/domains/${domainId}/attachments`, { method: "POST", body: JSON.stringify({ fromUrl: url, filename }) });
+  }
 };
 var SuppressionsResource = class {
   constructor(req) {
@@ -277,7 +297,19 @@ var BillingResource = class {
    * El usuario la abre y paga; hasta entonces no cambia nada.
    */
   checkout(domainId, kind = "domain", opts) {
-    return this.req("/api/addons/checkout", { method: "POST", body: JSON.stringify({ kind, domainId, payerEmail: opts?.payerEmail }) });
+    return this.req("/api/addons/checkout", { method: "POST", body: JSON.stringify({ kind, domainId, payerEmail: opts?.payerEmail, period: opts?.period }) });
+  }
+  /** Cancela la suscripción de un add-on; el cupo sigue hasta el fin del periodo pagado. */
+  cancelAddon(addonId) {
+    return this.req(`/api/addons/${addonId}/cancel`, { method: "POST" });
+  }
+  /** Historial de cobros, cortesías y cancelaciones (más reciente primero). */
+  orders(opts) {
+    const qs = new URLSearchParams();
+    if (opts?.limit) qs.set("limit", String(opts.limit));
+    if (opts?.before) qs.set("before", opts.before);
+    const q = qs.toString();
+    return this.req(`/api/billing/orders${q ? `?${q}` : ""}`);
   }
 };
 var RegistrationsResource = class {
@@ -305,6 +337,10 @@ var RegistrationsResource = class {
   renewal(regId, opts) {
     return this.req(`/api/domains/registrations/${regId}/renewal`, { method: "POST", body: JSON.stringify({ payerEmail: opts?.payerEmail }) });
   }
+  /** Deja de cobrar la renovación anual. El dominio sigue vigente hasta su vencimiento. */
+  cancelRenewal(regId) {
+    return this.req(`/api/domains/registrations/${regId}/renewal/cancel`, { method: "POST" });
+  }
 };
 var TransfersResource = class {
   constructor(req) {
@@ -372,6 +408,102 @@ var CannedResource = class {
     return this.req(`/api/domains/${domainId}/canned/${cannedId}`, { method: "DELETE" });
   }
 };
+var AccountResource = class {
+  constructor(req) {
+    this.req = req;
+  }
+  getProfile() {
+    return this.req("/api/profile");
+  }
+  /** Nombre visible (máx. 60 caracteres). Cadena vacía lo borra. */
+  updateProfile(input) {
+    return this.req("/api/profile", { method: "PUT", body: JSON.stringify(input) });
+  }
+  /** Foto desde un adjunto que el usuario subió al asistente (URL firmada de `/api/asistente/files/*`). */
+  setAvatarFromUrl(url) {
+    return this.req("/api/profile/avatar", { method: "POST", body: JSON.stringify({ fromUrl: url }) });
+  }
+  /** Foto desde bytes (PNG, JPG o WebP; máx. 2 MB). */
+  setAvatar(file, filename = "avatar") {
+    const form = new FormData();
+    form.append("file", file, filename);
+    return this.req("/api/profile/avatar", { method: "POST", body: form });
+  }
+  removeAvatar() {
+    return this.req("/api/profile/avatar", { method: "DELETE" });
+  }
+};
+var InboxResource = class {
+  constructor(req, raw) {
+    this.req = req;
+    this.raw = raw;
+  }
+  list(domainId, opts) {
+    const qs = new URLSearchParams({ domainId });
+    for (const [k, v] of Object.entries(opts ?? {})) if (v !== void 0 && v !== "") qs.set(k, String(v));
+    return this.req(`/api/bandeja/conversations?${qs}`);
+  }
+  /** Conversación con sus mensajes (los 30 más recientes, o anteriores a `before`). Abrirla la marca leída. */
+  get(domainId, conversationId, opts) {
+    const qs = new URLSearchParams({ domainId });
+    if (opts?.before) qs.set("before", opts.before);
+    return this.req(`/api/bandeja/conversations/${conversationId}?${qs}`);
+  }
+  /** Un correo nuevo desde una máscara: abre un hilo. Gasta cuota de envío (dominio activado). */
+  compose(domainId, input) {
+    return this.req("/api/bandeja/conversations", { method: "POST", body: JSON.stringify({ ...input, domainId }) });
+  }
+  /** Responde en el hilo desde la máscara del hilo. No gasta cuota de envío. */
+  reply(domainId, conversationId, input) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/reply`, { method: "POST", body: JSON.stringify({ ...input, domainId }) });
+  }
+  update(domainId, conversationId, input) {
+    return this.req(`/api/bandeja/conversations/${conversationId}`, { method: "PATCH", body: JSON.stringify({ ...input, domainId }) });
+  }
+  markRead(domainId, conversationId) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/read`, { method: "POST", body: JSON.stringify({ domainId }) });
+  }
+  /** Sin `assignedTo` la deja sin asignar. */
+  assign(domainId, conversationId, assignedTo) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/assign`, { method: "POST", body: JSON.stringify({ domainId, assignedTo }) });
+  }
+  /** Nota interna: la ve el equipo, nunca el contacto. */
+  addNote(domainId, conversationId, body) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/note`, { method: "POST", body: JSON.stringify({ domainId, body }) });
+  }
+  /** A la papelera (se puede restaurar). Máx. 200 por llamada. */
+  delete(domainId, conversationIds) {
+    return this.req("/api/bandeja/conversations/bulk-delete", { method: "POST", body: JSON.stringify({ domainId, ids: conversationIds }) });
+  }
+  restore(domainId, conversationId) {
+    return this.req(`/api/bandeja/conversations/${conversationId}/restore`, { method: "POST", body: JSON.stringify({ domainId }) });
+  }
+  metrics(domainId, opts) {
+    const qs = new URLSearchParams({ domainId });
+    if (opts?.days) qs.set("days", String(opts.days));
+    return this.req(`/api/bandeja/metrics?${qs}`);
+  }
+  /** Bytes de un adjunto de un mensaje (id del mensaje e índice de `attachments`). */
+  attachment(domainId, conversationId, messageId, index) {
+    return this.raw(`/api/bandeja/conversations/${conversationId}/attachments/${messageId}/${index}?domainId=${encodeURIComponent(domainId)}`);
+  }
+};
+var ReferralsResource = class {
+  constructor(req) {
+    this.req = req;
+  }
+  get() {
+    return this.req("/api/referrals");
+  }
+  /** 3-30 caracteres: minúsculas, números y guiones. */
+  setSlug(slug) {
+    return this.req("/api/referrals/slug", { method: "PUT", body: JSON.stringify({ slug }) });
+  }
+  /** Nombre que ven los invitados (2-40 caracteres). */
+  setName(name) {
+    return this.req("/api/referrals/name", { method: "PUT", body: JSON.stringify({ name }) });
+  }
+};
 
 // src/verify.ts
 function hex(buf) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easybits.cloud/mailmask",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Official SDK for the MailMask email alias/forwarding API",
   "type": "module",
   "main": "./dist/index.cjs",