mailery 0.1.1 → 0.1.2

package/dist/index.d.cts

@@ -1,11 +1,59 @@
-import { C as ContactAdapter, a as Contact, A as AdapterFilter, M as MailProvider, S as SendArgs, b as SendResult, N as NormalizedEvent, c as Mailer, T as TemplateDoc, d as SuppressionScope, F as FlowStep, e as SegmentFilter, P as Predicate } from './null-sygex0Ru.cjs';
-export { f as AuditLogDoc, B as BroadcastDoc, g as BroadcastStatus, h as CircuitBreakerThresholds, i as Collections, j as ContactTagDoc, E as EventDoc, k as FlowDoc, l as FlowGoal, m as FlowRunDoc, n as FlowRunStatus, o as FlowVersionDoc, H as HealthDoc, p as HealthStatus, L as LeadDoc, q as MailerConfig, r as NullProvider, O as OutboxDoc, R as RedisOptions, s as SegmentDefinition, t as SendDoc, u as SendStatus, v as SubscriptionDoc, w as SubscriptionStatus, x as SuppressionDoc, y as SuppressionReason, z as TemplateKind, D as TemplateVersionDoc, W as WebhookEventDoc, G as ensureIndexes, I as getCollections } from './null-sygex0Ru.cjs';
-import { Db, Filter } from 'mongodb';
+import { R as RunnerContext, N as NormalizedEvent, C as ContactAdapter, a as Contact, A as AdapterFilter, M as MailProvider, S as SendArgs, b as SendResult, c as Mailer, T as TemplateDoc, d as SuppressionScope, F as FlowStep, e as SegmentFilter, P as Predicate } from './null-OzIqP7A8.cjs';
+export { f as AuditLogDoc, B as BroadcastDoc, g as BroadcastStatus, h as CircuitBreakerThresholds, i as Collections, j as ContactTagDoc, E as EventDoc, k as FlowDoc, l as FlowGoal, m as FlowRunDoc, n as FlowRunStatus, o as FlowVersionDoc, H as HealthDoc, p as HealthStatus, L as LeadDoc, q as MailerConfig, r as NullProvider, O as OutboxDoc, s as RedisOptions, t as SegmentDefinition, u as SendDoc, v as SendStatus, w as SubscriptionDoc, x as SubscriptionStatus, y as SuppressionDoc, z as SuppressionReason, D as TemplateKind, G as TemplateVersionDoc, W as WebhookEventDoc, I as ensureIndexes, J as getCollections } from './null-OzIqP7A8.cjs';
+import { ObjectId, Db, Filter } from 'mongodb';
 import { Request, Router } from 'express';
 import Handlebars from 'handlebars';
 import 'ioredis';
 import 'zod';
 
+/**
+ * The mailer:tick handler. Orchestrates all the periodic work that doesn't
+ * fit a delayed-job model: event-trigger scanning, recovery sweep,
+ * scheduled-broadcast dispatch, outbox draining, rollups.
+ */
+
+declare function runTick(ctx: RunnerContext): Promise<void>;
+
+/**
+ * Flow_run state machine. One step transition per `processOneRunStep` call.
+ * Idempotent — optimistic concurrency on `currentStepIndex` means two workers
+ * racing on the same run advance exactly once.
+ */
+
+declare function processOneRunStep(runId: ObjectId, ctx: RunnerContext): Promise<void>;
+
+/**
+ * Send pipeline. `handleSend` is called by the runner state machine; it creates
+ * the Send document and enqueues a mailer:send job. `dispatchSend` is the
+ * worker — re-checks suppression + circuit breaker, applies tracking, calls
+ * the provider, updates the Send row.
+ */
+
+declare function dispatchSend(sendId: ObjectId, ctx: RunnerContext): Promise<void>;
+
+/**
+ * Event-trigger scan. Finds new event firings since each flow's
+ * lastTriggerScanAt watermark, creates flow_runs for matching contacts,
+ * enqueues immediate-advance jobs.
+ */
+
+declare function processNewlyFiredEventTriggers(ctx: RunnerContext): Promise<void>;
+
+/**
+ * Recovery sweep: finds active flow_runs whose `nextActionAt` has passed but
+ * weren't woken by their delayed `mailer:advance` job (worker restart, BullMQ
+ * data loss). Processes each one inline.
+ */
+
+declare function sweepStrandedFlowRuns(ctx: RunnerContext): Promise<void>;
+
+/**
+ * Apply a normalized provider event to the corresponding Send + cascading
+ * suppression / subscription updates. Called from the webhook worker.
+ */
+
+declare function applyWebhookEvent(event: NormalizedEvent, ctx: RunnerContext): Promise<void>;
+
 /**
  * MongoContactAdapter — reads contacts directly from the host's `users`
  * collection (read-mostly; optional narrow tag writes). Mailer never
@@ -157,6 +205,12 @@ interface CompileResult {
 }
 /** Compile MJML → HTML, then derive plain text. Called at template publish time. */
 declare function compileTemplate(mjml: string): Promise<CompileResult>;
+/**
+ * Compile Maily editor JSON (Tiptap-shape) → HTML via `@maily-to/render`, then
+ * derive plain text. Called at template publish time when the template was
+ * authored via the WYSIWYG editor.
+ */
+declare function compileMailyTemplate(content: unknown): Promise<CompileResult>;
 /** Auto-derive plain text from compiled HTML. */
 declare function derivePlaintext(html: string): string;
 interface RenderContext {
@@ -288,4 +342,4 @@ declare const DEDUPE_POLICIES: readonly DedupePolicyOption[];
  */
 declare const VERSION = "0.1.0";
 
-export { AdapterFilter, type AdminRouterOptions, Contact, ContactAdapter, DEDUPE_POLICIES, type DedupePolicyOption, FLOW_STEP_KINDS, FlowStep, type FlowStepKindOption, MailProvider, Mailer, MongoContactAdapter, type MongoContactAdapterOptions, NormalizedEvent, PREDICATE_KINDS, Predicate, type PredicateKind, type PredicateKindOption, type PublicRouterOptions, SEGMENT_FILTER_KINDS, SegmentFilter, type SegmentFilterKind, type SegmentFilterKindOption, SendArgs, SendGridProvider, type SendGridProviderOptions, SendResult, SuppressionScope, TemplateDoc, VERSION, applyTracking, compileTemplate, createAdminRouter, createPublicRouter, defaultFlowStep, defaultPredicate, defaultSegmentFilter, derivePlaintext, predicateKind, renderTemplate, sha256Hex, signUnsubscribeToken, verifyUnsubscribeToken };
+export { AdapterFilter, type AdminRouterOptions, Contact, ContactAdapter, DEDUPE_POLICIES, type DedupePolicyOption, FLOW_STEP_KINDS, FlowStep, type FlowStepKindOption, MailProvider, Mailer, MongoContactAdapter, type MongoContactAdapterOptions, NormalizedEvent, PREDICATE_KINDS, Predicate, type PredicateKind, type PredicateKindOption, type PublicRouterOptions, SEGMENT_FILTER_KINDS, SegmentFilter, type SegmentFilterKind, type SegmentFilterKindOption, SendArgs, SendGridProvider, type SendGridProviderOptions, SendResult, SuppressionScope, TemplateDoc, VERSION, applyTracking, applyWebhookEvent, compileMailyTemplate, compileTemplate, createAdminRouter, createPublicRouter, defaultFlowStep, defaultPredicate, defaultSegmentFilter, derivePlaintext, dispatchSend, predicateKind, processNewlyFiredEventTriggers, processOneRunStep, renderTemplate, runTick, sha256Hex, signUnsubscribeToken, sweepStrandedFlowRuns, verifyUnsubscribeToken };

package/dist/index.d.ts

@@ -1,11 +1,59 @@
-import { C as ContactAdapter, a as Contact, A as AdapterFilter, M as MailProvider, S as SendArgs, b as SendResult, N as NormalizedEvent, c as Mailer, T as TemplateDoc, d as SuppressionScope, F as FlowStep, e as SegmentFilter, P as Predicate } from './null-sygex0Ru.js';
-export { f as AuditLogDoc, B as BroadcastDoc, g as BroadcastStatus, h as CircuitBreakerThresholds, i as Collections, j as ContactTagDoc, E as EventDoc, k as FlowDoc, l as FlowGoal, m as FlowRunDoc, n as FlowRunStatus, o as FlowVersionDoc, H as HealthDoc, p as HealthStatus, L as LeadDoc, q as MailerConfig, r as NullProvider, O as OutboxDoc, R as RedisOptions, s as SegmentDefinition, t as SendDoc, u as SendStatus, v as SubscriptionDoc, w as SubscriptionStatus, x as SuppressionDoc, y as SuppressionReason, z as TemplateKind, D as TemplateVersionDoc, W as WebhookEventDoc, G as ensureIndexes, I as getCollections } from './null-sygex0Ru.js';
-import { Db, Filter } from 'mongodb';
+import { R as RunnerContext, N as NormalizedEvent, C as ContactAdapter, a as Contact, A as AdapterFilter, M as MailProvider, S as SendArgs, b as SendResult, c as Mailer, T as TemplateDoc, d as SuppressionScope, F as FlowStep, e as SegmentFilter, P as Predicate } from './null-OzIqP7A8.js';
+export { f as AuditLogDoc, B as BroadcastDoc, g as BroadcastStatus, h as CircuitBreakerThresholds, i as Collections, j as ContactTagDoc, E as EventDoc, k as FlowDoc, l as FlowGoal, m as FlowRunDoc, n as FlowRunStatus, o as FlowVersionDoc, H as HealthDoc, p as HealthStatus, L as LeadDoc, q as MailerConfig, r as NullProvider, O as OutboxDoc, s as RedisOptions, t as SegmentDefinition, u as SendDoc, v as SendStatus, w as SubscriptionDoc, x as SubscriptionStatus, y as SuppressionDoc, z as SuppressionReason, D as TemplateKind, G as TemplateVersionDoc, W as WebhookEventDoc, I as ensureIndexes, J as getCollections } from './null-OzIqP7A8.js';
+import { ObjectId, Db, Filter } from 'mongodb';
 import { Request, Router } from 'express';
 import Handlebars from 'handlebars';
 import 'ioredis';
 import 'zod';
 
+/**
+ * The mailer:tick handler. Orchestrates all the periodic work that doesn't
+ * fit a delayed-job model: event-trigger scanning, recovery sweep,
+ * scheduled-broadcast dispatch, outbox draining, rollups.
+ */
+
+declare function runTick(ctx: RunnerContext): Promise<void>;
+
+/**
+ * Flow_run state machine. One step transition per `processOneRunStep` call.
+ * Idempotent — optimistic concurrency on `currentStepIndex` means two workers
+ * racing on the same run advance exactly once.
+ */
+
+declare function processOneRunStep(runId: ObjectId, ctx: RunnerContext): Promise<void>;
+
+/**
+ * Send pipeline. `handleSend` is called by the runner state machine; it creates
+ * the Send document and enqueues a mailer:send job. `dispatchSend` is the
+ * worker — re-checks suppression + circuit breaker, applies tracking, calls
+ * the provider, updates the Send row.
+ */
+
+declare function dispatchSend(sendId: ObjectId, ctx: RunnerContext): Promise<void>;
+
+/**
+ * Event-trigger scan. Finds new event firings since each flow's
+ * lastTriggerScanAt watermark, creates flow_runs for matching contacts,
+ * enqueues immediate-advance jobs.
+ */
+
+declare function processNewlyFiredEventTriggers(ctx: RunnerContext): Promise<void>;
+
+/**
+ * Recovery sweep: finds active flow_runs whose `nextActionAt` has passed but
+ * weren't woken by their delayed `mailer:advance` job (worker restart, BullMQ
+ * data loss). Processes each one inline.
+ */
+
+declare function sweepStrandedFlowRuns(ctx: RunnerContext): Promise<void>;
+
+/**
+ * Apply a normalized provider event to the corresponding Send + cascading
+ * suppression / subscription updates. Called from the webhook worker.
+ */
+
+declare function applyWebhookEvent(event: NormalizedEvent, ctx: RunnerContext): Promise<void>;
+
 /**
  * MongoContactAdapter — reads contacts directly from the host's `users`
  * collection (read-mostly; optional narrow tag writes). Mailer never
@@ -157,6 +205,12 @@ interface CompileResult {
 }
 /** Compile MJML → HTML, then derive plain text. Called at template publish time. */
 declare function compileTemplate(mjml: string): Promise<CompileResult>;
+/**
+ * Compile Maily editor JSON (Tiptap-shape) → HTML via `@maily-to/render`, then
+ * derive plain text. Called at template publish time when the template was
+ * authored via the WYSIWYG editor.
+ */
+declare function compileMailyTemplate(content: unknown): Promise<CompileResult>;
 /** Auto-derive plain text from compiled HTML. */
 declare function derivePlaintext(html: string): string;
 interface RenderContext {
@@ -288,4 +342,4 @@ declare const DEDUPE_POLICIES: readonly DedupePolicyOption[];
  */
 declare const VERSION = "0.1.0";
 
-export { AdapterFilter, type AdminRouterOptions, Contact, ContactAdapter, DEDUPE_POLICIES, type DedupePolicyOption, FLOW_STEP_KINDS, FlowStep, type FlowStepKindOption, MailProvider, Mailer, MongoContactAdapter, type MongoContactAdapterOptions, NormalizedEvent, PREDICATE_KINDS, Predicate, type PredicateKind, type PredicateKindOption, type PublicRouterOptions, SEGMENT_FILTER_KINDS, SegmentFilter, type SegmentFilterKind, type SegmentFilterKindOption, SendArgs, SendGridProvider, type SendGridProviderOptions, SendResult, SuppressionScope, TemplateDoc, VERSION, applyTracking, compileTemplate, createAdminRouter, createPublicRouter, defaultFlowStep, defaultPredicate, defaultSegmentFilter, derivePlaintext, predicateKind, renderTemplate, sha256Hex, signUnsubscribeToken, verifyUnsubscribeToken };
+export { AdapterFilter, type AdminRouterOptions, Contact, ContactAdapter, DEDUPE_POLICIES, type DedupePolicyOption, FLOW_STEP_KINDS, FlowStep, type FlowStepKindOption, MailProvider, Mailer, MongoContactAdapter, type MongoContactAdapterOptions, NormalizedEvent, PREDICATE_KINDS, Predicate, type PredicateKind, type PredicateKindOption, type PublicRouterOptions, SEGMENT_FILTER_KINDS, SegmentFilter, type SegmentFilterKind, type SegmentFilterKindOption, SendArgs, SendGridProvider, type SendGridProviderOptions, SendResult, SuppressionScope, TemplateDoc, VERSION, applyTracking, applyWebhookEvent, compileMailyTemplate, compileTemplate, createAdminRouter, createPublicRouter, defaultFlowStep, defaultPredicate, defaultSegmentFilter, derivePlaintext, dispatchSend, predicateKind, processNewlyFiredEventTriggers, processOneRunStep, renderTemplate, runTick, sha256Hex, signUnsubscribeToken, sweepStrandedFlowRuns, verifyUnsubscribeToken };

package/dist/index.js

@@ -3817,6 +3817,6 @@ var DEDUPE_POLICIES = [
 // src/server/index.ts
 var VERSION = "0.1.0";
 
-export { DEDUPE_POLICIES, FLOW_STEP_KINDS, Mailer, MongoContactAdapter, NullProvider, PREDICATE_KINDS, SEGMENT_FILTER_KINDS, SendGridProvider, VERSION, applyTracking, compileTemplate, createAdminRouter, createPublicRouter, defaultFlowStep, defaultPredicate, defaultSegmentFilter, derivePlaintext, ensureIndexes, getCollections, predicateKind, renderTemplate, sha256Hex, signUnsubscribeToken, verifyUnsubscribeToken };
+export { DEDUPE_POLICIES, FLOW_STEP_KINDS, Mailer, MongoContactAdapter, NullProvider, PREDICATE_KINDS, SEGMENT_FILTER_KINDS, SendGridProvider, VERSION, applyTracking, applyWebhookEvent, compileMailyTemplate, compileTemplate, createAdminRouter, createPublicRouter, defaultFlowStep, defaultPredicate, defaultSegmentFilter, derivePlaintext, dispatchSend, ensureIndexes, getCollections, predicateKind, processNewlyFiredEventTriggers, processOneRunStep, renderTemplate, runTick, sha256Hex, signUnsubscribeToken, sweepStrandedFlowRuns, verifyUnsubscribeToken };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map