@easybits.cloud/mailmask 0.7.0 → 0.9.0

package/dist/index.cjs

@@ -20,11 +20,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AUTO_TOPUP_SUGGESTIONS: () => AUTO_TOPUP_SUGGESTIONS,
   AuthError: () => AuthError,
   BALANCE_LOW_FRACTION: () => BALANCE_LOW_FRACTION,
   BALANCE_MOVEMENT_KINDS: () => BALANCE_MOVEMENT_KINDS,
   ConflictError: () => ConflictError,
   DOMAIN_CLAIM_TTL_DAYS: () => DOMAIN_CLAIM_TTL_DAYS,
+  DailyLimitError: () => DailyLimitError,
   EXTERNAL_ID_RE: () => EXTERNAL_ID_RE,
   FALLBACK_LABEL_RE: () => FALLBACK_LABEL_RE,
   ForbiddenError: () => ForbiddenError,
@@ -43,8 +45,10 @@ __export(index_exports, {
   NotFoundError: () => NotFoundError,
   PARTNER_ADMIN_ROUTES: () => PARTNER_ADMIN_ROUTES,
   PARTNER_API_PREFIX: () => PARTNER_API_PREFIX,
+  PARTNER_CURRENCIES: () => PARTNER_CURRENCIES,
   PARTNER_ERROR_STATUS: () => PARTNER_ERROR_STATUS,
   PARTNER_HEADERS: () => PARTNER_HEADERS,
+  PARTNER_PRICES: () => PARTNER_PRICES,
   PARTNER_PRICE_PER_EMAIL_CENTS: () => PARTNER_PRICE_PER_EMAIL_CENTS,
   PARTNER_ROUTES: () => PARTNER_ROUTES,
   PARTNER_SIGNATURE_TOLERANCE_S: () => PARTNER_SIGNATURE_TOLERANCE_S,
@@ -52,6 +56,7 @@ __export(index_exports, {
   PARTNER_TOPUP_MAX_CENTS: () => PARTNER_TOPUP_MAX_CENTS,
   PARTNER_TOPUP_MIN_CENTS: () => PARTNER_TOPUP_MIN_CENTS,
   PARTNER_WEBHOOK_EVENTS: () => PARTNER_WEBHOOK_EVENTS,
+  PARTNER_WELCOME_CENTS: () => PARTNER_WELCOME_CENTS,
   PartnerApiError: () => PartnerApiError,
   PausedError: () => PausedError,
   QuotaError: () => QuotaError,
@@ -62,12 +67,17 @@ __export(index_exports, {
   STRICT_FIRST_DAYS: () => STRICT_FIRST_DAYS,
   TAG_RE: () => TAG_RE,
   TEMPLATE_VAR_NAME_RE: () => TEMPLATE_VAR_NAME_RE,
+  TENANT_DAILY_LIMIT_MAX: () => TENANT_DAILY_LIMIT_MAX,
+  TENANT_DAILY_LIMIT_START: () => TENANT_DAILY_LIMIT_START,
+  TENANT_WARMUP_STEP_DAYS: () => TENANT_WARMUP_STEP_DAYS,
   TimeoutError: () => TimeoutError,
   UNSUBSCRIBE_URL_VAR: () => UNSUBSCRIBE_URL_VAR,
   ValidationError: () => ValidationError,
   WEBHOOK_HEADERS: () => WEBHOOK_HEADERS,
   WEBHOOK_TOLERANCE_MS: () => WEBHOOK_TOLERANCE_MS,
   createWebhookHandler: () => createWebhookHandler,
+  estimateSendDays: () => estimateSendDays,
+  formatMoney: () => formatMoney,
   isValidExternalId: () => isValidExternalId,
   isValidFallbackLabel: () => isValidFallbackLabel,
   partnerSignatureBase: () => partnerSignatureBase,
@@ -80,6 +90,7 @@ __export(index_exports, {
   templateVarsProblem: () => templateVarsProblem,
   verifyWebhook: () => verifyWebhook,
   verifyWebhookSignature: () => verifyWebhookSignature,
+  warmupLimit: () => warmupLimit,
   webhookSignatureBase: () => webhookSignatureBase
 });
 module.exports = __toCommonJS(index_exports);
@@ -724,11 +735,16 @@ var PARTNER_ERROR_STATUS = {
   /** El tenant está en pausa (por MailMask o por el partner). No se manda nada hasta `resume`. */
   tenant_paused: 423,
   /**
-   * Saldo prepagado insuficiente (con `balanceCents` y `requiredCents`). Sólo cuando MailMask
-   * activó el cobro por adelantado del partner. No se reintenta: recarga con `POST /topup`.
+   * Saldo prepagado insuficiente (con `balanceCents` y `requiredCents`). No se reintenta: recarga
+   * con `POST /topup`.
    */
   insufficient_balance: 402,
-  /** Cuota mensual del tenant agotada. */
+  /**
+   * El tenant llegó a su límite del día (con `limit`, `sentToday` y `resetsAt`, la medianoche UTC).
+   * Sólo en envíos sueltos: un lote no falla, espera al día siguiente (`batch.throttled`).
+   */
+  daily_limit: 429,
+  /** Ya no sale desde la 0.8 (no hay tope mensual); se deja para clientes viejos. */
   quota_exceeded: 429,
   /** Demasiadas peticiones; reintenta tras `Retry-After`. */
   rate_limited: 429,
@@ -742,6 +758,30 @@ function isValidExternalId(id) {
 var MAX_BATCH_RECIPIENTS = 1e4;
 var MAX_TAGS = 10;
 var TAG_RE = /^[A-Za-z0-9_-]{1,64}$/;
+var TENANT_DAILY_LIMIT_START = 2e3;
+var TENANT_DAILY_LIMIT_MAX = 2e4;
+var TENANT_WARMUP_STEP_DAYS = 7;
+function warmupLimit(step) {
+  return Math.min(TENANT_DAILY_LIMIT_MAX, TENANT_DAILY_LIMIT_START * 2 ** Math.max(0, step));
+}
+function estimateSendDays(s, recipients) {
+  let left = recipients - Math.max(0, s.dailyLimit - s.sentToday);
+  if (left <= 0) return 1;
+  let days = 1;
+  let limit = s.dailyLimit;
+  let nextAt = s.nextStepAt ? Date.parse(s.nextStepAt) : null;
+  let day = Date.parse(s.resetsAt);
+  while (left > 0 && days < 3650) {
+    while (nextAt !== null && nextAt <= day && limit < TENANT_DAILY_LIMIT_MAX && !s.fixed) {
+      limit = Math.min(TENANT_DAILY_LIMIT_MAX, limit * 2);
+      nextAt += TENANT_WARMUP_STEP_DAYS * 864e5;
+    }
+    left -= limit;
+    days++;
+    day += 864e5;
+  }
+  return days;
+}
 var DOMAIN_CLAIM_TTL_DAYS = 7;
 var FALLBACK_LABEL_RE = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
 var RESERVED_FALLBACK_LABELS = [
@@ -807,12 +847,25 @@ function personalizePartnerMessage(input) {
     ...text !== void 0 ? { text: renderTemplate(text, vars) } : {}
   };
 }
-var PARTNER_PRICE_PER_EMAIL_CENTS = 6;
-var PARTNER_TENANT_MONTH_CENTS = 4900;
-var PARTNER_TOPUP_MIN_CENTS = 5e4;
-var PARTNER_TOPUP_MAX_CENTS = 1e7;
+var PARTNER_CURRENCIES = ["MXN", "USD"];
+var PARTNER_PRICES = {
+  MXN: { perEmailCents: 6, tenantMonthCents: 4900, welcomeCents: 5e4, topupMinCents: 5e4, topupMaxCents: 1e7 },
+  USD: { perEmailCents: 0.35, tenantMonthCents: 290, welcomeCents: 2900, topupMinCents: 2900, topupMaxCents: 55e4 }
+};
+var PARTNER_PRICE_PER_EMAIL_CENTS = PARTNER_PRICES.MXN.perEmailCents;
+var PARTNER_TENANT_MONTH_CENTS = PARTNER_PRICES.MXN.tenantMonthCents;
+var PARTNER_WELCOME_CENTS = PARTNER_PRICES.MXN.welcomeCents;
+var PARTNER_TOPUP_MIN_CENTS = PARTNER_PRICES.MXN.topupMinCents;
+var PARTNER_TOPUP_MAX_CENTS = PARTNER_PRICES.MXN.topupMaxCents;
+function formatMoney(cents, currency) {
+  const v = Math.abs(cents) / 100;
+  const decimals = v !== 0 && v < 0.01 ? 4 : 2;
+  const n = v.toLocaleString("en-US", { minimumFractionDigits: decimals, maximumFractionDigits: decimals });
+  return `${cents < 0 ? "\u2212" : ""}$${n} ${currency}`;
+}
 var BALANCE_LOW_FRACTION = 0.2;
 var BALANCE_MOVEMENT_KINDS = ["topup", "send", "tenant_fee", "refund", "adjust"];
+var AUTO_TOPUP_SUGGESTIONS = { MXN: [500, 1e3, 2500], USD: [29, 59, 149] };
 var PARTNER_WEBHOOK_EVENTS = [
   "email.sent",
   "email.delivered",
@@ -823,7 +876,8 @@ var PARTNER_WEBHOOK_EVENTS = [
   "tenant.paused",
   "tenant.resumed",
   "domain.verified",
-  "balance.low"
+  "balance.low",
+  "batch.throttled"
 ];
 var WEBHOOK_HEADERS = {
   event: "X-MailMask-Event",
@@ -858,6 +912,8 @@ var PARTNER_ROUTES = {
   balance: { method: "GET", path: "/balance" },
   balanceMovements: { method: "GET", path: "/balance/movements" },
   topup: { method: "POST", path: "/topup" },
+  getAutoTopup: { method: "GET", path: "/auto-topup" },
+  setAutoTopup: { method: "PUT", path: "/auto-topup" },
   getWebhook: { method: "GET", path: "/webhook" },
   setWebhook: { method: "PUT", path: "/webhook" },
   testWebhook: { method: "POST", path: "/webhook/test" },
@@ -877,10 +933,14 @@ var PARTNER_ADMIN_ROUTES = {
   getBalance: { method: "GET", path: "/api/partners/:partnerId/balance" },
   /** Sólo MailMask (admin): abono o cargo manual (`adjust`). */
   adjustBalance: { method: "POST", path: "/api/partners/:partnerId/balance/adjust" },
-  /** Sólo MailMask (admin): prende o apaga el cobro por adelantado. */
-  setPrepaidEnforced: { method: "PUT", path: "/api/partners/:partnerId/prepaid" },
   /** Recarga con MercadoPago desde la sesión del dueño (misma respuesta que `POST /topup`). */
   topup: { method: "POST", path: "/api/partners/:partnerId/topup" },
+  getAutoTopup: { method: "GET", path: "/api/partners/:partnerId/auto-topup" },
+  setAutoTopup: { method: "PUT", path: "/api/partners/:partnerId/auto-topup" },
+  /** Sólo MailMask: moneda del saldo, mientras no haya más movimientos que la bienvenida. */
+  setCurrency: { method: "PUT", path: "/api/partners/:partnerId/currency" },
+  /** Sólo MailMask: fija (o quita, con `null`) el límite diario de un tenant. Devuelve el `Tenant`. */
+  setTenantDailyLimit: { method: "PUT", path: "/api/partners/:partnerId/tenants/:externalId/daily-limit" },
   listCredentials: { method: "GET", path: "/api/partners/:partnerId/credentials" },
   createCredential: { method: "POST", path: "/api/partners/:partnerId/credentials" },
   rotateCredential: { method: "POST", path: "/api/partners/:partnerId/credentials/:keyId/rotate" },
@@ -894,8 +954,8 @@ var PartnerApiError = class extends MailMaskError {
       code: body.code,
       requestId: meta.requestId,
       cause: meta.cause,
-      // `quota_exceeded` es un 429 que no se arregla reintentando: hasta el mes siguiente.
-      retryable: status === 0 || status >= 500 || status === 429 && body.code !== "quota_exceeded"
+      // `daily_limit` (y el viejo `quota_exceeded`) son 429 que no se arreglan reintentando: hasta mañana.
+      retryable: status === 0 || status >= 500 || status === 429 && body.code !== "quota_exceeded" && body.code !== "daily_limit"
     });
     this.kind = "unknown";
     this.name = "PartnerApiError";
@@ -998,6 +1058,16 @@ var RateLimitError = class extends QuotaError {
     this.kind = "rate_limit";
   }
 };
+var DailyLimitError = class extends QuotaError {
+  constructor() {
+    super(...arguments);
+    this.name = "DailyLimitError";
+    this.kind = "daily_limit";
+  }
+  get sentToday() {
+    return this.body.sentToday;
+  }
+};
 var InsufficientBalanceError = class extends PartnerApiError {
   constructor() {
     super(...arguments);
@@ -1010,6 +1080,10 @@ var InsufficientBalanceError = class extends PartnerApiError {
   get requiredCents() {
     return this.body.requiredCents;
   }
+  /** Moneda de los dos montos de arriba. */
+  get currency() {
+    return this.body.currency;
+  }
 };
 var NetworkError = class extends PartnerApiError {
   constructor(message, cause) {
@@ -1029,6 +1103,7 @@ function errorFor(status, body, fallback, meta = {}) {
   const msg = body.error || fallback;
   if (body.code === "reputation_hold") return new ReputationHoldError(status, msg, body, meta);
   if (body.code === "recipient_suppressed") return new RecipientSuppressedError(status, msg, body, meta);
+  if (status === 429 && body.code === "daily_limit") return new DailyLimitError(status, msg, body, meta);
   if (status === 429 && body.code !== "quota_exceeded") return new RateLimitError(status, msg, body, meta);
   switch (status) {
     case 401:
@@ -1249,12 +1324,24 @@ var MailMaskPartner = class {
     return (await this.request("GET", `${PARTNER_ROUTES.balanceMovements.path}${qs ? `?${qs}` : ""}`)).data;
   }
   /**
-   * Liga de MercadoPago para recargar saldo (pago único, $500 a $100,000 MXN). El saldo sube cuando
-   * MercadoPago confirma el pago, no al crear la liga. Abre `initPoint` en el navegador de quien paga.
+   * Liga de MercadoPago para recargar saldo (pago único; `amount` en unidades enteras de tu moneda:
+   * MXN 500 a 100,000, USD 29 a 5,500). El saldo sube cuando MercadoPago confirma el pago, no al
+   * crear la liga. Abre `initPoint` en el navegador de quien paga.
    */
   async topup(input) {
     return (await this.request("POST", PARTNER_ROUTES.topup.path, input)).data;
   }
+  /** La recarga automática mensual: `off`, `pending` (falta autorizarla) o `active`. */
+  async autoTopup() {
+    return (await this.request("GET", PARTNER_ROUTES.getAutoTopup.path)).data;
+  }
+  /**
+   * Prende o cambia (`amount` entero de tu moneda) la recarga automática mensual, o la apaga
+   * (`amount: null`). Al prenderla o cambiarla devuelve `initPoint`: ábrelo para autorizar el cobro.
+   */
+  async setAutoTopup(input) {
+    return (await this.request("PUT", PARTNER_ROUTES.setAutoTopup.path, input)).data;
+  }
   /** Uso del mes (`YYYY-MM`, default el mes en curso UTC): tenants activos y envíos. */
   async usage(opts = {}) {
     const q = opts.month ? `?month=${encodeURIComponent(opts.month)}` : "";
@@ -1455,10 +1542,18 @@ var MailMaskPartnerAdmin = class {
   setReputationPolicy(partnerId, policy) {
     return this.req("setReputationPolicy", { partnerId }, { policy });
   }
+  /** Sólo MailMask (admin): moneda del saldo (MXN o USD); sólo antes de cualquier movimiento aparte de la bienvenida. */
+  setCurrency(partnerId, currency) {
+    return this.req("setCurrency", { partnerId }, { currency });
+  }
   /** Sólo MailMask (admin): levanta cualquier pausa, también la de reputación. */
   resumeTenant(partnerId, externalId) {
     return this.req("resumeTenant", { partnerId, externalId });
   }
+  /** Sólo MailMask: tope diario fijo del tenant, o `null` para volver al calentamiento. */
+  setTenantDailyLimit(partnerId, externalId, limit) {
+    return this.req("setTenantDailyLimit", { partnerId, externalId }, { limit });
+  }
   /**
    * Sólo MailMask (admin): crea o adopta la hosted zone de la zona de respaldo (`marketing.denik.me`)
    * y devuelve los NS que el partner tiene que delegar. Idempotente con la misma zona.
@@ -1478,14 +1573,18 @@ var MailMaskPartnerAdmin = class {
   adjustBalance(partnerId, input) {
     return this.req("adjustBalance", { partnerId }, input);
   }
-  /** Sólo MailMask (admin): prende o apaga el cobro por adelantado del partner. */
-  setPrepaidEnforced(partnerId, enforced) {
-    return this.req("setPrepaidEnforced", { partnerId }, { enforced });
-  }
   /** Liga de MercadoPago para recargar, con la llave del dueño. */
   topup(partnerId, input) {
     return this.req("topup", { partnerId }, input);
   }
+  /** La recarga automática mensual del partner (dueño o MailMask). */
+  getAutoTopup(partnerId) {
+    return this.req("getAutoTopup", { partnerId });
+  }
+  /** Prende, cambia (`amount`) o apaga (`null`) la recarga automática; trae `initPoint` al prenderla. */
+  setAutoTopup(partnerId, input) {
+    return this.req("setAutoTopup", { partnerId }, input);
+  }
   listCredentials(partnerId) {
     return this.req("listCredentials", { partnerId });
   }
@@ -1504,11 +1603,13 @@ var MailMaskPartnerAdmin = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AUTO_TOPUP_SUGGESTIONS,
   AuthError,
   BALANCE_LOW_FRACTION,
   BALANCE_MOVEMENT_KINDS,
   ConflictError,
   DOMAIN_CLAIM_TTL_DAYS,
+  DailyLimitError,
   EXTERNAL_ID_RE,
   FALLBACK_LABEL_RE,
   ForbiddenError,
@@ -1527,8 +1628,10 @@ var MailMaskPartnerAdmin = class {
   NotFoundError,
   PARTNER_ADMIN_ROUTES,
   PARTNER_API_PREFIX,
+  PARTNER_CURRENCIES,
   PARTNER_ERROR_STATUS,
   PARTNER_HEADERS,
+  PARTNER_PRICES,
   PARTNER_PRICE_PER_EMAIL_CENTS,
   PARTNER_ROUTES,
   PARTNER_SIGNATURE_TOLERANCE_S,
@@ -1536,6 +1639,7 @@ var MailMaskPartnerAdmin = class {
   PARTNER_TOPUP_MAX_CENTS,
   PARTNER_TOPUP_MIN_CENTS,
   PARTNER_WEBHOOK_EVENTS,
+  PARTNER_WELCOME_CENTS,
   PartnerApiError,
   PausedError,
   QuotaError,
@@ -1546,12 +1650,17 @@ var MailMaskPartnerAdmin = class {
   STRICT_FIRST_DAYS,
   TAG_RE,
   TEMPLATE_VAR_NAME_RE,
+  TENANT_DAILY_LIMIT_MAX,
+  TENANT_DAILY_LIMIT_START,
+  TENANT_WARMUP_STEP_DAYS,
   TimeoutError,
   UNSUBSCRIBE_URL_VAR,
   ValidationError,
   WEBHOOK_HEADERS,
   WEBHOOK_TOLERANCE_MS,
   createWebhookHandler,
+  estimateSendDays,
+  formatMoney,
   isValidExternalId,
   isValidFallbackLabel,
   partnerSignatureBase,
@@ -1564,5 +1673,6 @@ var MailMaskPartnerAdmin = class {
   templateVarsProblem,
   verifyWebhook,
   verifyWebhookSignature,
+  warmupLimit,
   webhookSignatureBase
 });

package/dist/index.js

@@ -638,11 +638,16 @@ var PARTNER_ERROR_STATUS = {
   /** El tenant está en pausa (por MailMask o por el partner). No se manda nada hasta `resume`. */
   tenant_paused: 423,
   /**
-   * Saldo prepagado insuficiente (con `balanceCents` y `requiredCents`). Sólo cuando MailMask
-   * activó el cobro por adelantado del partner. No se reintenta: recarga con `POST /topup`.
+   * Saldo prepagado insuficiente (con `balanceCents` y `requiredCents`). No se reintenta: recarga
+   * con `POST /topup`.
    */
   insufficient_balance: 402,
-  /** Cuota mensual del tenant agotada. */
+  /**
+   * El tenant llegó a su límite del día (con `limit`, `sentToday` y `resetsAt`, la medianoche UTC).
+   * Sólo en envíos sueltos: un lote no falla, espera al día siguiente (`batch.throttled`).
+   */
+  daily_limit: 429,
+  /** Ya no sale desde la 0.8 (no hay tope mensual); se deja para clientes viejos. */
   quota_exceeded: 429,
   /** Demasiadas peticiones; reintenta tras `Retry-After`. */
   rate_limited: 429,
@@ -656,6 +661,30 @@ function isValidExternalId(id) {
 var MAX_BATCH_RECIPIENTS = 1e4;
 var MAX_TAGS = 10;
 var TAG_RE = /^[A-Za-z0-9_-]{1,64}$/;
+var TENANT_DAILY_LIMIT_START = 2e3;
+var TENANT_DAILY_LIMIT_MAX = 2e4;
+var TENANT_WARMUP_STEP_DAYS = 7;
+function warmupLimit(step) {
+  return Math.min(TENANT_DAILY_LIMIT_MAX, TENANT_DAILY_LIMIT_START * 2 ** Math.max(0, step));
+}
+function estimateSendDays(s, recipients) {
+  let left = recipients - Math.max(0, s.dailyLimit - s.sentToday);
+  if (left <= 0) return 1;
+  let days = 1;
+  let limit = s.dailyLimit;
+  let nextAt = s.nextStepAt ? Date.parse(s.nextStepAt) : null;
+  let day = Date.parse(s.resetsAt);
+  while (left > 0 && days < 3650) {
+    while (nextAt !== null && nextAt <= day && limit < TENANT_DAILY_LIMIT_MAX && !s.fixed) {
+      limit = Math.min(TENANT_DAILY_LIMIT_MAX, limit * 2);
+      nextAt += TENANT_WARMUP_STEP_DAYS * 864e5;
+    }
+    left -= limit;
+    days++;
+    day += 864e5;
+  }
+  return days;
+}
 var DOMAIN_CLAIM_TTL_DAYS = 7;
 var FALLBACK_LABEL_RE = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
 var RESERVED_FALLBACK_LABELS = [
@@ -721,12 +750,25 @@ function personalizePartnerMessage(input) {
     ...text !== void 0 ? { text: renderTemplate(text, vars) } : {}
   };
 }
-var PARTNER_PRICE_PER_EMAIL_CENTS = 6;
-var PARTNER_TENANT_MONTH_CENTS = 4900;
-var PARTNER_TOPUP_MIN_CENTS = 5e4;
-var PARTNER_TOPUP_MAX_CENTS = 1e7;
+var PARTNER_CURRENCIES = ["MXN", "USD"];
+var PARTNER_PRICES = {
+  MXN: { perEmailCents: 6, tenantMonthCents: 4900, welcomeCents: 5e4, topupMinCents: 5e4, topupMaxCents: 1e7 },
+  USD: { perEmailCents: 0.35, tenantMonthCents: 290, welcomeCents: 2900, topupMinCents: 2900, topupMaxCents: 55e4 }
+};
+var PARTNER_PRICE_PER_EMAIL_CENTS = PARTNER_PRICES.MXN.perEmailCents;
+var PARTNER_TENANT_MONTH_CENTS = PARTNER_PRICES.MXN.tenantMonthCents;
+var PARTNER_WELCOME_CENTS = PARTNER_PRICES.MXN.welcomeCents;
+var PARTNER_TOPUP_MIN_CENTS = PARTNER_PRICES.MXN.topupMinCents;
+var PARTNER_TOPUP_MAX_CENTS = PARTNER_PRICES.MXN.topupMaxCents;
+function formatMoney(cents, currency) {
+  const v = Math.abs(cents) / 100;
+  const decimals = v !== 0 && v < 0.01 ? 4 : 2;
+  const n = v.toLocaleString("en-US", { minimumFractionDigits: decimals, maximumFractionDigits: decimals });
+  return `${cents < 0 ? "\u2212" : ""}$${n} ${currency}`;
+}
 var BALANCE_LOW_FRACTION = 0.2;
 var BALANCE_MOVEMENT_KINDS = ["topup", "send", "tenant_fee", "refund", "adjust"];
+var AUTO_TOPUP_SUGGESTIONS = { MXN: [500, 1e3, 2500], USD: [29, 59, 149] };
 var PARTNER_WEBHOOK_EVENTS = [
   "email.sent",
   "email.delivered",
@@ -737,7 +779,8 @@ var PARTNER_WEBHOOK_EVENTS = [
   "tenant.paused",
   "tenant.resumed",
   "domain.verified",
-  "balance.low"
+  "balance.low",
+  "batch.throttled"
 ];
 var WEBHOOK_HEADERS = {
   event: "X-MailMask-Event",
@@ -772,6 +815,8 @@ var PARTNER_ROUTES = {
   balance: { method: "GET", path: "/balance" },
   balanceMovements: { method: "GET", path: "/balance/movements" },
   topup: { method: "POST", path: "/topup" },
+  getAutoTopup: { method: "GET", path: "/auto-topup" },
+  setAutoTopup: { method: "PUT", path: "/auto-topup" },
   getWebhook: { method: "GET", path: "/webhook" },
   setWebhook: { method: "PUT", path: "/webhook" },
   testWebhook: { method: "POST", path: "/webhook/test" },
@@ -791,10 +836,14 @@ var PARTNER_ADMIN_ROUTES = {
   getBalance: { method: "GET", path: "/api/partners/:partnerId/balance" },
   /** Sólo MailMask (admin): abono o cargo manual (`adjust`). */
   adjustBalance: { method: "POST", path: "/api/partners/:partnerId/balance/adjust" },
-  /** Sólo MailMask (admin): prende o apaga el cobro por adelantado. */
-  setPrepaidEnforced: { method: "PUT", path: "/api/partners/:partnerId/prepaid" },
   /** Recarga con MercadoPago desde la sesión del dueño (misma respuesta que `POST /topup`). */
   topup: { method: "POST", path: "/api/partners/:partnerId/topup" },
+  getAutoTopup: { method: "GET", path: "/api/partners/:partnerId/auto-topup" },
+  setAutoTopup: { method: "PUT", path: "/api/partners/:partnerId/auto-topup" },
+  /** Sólo MailMask: moneda del saldo, mientras no haya más movimientos que la bienvenida. */
+  setCurrency: { method: "PUT", path: "/api/partners/:partnerId/currency" },
+  /** Sólo MailMask: fija (o quita, con `null`) el límite diario de un tenant. Devuelve el `Tenant`. */
+  setTenantDailyLimit: { method: "PUT", path: "/api/partners/:partnerId/tenants/:externalId/daily-limit" },
   listCredentials: { method: "GET", path: "/api/partners/:partnerId/credentials" },
   createCredential: { method: "POST", path: "/api/partners/:partnerId/credentials" },
   rotateCredential: { method: "POST", path: "/api/partners/:partnerId/credentials/:keyId/rotate" },
@@ -808,8 +857,8 @@ var PartnerApiError = class extends MailMaskError {
       code: body.code,
       requestId: meta.requestId,
       cause: meta.cause,
-      // `quota_exceeded` es un 429 que no se arregla reintentando: hasta el mes siguiente.
-      retryable: status === 0 || status >= 500 || status === 429 && body.code !== "quota_exceeded"
+      // `daily_limit` (y el viejo `quota_exceeded`) son 429 que no se arreglan reintentando: hasta mañana.
+      retryable: status === 0 || status >= 500 || status === 429 && body.code !== "quota_exceeded" && body.code !== "daily_limit"
     });
     this.kind = "unknown";
     this.name = "PartnerApiError";
@@ -912,6 +961,16 @@ var RateLimitError = class extends QuotaError {
     this.kind = "rate_limit";
   }
 };
+var DailyLimitError = class extends QuotaError {
+  constructor() {
+    super(...arguments);
+    this.name = "DailyLimitError";
+    this.kind = "daily_limit";
+  }
+  get sentToday() {
+    return this.body.sentToday;
+  }
+};
 var InsufficientBalanceError = class extends PartnerApiError {
   constructor() {
     super(...arguments);
@@ -924,6 +983,10 @@ var InsufficientBalanceError = class extends PartnerApiError {
   get requiredCents() {
     return this.body.requiredCents;
   }
+  /** Moneda de los dos montos de arriba. */
+  get currency() {
+    return this.body.currency;
+  }
 };
 var NetworkError = class extends PartnerApiError {
   constructor(message, cause) {
@@ -943,6 +1006,7 @@ function errorFor(status, body, fallback, meta = {}) {
   const msg = body.error || fallback;
   if (body.code === "reputation_hold") return new ReputationHoldError(status, msg, body, meta);
   if (body.code === "recipient_suppressed") return new RecipientSuppressedError(status, msg, body, meta);
+  if (status === 429 && body.code === "daily_limit") return new DailyLimitError(status, msg, body, meta);
   if (status === 429 && body.code !== "quota_exceeded") return new RateLimitError(status, msg, body, meta);
   switch (status) {
     case 401:
@@ -1163,12 +1227,24 @@ var MailMaskPartner = class {
     return (await this.request("GET", `${PARTNER_ROUTES.balanceMovements.path}${qs ? `?${qs}` : ""}`)).data;
   }
   /**
-   * Liga de MercadoPago para recargar saldo (pago único, $500 a $100,000 MXN). El saldo sube cuando
-   * MercadoPago confirma el pago, no al crear la liga. Abre `initPoint` en el navegador de quien paga.
+   * Liga de MercadoPago para recargar saldo (pago único; `amount` en unidades enteras de tu moneda:
+   * MXN 500 a 100,000, USD 29 a 5,500). El saldo sube cuando MercadoPago confirma el pago, no al
+   * crear la liga. Abre `initPoint` en el navegador de quien paga.
    */
   async topup(input) {
     return (await this.request("POST", PARTNER_ROUTES.topup.path, input)).data;
   }
+  /** La recarga automática mensual: `off`, `pending` (falta autorizarla) o `active`. */
+  async autoTopup() {
+    return (await this.request("GET", PARTNER_ROUTES.getAutoTopup.path)).data;
+  }
+  /**
+   * Prende o cambia (`amount` entero de tu moneda) la recarga automática mensual, o la apaga
+   * (`amount: null`). Al prenderla o cambiarla devuelve `initPoint`: ábrelo para autorizar el cobro.
+   */
+  async setAutoTopup(input) {
+    return (await this.request("PUT", PARTNER_ROUTES.setAutoTopup.path, input)).data;
+  }
   /** Uso del mes (`YYYY-MM`, default el mes en curso UTC): tenants activos y envíos. */
   async usage(opts = {}) {
     const q = opts.month ? `?month=${encodeURIComponent(opts.month)}` : "";
@@ -1369,10 +1445,18 @@ var MailMaskPartnerAdmin = class {
   setReputationPolicy(partnerId, policy) {
     return this.req("setReputationPolicy", { partnerId }, { policy });
   }
+  /** Sólo MailMask (admin): moneda del saldo (MXN o USD); sólo antes de cualquier movimiento aparte de la bienvenida. */
+  setCurrency(partnerId, currency) {
+    return this.req("setCurrency", { partnerId }, { currency });
+  }
   /** Sólo MailMask (admin): levanta cualquier pausa, también la de reputación. */
   resumeTenant(partnerId, externalId) {
     return this.req("resumeTenant", { partnerId, externalId });
   }
+  /** Sólo MailMask: tope diario fijo del tenant, o `null` para volver al calentamiento. */
+  setTenantDailyLimit(partnerId, externalId, limit) {
+    return this.req("setTenantDailyLimit", { partnerId, externalId }, { limit });
+  }
   /**
    * Sólo MailMask (admin): crea o adopta la hosted zone de la zona de respaldo (`marketing.denik.me`)
    * y devuelve los NS que el partner tiene que delegar. Idempotente con la misma zona.
@@ -1392,14 +1476,18 @@ var MailMaskPartnerAdmin = class {
   adjustBalance(partnerId, input) {
     return this.req("adjustBalance", { partnerId }, input);
   }
-  /** Sólo MailMask (admin): prende o apaga el cobro por adelantado del partner. */
-  setPrepaidEnforced(partnerId, enforced) {
-    return this.req("setPrepaidEnforced", { partnerId }, { enforced });
-  }
   /** Liga de MercadoPago para recargar, con la llave del dueño. */
   topup(partnerId, input) {
     return this.req("topup", { partnerId }, input);
   }
+  /** La recarga automática mensual del partner (dueño o MailMask). */
+  getAutoTopup(partnerId) {
+    return this.req("getAutoTopup", { partnerId });
+  }
+  /** Prende, cambia (`amount`) o apaga (`null`) la recarga automática; trae `initPoint` al prenderla. */
+  setAutoTopup(partnerId, input) {
+    return this.req("setAutoTopup", { partnerId }, input);
+  }
   listCredentials(partnerId) {
     return this.req("listCredentials", { partnerId });
   }
@@ -1417,11 +1505,13 @@ var MailMaskPartnerAdmin = class {
   }
 };
 export {
+  AUTO_TOPUP_SUGGESTIONS,
   AuthError,
   BALANCE_LOW_FRACTION,
   BALANCE_MOVEMENT_KINDS,
   ConflictError,
   DOMAIN_CLAIM_TTL_DAYS,
+  DailyLimitError,
   EXTERNAL_ID_RE,
   FALLBACK_LABEL_RE,
   ForbiddenError,
@@ -1440,8 +1530,10 @@ export {
   NotFoundError,
   PARTNER_ADMIN_ROUTES,
   PARTNER_API_PREFIX,
+  PARTNER_CURRENCIES,
   PARTNER_ERROR_STATUS,
   PARTNER_HEADERS,
+  PARTNER_PRICES,
   PARTNER_PRICE_PER_EMAIL_CENTS,
   PARTNER_ROUTES,
   PARTNER_SIGNATURE_TOLERANCE_S,
@@ -1449,6 +1541,7 @@ export {
   PARTNER_TOPUP_MAX_CENTS,
   PARTNER_TOPUP_MIN_CENTS,
   PARTNER_WEBHOOK_EVENTS,
+  PARTNER_WELCOME_CENTS,
   PartnerApiError,
   PausedError,
   QuotaError,
@@ -1459,12 +1552,17 @@ export {
   STRICT_FIRST_DAYS,
   TAG_RE,
   TEMPLATE_VAR_NAME_RE,
+  TENANT_DAILY_LIMIT_MAX,
+  TENANT_DAILY_LIMIT_START,
+  TENANT_WARMUP_STEP_DAYS,
   TimeoutError,
   UNSUBSCRIBE_URL_VAR,
   ValidationError,
   WEBHOOK_HEADERS,
   WEBHOOK_TOLERANCE_MS,
   createWebhookHandler,
+  estimateSendDays,
+  formatMoney,
   isValidExternalId,
   isValidFallbackLabel,
   partnerSignatureBase,
@@ -1477,5 +1575,6 @@ export {
   templateVarsProblem,
   verifyWebhook,
   verifyWebhookSignature,
+  warmupLimit,
   webhookSignatureBase
 };

package/dist/partner-contract.d.ts

@@ -60,11 +60,16 @@ export declare const PARTNER_ERROR_STATUS: {
     /** El tenant está en pausa (por MailMask o por el partner). No se manda nada hasta `resume`. */
     readonly tenant_paused: 423;
     /**
-     * Saldo prepagado insuficiente (con `balanceCents` y `requiredCents`). Sólo cuando MailMask
-     * activó el cobro por adelantado del partner. No se reintenta: recarga con `POST /topup`.
+     * Saldo prepagado insuficiente (con `balanceCents` y `requiredCents`). No se reintenta: recarga
+     * con `POST /topup`.
      */
     readonly insufficient_balance: 402;
-    /** Cuota mensual del tenant agotada. */
+    /**
+     * El tenant llegó a su límite del día (con `limit`, `sentToday` y `resetsAt`, la medianoche UTC).
+     * Sólo en envíos sueltos: un lote no falla, espera al día siguiente (`batch.throttled`).
+     */
+    readonly daily_limit: 429;
+    /** Ya no sale desde la 0.8 (no hay tope mensual); se deja para clientes viejos. */
     readonly quota_exceeded: 429;
     /** Demasiadas peticiones; reintenta tras `Retry-After`. */
     readonly rate_limited: 429;
@@ -77,12 +82,15 @@ export interface PartnerErrorBody {
     code: PartnerErrorCode;
     /** Sólo en `invalid_request`: el campo que falló, si aplica. */
     field?: string;
-    /** Sólo en `quota_exceeded`: el tope del mes y cuándo se reinicia (ISO, día 1 a las 00:00 UTC). */
+    /** Sólo en `daily_limit`: el límite de hoy, lo enviado y cuándo se reinicia (medianoche UTC). */
     limit?: number;
+    sentToday?: number;
     resetsAt?: string;
-    /** Sólo en `insufficient_balance`: saldo actual y lo que pedía el envío (centavos MXN). */
+    /** Sólo en `insufficient_balance`: saldo actual y lo que pedía el envío (centavos de `currency`). */
     balanceCents?: number;
     requiredCents?: number;
+    /** Moneda de `balanceCents` y `requiredCents`. */
+    currency?: PartnerCurrency;
     /** Sólo en `recipient_suppressed`. */
     reason?: SuppressionReason;
     stream?: MessageStream;
@@ -112,7 +120,38 @@ export interface Tenant {
     lastSendAt: string | null;
     createdAt: string;
     updatedAt: string;
+    /** Límite diario con calentamiento. Ver `TenantSending`. */
+    sending: TenantSending;
 }
+/**
+ * Límite diario por tenant que crece solo, como el calentamiento de SES: empieza en
+ * `TENANT_DAILY_LIMIT_START` al primer envío y se duplica cada `TENANT_WARMUP_STEP_DAYS` días sanos
+ * (rebotes < 2 %, quejas < 0.1 %) hasta `TENANT_DAILY_LIMIT_MAX`. Una pausa por reputación lo
+ * regresa al inicio al reanudar. No hay tope mensual: el saldo es el otro freno.
+ */
+export declare const TENANT_DAILY_LIMIT_START = 2000;
+export declare const TENANT_DAILY_LIMIT_MAX = 20000;
+export declare const TENANT_WARMUP_STEP_DAYS = 7;
+/** El límite del escalón `step` (0 = inicio). */
+export declare function warmupLimit(step: number): number;
+export interface TenantSending {
+    /** Correos que puede mandar hoy (UTC) en total. */
+    dailyLimit: number;
+    sentToday: number;
+    /** Medianoche UTC siguiente. */
+    resetsAt: string;
+    /** Cuándo sube al siguiente escalón si sigue sano; null = ya en el máximo, con tope fijo o sin envíos aún. */
+    nextStepAt: string | null;
+    /** El límite que tendrá en `nextStepAt`; null si no sube. */
+    nextStepLimit: number | null;
+    /** true = MailMask fijó el límite a mano (no se calienta). */
+    fixed: boolean;
+}
+/**
+ * Días (contando hoy) que tarda en salir un lote de `recipients` correos si los escalones llegan a
+ * tiempo. 1 = sale hoy. Sirve para avisar «se manda en N días» antes de encolar.
+ */
+export declare function estimateSendDays(s: TenantSending, recipients: number): number;
 /** `PUT /tenants/:externalId` — crea o actualiza. 201 si lo creó, 200 si ya existía. */
 export interface PutTenantRequest {
     name?: string;
@@ -351,6 +390,11 @@ export interface BatchStatus {
     lastError: string | null;
     createdAt: string;
     completedAt: string | null;
+    /**
+     * El lote llegó al límite diario del tenant y sigue solo a esta hora (medianoche UTC); null si no
+     * está esperando por el límite. Mientras espera, el lote no caduca.
+     */
+    waitingUntil: string | null;
     /**
      * Sólo en modo de prueba: el lote se valida y responde `completed` al instante (los suprimidos en
      * `skippedSuppressed`, el resto en `sent`), con `batchId` `test_…` que no se guarda (su GET da 404).
@@ -368,6 +412,8 @@ export interface TenantUsage {
     bounced: number;
     complained: number;
     unsubscribed: number;
+    /** Límite diario de hoy; falta si el tenant ya se borró. */
+    sending?: TenantSending;
 }
 /** `GET /usage?month=YYYY-MM` (default: el mes en curso, UTC). Activo = al menos un envío en el mes. */
 export interface UsageResponse {
@@ -378,18 +424,37 @@ export interface UsageResponse {
 }
 /**
  * El partner paga por adelantado: cada correo y la cuota mensual de cada tenant activo se
- * descuentan de un saldo que se recarga con MercadoPago (`POST /topup`). Todo en centavos de MXN.
- */
-/** Precio por correo enviado (por destinatario). */
-export declare const PARTNER_PRICE_PER_EMAIL_CENTS = 6;
-/**
- * Cuota mensual por tenant activo. Activo = envía ese mes: se descuenta con su primer envío del
- * mes (UTC), una sola vez, así que un tenant dormido no cuesta nada.
+ * descuentan de un saldo que se recarga con MercadoPago (`POST /topup`). El saldo es en la moneda
+ * del partner (MXN o USD) y es la única unidad: no hay «créditos». Todos los montos `*Cents` son
+ * centavos de esa moneda y pueden traer decimales (en USD un correo cuesta 0.35 centavos; por
+ * dentro se lleva en milésimas de centavo). Se muestran con 2 decimales.
  */
-export declare const PARTNER_TENANT_MONTH_CENTS = 4900;
-/** Recarga mínima y máxima por pago. */
-export declare const PARTNER_TOPUP_MIN_CENTS = 50000;
-export declare const PARTNER_TOPUP_MAX_CENTS = 10000000;
+export type PartnerCurrency = "MXN" | "USD";
+export declare const PARTNER_CURRENCIES: readonly PartnerCurrency[];
+export interface PartnerPrices {
+    /** Por correo enviado (por destinatario). */
+    perEmailCents: number;
+    /**
+     * Cuota mensual por tenant activo. Activo = envía ese mes: se descuenta con su primer envío del
+     * mes (UTC), una sola vez, así que un tenant dormido no cuesta nada.
+     */
+    tenantMonthCents: number;
+    /** Saldo de bienvenida con el que nace el partner (`adjust`, idemKey `welcome:<partnerId>`). */
+    welcomeCents: number;
+    /** Recarga mínima y máxima por pago (enteros de la moneda × 100). */
+    topupMinCents: number;
+    topupMaxCents: number;
+}
+/** Precios por moneda. USD = MXN redondeado; se cobra en MXN por MercadoPago con el tipo de cambio. */
+export declare const PARTNER_PRICES: Record<PartnerCurrency, PartnerPrices>;
+/** Los de MXN, con su nombre de antes (0.7). */
+export declare const PARTNER_PRICE_PER_EMAIL_CENTS: number;
+export declare const PARTNER_TENANT_MONTH_CENTS: number;
+export declare const PARTNER_WELCOME_CENTS: number;
+export declare const PARTNER_TOPUP_MIN_CENTS: number;
+export declare const PARTNER_TOPUP_MAX_CENTS: number;
+/** `$1,234.50 USD`: 2 decimales (4 si el monto es menor a un centavo, como el precio por correo en USD). */
+export declare function formatMoney(cents: number, currency: PartnerCurrency): string;
 /** `balance.low` sale cuando el saldo baja del 20 % de la última recarga (una vez por recarga). */
 export declare const BALANCE_LOW_FRACTION = 0.2;
 export type BalanceMovementKind = "topup" | "send" | "tenant_fee" | "refund" | "adjust";
@@ -409,18 +474,11 @@ export interface BalanceMovement {
 }
 /** `GET /balance` */
 export interface BalanceResponse {
-    currency: "MXN";
+    /** La moneda del saldo y de todos los montos de esta respuesta. */
+    currency: PartnerCurrency;
+    /** Sin saldo suficiente el envío se rechaza (402 `insufficient_balance`) y el lote espera. Siempre. */
     balanceCents: number;
-    /**
-     * true = sin saldo suficiente los envíos se rechazan (402 `insufficient_balance`) y los lotes
-     * esperan. false = el saldo se lleva igual (puede quedar negativo) pero no frena nada.
-     */
-    enforced: boolean;
-    prices: {
-        perEmailCents: number;
-        tenantMonthCents: number;
-        topupMinCents: number;
-    };
+    prices: PartnerPrices;
     lastTopup: {
         amountCents: number;
         at: string;
@@ -429,7 +487,7 @@ export interface BalanceResponse {
     lowBalanceThresholdCents: number | null;
     /** Mes en curso (UTC). */
     month: string;
-    /** Tenants a los que ya se les cobró la cuota del mes. */
+    /** Tenants que enviaron este mes (la misma cuenta que `/usage`): cada uno paga la cuota del mes. */
     activeTenants: number;
     /** Correos cobrados en el mes (sin los devueltos). */
     monthEmails: number;
@@ -444,6 +502,8 @@ export interface BalanceMovementsQuery {
     kind?: BalanceMovementKind[];
 }
 export interface BalanceMovementsResponse {
+    /** La moneda de los montos. */
+    currency: PartnerCurrency;
     movements: BalanceMovement[];
     nextCursor: string | null;
 }
@@ -452,37 +512,89 @@ export interface BalanceMovementsResponse {
  * el pago (webhook), no al crear la liga. `returnUrl` (https) es a dónde regresa el navegador.
  */
 export interface TopupRequest {
-    /** Pesos MXN enteros, 500 a 100,000. */
-    amountMxn: number;
+    /**
+     * Unidades enteras de la moneda del partner (MXN: 500 a 100,000; USD: 29 a 5,500). En USD
+     * MercadoPago cobra el equivalente en MXN con el tipo de cambio de MailMask y se abona lo pedido
+     * en USD.
+     */
+    amount?: number;
+    /** Lo mismo que `amount`, sólo para partners en MXN (0.7). */
+    amountMxn?: number;
     returnUrl?: string;
 }
 export interface TopupResponse {
     topupId: string;
+    /** Lo que se abona al saldo, en la moneda del partner. */
     amountCents: number;
+    currency: PartnerCurrency;
+    /** Lo que cobra MercadoPago, en centavos MXN (igual a `amountCents` si el partner es MXN). */
+    chargeMxnCents: number;
+    /** MXN por USD con que se cotizó; null en MXN. */
+    fxRate: number | null;
     /** Abre esto en el navegador de quien paga. */
     initPoint: string;
 }
+/**
+ * Recarga automática mensual: un cobro de MercadoPago cada mes (preapproval con la tarjeta del
+ * dueño) que abona `amountCents` al saldo con nota «Recarga automática». En USD MercadoPago cobra
+ * `chargeMxnCents` (fijado al activarla) y se abona lo elegido en USD.
+ */
+export interface AutoTopup {
+    /** off = apagada; pending = falta autorizarla en MercadoPago (`initPoint`); active = cobra cada mes. */
+    status: "off" | "pending" | "active";
+    currency: PartnerCurrency;
+    amountCents: number | null;
+    chargeMxnCents: number | null;
+    nextChargeAt: string | null;
+    lastChargeAt: string | null;
+    /** Cobros rechazados seguidos (se reinicia con uno aprobado). */
+    failedCharges: number;
+    lastError: string | null;
+    /** Sólo en la respuesta de prenderla o cambiarla: ábrelo para autorizar el cobro mensual. */
+    initPoint?: string;
+}
+/**
+ * `PUT /auto-topup` — `amount` en unidades enteras de la moneda (mismo rango que `/topup`) la prende
+ * o cambia (cancela la anterior y crea otra); `null` la apaga.
+ */
+export interface SetAutoTopupRequest {
+    amount: number | null;
+    returnUrl?: string;
+}
+/** Montos sugeridos para la recarga automática (unidades enteras). */
+export declare const AUTO_TOPUP_SUGGESTIONS: Record<PartnerCurrency, readonly number[]>;
 /**
  * `GET /api/partners/:partnerId/balance` (dueño o MailMask): el saldo, sus últimos 20 movimientos,
  * el partner (con `tenants` y `ownerEmail`) y si quien mira es de MailMask (ve abonar y el cobro).
  */
+/** Un tenant en la ficha: los 50 que enviaron más recientemente, con su límite de hoy. */
+export interface PartnerDetailTenant {
+    externalId: string;
+    name: string | null;
+    status: TenantStatus;
+    lastSendAt: string | null;
+    sending: TenantSending;
+}
 export type PartnerBalanceDetail = BalanceResponse & {
     movements: BalanceMovement[];
     partner: PartnerSummary;
+    tenants: PartnerDetailTenant[];
+    /** La recarga automática mensual. */
+    autoTopup: AutoTopup;
     staff: boolean;
 };
+/** `PUT /api/partners/:partnerId/tenants/:externalId/daily-limit` — sólo MailMask: tope fijo o `null` (vuelve al calentamiento). */
+export interface SetTenantDailyLimitRequest {
+    limit: number | null;
+}
 /** `POST /api/partners/:partnerId/balance/adjust` — sólo MailMask (admin): abono o cargo manual. */
 export interface AdjustBalanceRequest {
-    /** Centavos MXN, distinto de 0 (negativo = cargo). */
+    /** Centavos enteros de la moneda del partner, distinto de 0 (negativo = cargo). */
     amountCents: number;
     note: string;
     /** Repetir con la misma llave no vuelve a abonar. */
     idempotencyKey?: string;
 }
-/** `PUT /api/partners/:partnerId/prepaid` — sólo MailMask (admin): prende o apaga el cobro por adelantado. */
-export interface SetPrepaidEnforcedRequest {
-    enforced: boolean;
-}
 /** `GET /webhook` */
 export interface WebhookConfig {
     url: string | null;
@@ -516,7 +628,7 @@ export interface RotateWebhookSecretResponse {
 export interface TestWebhookResponse {
     deliveryId: string;
 }
-export declare const PARTNER_WEBHOOK_EVENTS: readonly ["email.sent", "email.delivered", "email.bounced", "email.complained", "email.received", "contact.unsubscribed", "tenant.paused", "tenant.resumed", "domain.verified", "balance.low"];
+export declare const PARTNER_WEBHOOK_EVENTS: readonly ["email.sent", "email.delivered", "email.bounced", "email.complained", "email.received", "contact.unsubscribed", "tenant.paused", "tenant.resumed", "domain.verified", "balance.low", "batch.throttled"];
 export type PartnerWebhookEvent = typeof PARTNER_WEBHOOK_EVENTS[number];
 /** Headers de cada entrega al webhook del partner (los mismos que los webhooks de dominio). */
 export declare const WEBHOOK_HEADERS: {
@@ -599,6 +711,15 @@ export interface PartnerEventData {
         balanceCents: number;
         thresholdCents: number;
         lastTopupCents: number;
+        currency: PartnerCurrency;
+    };
+    /** Un lote llegó al límite diario del tenant: sigue solo en `resumesAt`. Una vez por lote. */
+    "batch.throttled": {
+        batchId: string;
+        sent: number;
+        total: number;
+        dailyLimit: number;
+        resumesAt: string;
     };
     ping: Record<string, never>;
 }
@@ -623,6 +744,7 @@ export declare const STRICT_FIRST_DAYS = 30;
 export interface PartnerSummary {
     id: string;
     name: string;
+    /** `sendsPerTenantMonth` ya no frena (0.8): el límite es diario por tenant, ver `TenantSending`. */
     plan: {
         includedTenants: number;
         sendsPerTenantMonth: number;
@@ -636,9 +758,9 @@ export interface PartnerSummary {
     effectiveReputationPolicy: ReputationPolicy;
     /** Zona de respaldo (`marketing.denik.me`); null = sin zona. Ver `FallbackZone`. */
     fallbackZone: string | null;
-    /** Saldo prepagado (centavos MXN) y si ya frena envíos. Ver `BalanceResponse`. */
+    /** Saldo prepagado, en centavos de `currency`. Ver `BalanceResponse`. */
     balanceCents: number;
-    prepaidEnforced: boolean;
+    currency: PartnerCurrency;
     /** Sólo en `GET /api/partners?all=1` (MailMask, admin): tenants totales y activos del mes. */
     tenants?: {
         total: number;
@@ -654,6 +776,15 @@ export interface CreatePartnerRequest {
     ownerEmail: string;
     plan?: Partial<PartnerSummary["plan"]>;
     reputationPolicy?: ReputationPolicy | null;
+    /** Moneda del saldo; default MXN. Nace con la bienvenida de esa moneda. */
+    currency?: PartnerCurrency;
+}
+/**
+ * `PUT /api/partners/:partnerId/currency` — sólo MailMask, y sólo mientras el partner no tenga más
+ * movimientos que la bienvenida (que se cambia por la de la nueva moneda).
+ */
+export interface SetPartnerCurrencyRequest {
+    currency: PartnerCurrency;
 }
 /** `PUT /api/partners/:partnerId/reputation-policy` — sólo MailMask (admin); null = automática. */
 export interface SetReputationPolicyRequest {
@@ -773,6 +904,14 @@ export declare const PARTNER_ROUTES: {
         readonly method: "POST";
         readonly path: "/topup";
     };
+    readonly getAutoTopup: {
+        readonly method: "GET";
+        readonly path: "/auto-topup";
+    };
+    readonly setAutoTopup: {
+        readonly method: "PUT";
+        readonly path: "/auto-topup";
+    };
     readonly getWebhook: {
         readonly method: "GET";
         readonly path: "/webhook";
@@ -829,16 +968,29 @@ export declare const PARTNER_ADMIN_ROUTES: {
         readonly method: "POST";
         readonly path: "/api/partners/:partnerId/balance/adjust";
     };
-    /** Sólo MailMask (admin): prende o apaga el cobro por adelantado. */
-    readonly setPrepaidEnforced: {
-        readonly method: "PUT";
-        readonly path: "/api/partners/:partnerId/prepaid";
-    };
     /** Recarga con MercadoPago desde la sesión del dueño (misma respuesta que `POST /topup`). */
     readonly topup: {
         readonly method: "POST";
         readonly path: "/api/partners/:partnerId/topup";
     };
+    readonly getAutoTopup: {
+        readonly method: "GET";
+        readonly path: "/api/partners/:partnerId/auto-topup";
+    };
+    readonly setAutoTopup: {
+        readonly method: "PUT";
+        readonly path: "/api/partners/:partnerId/auto-topup";
+    };
+    /** Sólo MailMask: moneda del saldo, mientras no haya más movimientos que la bienvenida. */
+    readonly setCurrency: {
+        readonly method: "PUT";
+        readonly path: "/api/partners/:partnerId/currency";
+    };
+    /** Sólo MailMask: fija (o quita, con `null`) el límite diario de un tenant. Devuelve el `Tenant`. */
+    readonly setTenantDailyLimit: {
+        readonly method: "PUT";
+        readonly path: "/api/partners/:partnerId/tenants/:externalId/daily-limit";
+    };
     readonly listCredentials: {
         readonly method: "GET";
         readonly path: "/api/partners/:partnerId/credentials";

package/dist/partner.d.ts

@@ -1,12 +1,12 @@
 import { MailMaskError } from "./client.js";
-import type { TemplateVars, PartnerSummary, CreatePartnerRequest, ReputationPolicy, ListCredentialsResponse, CreateCredentialRequest, CreateCredentialResponse, RotateCredentialRequest, RotateCredentialResponse, RevokeCredentialResponse, PartnerErrorBody, PartnerErrorCode, Tenant, PutTenantRequest, ListTenantsQuery, ListTenantsResponse, DeleteTenantResponse, PartnerDomain, SendRequest, SendResponse, BatchRequest, BatchStatus, UsageResponse, WebhookConfig, SetWebhookRequest, SetWebhookResponse, TestWebhookResponse, PartnerWebhookPayload, RotateWebhookSecretRequest, RotateWebhookSecretResponse, MessageStream, SuppressionReason, FallbackZone, BalanceResponse, BalanceMovementsQuery, BalanceMovementsResponse, TopupRequest, TopupResponse, PartnerBalanceDetail, AdjustBalanceRequest } from "./partner-contract.js";
+import type { TemplateVars, PartnerSummary, CreatePartnerRequest, ReputationPolicy, ListCredentialsResponse, CreateCredentialRequest, CreateCredentialResponse, RotateCredentialRequest, RotateCredentialResponse, RevokeCredentialResponse, PartnerErrorBody, PartnerErrorCode, Tenant, PutTenantRequest, ListTenantsQuery, ListTenantsResponse, DeleteTenantResponse, PartnerDomain, SendRequest, SendResponse, BatchRequest, BatchStatus, UsageResponse, WebhookConfig, SetWebhookRequest, SetWebhookResponse, TestWebhookResponse, PartnerWebhookPayload, RotateWebhookSecretRequest, RotateWebhookSecretResponse, MessageStream, SuppressionReason, FallbackZone, BalanceResponse, BalanceMovementsQuery, BalanceMovementsResponse, TopupRequest, TopupResponse, PartnerBalanceDetail, AdjustBalanceRequest, PartnerCurrency, AutoTopup, SetAutoTopupRequest } from "./partner-contract.js";
 export * from "./partner-contract.js";
 /**
  * Discriminante estable de los errores de partners, para un `switch` sin cadenas de `instanceof`.
  * `network` y `timeout` llevan `status` 0 (no hubo respuesta); `unknown` es un status que el
  * contrato no define (p. ej. un 400 de un proxy).
  */
-export type PartnerErrorKind = "auth" | "forbidden" | "reputation_hold" | "not_found" | "conflict" | "validation" | "suppressed" | "paused" | "quota" | "insufficient_balance" | "rate_limit" | "server" | "network" | "timeout" | "unknown";
+export type PartnerErrorKind = "auth" | "forbidden" | "reputation_hold" | "not_found" | "conflict" | "validation" | "suppressed" | "paused" | "quota" | "daily_limit" | "insufficient_balance" | "rate_limit" | "server" | "network" | "timeout" | "unknown";
 /** Metadatos de la respuesta que no vienen en el cuerpo. */
 export interface PartnerErrorMeta {
     requestId?: string;
@@ -101,14 +101,25 @@ export declare class RateLimitError extends QuotaError {
     kind: PartnerErrorKind;
 }
 /**
- * 402 `insufficient_balance`: el saldo prepagado no alcanza (sólo con el cobro por adelantado
- * prendido). No se reintenta: recarga con `partner.topup()`. Trae `balanceCents` y `requiredCents`.
+ * 429 `daily_limit`: el tenant llegó a su límite del día (crece solo con buena reputación). NO se
+ * reintenta: vuelve a intentar después de `resetsAt` (medianoche UTC) o manda un `batch`, que espera
+ * solo. Trae `limit` y `sentToday`.
+ */
+export declare class DailyLimitError extends QuotaError {
+    name: string;
+    kind: PartnerErrorKind;
+    get sentToday(): number | undefined;
+}
+/**
+ * 402 `insufficient_balance`: el saldo prepagado no alcanza. No se reintenta: recarga con `partner.topup()`. Trae `balanceCents`, `requiredCents` y `currency`.
  */
 export declare class InsufficientBalanceError extends PartnerApiError {
     name: string;
     kind: PartnerErrorKind;
     get balanceCents(): number | undefined;
     get requiredCents(): number | undefined;
+    /** Moneda de los dos montos de arriba. */
+    get currency(): PartnerCurrency | undefined;
 }
 /** No hubo respuesta: DNS, conexión rechazada o cortada. `status` 0. */
 export declare class NetworkError extends PartnerApiError {
@@ -233,10 +244,18 @@ export declare class MailMaskPartner {
     /** Movimientos del saldo, del más nuevo al más viejo; pagina con `nextCursor`. */
     balanceMovements(query?: BalanceMovementsQuery): Promise<BalanceMovementsResponse>;
     /**
-     * Liga de MercadoPago para recargar saldo (pago único, $500 a $100,000 MXN). El saldo sube cuando
-     * MercadoPago confirma el pago, no al crear la liga. Abre `initPoint` en el navegador de quien paga.
+     * Liga de MercadoPago para recargar saldo (pago único; `amount` en unidades enteras de tu moneda:
+     * MXN 500 a 100,000, USD 29 a 5,500). El saldo sube cuando MercadoPago confirma el pago, no al
+     * crear la liga. Abre `initPoint` en el navegador de quien paga.
      */
     topup(input: TopupRequest): Promise<TopupResponse>;
+    /** La recarga automática mensual: `off`, `pending` (falta autorizarla) o `active`. */
+    autoTopup(): Promise<AutoTopup>;
+    /**
+     * Prende o cambia (`amount` entero de tu moneda) la recarga automática mensual, o la apaga
+     * (`amount: null`). Al prenderla o cambiarla devuelve `initPoint`: ábrelo para autorizar el cobro.
+     */
+    setAutoTopup(input: SetAutoTopupRequest): Promise<AutoTopup>;
     /** Uso del mes (`YYYY-MM`, default el mes en curso UTC): tenants activos y envíos. */
     usage(opts?: {
         month?: string;
@@ -371,8 +390,12 @@ export declare class MailMaskPartnerAdmin {
     createPartner(input: CreatePartnerRequest): Promise<PartnerSummary>;
     /** Sólo MailMask (admin); null = automática (Strict el primer mes, Standard después). */
     setReputationPolicy(partnerId: string, policy: ReputationPolicy | null): Promise<PartnerSummary>;
+    /** Sólo MailMask (admin): moneda del saldo (MXN o USD); sólo antes de cualquier movimiento aparte de la bienvenida. */
+    setCurrency(partnerId: string, currency: PartnerCurrency): Promise<PartnerSummary>;
     /** Sólo MailMask (admin): levanta cualquier pausa, también la de reputación. */
     resumeTenant(partnerId: string, externalId: string): Promise<Tenant>;
+    /** Sólo MailMask: tope diario fijo del tenant, o `null` para volver al calentamiento. */
+    setTenantDailyLimit(partnerId: string, externalId: string, limit: number | null): Promise<Tenant>;
     /**
      * Sólo MailMask (admin): crea o adopta la hosted zone de la zona de respaldo (`marketing.denik.me`)
      * y devuelve los NS que el partner tiene que delegar. Idempotente con la misma zona.
@@ -384,10 +407,12 @@ export declare class MailMaskPartnerAdmin {
     getBalance(partnerId: string): Promise<PartnerBalanceDetail>;
     /** Sólo MailMask (admin): abono (o cargo, negativo) manual. Con la misma `idempotencyKey` no se repite. */
     adjustBalance(partnerId: string, input: AdjustBalanceRequest): Promise<PartnerBalanceDetail>;
-    /** Sólo MailMask (admin): prende o apaga el cobro por adelantado del partner. */
-    setPrepaidEnforced(partnerId: string, enforced: boolean): Promise<PartnerSummary>;
     /** Liga de MercadoPago para recargar, con la llave del dueño. */
     topup(partnerId: string, input: TopupRequest): Promise<TopupResponse>;
+    /** La recarga automática mensual del partner (dueño o MailMask). */
+    getAutoTopup(partnerId: string): Promise<AutoTopup>;
+    /** Prende, cambia (`amount`) o apaga (`null`) la recarga automática; trae `initPoint` al prenderla. */
+    setAutoTopup(partnerId: string, input: SetAutoTopupRequest): Promise<AutoTopup>;
     listCredentials(partnerId: string): Promise<ListCredentialsResponse>;
     /** El secreto `mms_…` viene UNA vez en la respuesta. */
     createCredential(partnerId: string, input?: CreateCredentialRequest): Promise<CreateCredentialResponse>;

package/package.json

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