@easybits.cloud/mailmask 0.4.10 → 0.4.12

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { MailMaskConfig, Domain, DomainCreated, DomainVerification, Alias, AliasCreated, MailboxCreated, CreateAliasInput, UpdateAliasInput, Rule, CreateRuleInput, UpdateRuleInput, EmailLog, SendEmailInput, BulkSendInput, BulkJob, BulkJobCreated, SmtpCredential, SmtpCredentialCreated, ApiKey, SendOptions, UploadAttachmentInput, UploadedAttachment, Suppression, Webhook, WebhookCreated, CreateWebhookInput, UpdateWebhookInput, WebhookDelivery, DnsRecordType, DnsListResponse, DnsZoneCreated, DnsDelegation, DnsImportResult, DnsChangeResult, DnsPreset, DnsPresetPreview, DnsSetup, WebsiteStatus, PublishEasyBitsSiteInput, EasyBitsPublishResult, EasyBitsSiteStatus, EasyBitsUnpublishResult, BillingStatus, AddonsResponse, CheckoutLink, DomainSearchResult, TldPrice, DomainRegistrationCreated, DomainRegistration, TransferCheck, TransferDnsInventory, RenewalLink, DomainMember, DomainInvite, CannedReply, AccountProfile, AccountMe, AccountExport, InboxPage, InboxListOptions, InboxConversation, InboxConversationDetail, InboxComposeInput, InboxReplyInput, InboxUpdateInput, InboxNote, OrdersPage, ReferralStats, UploadedEmailImage } from "./types.js";
+import type { MailMaskConfig, Domain, DomainCreated, DomainVerification, Alias, AliasCreated, MailboxCreated, CreateAliasInput, UpdateAliasInput, Rule, CreateRuleInput, UpdateRuleInput, EmailLog, SendEmailInput, BulkSendInput, BulkJob, BulkJobCreated, SmtpCredential, SmtpCredentialCreated, ApiKey, SendOptions, UploadAttachmentInput, UploadedAttachment, Suppression, Webhook, WebhookCreated, CreateWebhookInput, UpdateWebhookInput, WebhookDelivery, DnsRecordType, DnsListResponse, DnsZoneCreated, DnsDelegation, DnsImportResult, DnsAudit, DnsLookup, DnsLookupType, HttpsCheck, RegistrationInfo, DnsChangeResult, DnsPreset, DnsPresetPreview, DnsSetup, WebsiteStatus, PublishEasyBitsSiteInput, EasyBitsPublishResult, EasyBitsSiteStatus, EasyBitsUnpublishResult, BillingStatus, AddonsResponse, CheckoutLink, DomainSearchResult, TldPrice, DomainRegistrationCreated, DomainRegistration, TransferCheck, TransferDnsInventory, RenewalLink, DomainMember, DomainInvite, CannedReply, AccountProfile, AccountMe, AccountExport, InboxPage, InboxListOptions, InboxConversation, InboxConversationDetail, InboxComposeInput, InboxReplyInput, InboxUpdateInput, InboxNote, OrdersPage, ReferralStats, UploadedEmailImage } from "./types.js";
 declare class MailMaskError extends Error {
     status: number;
     constructor(status: number, message: string);
@@ -42,6 +42,10 @@ declare class DomainsResource {
         ok: boolean;
     }>;
     health(id: string): Promise<Record<string, unknown>>;
+    /** Certificado, vencimiento y redirecciones de la web del dominio o un subdominio ('@', 'www'). */
+    httpsCheck(id: string, host?: string): Promise<HttpsCheck>;
+    /** Datos públicos del registro (RDAP): registrador, vencimiento, candados y nameservers. */
+    registrationInfo(id: string): Promise<RegistrationInfo>;
     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?: {
@@ -80,6 +84,10 @@ declare class DnsResource {
     createZone(domainId: string): Promise<DnsZoneCreated>;
     delegation(domainId: string): Promise<DnsDelegation>;
     import(domainId: string): Promise<DnsImportResult>;
+    /** Mide qué registros siguen vivos y los clasifica para podar (sólo lectura). */
+    audit(domainId: string): Promise<DnsAudit>;
+    /** Lo que contestan los resolvers públicos y los nameservers del dominio para un nombre (propagación). */
+    lookup(domainId: string, name: string, type?: DnsLookupType): Promise<DnsLookup>;
     /** Reemplaza el conjunto: `values` sustituye por completo lo que hubiera en ese nombre y tipo. */
     upsert(domainId: string, record: {
         name: string;

package/dist/index.cjs

@@ -100,6 +100,14 @@ var DomainsResource = class {
   health(id) {
     return this.req(`/api/domains/${id}/health`);
   }
+  /** Certificado, vencimiento y redirecciones de la web del dominio o un subdominio ('@', 'www'). */
+  httpsCheck(id, host = "@") {
+    return this.req(`/api/domains/${id}/https-check?host=${encodeURIComponent(host)}`);
+  }
+  /** Datos públicos del registro (RDAP): registrador, vencimiento, candados y nameservers. */
+  registrationInfo(id) {
+    return this.req(`/api/domains/${id}/registration-info`);
+  }
   verify(id) {
     return this.req(`/api/domains/${id}/verify`, { method: "POST" });
   }
@@ -159,6 +167,14 @@ var DnsResource = class {
   import(domainId) {
     return this.req(`/api/domains/${domainId}/dns/import`, { method: "POST" });
   }
+  /** Mide qué registros siguen vivos y los clasifica para podar (sólo lectura). */
+  audit(domainId) {
+    return this.req(`/api/domains/${domainId}/dns/audit`);
+  }
+  /** Lo que contestan los resolvers públicos y los nameservers del dominio para un nombre (propagación). */
+  lookup(domainId, name, type = "A") {
+    return this.req(`/api/domains/${domainId}/dns/lookup?name=${encodeURIComponent(name)}&type=${type}`);
+  }
   /** Reemplaza el conjunto: `values` sustituye por completo lo que hubiera en ese nombre y tipo. */
   upsert(domainId, record) {
     return this.req(`/api/domains/${domainId}/dns/records`, { method: "PUT", body: JSON.stringify(record) });

package/dist/index.js

@@ -72,6 +72,14 @@ var DomainsResource = class {
   health(id) {
     return this.req(`/api/domains/${id}/health`);
   }
+  /** Certificado, vencimiento y redirecciones de la web del dominio o un subdominio ('@', 'www'). */
+  httpsCheck(id, host = "@") {
+    return this.req(`/api/domains/${id}/https-check?host=${encodeURIComponent(host)}`);
+  }
+  /** Datos públicos del registro (RDAP): registrador, vencimiento, candados y nameservers. */
+  registrationInfo(id) {
+    return this.req(`/api/domains/${id}/registration-info`);
+  }
   verify(id) {
     return this.req(`/api/domains/${id}/verify`, { method: "POST" });
   }
@@ -131,6 +139,14 @@ var DnsResource = class {
   import(domainId) {
     return this.req(`/api/domains/${domainId}/dns/import`, { method: "POST" });
   }
+  /** Mide qué registros siguen vivos y los clasifica para podar (sólo lectura). */
+  audit(domainId) {
+    return this.req(`/api/domains/${domainId}/dns/audit`);
+  }
+  /** Lo que contestan los resolvers públicos y los nameservers del dominio para un nombre (propagación). */
+  lookup(domainId, name, type = "A") {
+    return this.req(`/api/domains/${domainId}/dns/lookup?name=${encodeURIComponent(name)}&type=${type}`);
+  }
   /** Reemplaza el conjunto: `values` sustituye por completo lo que hubiera en ese nombre y tipo. */
   upsert(domainId, record) {
     return this.req(`/api/domains/${domainId}/dns/records`, { method: "PUT", body: JSON.stringify(record) });

package/dist/types.d.ts

@@ -350,6 +350,71 @@ export interface DnsListResponse {
     /** Presente cuando todavía no hay zona: dice qué hacer. */
     hint?: string;
 }
+export type DnsAuditVerdict = "takeover_risk" | "duplicated_name" | "not_responding" | "previous_provider" | "cert_validation" | "in_use" | "keep";
+export interface DnsAuditFinding {
+    name: string;
+    type: string;
+    values: string[];
+    verdict: DnsAuditVerdict;
+    /** Lo que se midió, en español. */
+    evidence: string;
+    /** Qué conviene hacer, en español. */
+    action: string;
+}
+/** Respuesta de `dns.audit`: hallazgos ordenados, los urgentes primero. */
+export interface DnsAudit {
+    domain: string;
+    checkedAt: string;
+    summary: Partial<Record<DnsAuditVerdict, number>>;
+    findings: DnsAuditFinding[];
+    truncated: boolean;
+    note: string;
+}
+export type DnsLookupType = "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS" | "CAA";
+/** Respuesta de `dns.lookup`. */
+export interface DnsLookup {
+    name: string;
+    type: DnsLookupType;
+    answers: {
+        server: string;
+        values: string[] | null;
+        error?: string;
+    }[];
+    propagated: boolean;
+    /** null si la zona no es de MailMask. */
+    matchesZone: boolean | null;
+    summary: string;
+}
+/** Respuesta de `domains.httpsCheck`. */
+export interface HttpsCheck {
+    host: string;
+    ip: string | null;
+    certificate: {
+        issuer: string;
+        validTo: string;
+        daysLeft: number;
+        coversHost: boolean;
+    } | null;
+    redirects: {
+        url: string;
+        status: number;
+    }[];
+    finalStatus: number | null;
+    ok: boolean;
+    summary: string;
+}
+/** Respuesta de `domains.registrationInfo`. */
+export interface RegistrationInfo {
+    domain: string;
+    registrar: string | null;
+    createdAt: string | null;
+    expiresAt: string | null;
+    statuses: string[];
+    nameservers: string[];
+    daysToExpire: number | null;
+    transferLocked: boolean | null;
+    summary: string;
+}
 export interface DnsZoneCreated {
     hostedZoneId: string;
     nameservers: string[];

package/package.json

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