@growth-labs/mailer 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +89 -0
- package/dist/components/index.d.ts +3 -0
- package/dist/components/index.d.ts.map +1 -0
- package/dist/components/index.js +3 -0
- package/dist/components/index.js.map +1 -0
- package/dist/index.d.ts +14 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +65 -0
- package/dist/index.js.map +1 -0
- package/dist/middleware/tracking.d.ts +3 -0
- package/dist/middleware/tracking.d.ts.map +1 -0
- package/dist/middleware/tracking.js +13 -0
- package/dist/middleware/tracking.js.map +1 -0
- package/dist/options.d.ts +160 -0
- package/dist/options.d.ts.map +1 -0
- package/dist/options.js +51 -0
- package/dist/options.js.map +1 -0
- package/dist/queue/consumer.d.ts +8 -0
- package/dist/queue/consumer.d.ts.map +1 -0
- package/dist/queue/consumer.js +83 -0
- package/dist/queue/consumer.js.map +1 -0
- package/dist/routes/confirm.d.ts +3 -0
- package/dist/routes/confirm.d.ts.map +1 -0
- package/dist/routes/confirm.js +59 -0
- package/dist/routes/confirm.js.map +1 -0
- package/dist/routes/subscribe.d.ts +3 -0
- package/dist/routes/subscribe.d.ts.map +1 -0
- package/dist/routes/subscribe.js +87 -0
- package/dist/routes/subscribe.js.map +1 -0
- package/dist/routes/track-click.d.ts +3 -0
- package/dist/routes/track-click.d.ts.map +1 -0
- package/dist/routes/track-click.js +45 -0
- package/dist/routes/track-click.js.map +1 -0
- package/dist/routes/track-open.d.ts +3 -0
- package/dist/routes/track-open.d.ts.map +1 -0
- package/dist/routes/track-open.js +40 -0
- package/dist/routes/track-open.js.map +1 -0
- package/dist/routes/unsubscribe.d.ts +4 -0
- package/dist/routes/unsubscribe.d.ts.map +1 -0
- package/dist/routes/unsubscribe.js +81 -0
- package/dist/routes/unsubscribe.js.map +1 -0
- package/dist/routes/webhook.d.ts +3 -0
- package/dist/routes/webhook.d.ts.map +1 -0
- package/dist/routes/webhook.js +30 -0
- package/dist/routes/webhook.js.map +1 -0
- package/dist/schema.d.ts +564 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +47 -0
- package/dist/schema.js.map +1 -0
- package/dist/types.d.ts +106 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/dist/utils/bindings.d.ts +20 -0
- package/dist/utils/bindings.d.ts.map +1 -0
- package/dist/utils/bindings.js +19 -0
- package/dist/utils/bindings.js.map +1 -0
- package/dist/utils/bounce.d.ts +29 -0
- package/dist/utils/bounce.d.ts.map +1 -0
- package/dist/utils/bounce.js +59 -0
- package/dist/utils/bounce.js.map +1 -0
- package/dist/utils/index.d.ts +12 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +9 -0
- package/dist/utils/index.js.map +1 -0
- package/dist/utils/providers.d.ts +31 -0
- package/dist/utils/providers.d.ts.map +1 -0
- package/dist/utils/providers.js +109 -0
- package/dist/utils/providers.js.map +1 -0
- package/dist/utils/scheduling.d.ts +89 -0
- package/dist/utils/scheduling.d.ts.map +1 -0
- package/dist/utils/scheduling.js +110 -0
- package/dist/utils/scheduling.js.map +1 -0
- package/dist/utils/send.d.ts +42 -0
- package/dist/utils/send.d.ts.map +1 -0
- package/dist/utils/send.js +193 -0
- package/dist/utils/send.js.map +1 -0
- package/dist/utils/subscribers.d.ts +23 -0
- package/dist/utils/subscribers.d.ts.map +1 -0
- package/dist/utils/subscribers.js +200 -0
- package/dist/utils/subscribers.js.map +1 -0
- package/dist/utils/templates.d.ts +16 -0
- package/dist/utils/templates.d.ts.map +1 -0
- package/dist/utils/templates.js +426 -0
- package/dist/utils/templates.js.map +1 -0
- package/dist/utils/tokens.d.ts +13 -0
- package/dist/utils/tokens.d.ts.map +1 -0
- package/dist/utils/tokens.js +62 -0
- package/dist/utils/tokens.js.map +1 -0
- package/dist/utils/tracking.d.ts +26 -0
- package/dist/utils/tracking.d.ts.map +1 -0
- package/dist/utils/tracking.js +49 -0
- package/dist/utils/tracking.js.map +1 -0
- package/dist/utils/urls.d.ts +7 -0
- package/dist/utils/urls.d.ts.map +1 -0
- package/dist/utils/urls.js +34 -0
- package/dist/utils/urls.js.map +1 -0
- package/dist/vite-plugin.d.ts +4 -0
- package/dist/vite-plugin.d.ts.map +1 -0
- package/dist/vite-plugin.js +18 -0
- package/dist/vite-plugin.js.map +1 -0
- package/package.json +85 -0
- package/src/astro.d.ts +4 -0
- package/src/components/PreferenceCenter.astro +147 -0
- package/src/components/SubscribeForm.astro +161 -0
- package/src/components/index.ts +2 -0
- package/src/index.ts +101 -0
- package/src/middleware/tracking.ts +18 -0
- package/src/options.ts +65 -0
- package/src/queue/consumer.ts +99 -0
- package/src/routes/confirm.ts +68 -0
- package/src/routes/preferences.astro +137 -0
- package/src/routes/subscribe.ts +107 -0
- package/src/routes/track-click.ts +57 -0
- package/src/routes/track-open.ts +51 -0
- package/src/routes/unsubscribe.ts +96 -0
- package/src/routes/webhook.ts +48 -0
- package/src/schema.ts +56 -0
- package/src/types.ts +145 -0
- package/src/utils/bindings.ts +28 -0
- package/src/utils/bounce.ts +77 -0
- package/src/utils/index.ts +47 -0
- package/src/utils/providers.ts +141 -0
- package/src/utils/scheduling.ts +188 -0
- package/src/utils/send.ts +282 -0
- package/src/utils/subscribers.ts +277 -0
- package/src/utils/templates.ts +459 -0
- package/src/utils/tokens.ts +91 -0
- package/src/utils/tracking.ts +58 -0
- package/src/utils/urls.ts +49 -0
- package/src/virtual.d.ts +32 -0
- package/src/vite-plugin.ts +21 -0
package/README.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# @growth-labs/mailer
|
|
2
|
+
|
|
3
|
+
Queue-based email sending engine for Astro + Cloudflare. Newsletter subscriptions with double opt-in, campaign sending, open/click tracking, unsubscribe management. Uses Cloudflare Queues for async delivery.
|
|
4
|
+
|
|
5
|
+
**"The engine, not the driver."** This package sends emails. What to send and to whom is the consumer's concern (e.g. `@fulcrum/dispatch` layers editorial intelligence on top).
|
|
6
|
+
|
|
7
|
+
If you only need immediate transactional delivery from a Worker with no subscriber state or queueing, use `@growth-labs/email` instead.
|
|
8
|
+
|
|
9
|
+
## Config
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
import mailer from '@growth-labs/mailer'
|
|
13
|
+
|
|
14
|
+
mailer({
|
|
15
|
+
senderName: 'FEDweek',
|
|
16
|
+
fromAddress: 'newsletter@fedweek.com',
|
|
17
|
+
replyTo: 'editors@fedweek.com',
|
|
18
|
+
d1Binding: 'SITE_DB',
|
|
19
|
+
queueBinding: 'EMAIL_QUEUE',
|
|
20
|
+
turnstileSiteKey: '...',
|
|
21
|
+
turnstileSecretKey: '...', // Via Cloudflare Secrets
|
|
22
|
+
doubleOptIn: true,
|
|
23
|
+
topics: ['daily-digest', 'breaking-news'], // Optional topic-based subscriptions
|
|
24
|
+
signingSecret: '...', // HMAC for unsubscribe tokens
|
|
25
|
+
siteUrl: 'https://fedweek.com',
|
|
26
|
+
brand: {
|
|
27
|
+
logoUrl: 'https://media.fedweek.com/logos/email.png',
|
|
28
|
+
primaryColor: '#1a365d',
|
|
29
|
+
accentColor: '#e53e3e',
|
|
30
|
+
footerText: '© FEDweek. All rights reserved.',
|
|
31
|
+
},
|
|
32
|
+
fallbackProvider: 'resend', // 'resend' | 'none'
|
|
33
|
+
resendApiKey: '...', // Via Cloudflare Secrets
|
|
34
|
+
analyticsEnabled: true, // Emit email events to @growth-labs/analytics
|
|
35
|
+
})
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## What It Injects
|
|
39
|
+
|
|
40
|
+
**Routes:**
|
|
41
|
+
- `POST /api/newsletter/subscribe` — Turnstile-protected subscription
|
|
42
|
+
- `GET /api/newsletter/confirm?token=...` — Double opt-in confirmation
|
|
43
|
+
- `GET /api/newsletter/unsubscribe?token=...` — One-click unsubscribe
|
|
44
|
+
- `GET/POST /email/preferences?token=...` — Preference center page
|
|
45
|
+
- `POST /api/newsletter/webhook` — ESP webhook receiver (delivery, bounce, complaint)
|
|
46
|
+
- `GET /api/email/open/:trackingId` — Open tracking pixel
|
|
47
|
+
- `GET /api/email/click/:trackingId` — Click tracking redirect
|
|
48
|
+
|
|
49
|
+
**Components:**
|
|
50
|
+
- `<SubscribeForm />` — Newsletter signup form with Turnstile
|
|
51
|
+
- `<PreferenceCenter />` — Topic subscription management
|
|
52
|
+
|
|
53
|
+
## D1 Tables (prefixed `gl_`)
|
|
54
|
+
|
|
55
|
+
- `gl_subscribers` — subscriber records (email, name, status, topics, confirmed_at)
|
|
56
|
+
- `gl_email_sends` — send log (status: queued → sent → delivered → opened → clicked)
|
|
57
|
+
|
|
58
|
+
## Wrangler Bindings
|
|
59
|
+
|
|
60
|
+
```toml
|
|
61
|
+
[[d1_databases]]
|
|
62
|
+
binding = "SITE_DB"
|
|
63
|
+
database_id = "..."
|
|
64
|
+
|
|
65
|
+
[[queues.producers]]
|
|
66
|
+
binding = "EMAIL_QUEUE"
|
|
67
|
+
queue = "email-sends"
|
|
68
|
+
|
|
69
|
+
[[queues.consumers]]
|
|
70
|
+
queue = "email-sends"
|
|
71
|
+
max_batch_size = 10
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Email Sending Flow
|
|
75
|
+
|
|
76
|
+
1. Consumer calls `sendTransactional()`, `sendCampaign()`, or `sendDigest()` → message enqueued
|
|
77
|
+
2. Queue consumer dequeues → sends via Cloudflare Email (primary) or Resend (fallback)
|
|
78
|
+
3. Status updated in `gl_email_sends`: queued → sent → delivered/bounced
|
|
79
|
+
4. Open/click tracking updates status further
|
|
80
|
+
|
|
81
|
+
## Key Patterns
|
|
82
|
+
|
|
83
|
+
- Virtual module: `virtual:growth-labs/mailer/config`
|
|
84
|
+
- Status never downgrades (sent → delivered → opened → clicked)
|
|
85
|
+
- List-Unsubscribe header on every email (RFC 8058)
|
|
86
|
+
- Turnstile on subscribe endpoint (+ IP rate limiting as backup)
|
|
87
|
+
- Provider failover logged for observability
|
|
88
|
+
- WAE events via `@growth-labs/analytics` writeDataPoint() — fire-and-forget, non-blocking
|
|
89
|
+
- `.astro` component files ship as source, not compiled
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAA"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { AstroIntegration } from 'astro';
|
|
2
|
+
import type { MailerOptions } from './options.js';
|
|
3
|
+
export default function mailer(userOptions: MailerOptions): AstroIntegration;
|
|
4
|
+
export type { MailerOptions, ResolvedMailerOptions } from './options.js';
|
|
5
|
+
export { mailerOptionsSchema } from './options.js';
|
|
6
|
+
export { handleEmailQueue } from './queue/consumer.js';
|
|
7
|
+
export type { DigestItem, EmailProvider, EmailQueueMessage, EmailSend, EmailSendStatus, OutboundEmail, SendResult, Subscriber, SubscriberFilter, SubscriberStatus, TemplateData, TemplateName, } from './types.js';
|
|
8
|
+
export type { CampaignSchedule, DigestSchedule } from './utils/scheduling.js';
|
|
9
|
+
export { executeCampaignSchedule, executeDigestSchedule, prepareCampaign, prepareDigest, sendBatchCampaigns, } from './utils/scheduling.js';
|
|
10
|
+
export type { MailerEnv } from './utils/send.js';
|
|
11
|
+
export { sendCampaign, sendDigest, sendTransactional } from './utils/send.js';
|
|
12
|
+
export { countSubscribers, createSubscriber, getSubscriberByEmail, getSubscriberById, } from './utils/subscribers.js';
|
|
13
|
+
export { renderEmail } from './utils/templates.js';
|
|
14
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,cAAc,CAAA;AAIxE,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,WAAW,EAAE,aAAa,GAAG,gBAAgB,CA0D3E;AAED,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EACX,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACZ,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,kBAAkB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC7E,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { mailerOptionsSchema } from './options.js';
|
|
2
|
+
import { growthLabsMailerPlugin } from './vite-plugin.js';
|
|
3
|
+
export default function mailer(userOptions) {
|
|
4
|
+
const options = mailerOptionsSchema.parse(userOptions);
|
|
5
|
+
return {
|
|
6
|
+
name: '@growth-labs/mailer',
|
|
7
|
+
hooks: {
|
|
8
|
+
'astro:config:setup': ({ injectRoute, addMiddleware, updateConfig, config: astroConfig }) => {
|
|
9
|
+
// Auto-detect @growth-labs/analytics
|
|
10
|
+
const hasAnalytics = astroConfig.integrations.some((i) => i.name === '@growth-labs/analytics');
|
|
11
|
+
if (hasAnalytics) {
|
|
12
|
+
;
|
|
13
|
+
options.analyticsEnabled = true;
|
|
14
|
+
}
|
|
15
|
+
// Install Vite plugin for virtual module
|
|
16
|
+
updateConfig({
|
|
17
|
+
vite: { plugins: [growthLabsMailerPlugin(options)] },
|
|
18
|
+
});
|
|
19
|
+
// Inject routes
|
|
20
|
+
injectRoute({
|
|
21
|
+
pattern: options.subscribePath,
|
|
22
|
+
entrypoint: '@growth-labs/mailer/routes/subscribe',
|
|
23
|
+
});
|
|
24
|
+
injectRoute({
|
|
25
|
+
pattern: options.confirmPath,
|
|
26
|
+
entrypoint: '@growth-labs/mailer/routes/confirm',
|
|
27
|
+
});
|
|
28
|
+
injectRoute({
|
|
29
|
+
pattern: options.unsubscribePath,
|
|
30
|
+
entrypoint: '@growth-labs/mailer/routes/unsubscribe',
|
|
31
|
+
});
|
|
32
|
+
injectRoute({
|
|
33
|
+
pattern: options.preferencesPath,
|
|
34
|
+
entrypoint: '@growth-labs/mailer/routes/preferences',
|
|
35
|
+
});
|
|
36
|
+
injectRoute({
|
|
37
|
+
pattern: options.webhookPath,
|
|
38
|
+
entrypoint: '@growth-labs/mailer/routes/webhook',
|
|
39
|
+
});
|
|
40
|
+
injectRoute({
|
|
41
|
+
pattern: `${options.trackOpenPath}/[trackingId]`,
|
|
42
|
+
entrypoint: '@growth-labs/mailer/routes/track-open',
|
|
43
|
+
});
|
|
44
|
+
injectRoute({
|
|
45
|
+
pattern: `${options.trackClickPath}/[trackingId]`,
|
|
46
|
+
entrypoint: '@growth-labs/mailer/routes/track-click',
|
|
47
|
+
});
|
|
48
|
+
// Add tracking middleware
|
|
49
|
+
addMiddleware({
|
|
50
|
+
entrypoint: '@growth-labs/mailer/middleware/tracking',
|
|
51
|
+
order: 'post',
|
|
52
|
+
});
|
|
53
|
+
},
|
|
54
|
+
},
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
// Re-export options and types
|
|
58
|
+
export { mailerOptionsSchema } from './options.js';
|
|
59
|
+
export { handleEmailQueue } from './queue/consumer.js';
|
|
60
|
+
export { executeCampaignSchedule, executeDigestSchedule, prepareCampaign, prepareDigest, sendBatchCampaigns, } from './utils/scheduling.js';
|
|
61
|
+
// Re-export utilities for standalone use
|
|
62
|
+
export { sendCampaign, sendDigest, sendTransactional } from './utils/send.js';
|
|
63
|
+
export { countSubscribers, createSubscriber, getSubscriberByEmail, getSubscriberById, } from './utils/subscribers.js';
|
|
64
|
+
export { renderEmail } from './utils/templates.js';
|
|
65
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,WAA0B;IACxD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAA0B,CAAA;IAE/E,OAAO;QACN,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE;YACN,oBAAoB,EAAE,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;gBAC3F,qCAAqC;gBACrC,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAC1C,CAAA;gBACD,IAAI,YAAY,EAAE,CAAC;oBAClB,CAAC;oBAAC,OAAmC,CAAC,gBAAgB,GAAG,IAAI,CAAA;gBAC9D,CAAC;gBAED,yCAAyC;gBACzC,YAAY,CAAC;oBACZ,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,EAAE;iBACpD,CAAC,CAAA;gBAEF,gBAAgB;gBAChB,WAAW,CAAC;oBACX,OAAO,EAAE,OAAO,CAAC,aAAa;oBAC9B,UAAU,EAAE,sCAAsC;iBAClD,CAAC,CAAA;gBACF,WAAW,CAAC;oBACX,OAAO,EAAE,OAAO,CAAC,WAAW;oBAC5B,UAAU,EAAE,oCAAoC;iBAChD,CAAC,CAAA;gBACF,WAAW,CAAC;oBACX,OAAO,EAAE,OAAO,CAAC,eAAe;oBAChC,UAAU,EAAE,wCAAwC;iBACpD,CAAC,CAAA;gBACF,WAAW,CAAC;oBACX,OAAO,EAAE,OAAO,CAAC,eAAe;oBAChC,UAAU,EAAE,wCAAwC;iBACpD,CAAC,CAAA;gBACF,WAAW,CAAC;oBACX,OAAO,EAAE,OAAO,CAAC,WAAW;oBAC5B,UAAU,EAAE,oCAAoC;iBAChD,CAAC,CAAA;gBACF,WAAW,CAAC;oBACX,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,eAAe;oBAChD,UAAU,EAAE,uCAAuC;iBACnD,CAAC,CAAA;gBACF,WAAW,CAAC;oBACX,OAAO,EAAE,GAAG,OAAO,CAAC,cAAc,eAAe;oBACjD,UAAU,EAAE,wCAAwC;iBACpD,CAAC,CAAA;gBAEF,0BAA0B;gBAC1B,aAAa,CAAC;oBACb,UAAU,EAAE,yCAAyC;oBACrD,KAAK,EAAE,MAAM;iBACb,CAAC,CAAA;YACH,CAAC;SACD;KACD,CAAA;AACF,CAAC;AAGD,8BAA8B;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAgBtD,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,kBAAkB,GAClB,MAAM,uBAAuB,CAAA;AAE9B,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC7E,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/middleware/tracking.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAE9C,eAAO,MAAM,SAAS,EAAE,iBAcvB,CAAA"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { config } from 'virtual:growth-labs/mailer/config';
|
|
2
|
+
export const onRequest = async (_context, next) => {
|
|
3
|
+
const response = await next();
|
|
4
|
+
const url = new URL(_context.request.url);
|
|
5
|
+
if (url.pathname.startsWith(config.trackOpenPath) ||
|
|
6
|
+
url.pathname.startsWith(config.trackClickPath)) {
|
|
7
|
+
response.headers.set('Cache-Control', 'no-store, no-cache, must-revalidate');
|
|
8
|
+
response.headers.delete('ETag');
|
|
9
|
+
response.headers.delete('Last-Modified');
|
|
10
|
+
}
|
|
11
|
+
return response;
|
|
12
|
+
};
|
|
13
|
+
//# sourceMappingURL=tracking.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../src/middleware/tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAA;AAG1D,MAAM,CAAC,MAAM,SAAS,GAAsB,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAA;IAC7B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAEzC,IACC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC;QAC7C,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,EAC7C,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,qCAAqC,CAAC,CAAA;QAC5E,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC/B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,QAAQ,CAAA;AAChB,CAAC,CAAA"}
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const mailerOptionsSchema: z.ZodEffects<z.ZodObject<{
|
|
3
|
+
senderName: z.ZodString;
|
|
4
|
+
fromAddress: z.ZodString;
|
|
5
|
+
replyTo: z.ZodOptional<z.ZodString>;
|
|
6
|
+
d1Binding: z.ZodDefault<z.ZodString>;
|
|
7
|
+
queueBinding: z.ZodDefault<z.ZodString>;
|
|
8
|
+
turnstileSiteKey: z.ZodString;
|
|
9
|
+
turnstileSecretKey: z.ZodString;
|
|
10
|
+
doubleOptIn: z.ZodDefault<z.ZodBoolean>;
|
|
11
|
+
topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
12
|
+
signingSecret: z.ZodString;
|
|
13
|
+
subscribePath: z.ZodDefault<z.ZodString>;
|
|
14
|
+
confirmPath: z.ZodDefault<z.ZodString>;
|
|
15
|
+
unsubscribePath: z.ZodDefault<z.ZodString>;
|
|
16
|
+
preferencesPath: z.ZodDefault<z.ZodString>;
|
|
17
|
+
webhookPath: z.ZodDefault<z.ZodString>;
|
|
18
|
+
trackOpenPath: z.ZodDefault<z.ZodString>;
|
|
19
|
+
trackClickPath: z.ZodDefault<z.ZodString>;
|
|
20
|
+
siteUrl: z.ZodString;
|
|
21
|
+
brand: z.ZodDefault<z.ZodObject<{
|
|
22
|
+
logoUrl: z.ZodOptional<z.ZodString>;
|
|
23
|
+
primaryColor: z.ZodDefault<z.ZodString>;
|
|
24
|
+
accentColor: z.ZodDefault<z.ZodString>;
|
|
25
|
+
footerText: z.ZodOptional<z.ZodString>;
|
|
26
|
+
}, "strip", z.ZodTypeAny, {
|
|
27
|
+
primaryColor: string;
|
|
28
|
+
accentColor: string;
|
|
29
|
+
logoUrl?: string | undefined;
|
|
30
|
+
footerText?: string | undefined;
|
|
31
|
+
}, {
|
|
32
|
+
logoUrl?: string | undefined;
|
|
33
|
+
primaryColor?: string | undefined;
|
|
34
|
+
accentColor?: string | undefined;
|
|
35
|
+
footerText?: string | undefined;
|
|
36
|
+
}>>;
|
|
37
|
+
fallbackProvider: z.ZodDefault<z.ZodEnum<["resend", "none"]>>;
|
|
38
|
+
resendApiKey: z.ZodOptional<z.ZodString>;
|
|
39
|
+
batchSize: z.ZodDefault<z.ZodNumber>;
|
|
40
|
+
analyticsEnabled: z.ZodDefault<z.ZodBoolean>;
|
|
41
|
+
}, "strip", z.ZodTypeAny, {
|
|
42
|
+
senderName: string;
|
|
43
|
+
fromAddress: string;
|
|
44
|
+
d1Binding: string;
|
|
45
|
+
queueBinding: string;
|
|
46
|
+
turnstileSiteKey: string;
|
|
47
|
+
turnstileSecretKey: string;
|
|
48
|
+
doubleOptIn: boolean;
|
|
49
|
+
signingSecret: string;
|
|
50
|
+
subscribePath: string;
|
|
51
|
+
confirmPath: string;
|
|
52
|
+
unsubscribePath: string;
|
|
53
|
+
preferencesPath: string;
|
|
54
|
+
webhookPath: string;
|
|
55
|
+
trackOpenPath: string;
|
|
56
|
+
trackClickPath: string;
|
|
57
|
+
siteUrl: string;
|
|
58
|
+
brand: {
|
|
59
|
+
primaryColor: string;
|
|
60
|
+
accentColor: string;
|
|
61
|
+
logoUrl?: string | undefined;
|
|
62
|
+
footerText?: string | undefined;
|
|
63
|
+
};
|
|
64
|
+
fallbackProvider: "resend" | "none";
|
|
65
|
+
batchSize: number;
|
|
66
|
+
analyticsEnabled: boolean;
|
|
67
|
+
replyTo?: string | undefined;
|
|
68
|
+
topics?: string[] | undefined;
|
|
69
|
+
resendApiKey?: string | undefined;
|
|
70
|
+
}, {
|
|
71
|
+
senderName: string;
|
|
72
|
+
fromAddress: string;
|
|
73
|
+
turnstileSiteKey: string;
|
|
74
|
+
turnstileSecretKey: string;
|
|
75
|
+
signingSecret: string;
|
|
76
|
+
siteUrl: string;
|
|
77
|
+
replyTo?: string | undefined;
|
|
78
|
+
d1Binding?: string | undefined;
|
|
79
|
+
queueBinding?: string | undefined;
|
|
80
|
+
doubleOptIn?: boolean | undefined;
|
|
81
|
+
topics?: string[] | undefined;
|
|
82
|
+
subscribePath?: string | undefined;
|
|
83
|
+
confirmPath?: string | undefined;
|
|
84
|
+
unsubscribePath?: string | undefined;
|
|
85
|
+
preferencesPath?: string | undefined;
|
|
86
|
+
webhookPath?: string | undefined;
|
|
87
|
+
trackOpenPath?: string | undefined;
|
|
88
|
+
trackClickPath?: string | undefined;
|
|
89
|
+
brand?: {
|
|
90
|
+
logoUrl?: string | undefined;
|
|
91
|
+
primaryColor?: string | undefined;
|
|
92
|
+
accentColor?: string | undefined;
|
|
93
|
+
footerText?: string | undefined;
|
|
94
|
+
} | undefined;
|
|
95
|
+
fallbackProvider?: "resend" | "none" | undefined;
|
|
96
|
+
resendApiKey?: string | undefined;
|
|
97
|
+
batchSize?: number | undefined;
|
|
98
|
+
analyticsEnabled?: boolean | undefined;
|
|
99
|
+
}>, {
|
|
100
|
+
senderName: string;
|
|
101
|
+
fromAddress: string;
|
|
102
|
+
d1Binding: string;
|
|
103
|
+
queueBinding: string;
|
|
104
|
+
turnstileSiteKey: string;
|
|
105
|
+
turnstileSecretKey: string;
|
|
106
|
+
doubleOptIn: boolean;
|
|
107
|
+
signingSecret: string;
|
|
108
|
+
subscribePath: string;
|
|
109
|
+
confirmPath: string;
|
|
110
|
+
unsubscribePath: string;
|
|
111
|
+
preferencesPath: string;
|
|
112
|
+
webhookPath: string;
|
|
113
|
+
trackOpenPath: string;
|
|
114
|
+
trackClickPath: string;
|
|
115
|
+
siteUrl: string;
|
|
116
|
+
brand: {
|
|
117
|
+
primaryColor: string;
|
|
118
|
+
accentColor: string;
|
|
119
|
+
logoUrl?: string | undefined;
|
|
120
|
+
footerText?: string | undefined;
|
|
121
|
+
};
|
|
122
|
+
fallbackProvider: "resend" | "none";
|
|
123
|
+
batchSize: number;
|
|
124
|
+
analyticsEnabled: boolean;
|
|
125
|
+
replyTo?: string | undefined;
|
|
126
|
+
topics?: string[] | undefined;
|
|
127
|
+
resendApiKey?: string | undefined;
|
|
128
|
+
}, {
|
|
129
|
+
senderName: string;
|
|
130
|
+
fromAddress: string;
|
|
131
|
+
turnstileSiteKey: string;
|
|
132
|
+
turnstileSecretKey: string;
|
|
133
|
+
signingSecret: string;
|
|
134
|
+
siteUrl: string;
|
|
135
|
+
replyTo?: string | undefined;
|
|
136
|
+
d1Binding?: string | undefined;
|
|
137
|
+
queueBinding?: string | undefined;
|
|
138
|
+
doubleOptIn?: boolean | undefined;
|
|
139
|
+
topics?: string[] | undefined;
|
|
140
|
+
subscribePath?: string | undefined;
|
|
141
|
+
confirmPath?: string | undefined;
|
|
142
|
+
unsubscribePath?: string | undefined;
|
|
143
|
+
preferencesPath?: string | undefined;
|
|
144
|
+
webhookPath?: string | undefined;
|
|
145
|
+
trackOpenPath?: string | undefined;
|
|
146
|
+
trackClickPath?: string | undefined;
|
|
147
|
+
brand?: {
|
|
148
|
+
logoUrl?: string | undefined;
|
|
149
|
+
primaryColor?: string | undefined;
|
|
150
|
+
accentColor?: string | undefined;
|
|
151
|
+
footerText?: string | undefined;
|
|
152
|
+
} | undefined;
|
|
153
|
+
fallbackProvider?: "resend" | "none" | undefined;
|
|
154
|
+
resendApiKey?: string | undefined;
|
|
155
|
+
batchSize?: number | undefined;
|
|
156
|
+
analyticsEnabled?: boolean | undefined;
|
|
157
|
+
}>;
|
|
158
|
+
export type MailerOptions = z.input<typeof mailerOptionsSchema>;
|
|
159
|
+
export type ResolvedMailerOptions = z.output<typeof mailerOptionsSchema>;
|
|
160
|
+
//# sourceMappingURL=options.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2D7B,CAAA;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAA"}
|
package/dist/options.js
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export const mailerOptionsSchema = z
|
|
3
|
+
.object({
|
|
4
|
+
// ─── Required ───
|
|
5
|
+
senderName: z.string(),
|
|
6
|
+
fromAddress: z.string().email(),
|
|
7
|
+
// ─── Reply-to ───
|
|
8
|
+
replyTo: z.string().email().optional(),
|
|
9
|
+
// ─── Cloudflare bindings ───
|
|
10
|
+
d1Binding: z.string().default('SITE_DB'),
|
|
11
|
+
queueBinding: z.string().default('EMAIL_QUEUE'),
|
|
12
|
+
// ─── Turnstile (subscribe form) ───
|
|
13
|
+
turnstileSiteKey: z.string(),
|
|
14
|
+
turnstileSecretKey: z.string(),
|
|
15
|
+
// ─── Subscriber lifecycle ───
|
|
16
|
+
doubleOptIn: z.boolean().default(true),
|
|
17
|
+
topics: z.array(z.string()).optional(),
|
|
18
|
+
// ─── Token signing ───
|
|
19
|
+
signingSecret: z.string(),
|
|
20
|
+
// ─── Routes ───
|
|
21
|
+
subscribePath: z.string().default('/api/newsletter/subscribe'),
|
|
22
|
+
confirmPath: z.string().default('/api/newsletter/confirm'),
|
|
23
|
+
unsubscribePath: z.string().default('/api/newsletter/unsubscribe'),
|
|
24
|
+
preferencesPath: z.string().default('/email/preferences'),
|
|
25
|
+
webhookPath: z.string().default('/api/email/webhook'),
|
|
26
|
+
// ─── Tracking ───
|
|
27
|
+
trackOpenPath: z.string().default('/api/email/open'),
|
|
28
|
+
trackClickPath: z.string().default('/api/email/click'),
|
|
29
|
+
siteUrl: z.string().url(),
|
|
30
|
+
// ─── Branding (for built-in templates) ───
|
|
31
|
+
brand: z
|
|
32
|
+
.object({
|
|
33
|
+
logoUrl: z.string().url().optional(),
|
|
34
|
+
primaryColor: z.string().default('#1a365d'),
|
|
35
|
+
accentColor: z.string().default('#e53e3e'),
|
|
36
|
+
footerText: z.string().optional(),
|
|
37
|
+
})
|
|
38
|
+
.default({}),
|
|
39
|
+
// ─── Fallback provider ───
|
|
40
|
+
fallbackProvider: z.enum(['resend', 'none']).default('none'),
|
|
41
|
+
resendApiKey: z.string().optional(),
|
|
42
|
+
// ─── Queue batching ───
|
|
43
|
+
batchSize: z.number().min(1).max(500).default(100),
|
|
44
|
+
// ─── Optional peer: analytics ───
|
|
45
|
+
analyticsEnabled: z.boolean().default(false),
|
|
46
|
+
})
|
|
47
|
+
.refine((data) => data.fallbackProvider !== 'resend' || data.resendApiKey, {
|
|
48
|
+
message: 'resendApiKey is required when fallbackProvider is "resend"',
|
|
49
|
+
path: ['resendApiKey'],
|
|
50
|
+
});
|
|
51
|
+
//# sourceMappingURL=options.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ResolvedMailerOptions } from '../options.js';
|
|
2
|
+
import type { EmailQueueMessage } from '../types.js';
|
|
3
|
+
import type { CloudflareEmailSender } from '../utils/providers.js';
|
|
4
|
+
export declare function handleEmailQueue(batch: MessageBatch<EmailQueueMessage>, env: {
|
|
5
|
+
DB: D1Database;
|
|
6
|
+
EMAIL_SENDER?: CloudflareEmailSender;
|
|
7
|
+
}, options: ResolvedMailerOptions): Promise<void>;
|
|
8
|
+
//# sourceMappingURL=consumer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/queue/consumer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAGlE,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,YAAY,CAAC,iBAAiB,CAAC,EACtC,GAAG,EAAE;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,YAAY,CAAC,EAAE,qBAAqB,CAAA;CAAE,EAC7D,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAuFf"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { drizzle } from 'drizzle-orm/d1';
|
|
2
|
+
import { updateSendStatus } from '../utils/bounce.js';
|
|
3
|
+
import { CloudflareEmailProvider, getFallbackProvider, sleep } from '../utils/providers.js';
|
|
4
|
+
export async function handleEmailQueue(batch, env, options) {
|
|
5
|
+
const db = drizzle(env.DB);
|
|
6
|
+
const provider = env.EMAIL_SENDER
|
|
7
|
+
? new CloudflareEmailProvider(env.EMAIL_SENDER)
|
|
8
|
+
: new CloudflareEmailProvider({
|
|
9
|
+
send: () => Promise.reject(new Error('No email sender configured')),
|
|
10
|
+
});
|
|
11
|
+
const fallback = getFallbackProvider(options);
|
|
12
|
+
for (const message of batch.messages) {
|
|
13
|
+
const { recipients, htmlTemplate, subject, from, replyTo, headers, type } = message.body;
|
|
14
|
+
for (const recipient of recipients) {
|
|
15
|
+
let html = htmlTemplate;
|
|
16
|
+
if (type !== 'transactional') {
|
|
17
|
+
const unsubscribeUrl = `${options.siteUrl}${options.unsubscribePath}?token=${recipient.unsubscribeToken}`;
|
|
18
|
+
const preferencesUrl = `${options.siteUrl}${options.preferencesPath}?token=${recipient.preferencesToken}`;
|
|
19
|
+
html = html
|
|
20
|
+
.replaceAll('{{TRACKING_ID}}', recipient.trackingId)
|
|
21
|
+
.replaceAll('{{UNSUBSCRIBE_URL}}', unsubscribeUrl)
|
|
22
|
+
.replaceAll('{{PREFERENCES_URL}}', preferencesUrl);
|
|
23
|
+
}
|
|
24
|
+
const recipientHeaders = type !== 'transactional'
|
|
25
|
+
? {
|
|
26
|
+
...headers,
|
|
27
|
+
'List-Unsubscribe': `<${options.siteUrl}${options.unsubscribePath}?token=${recipient.unsubscribeToken}>`,
|
|
28
|
+
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
|
|
29
|
+
}
|
|
30
|
+
: headers;
|
|
31
|
+
let result = await provider.send({
|
|
32
|
+
to: recipient.email,
|
|
33
|
+
from,
|
|
34
|
+
replyTo,
|
|
35
|
+
subject,
|
|
36
|
+
html,
|
|
37
|
+
headers: recipientHeaders,
|
|
38
|
+
});
|
|
39
|
+
if (!result.success && result.retryable) {
|
|
40
|
+
for (let attempt = 1; attempt <= 3; attempt++) {
|
|
41
|
+
await sleep(2 ** attempt * 1000);
|
|
42
|
+
result = await provider.send({
|
|
43
|
+
to: recipient.email,
|
|
44
|
+
from,
|
|
45
|
+
replyTo,
|
|
46
|
+
subject,
|
|
47
|
+
html,
|
|
48
|
+
headers: recipientHeaders,
|
|
49
|
+
});
|
|
50
|
+
if (result.success)
|
|
51
|
+
break;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
if (!result.success && fallback) {
|
|
55
|
+
result = await fallback.send({
|
|
56
|
+
to: recipient.email,
|
|
57
|
+
from,
|
|
58
|
+
replyTo,
|
|
59
|
+
subject,
|
|
60
|
+
html,
|
|
61
|
+
headers: recipientHeaders,
|
|
62
|
+
});
|
|
63
|
+
if (result.success) {
|
|
64
|
+
console.warn(`[mailer] Fallback provider used for ${recipient.email}: ${provider.name} → ${fallback.name}`);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
if (result.success) {
|
|
68
|
+
await updateSendStatus(db, recipient.trackingId, 'sent', {
|
|
69
|
+
sentAt: new Date().toISOString(),
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
else {
|
|
73
|
+
await updateSendStatus(db, recipient.trackingId, 'bounced', {
|
|
74
|
+
bouncedAt: new Date().toISOString(),
|
|
75
|
+
bounceType: 'hard',
|
|
76
|
+
});
|
|
77
|
+
console.error(`[mailer] Send failed for ${recipient.email}: ${result.error}`);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
message.ack();
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
//# sourceMappingURL=consumer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consumer.js","sourceRoot":"","sources":["../../src/queue/consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAGxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAE3F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,KAAsC,EACtC,GAA6D,EAC7D,OAA8B;IAE9B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,MAAM,QAAQ,GAAkB,GAAG,CAAC,YAAY;QAC/C,CAAC,CAAC,IAAI,uBAAuB,CAAC,GAAG,CAAC,YAAY,CAAC;QAC/C,CAAC,CAAC,IAAI,uBAAuB,CAAC;YAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;SACnE,CAAC,CAAA;IACJ,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAE7C,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAA;QAExF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,IAAI,IAAI,GAAG,YAAY,CAAA;YACvB,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC9B,MAAM,cAAc,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,eAAe,UAAU,SAAS,CAAC,gBAAgB,EAAE,CAAA;gBACzG,MAAM,cAAc,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,eAAe,UAAU,SAAS,CAAC,gBAAgB,EAAE,CAAA;gBACzG,IAAI,GAAG,IAAI;qBACT,UAAU,CAAC,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC;qBACnD,UAAU,CAAC,qBAAqB,EAAE,cAAc,CAAC;qBACjD,UAAU,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAA;YACpD,CAAC;YAED,MAAM,gBAAgB,GACrB,IAAI,KAAK,eAAe;gBACvB,CAAC,CAAC;oBACA,GAAG,OAAO;oBACV,kBAAkB,EAAE,IAAI,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,eAAe,UAAU,SAAS,CAAC,gBAAgB,GAAG;oBACxG,uBAAuB,EAAE,4BAA4B;iBACrD;gBACF,CAAC,CAAC,OAAO,CAAA;YAEX,IAAI,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;gBAChC,EAAE,EAAE,SAAS,CAAC,KAAK;gBACnB,IAAI;gBACJ,OAAO;gBACP,OAAO;gBACP,IAAI;gBACJ,OAAO,EAAE,gBAAgB;aACzB,CAAC,CAAA;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACzC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;oBAC/C,MAAM,KAAK,CAAC,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,CAAA;oBAChC,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;wBAC5B,EAAE,EAAE,SAAS,CAAC,KAAK;wBACnB,IAAI;wBACJ,OAAO;wBACP,OAAO;wBACP,IAAI;wBACJ,OAAO,EAAE,gBAAgB;qBACzB,CAAC,CAAA;oBACF,IAAI,MAAM,CAAC,OAAO;wBAAE,MAAK;gBAC1B,CAAC;YACF,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;gBACjC,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;oBAC5B,EAAE,EAAE,SAAS,CAAC,KAAK;oBACnB,IAAI;oBACJ,OAAO;oBACP,OAAO;oBACP,IAAI;oBACJ,OAAO,EAAE,gBAAgB;iBACzB,CAAC,CAAA;gBACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CACX,uCAAuC,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,CAC7F,CAAA;gBACF,CAAC;YACF,CAAC;YAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,gBAAgB,CAAC,EAAE,EAAE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE;oBACxD,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBAChC,CAAC,CAAA;YACH,CAAC;iBAAM,CAAC;gBACP,MAAM,gBAAgB,CAAC,EAAE,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE;oBAC3D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,UAAU,EAAE,MAAM;iBAClB,CAAC,CAAA;gBACF,OAAO,CAAC,KAAK,CAAC,4BAA4B,SAAS,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;YAC9E,CAAC;QACF,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAA;IACd,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../src/routes/confirm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQrC,eAAO,MAAM,GAAG,EAAE,QA0DjB,CAAA"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { config } from 'virtual:growth-labs/mailer/config';
|
|
2
|
+
import { drizzle } from 'drizzle-orm/d1';
|
|
3
|
+
import { sendTransactional } from '../utils/send.js';
|
|
4
|
+
import { confirmSubscriber, getSubscriberById } from '../utils/subscribers.js';
|
|
5
|
+
import { verifyToken } from '../utils/tokens.js';
|
|
6
|
+
export const GET = async ({ url, locals }) => {
|
|
7
|
+
const token = url.searchParams.get('token');
|
|
8
|
+
if (!token) {
|
|
9
|
+
return Response.json({ error: 'Missing token' }, { status: 400 });
|
|
10
|
+
}
|
|
11
|
+
// Verify token
|
|
12
|
+
const payload = await verifyToken(config.signingSecret, token);
|
|
13
|
+
if (!payload || payload.action !== 'confirm') {
|
|
14
|
+
return Response.json({ error: 'Invalid or expired token' }, { status: 400 });
|
|
15
|
+
}
|
|
16
|
+
// Resolve bindings
|
|
17
|
+
const runtimeEnv = locals.runtime?.env;
|
|
18
|
+
const d1 = runtimeEnv[config.d1Binding];
|
|
19
|
+
const queue = runtimeEnv[config.queueBinding];
|
|
20
|
+
const db = drizzle(d1);
|
|
21
|
+
const env = { DB: d1, QUEUE: queue };
|
|
22
|
+
// Get subscriber to check status
|
|
23
|
+
const subscriber = await getSubscriberById(db, payload.subscriberId);
|
|
24
|
+
if (!subscriber) {
|
|
25
|
+
return Response.json({ error: 'Subscriber not found' }, { status: 404 });
|
|
26
|
+
}
|
|
27
|
+
if (subscriber.status === 'active') {
|
|
28
|
+
// Already confirmed — redirect with flag
|
|
29
|
+
return new Response(null, {
|
|
30
|
+
status: 302,
|
|
31
|
+
headers: {
|
|
32
|
+
Location: `${config.siteUrl}?already_confirmed=true`,
|
|
33
|
+
},
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
// Confirm subscriber
|
|
37
|
+
try {
|
|
38
|
+
await confirmSubscriber(db, payload.subscriberId);
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return Response.json({ error: 'Confirmation failed' }, { status: 400 });
|
|
42
|
+
}
|
|
43
|
+
// Send welcome email
|
|
44
|
+
await sendTransactional(env, config, {
|
|
45
|
+
to: subscriber.email,
|
|
46
|
+
subscriberId: subscriber.id,
|
|
47
|
+
subject: `Welcome to ${config.senderName}`,
|
|
48
|
+
template: 'welcome',
|
|
49
|
+
data: { name: subscriber.name },
|
|
50
|
+
});
|
|
51
|
+
// Redirect to site with confirmed flag
|
|
52
|
+
return new Response(null, {
|
|
53
|
+
status: 302,
|
|
54
|
+
headers: {
|
|
55
|
+
Location: `${config.siteUrl}?confirmed=true`,
|
|
56
|
+
},
|
|
57
|
+
});
|
|
58
|
+
};
|
|
59
|
+
//# sourceMappingURL=confirm.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../src/routes/confirm.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../src/routes/subscribe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQrC,eAAO,MAAM,IAAI,EAAE,QAiGlB,CAAA"}
|