mailery 0.2.0 → 0.2.2

package/dist/{null-CWw3Gpbl.d.cts → null-DaisDvB_.d.cts}

@@ -365,6 +365,54 @@ type QueueDriverConfig = {
     driver: 'noop';
 };
 
+/**
+ * Shared enums — string-literal unions for status fields and other discriminators.
+ * Kept separate from types.ts so the client can import these without pulling in
+ * server-shaped interfaces.
+ */
+type SubscriptionStatus = 'subscribed' | 'pending_doi' | 'unsubscribed' | 'bounced' | 'complained';
+type SendStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'suppressed';
+type TemplateKind = 'transactional' | 'marketing';
+type SuppressionScope = 'all' | 'marketing' | 'transactional';
+type SuppressionReason = 'unsubscribed' | 'hard_bounce' | 'complaint' | 'manual' | 'list_cleaning' | 'gdpr_forget';
+type FlowRunStatus = 'active' | 'completed' | 'exited' | 'failed';
+type BroadcastStatus = 'draft' | 'scheduled' | 'sending' | 'sent' | 'cancelled' | 'failed';
+type HealthStatus = 'healthy' | 'degraded' | 'tripped';
+type FlowGoal = 'activation' | 'conversion' | 'retention' | 'reactivation' | 'transactional' | 'broadcast';
+
+/**
+ * Sender-domain validator.
+ *
+ * Hosts may declare a `senderDomains` registry mapping a domain to which kind
+ * of email is allowed to send from it. Used to isolate marketing reputation
+ * from transactional reputation:
+ *
+ *   senderDomains: {
+ *     'news.example.com': { kind: 'marketing' },
+ *     'mail.example.com': { kind: 'transactional' },
+ *     'tools.example.com': { kind: 'both' },     // OK for either kind
+ *   }
+ *
+ * The check runs at template publish time. If a template's `fromEmail` domain
+ * isn't declared, or is declared for the wrong kind, publish fails with a
+ * descriptive 400. Hosts who don't set `senderDomains` get no enforcement —
+ * back-compat default.
+ */
+
+interface SenderDomainConfig {
+    /** Which template `kind` may use this domain as a From address. */
+    kind: 'marketing' | 'transactional' | 'both';
+}
+type SenderDomainRegistry = Record<string, SenderDomainConfig>;
+type SenderDomainValidation = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'invalid_email' | 'unregistered_domain' | 'wrong_kind';
+    reason: string;
+};
+declare function validateSenderDomain(fromEmail: string, templateKind: TemplateKind, registry: SenderDomainRegistry | undefined): SenderDomainValidation;
+
 /**
  * Mailer configuration shape. Required + optional surfaces with sane defaults.
  */
@@ -412,6 +460,15 @@ interface MailerConfig {
         name: string;
         email: string;
     };
+    /**
+     * Optional registry of sender domains by kind. When set, mailery enforces at
+     * template publish time that a template's `fromEmail` domain is declared and
+     * matches the template's `kind`. Used to keep marketing reputation isolated
+     * from transactional reputation by sending from separate verified domains.
+     *
+     * Domains are case-insensitive. If unset, no enforcement happens.
+     */
+    senderDomains?: SenderDomainRegistry;
     requireDoubleOptIn?: boolean;
     unsubscribeTokenLifetimeDays?: number;
     transactionalRespectUnsubscribe?: boolean;
@@ -450,21 +507,6 @@ type ResolvedConfig = Required<Pick<MailerConfig, 'collectionPrefix' | 'requireD
     circuitBreaker: CircuitBreakerThresholds;
 } & MailerConfig;
 
-/**
- * Shared enums — string-literal unions for status fields and other discriminators.
- * Kept separate from types.ts so the client can import these without pulling in
- * server-shaped interfaces.
- */
-type SubscriptionStatus = 'subscribed' | 'pending_doi' | 'unsubscribed' | 'bounced' | 'complained';
-type SendStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'suppressed';
-type TemplateKind = 'transactional' | 'marketing';
-type SuppressionScope = 'all' | 'marketing' | 'transactional';
-type SuppressionReason = 'unsubscribed' | 'hard_bounce' | 'complaint' | 'manual' | 'list_cleaning' | 'gdpr_forget';
-type FlowRunStatus = 'active' | 'completed' | 'exited' | 'failed';
-type BroadcastStatus = 'draft' | 'scheduled' | 'sending' | 'sent' | 'cancelled' | 'failed';
-type HealthStatus = 'healthy' | 'degraded' | 'tripped';
-type FlowGoal = 'activation' | 'conversion' | 'retention' | 'reactivation' | 'transactional' | 'broadcast';
-
 /**
  * Mongo collection helpers + indexes for every mailer-owned collection.
  *
@@ -978,4 +1020,4 @@ declare class NullProvider implements MailProvider {
     reset(): void;
 }
 
-export { type AdapterFilter as A, type BroadcastDoc as B, type ContactAdapter as C, type TemplateKind as D, type EventDoc as E, type FlowStep as F, type TemplateVersionDoc as G, type HealthDoc as H, ensureIndexes as I, getCollections as J, type LeadDoc as L, type MailProvider as M, type NormalizedEvent as N, type OutboxDoc as O, type Predicate as P, type RunnerContext as R, type SendArgs as S, type TemplateDoc as T, type WebhookEventDoc as W, type Contact as a, type SendResult as b, Mailer as c, type SuppressionScope as d, type SegmentFilter as e, type AuditLogDoc as f, type BroadcastStatus as g, type CircuitBreakerThresholds as h, type Collections as i, type ContactTagDoc as j, type FlowDoc as k, type FlowGoal as l, type FlowRunDoc as m, type FlowRunStatus as n, type FlowVersionDoc as o, type HealthStatus as p, type MailerConfig as q, NullProvider as r, type RedisOptions as s, type SegmentDefinition as t, type SendDoc as u, type SendStatus as v, type SubscriptionDoc as w, type SubscriptionStatus as x, type SuppressionDoc as y, type SuppressionReason as z };
+export { type AdapterFilter as A, type BroadcastDoc as B, type ContactAdapter as C, type SubscriptionStatus as D, type EventDoc as E, type FlowStep as F, type SuppressionDoc as G, type HealthDoc as H, type SuppressionReason as I, type TemplateKind as J, type TemplateVersionDoc as K, type LeadDoc as L, type MailProvider as M, type NormalizedEvent as N, type OutboxDoc as O, type Predicate as P, ensureIndexes as Q, type RunnerContext as R, type SendArgs as S, type TemplateDoc as T, getCollections as U, validateSenderDomain as V, type WebhookEventDoc as W, type Contact as a, type SendResult as b, Mailer as c, type SuppressionScope as d, type SegmentFilter as e, type AuditLogDoc as f, type BroadcastStatus as g, type CircuitBreakerThresholds as h, type Collections as i, type ContactTagDoc as j, type FlowDoc as k, type FlowGoal as l, type FlowRunDoc as m, type FlowRunStatus as n, type FlowVersionDoc as o, type HealthStatus as p, type MailerConfig as q, NullProvider as r, type RedisOptions as s, type SegmentDefinition as t, type SendDoc as u, type SendStatus as v, type SenderDomainConfig as w, type SenderDomainRegistry as x, type SenderDomainValidation as y, type SubscriptionDoc as z };

package/dist/{null-CWw3Gpbl.d.ts → null-DaisDvB_.d.ts}

@@ -365,6 +365,54 @@ type QueueDriverConfig = {
     driver: 'noop';
 };
 
+/**
+ * Shared enums — string-literal unions for status fields and other discriminators.
+ * Kept separate from types.ts so the client can import these without pulling in
+ * server-shaped interfaces.
+ */
+type SubscriptionStatus = 'subscribed' | 'pending_doi' | 'unsubscribed' | 'bounced' | 'complained';
+type SendStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'suppressed';
+type TemplateKind = 'transactional' | 'marketing';
+type SuppressionScope = 'all' | 'marketing' | 'transactional';
+type SuppressionReason = 'unsubscribed' | 'hard_bounce' | 'complaint' | 'manual' | 'list_cleaning' | 'gdpr_forget';
+type FlowRunStatus = 'active' | 'completed' | 'exited' | 'failed';
+type BroadcastStatus = 'draft' | 'scheduled' | 'sending' | 'sent' | 'cancelled' | 'failed';
+type HealthStatus = 'healthy' | 'degraded' | 'tripped';
+type FlowGoal = 'activation' | 'conversion' | 'retention' | 'reactivation' | 'transactional' | 'broadcast';
+
+/**
+ * Sender-domain validator.
+ *
+ * Hosts may declare a `senderDomains` registry mapping a domain to which kind
+ * of email is allowed to send from it. Used to isolate marketing reputation
+ * from transactional reputation:
+ *
+ *   senderDomains: {
+ *     'news.example.com': { kind: 'marketing' },
+ *     'mail.example.com': { kind: 'transactional' },
+ *     'tools.example.com': { kind: 'both' },     // OK for either kind
+ *   }
+ *
+ * The check runs at template publish time. If a template's `fromEmail` domain
+ * isn't declared, or is declared for the wrong kind, publish fails with a
+ * descriptive 400. Hosts who don't set `senderDomains` get no enforcement —
+ * back-compat default.
+ */
+
+interface SenderDomainConfig {
+    /** Which template `kind` may use this domain as a From address. */
+    kind: 'marketing' | 'transactional' | 'both';
+}
+type SenderDomainRegistry = Record<string, SenderDomainConfig>;
+type SenderDomainValidation = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'invalid_email' | 'unregistered_domain' | 'wrong_kind';
+    reason: string;
+};
+declare function validateSenderDomain(fromEmail: string, templateKind: TemplateKind, registry: SenderDomainRegistry | undefined): SenderDomainValidation;
+
 /**
  * Mailer configuration shape. Required + optional surfaces with sane defaults.
  */
@@ -412,6 +460,15 @@ interface MailerConfig {
         name: string;
         email: string;
     };
+    /**
+     * Optional registry of sender domains by kind. When set, mailery enforces at
+     * template publish time that a template's `fromEmail` domain is declared and
+     * matches the template's `kind`. Used to keep marketing reputation isolated
+     * from transactional reputation by sending from separate verified domains.
+     *
+     * Domains are case-insensitive. If unset, no enforcement happens.
+     */
+    senderDomains?: SenderDomainRegistry;
     requireDoubleOptIn?: boolean;
     unsubscribeTokenLifetimeDays?: number;
     transactionalRespectUnsubscribe?: boolean;
@@ -450,21 +507,6 @@ type ResolvedConfig = Required<Pick<MailerConfig, 'collectionPrefix' | 'requireD
     circuitBreaker: CircuitBreakerThresholds;
 } & MailerConfig;
 
-/**
- * Shared enums — string-literal unions for status fields and other discriminators.
- * Kept separate from types.ts so the client can import these without pulling in
- * server-shaped interfaces.
- */
-type SubscriptionStatus = 'subscribed' | 'pending_doi' | 'unsubscribed' | 'bounced' | 'complained';
-type SendStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'suppressed';
-type TemplateKind = 'transactional' | 'marketing';
-type SuppressionScope = 'all' | 'marketing' | 'transactional';
-type SuppressionReason = 'unsubscribed' | 'hard_bounce' | 'complaint' | 'manual' | 'list_cleaning' | 'gdpr_forget';
-type FlowRunStatus = 'active' | 'completed' | 'exited' | 'failed';
-type BroadcastStatus = 'draft' | 'scheduled' | 'sending' | 'sent' | 'cancelled' | 'failed';
-type HealthStatus = 'healthy' | 'degraded' | 'tripped';
-type FlowGoal = 'activation' | 'conversion' | 'retention' | 'reactivation' | 'transactional' | 'broadcast';
-
 /**
  * Mongo collection helpers + indexes for every mailer-owned collection.
  *
@@ -978,4 +1020,4 @@ declare class NullProvider implements MailProvider {
     reset(): void;
 }
 
-export { type AdapterFilter as A, type BroadcastDoc as B, type ContactAdapter as C, type TemplateKind as D, type EventDoc as E, type FlowStep as F, type TemplateVersionDoc as G, type HealthDoc as H, ensureIndexes as I, getCollections as J, type LeadDoc as L, type MailProvider as M, type NormalizedEvent as N, type OutboxDoc as O, type Predicate as P, type RunnerContext as R, type SendArgs as S, type TemplateDoc as T, type WebhookEventDoc as W, type Contact as a, type SendResult as b, Mailer as c, type SuppressionScope as d, type SegmentFilter as e, type AuditLogDoc as f, type BroadcastStatus as g, type CircuitBreakerThresholds as h, type Collections as i, type ContactTagDoc as j, type FlowDoc as k, type FlowGoal as l, type FlowRunDoc as m, type FlowRunStatus as n, type FlowVersionDoc as o, type HealthStatus as p, type MailerConfig as q, NullProvider as r, type RedisOptions as s, type SegmentDefinition as t, type SendDoc as u, type SendStatus as v, type SubscriptionDoc as w, type SubscriptionStatus as x, type SuppressionDoc as y, type SuppressionReason as z };
+export { type AdapterFilter as A, type BroadcastDoc as B, type ContactAdapter as C, type SubscriptionStatus as D, type EventDoc as E, type FlowStep as F, type SuppressionDoc as G, type HealthDoc as H, type SuppressionReason as I, type TemplateKind as J, type TemplateVersionDoc as K, type LeadDoc as L, type MailProvider as M, type NormalizedEvent as N, type OutboxDoc as O, type Predicate as P, ensureIndexes as Q, type RunnerContext as R, type SendArgs as S, type TemplateDoc as T, getCollections as U, validateSenderDomain as V, type WebhookEventDoc as W, type Contact as a, type SendResult as b, Mailer as c, type SuppressionScope as d, type SegmentFilter as e, type AuditLogDoc as f, type BroadcastStatus as g, type CircuitBreakerThresholds as h, type Collections as i, type ContactTagDoc as j, type FlowDoc as k, type FlowGoal as l, type FlowRunDoc as m, type FlowRunStatus as n, type FlowVersionDoc as o, type HealthStatus as p, type MailerConfig as q, NullProvider as r, type RedisOptions as s, type SegmentDefinition as t, type SendDoc as u, type SendStatus as v, type SenderDomainConfig as w, type SenderDomainRegistry as x, type SenderDomainValidation as y, type SubscriptionDoc as z };

package/dist/testing.cjs

@@ -15943,6 +15943,25 @@ async function promoteSoftBounces(ctx) {
 // src/server/runner/tick.ts
 var STRANDED_SEND_THRESHOLD_MS = 5 * 60 * 1e3;
 async function runTick(ctx) {
+  await ctx.collections.health.updateOne(
+    { _id: "singleton" },
+    {
+      $set: { updatedAt: /* @__PURE__ */ new Date() },
+      $setOnInsert: {
+        _id: "singleton",
+        windowStartedAt: /* @__PURE__ */ new Date(),
+        windowDurationMs: ctx.config.circuitBreaker.windowMinutes * 60 * 1e3,
+        status: "healthy",
+        trippedAt: null,
+        trippedReason: null,
+        manuallyResumedAt: null,
+        counters: { sent: 0, delivered: 0, bounced: 0, hardBounced: 0, softBounced: 0, complained: 0, failedToSend: 0 },
+        rates: { bounceRate: 0, hardBounceRate: 0, complaintRate: 0, failureRate: 0 }
+      }
+    },
+    { upsert: true }
+  ).catch(() => {
+  });
   await processNewlyFiredEventTriggers(ctx).catch((err) => {
     console.error("mailery: triggers scan failed", err);
   });