@growth-labs/mailer 0.1.3

package/dist/utils/scheduling.js

@@ -0,0 +1,110 @@
+import { ulid } from 'ulidx';
+import { sendCampaign, sendDigest } from './send.js';
+import { countSubscribers } from './subscribers.js';
+// ─── Schedule builder ───
+/**
+ * Build a campaign schedule entry.
+ * The consumer stores this in KV/D1/R2 and uses a Cron Trigger to
+ * call `executeCampaignSchedule()` at the appropriate time.
+ *
+ * This is a lightweight helper — it pre-generates the campaignId
+ * and validates the send would have recipients.
+ */
+export async function prepareCampaign(db, params) {
+    const campaignId = ulid();
+    const filter = params.filter ?? { status: ['active'] };
+    if (!filter.status)
+        filter.status = ['active'];
+    const estimatedRecipients = await countSubscribers(db, filter);
+    return {
+        campaignId,
+        subject: params.subject,
+        html: params.html,
+        template: params.template,
+        data: params.data,
+        filter: params.filter,
+        scheduledAt: params.scheduledAt,
+        estimatedRecipients,
+    };
+}
+/**
+ * Build a digest schedule entry with recipient estimate.
+ */
+export async function prepareDigest(db, params) {
+    const campaignId = ulid();
+    const filter = params.filter ?? { status: ['active'] };
+    if (!filter.status)
+        filter.status = ['active'];
+    const estimatedRecipients = await countSubscribers(db, filter);
+    return {
+        campaignId,
+        subject: params.subject,
+        items: params.items,
+        introText: params.introText,
+        filter: params.filter,
+        scheduledAt: params.scheduledAt,
+        estimatedRecipients,
+    };
+}
+// ─── Execute scheduled sends ───
+/**
+ * Execute a previously prepared campaign schedule.
+ * Checks that the scheduled time has arrived before sending.
+ * Returns null if not yet due.
+ */
+export async function executeCampaignSchedule(env, options, schedule) {
+    const now = Date.now();
+    const scheduledTime = new Date(schedule.scheduledAt).getTime();
+    if (scheduledTime > now) {
+        return null;
+    }
+    return sendCampaign(env, options, {
+        subject: schedule.subject,
+        html: schedule.html,
+        template: schedule.template,
+        data: schedule.data,
+        filter: schedule.filter,
+        campaignId: schedule.campaignId,
+    });
+}
+/**
+ * Execute a previously prepared digest schedule.
+ * Checks that the scheduled time has arrived before sending.
+ * Returns null if not yet due.
+ */
+export async function executeDigestSchedule(env, options, schedule) {
+    const now = Date.now();
+    const scheduledTime = new Date(schedule.scheduledAt).getTime();
+    if (scheduledTime > now) {
+        return null;
+    }
+    return sendDigest(env, options, {
+        subject: schedule.subject,
+        items: schedule.items,
+        introText: schedule.introText,
+        filter: schedule.filter,
+        campaignId: schedule.campaignId,
+    });
+}
+/**
+ * Batch send helper: sends a campaign to multiple topic-segmented groups
+ * in a single call. Each segment gets its own campaign ID for tracking.
+ *
+ * Useful for sites that want to send the same content to different
+ * topic segments with different subject lines or intros.
+ */
+export async function sendBatchCampaigns(env, options, segments) {
+    const results = [];
+    for (const segment of segments) {
+        const result = await sendCampaign(env, options, {
+            subject: segment.subject,
+            html: segment.html,
+            template: segment.template,
+            data: segment.data,
+            filter: segment.filter,
+        });
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=scheduling.js.map

package/dist/utils/scheduling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.js","sourceRoot":"","sources":["../../src/utils/scheduling.ts"],"names":[],"mappings":"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"}

package/dist/utils/send.d.ts

@@ -0,0 +1,42 @@
+import { drizzle } from 'drizzle-orm/d1';
+import type { ResolvedMailerOptions } from '../options.js';
+import type { DigestItem, SubscriberFilter, TemplateName } from '../types.js';
+type DrizzleDB = ReturnType<typeof drizzle>;
+export interface MailerEnv {
+    DB: D1Database;
+    QUEUE: Queue;
+}
+export declare function sendTransactional(env: MailerEnv, options: ResolvedMailerOptions, params: {
+    to: string;
+    subscriberId?: string;
+    subject: string;
+    html?: string;
+    template?: TemplateName;
+    data?: Record<string, unknown>;
+}): Promise<{
+    trackingId: string;
+}>;
+export declare function sendCampaign(env: MailerEnv, options: ResolvedMailerOptions, params: {
+    subject: string;
+    html?: string;
+    template?: 'campaign';
+    data?: Record<string, unknown>;
+    filter?: SubscriberFilter;
+    campaignId?: string;
+}): Promise<{
+    campaignId: string;
+    recipientCount: number;
+}>;
+export declare function sendDigest(env: MailerEnv, options: ResolvedMailerOptions, params: {
+    subject: string;
+    items: DigestItem[];
+    introText?: string;
+    filter?: SubscriberFilter;
+    campaignId?: string;
+}): Promise<{
+    campaignId: string;
+    recipientCount: number;
+}>;
+export declare function updateSendStatus(db: DrizzleDB, trackingId: string, status: string, fields?: Record<string, string | null>): Promise<void>;
+export {};
+//# sourceMappingURL=send.d.ts.map

package/dist/utils/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/utils/send.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,KAAK,EACX,UAAU,EAGV,gBAAgB,EAEhB,YAAY,EACZ,MAAM,aAAa,CAAA;AAOpB,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;AAI3C,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,UAAU,CAAA;IACd,KAAK,EAAE,KAAK,CAAA;CACZ;AAID,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE;IACP,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B,GACC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAwDjC;AA8ED,wBAAsB,YAAY,CACjC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE;IACP,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,GACC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCzD;AAID,wBAAsB,UAAU,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE;IACP,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,GACC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BzD;AAID,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/utils/send.js

@@ -0,0 +1,193 @@
+import { eq } from 'drizzle-orm';
+import { drizzle } from 'drizzle-orm/d1';
+import { ulid } from 'ulidx';
+import { emailSends } from '../schema.js';
+import { getSubscriberBatch } from './subscribers.js';
+import { renderDigestItems, renderEmail } from './templates.js';
+import { generateToken } from './tokens.js';
+import { injectTrackingPixel, rewriteLinksForTracking } from './tracking.js';
+import { buildSubscriberManageUrls } from './urls.js';
+// ─── sendTransactional ───
+export async function sendTransactional(env, options, params) {
+    const db = drizzle(env.DB);
+    const trackingId = ulid();
+    const subscriberId = params.subscriberId ?? ulid();
+    // Render HTML
+    let html;
+    if (params.template) {
+        const manageUrls = await buildSubscriberManageUrls(options, params.subscriberId);
+        html = renderEmail(params.template, {
+            ...params.data,
+            senderName: options.senderName,
+            siteUrl: options.siteUrl,
+            unsubscribeUrl: manageUrls.unsubscribeUrl,
+            preferencesUrl: manageUrls.preferencesUrl,
+            brand: options.brand,
+        });
+    }
+    else if (params.html) {
+        html = params.html;
+    }
+    else {
+        throw new Error('Either template or html must be provided');
+    }
+    // Record the send
+    await db.insert(emailSends).values({
+        id: ulid(),
+        subscriberId,
+        email: params.to,
+        subject: params.subject,
+        type: 'transactional',
+        status: 'queued',
+        trackingId,
+        createdAt: new Date().toISOString(),
+    });
+    // Build and enqueue the message
+    const message = {
+        type: 'transactional',
+        recipients: [
+            {
+                email: params.to,
+                subscriberId,
+                trackingId,
+                unsubscribeToken: '',
+                preferencesToken: '',
+            },
+        ],
+        subject: params.subject,
+        htmlTemplate: html,
+        from: `${options.senderName} <${options.fromAddress}>`,
+        replyTo: options.replyTo,
+    };
+    await env.QUEUE.send(message);
+    return { trackingId };
+}
+// ─── Fan-out helper (shared by campaign + digest) ───
+async function fanOutToSubscribers(env, db, options, params) {
+    let cursor = null;
+    let recipientCount = 0;
+    const filter = params.filter ?? { status: ['active'] };
+    if (!filter.status)
+        filter.status = ['active'];
+    while (true) {
+        const batch = await getSubscriberBatch(db, filter, options.batchSize, cursor);
+        if (batch.length === 0)
+            break;
+        const recipients = [];
+        for (const sub of batch) {
+            const trackingId = ulid();
+            const unsubscribeToken = await generateToken(options.signingSecret, {
+                subscriberId: sub.id,
+                action: 'unsubscribe',
+            });
+            const preferencesToken = await generateToken(options.signingSecret, {
+                subscriberId: sub.id,
+                action: 'preferences',
+            });
+            await db.insert(emailSends).values({
+                id: ulid(),
+                subscriberId: sub.id,
+                campaignId: params.campaignId,
+                email: sub.email,
+                subject: params.subject,
+                type: params.type,
+                status: 'queued',
+                trackingId,
+                createdAt: new Date().toISOString(),
+            });
+            recipients.push({
+                email: sub.email,
+                subscriberId: sub.id,
+                trackingId,
+                unsubscribeToken,
+                preferencesToken,
+            });
+        }
+        const message = {
+            type: params.type,
+            recipients,
+            subject: params.subject,
+            htmlTemplate: params.html,
+            from: `${options.senderName} <${options.fromAddress}>`,
+            replyTo: options.replyTo,
+            campaignId: params.campaignId,
+        };
+        await env.QUEUE.send(message);
+        recipientCount += batch.length;
+        cursor = batch[batch.length - 1].id;
+    }
+    return recipientCount;
+}
+// ─── sendCampaign ───
+export async function sendCampaign(env, options, params) {
+    const campaignId = params.campaignId ?? ulid();
+    const db = drizzle(env.DB);
+    // Render HTML
+    let html;
+    if (params.template) {
+        html = renderEmail('campaign', {
+            ...params.data,
+            senderName: options.senderName,
+            siteUrl: options.siteUrl,
+            unsubscribeUrl: '{{UNSUBSCRIBE_URL}}',
+            preferencesUrl: '{{PREFERENCES_URL}}',
+            brand: options.brand,
+        });
+    }
+    else if (params.html) {
+        html = params.html;
+    }
+    else {
+        throw new Error('Either template or html must be provided');
+    }
+    // Inject tracking
+    const trackOpenUrl = `${options.siteUrl}${options.trackOpenPath}`;
+    const trackClickUrl = `${options.siteUrl}${options.trackClickPath}`;
+    html = injectTrackingPixel(html, trackOpenUrl);
+    html = rewriteLinksForTracking(html, trackClickUrl);
+    const recipientCount = await fanOutToSubscribers(env, db, options, {
+        subject: params.subject,
+        html,
+        campaignId,
+        type: 'campaign',
+        filter: params.filter,
+    });
+    return { campaignId, recipientCount };
+}
+// ─── sendDigest ───
+export async function sendDigest(env, options, params) {
+    const campaignId = params.campaignId ?? ulid();
+    const db = drizzle(env.DB);
+    // Render digest items then full template
+    const itemsHtml = renderDigestItems(params.items);
+    let html = renderEmail('digest', {
+        senderName: options.senderName,
+        siteUrl: options.siteUrl,
+        unsubscribeUrl: '{{UNSUBSCRIBE_URL}}',
+        preferencesUrl: '{{PREFERENCES_URL}}',
+        brand: options.brand,
+        introText: params.introText ?? '',
+        digestItems: itemsHtml,
+    });
+    // Inject tracking
+    const trackOpenUrl = `${options.siteUrl}${options.trackOpenPath}`;
+    const trackClickUrl = `${options.siteUrl}${options.trackClickPath}`;
+    html = injectTrackingPixel(html, trackOpenUrl);
+    html = rewriteLinksForTracking(html, trackClickUrl);
+    const recipientCount = await fanOutToSubscribers(env, db, options, {
+        subject: params.subject,
+        html,
+        campaignId,
+        type: 'digest',
+        filter: params.filter,
+    });
+    return { campaignId, recipientCount };
+}
+// ─── updateSendStatus ───
+export async function updateSendStatus(db, trackingId, status, fields) {
+    await db
+        .update(emailSends)
+        .set({ status, ...fields })
+        .where(eq(emailSends.trackingId, trackingId));
+}
+//# sourceMappingURL=send.js.map

package/dist/utils/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/utils/send.ts"],"names":[],"mappings":"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"}

package/dist/utils/subscribers.d.ts

@@ -0,0 +1,23 @@
+import type { drizzle } from 'drizzle-orm/d1';
+import type { Subscriber, SubscriberAttribution, SubscriberFilter } from '../types.js';
+type DrizzleDB = ReturnType<typeof drizzle>;
+export declare function createSubscriber(db: DrizzleDB, params: {
+    email: string;
+    name?: string;
+    source: string;
+    preferences?: string[];
+    attribution?: SubscriberAttribution;
+    doubleOptIn?: boolean;
+}): Promise<{
+    subscriber: Subscriber;
+    isNew: boolean;
+}>;
+export declare function confirmSubscriber(db: DrizzleDB, subscriberId: string): Promise<Subscriber>;
+export declare function unsubscribeSubscriber(db: DrizzleDB, subscriberId: string): Promise<void>;
+export declare function updatePreferences(db: DrizzleDB, subscriberId: string, preferences: string[]): Promise<void>;
+export declare function getSubscriberByEmail(db: DrizzleDB, email: string): Promise<Subscriber | null>;
+export declare function getSubscriberById(db: DrizzleDB, id: string): Promise<Subscriber | null>;
+export declare function getSubscriberBatch(db: DrizzleDB, filter: SubscriberFilter, limit: number, cursor: string | null): Promise<Subscriber[]>;
+export declare function countSubscribers(db: DrizzleDB, filter?: SubscriberFilter): Promise<number>;
+export {};
+//# sourceMappingURL=subscribers.d.ts.map

package/dist/utils/subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/utils/subscribers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAG7C,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEtF,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;AA0B3C,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,GACC,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAkErD;AAID,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBhG;AAID,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AAID,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,SAAS,EACb,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf;AAID,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAK5B;AAID,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAK7F;AAID,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CvB;AAID,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmChG"}

package/dist/utils/subscribers.js

@@ -0,0 +1,200 @@
+import { and, eq, gt, inArray, like, lt, or, sql } from 'drizzle-orm';
+import { ulid } from 'ulidx';
+import { subscribers } from '../schema.js';
+// ─── Helpers ───
+function rowToSubscriber(row) {
+    return {
+        id: row.id,
+        email: row.email,
+        name: row.name ?? undefined,
+        status: row.status,
+        preferences: JSON.parse(row.preferences ?? '[]'),
+        source: row.source,
+        attribution: row.attribution
+            ? JSON.parse(row.attribution)
+            : undefined,
+        softBounceCount: row.softBounceCount ?? 0,
+        subscribedAt: row.subscribedAt,
+        confirmedAt: row.confirmedAt ?? undefined,
+        unsubscribedAt: row.unsubscribedAt ?? undefined,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+// ─── createSubscriber ───
+export async function createSubscriber(db, params) {
+    const doubleOptIn = params.doubleOptIn ?? true;
+    const existing = await db.select().from(subscribers).where(eq(subscribers.email, params.email));
+    if (existing.length > 0) {
+        const row = existing[0];
+        if (row.status === 'active') {
+            return { subscriber: rowToSubscriber(row), isNew: false };
+        }
+        if (row.status === 'pending') {
+            return { subscriber: rowToSubscriber(row), isNew: false };
+        }
+        if (row.status === 'bounced' || row.status === 'complained') {
+            throw new Error('Cannot re-subscribe a bounced or complained address');
+        }
+        // status === 'unsubscribed' → reactivate
+        const now = new Date().toISOString();
+        const newStatus = doubleOptIn ? 'pending' : 'active';
+        const updated = await db
+            .update(subscribers)
+            .set({
+            status: newStatus,
+            subscribedAt: now,
+            unsubscribedAt: null,
+            updatedAt: now,
+        })
+            .where(eq(subscribers.id, row.id))
+            .returning();
+        return {
+            subscriber: rowToSubscriber(updated[0]),
+            isNew: false,
+        };
+    }
+    // New subscriber
+    const now = new Date().toISOString();
+    const id = ulid();
+    const status = doubleOptIn ? 'pending' : 'active';
+    const inserted = await db
+        .insert(subscribers)
+        .values({
+        id,
+        email: params.email,
+        name: params.name ?? null,
+        status,
+        preferences: JSON.stringify(params.preferences ?? []),
+        source: params.source,
+        attribution: params.attribution ? JSON.stringify(params.attribution) : null,
+        softBounceCount: 0,
+        subscribedAt: now,
+        confirmedAt: null,
+        unsubscribedAt: null,
+        createdAt: now,
+        updatedAt: now,
+    })
+        .returning();
+    return { subscriber: rowToSubscriber(inserted[0]), isNew: true };
+}
+// ─── confirmSubscriber ───
+export async function confirmSubscriber(db, subscriberId) {
+    const rows = await db.select().from(subscribers).where(eq(subscribers.id, subscriberId));
+    if (rows.length === 0) {
+        throw new Error('Subscriber not found');
+    }
+    if (rows[0].status !== 'pending') {
+        throw new Error('Subscriber is not in pending status');
+    }
+    const now = new Date().toISOString();
+    const updated = await db
+        .update(subscribers)
+        .set({ status: 'active', confirmedAt: now, updatedAt: now })
+        .where(eq(subscribers.id, subscriberId))
+        .returning();
+    return rowToSubscriber(updated[0]);
+}
+// ─── unsubscribeSubscriber ───
+export async function unsubscribeSubscriber(db, subscriberId) {
+    const now = new Date().toISOString();
+    await db
+        .update(subscribers)
+        .set({
+        status: 'unsubscribed',
+        unsubscribedAt: now,
+        updatedAt: now,
+    })
+        .where(eq(subscribers.id, subscriberId));
+}
+// ─── updatePreferences ───
+export async function updatePreferences(db, subscriberId, preferences) {
+    const now = new Date().toISOString();
+    await db
+        .update(subscribers)
+        .set({
+        preferences: JSON.stringify(preferences),
+        updatedAt: now,
+    })
+        .where(eq(subscribers.id, subscriberId));
+}
+// ─── getSubscriberByEmail ───
+export async function getSubscriberByEmail(db, email) {
+    const rows = await db.select().from(subscribers).where(eq(subscribers.email, email));
+    if (rows.length === 0)
+        return null;
+    return rowToSubscriber(rows[0]);
+}
+// ─── getSubscriberById ───
+export async function getSubscriberById(db, id) {
+    const rows = await db.select().from(subscribers).where(eq(subscribers.id, id));
+    if (rows.length === 0)
+        return null;
+    return rowToSubscriber(rows[0]);
+}
+// ─── getSubscriberBatch ───
+export async function getSubscriberBatch(db, filter, limit, cursor) {
+    const conditions = [];
+    // Status filter (default: active only)
+    const statuses = filter.status ?? ['active'];
+    conditions.push(inArray(subscribers.status, statuses));
+    // Preferences overlap — any match
+    if (filter.preferences && filter.preferences.length > 0) {
+        const prefConditions = filter.preferences.map((pref) => like(subscribers.preferences, `%"${pref}"%`));
+        const prefOr = or(...prefConditions);
+        if (prefOr)
+            conditions.push(prefOr);
+    }
+    // Date range
+    if (filter.subscribedAfter) {
+        conditions.push(gt(subscribers.subscribedAt, filter.subscribedAfter));
+    }
+    if (filter.subscribedBefore) {
+        conditions.push(lt(subscribers.subscribedAt, filter.subscribedBefore));
+    }
+    // Source filter
+    if (filter.source && filter.source.length > 0) {
+        conditions.push(inArray(subscribers.source, filter.source));
+    }
+    // Cursor-based pagination
+    if (cursor) {
+        conditions.push(gt(subscribers.id, cursor));
+    }
+    const rows = await db
+        .select()
+        .from(subscribers)
+        .where(and(...conditions))
+        .orderBy(subscribers.id)
+        .limit(limit);
+    return rows.map(rowToSubscriber);
+}
+// ─── countSubscribers ───
+export async function countSubscribers(db, filter) {
+    const conditions = [];
+    if (filter) {
+        const statuses = filter.status ?? ['active'];
+        conditions.push(inArray(subscribers.status, statuses));
+        if (filter.preferences && filter.preferences.length > 0) {
+            const prefConditions = filter.preferences.map((pref) => like(subscribers.preferences, `%"${pref}"%`));
+            const prefOr = or(...prefConditions);
+            if (prefOr)
+                conditions.push(prefOr);
+        }
+        if (filter.subscribedAfter) {
+            conditions.push(gt(subscribers.subscribedAt, filter.subscribedAfter));
+        }
+        if (filter.subscribedBefore) {
+            conditions.push(lt(subscribers.subscribedAt, filter.subscribedBefore));
+        }
+        if (filter.source && filter.source.length > 0) {
+            conditions.push(inArray(subscribers.source, filter.source));
+        }
+    }
+    const whereClause = conditions.length > 0 ? and(...conditions) : undefined;
+    const result = await db
+        .select({ count: sql `count(*)` })
+        .from(subscribers)
+        .where(whereClause);
+    return result[0].count;
+}
+//# sourceMappingURL=subscribers.js.map

package/dist/utils/subscribers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.js","sourceRoot":"","sources":["../../src/utils/subscribers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAErE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAK1C,kBAAkB;AAElB,SAAS,eAAe,CAAC,GAA4B;IACpD,OAAO;QACN,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,KAAK,EAAE,GAAG,CAAC,KAAe;QAC1B,IAAI,EAAG,GAAG,CAAC,IAAe,IAAI,SAAS;QACvC,MAAM,EAAE,GAAG,CAAC,MAA8B;QAC1C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAE,GAAG,CAAC,WAAsB,IAAI,IAAI,CAAa;QACxE,MAAM,EAAE,GAAG,CAAC,MAAgB;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC3B,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAqB,CAA2B;YAClE,CAAC,CAAC,SAAS;QACZ,eAAe,EAAG,GAAG,CAAC,eAA0B,IAAI,CAAC;QACrD,YAAY,EAAE,GAAG,CAAC,YAAsB;QACxC,WAAW,EAAG,GAAG,CAAC,WAAsB,IAAI,SAAS;QACrD,cAAc,EAAG,GAAG,CAAC,cAAyB,IAAI,SAAS;QAC3D,SAAS,EAAE,GAAG,CAAC,SAAmB;QAClC,SAAS,EAAE,GAAG,CAAC,SAAmB;KAClC,CAAA;AACF,CAAC;AAED,2BAA2B;AAE3B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,EAAa,EACb,MAOC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAA;IAE9C,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAE/F,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAEvB,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QAC1D,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QAC1D,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACvE,CAAC;QAED,yCAAyC;QACzC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACpC,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;QAEpD,MAAM,OAAO,GAAG,MAAM,EAAE;aACtB,MAAM,CAAC,WAAW,CAAC;aACnB,GAAG,CAAC;YACJ,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,GAAG;YACjB,cAAc,EAAE,IAAI;YACpB,SAAS,EAAE,GAAG;SACd,CAAC;aACD,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,EAAY,CAAC,CAAC;aAC3C,SAAS,EAAE,CAAA;QAEb,OAAO;YACN,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,KAAK,EAAE,KAAK;SACZ,CAAA;IACF,CAAC;IAED,iBAAiB;IACjB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAA;IACjB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;IAEjD,MAAM,QAAQ,GAAG,MAAM,EAAE;SACvB,MAAM,CAAC,WAAW,CAAC;SACnB,MAAM,CAAC;QACP,EAAE;QACF,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3E,eAAe,EAAE,CAAC;QAClB,YAAY,EAAE,GAAG;QACjB,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACd,CAAC;SACD,SAAS,EAAE,CAAA;IAEb,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACjE,CAAC;AAED,4BAA4B;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAa,EAAE,YAAoB;IAC1E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAA;IAExF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACvD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAEpC,MAAM,OAAO,GAAG,MAAM,EAAE;SACtB,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;SAC3D,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;SACvC,SAAS,EAAE,CAAA;IAEb,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,gCAAgC;AAEhC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAa,EAAE,YAAoB;IAC9E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAEpC,MAAM,EAAE;SACN,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC;QACJ,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,GAAG;KACd,CAAC;SACD,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,4BAA4B;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,EAAa,EACb,YAAoB,EACpB,WAAqB;IAErB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAEpC,MAAM,EAAE;SACN,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC;QACJ,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QACxC,SAAS,EAAE,GAAG;KACd,CAAC;SACD,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,+BAA+B;AAE/B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,EAAa,EACb,KAAa;IAEb,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IAEpF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC;AAED,4BAA4B;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAa,EAAE,EAAU;IAChE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IAE9E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC;AAED,6BAA6B;AAE7B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,EAAa,EACb,MAAwB,EACxB,KAAa,EACb,MAAqB;IAErB,MAAM,UAAU,GAAG,EAAE,CAAA;IAErB,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5C,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IAEtD,kCAAkC;IAClC,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,CAC5C,CAAA;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,CAAA;QACpC,IAAI,MAAM;YAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,aAAa;IACb,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,EAAE,CAAC;QACZ,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,EAAE;SACnB,MAAM,EAAE;SACR,IAAI,CAAC,WAAW,CAAC;SACjB,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;SACzB,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;SACvB,KAAK,CAAC,KAAK,CAAC,CAAA;IAEd,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;AACjC,CAAC;AAED,2BAA2B;AAE3B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAa,EAAE,MAAyB;IAC9E,MAAM,UAAU,GAAG,EAAE,CAAA;IAErB,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;QAEtD,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,CAC5C,CAAA;YACD,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,CAAA;YACpC,IAAI,MAAM;gBAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpC,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAA;QACtE,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC7B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAA;QACvE,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5D,CAAC;IACF,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE1E,MAAM,MAAM,GAAG,MAAM,EAAE;SACrB,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAQ,UAAU,EAAE,CAAC;SACxC,IAAI,CAAC,WAAW,CAAC;SACjB,KAAK,CAAC,WAAW,CAAC,CAAA;IAEpB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AACvB,CAAC"}

package/dist/utils/templates.d.ts

@@ -0,0 +1,16 @@
+import type { DigestItem, TemplateData, TemplateName } from '../types.js';
+/**
+ * Process {{#key}}...{{/key}} conditional blocks.
+ * If the resolved value is truthy the inner content is kept;
+ * otherwise the entire block (including delimiters) is removed.
+ * Supports nested dot paths like {{#brand.logoUrl}}...{{/brand.logoUrl}}.
+ */
+export declare function processConditionals(template: string, data: Record<string, unknown>): string;
+export declare function interpolate(template: string, data: Record<string, unknown>): string;
+export declare function inlineStyles(html: string, brand?: {
+    primaryColor: string;
+    accentColor: string;
+}): string;
+export declare function renderDigestItems(items: DigestItem[]): string;
+export declare function renderEmail(template: string | TemplateName, data: TemplateData): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/utils/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/utils/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAyEzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQ3F;AAID,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBnF;AAID,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CA0BR;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAsB7D;AAuRD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAYvF"}