@easybits.cloud/mailmask 0.7.0 → 0.8.0

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   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,
@@ -52,6 +53,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 +64,16 @@ __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,
   isValidExternalId: () => isValidExternalId,
   isValidFallbackLabel: () => isValidFallbackLabel,
   partnerSignatureBase: () => partnerSignatureBase,
@@ -80,6 +86,7 @@ __export(index_exports, {
   templateVarsProblem: () => templateVarsProblem,
   verifyWebhook: () => verifyWebhook,
   verifyWebhookSignature: () => verifyWebhookSignature,
+  warmupLimit: () => warmupLimit,
   webhookSignatureBase: () => webhookSignatureBase
 });
 module.exports = __toCommonJS(index_exports);
@@ -724,11 +731,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 +754,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 = 5e4;
+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 = [
@@ -809,6 +845,7 @@ function personalizePartnerMessage(input) {
 }
 var PARTNER_PRICE_PER_EMAIL_CENTS = 6;
 var PARTNER_TENANT_MONTH_CENTS = 4900;
+var PARTNER_WELCOME_CENTS = 5e4;
 var PARTNER_TOPUP_MIN_CENTS = 5e4;
 var PARTNER_TOPUP_MAX_CENTS = 1e7;
 var BALANCE_LOW_FRACTION = 0.2;
@@ -823,7 +860,8 @@ var PARTNER_WEBHOOK_EVENTS = [
   "tenant.paused",
   "tenant.resumed",
   "domain.verified",
-  "balance.low"
+  "balance.low",
+  "batch.throttled"
 ];
 var WEBHOOK_HEADERS = {
   event: "X-MailMask-Event",
@@ -877,10 +915,10 @@ 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" },
+  /** 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 +932,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 +1036,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);
@@ -1029,6 +1077,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:
@@ -1459,6 +1508,10 @@ var MailMaskPartnerAdmin = class {
   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,10 +1531,6 @@ 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);
@@ -1509,6 +1558,7 @@ var MailMaskPartnerAdmin = class {
   BALANCE_MOVEMENT_KINDS,
   ConflictError,
   DOMAIN_CLAIM_TTL_DAYS,
+  DailyLimitError,
   EXTERNAL_ID_RE,
   FALLBACK_LABEL_RE,
   ForbiddenError,
@@ -1536,6 +1586,7 @@ var MailMaskPartnerAdmin = class {
   PARTNER_TOPUP_MAX_CENTS,
   PARTNER_TOPUP_MIN_CENTS,
   PARTNER_WEBHOOK_EVENTS,
+  PARTNER_WELCOME_CENTS,
   PartnerApiError,
   PausedError,
   QuotaError,
@@ -1546,12 +1597,16 @@ 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,
   isValidExternalId,
   isValidFallbackLabel,
   partnerSignatureBase,
@@ -1564,5 +1619,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 = 5e4;
+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 = [
@@ -723,6 +752,7 @@ function personalizePartnerMessage(input) {
 }
 var PARTNER_PRICE_PER_EMAIL_CENTS = 6;
 var PARTNER_TENANT_MONTH_CENTS = 4900;
+var PARTNER_WELCOME_CENTS = 5e4;
 var PARTNER_TOPUP_MIN_CENTS = 5e4;
 var PARTNER_TOPUP_MAX_CENTS = 1e7;
 var BALANCE_LOW_FRACTION = 0.2;
@@ -737,7 +767,8 @@ var PARTNER_WEBHOOK_EVENTS = [
   "tenant.paused",
   "tenant.resumed",
   "domain.verified",
-  "balance.low"
+  "balance.low",
+  "batch.throttled"
 ];
 var WEBHOOK_HEADERS = {
   event: "X-MailMask-Event",
@@ -791,10 +822,10 @@ 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" },
+  /** 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 +839,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 +943,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);
@@ -943,6 +984,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:
@@ -1373,6 +1415,10 @@ var MailMaskPartnerAdmin = class {
   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,10 +1438,6 @@ 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);
@@ -1422,6 +1464,7 @@ export {
   BALANCE_MOVEMENT_KINDS,
   ConflictError,
   DOMAIN_CLAIM_TTL_DAYS,
+  DailyLimitError,
   EXTERNAL_ID_RE,
   FALLBACK_LABEL_RE,
   ForbiddenError,
@@ -1449,6 +1492,7 @@ export {
   PARTNER_TOPUP_MAX_CENTS,
   PARTNER_TOPUP_MIN_CENTS,
   PARTNER_WEBHOOK_EVENTS,
+  PARTNER_WELCOME_CENTS,
   PartnerApiError,
   PausedError,
   QuotaError,
@@ -1459,12 +1503,16 @@ 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,
   isValidExternalId,
   isValidFallbackLabel,
   partnerSignatureBase,
@@ -1477,5 +1525,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,8 +82,9 @@ 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). */
     balanceCents?: number;
@@ -112,7 +118,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 = 50000;
+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 +388,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 +410,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 {
@@ -387,6 +431,8 @@ export declare const PARTNER_PRICE_PER_EMAIL_CENTS = 6;
  * mes (UTC), una sola vez, así que un tenant dormido no cuesta nada.
  */
 export declare const PARTNER_TENANT_MONTH_CENTS = 4900;
+/** Saldo de bienvenida con el que nace todo partner (`adjust`, idemKey `welcome:<partnerId>`). */
+export declare const PARTNER_WELCOME_CENTS = 50000;
 /** Recarga mínima y máxima por pago. */
 export declare const PARTNER_TOPUP_MIN_CENTS = 50000;
 export declare const PARTNER_TOPUP_MAX_CENTS = 10000000;
@@ -410,12 +456,8 @@ export interface BalanceMovement {
 /** `GET /balance` */
 export interface BalanceResponse {
     currency: "MXN";
+    /** 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;
@@ -429,7 +471,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;
@@ -466,11 +508,24 @@ export interface TopupResponse {
  * `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[];
     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). */
@@ -479,10 +534,6 @@ export interface AdjustBalanceRequest {
     /** 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 +567,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: {
@@ -600,6 +651,14 @@ export interface PartnerEventData {
         thresholdCents: number;
         lastTopupCents: number;
     };
+    /** 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>;
 }
 /** Sobre de cada evento. `externalId` es null en `ping` y `balance.low`. */
@@ -623,6 +682,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 +696,8 @@ 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 (centavos MXN). Ver `BalanceResponse`. */
     balanceCents: number;
-    prepaidEnforced: boolean;
     /** Sólo en `GET /api/partners?all=1` (MailMask, admin): tenants totales y activos del mes. */
     tenants?: {
         total: number;
@@ -829,16 +888,16 @@ 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";
     };
+    /** 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

@@ -6,7 +6,7 @@ export * from "./partner-contract.js";
  * `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,8 +101,17 @@ 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` y `requiredCents`.
  */
 export declare class InsufficientBalanceError extends PartnerApiError {
     name: string;
@@ -373,6 +382,8 @@ export declare class MailMaskPartnerAdmin {
     setReputationPolicy(partnerId: string, policy: ReputationPolicy | null): 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,8 +395,6 @@ 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>;
     listCredentials(partnerId: string): Promise<ListCredentialsResponse>;

package/package.json

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