@easybits.cloud/mailmask 0.4.2 → 0.4.3

package/dist/index.cjs

@@ -75,6 +75,7 @@ var MailMask = class {
     this.members = new MembersResource(req);
     this.signature = new SignatureResource(req);
     this.canned = new CannedResource(req);
+    this.account = new AccountResource(req);
   }
 };
 var DomainsResource = class {
@@ -400,6 +401,31 @@ 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" });
+  }
+};
 
 // 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,13 @@ 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;
+}
 
 declare class MailMaskError extends Error {
     status: number;
@@ -536,6 +546,7 @@ declare class MailMask {
     members: MembersResource;
     signature: SignatureResource;
     canned: CannedResource;
+    account: AccountResource;
     constructor(config: MailMaskConfig);
 }
 type Req = <T>(path: string, opts?: RequestInit) => Promise<T>;
@@ -779,6 +790,26 @@ 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;
+    }>;
+}
 
 interface WebhookSignatureHeaders {
     /** Header `X-MailMask-Signature`, con forma `sha256=<hex>`. */
@@ -793,4 +824,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, 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 };

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,13 @@ 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;
+}
 
 declare class MailMaskError extends Error {
     status: number;
@@ -536,6 +546,7 @@ declare class MailMask {
     members: MembersResource;
     signature: SignatureResource;
     canned: CannedResource;
+    account: AccountResource;
     constructor(config: MailMaskConfig);
 }
 type Req = <T>(path: string, opts?: RequestInit) => Promise<T>;
@@ -779,6 +790,26 @@ 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;
+    }>;
+}
 
 interface WebhookSignatureHeaders {
     /** Header `X-MailMask-Signature`, con forma `sha256=<hex>`. */
@@ -793,4 +824,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, 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 };

package/dist/index.js

@@ -47,6 +47,7 @@ var MailMask = class {
     this.members = new MembersResource(req);
     this.signature = new SignatureResource(req);
     this.canned = new CannedResource(req);
+    this.account = new AccountResource(req);
   }
 };
 var DomainsResource = class {
@@ -372,6 +373,31 @@ 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" });
+  }
+};
 
 // src/verify.ts
 function hex(buf) {

package/package.json

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